← OkFile 首页

直接说出你想做什么。

从进入聊天到上传、密码加密、下载与续传,按下面步骤操作即可;示例均为手动输入,不需要编写脚本。

CLI 2.15.5逐条复制 · 手动操作
正在检查当前实例能力…

1 · 开始聊天

先在 PowerShell 或终端运行以下命令。完成登录后再进入聊天,普通用户不需要填写 DeepSeek Key。

1升级到配套版本,直接使用官方源。

python -m pip install --upgrade --index-url https://pypi.org/simple okfile==2.15.5

2默认英文;习惯中文可先运行这一条,选择会保存在 config.json。

okfile config set language zh

3首次使用先登录。输入自己的邮箱,收到验证码后按提示填写,输入内容会显示。

okfile login you@example.com --server https://hkokfile.pckee.com

4进入聊天。后面的任务语句在 You > 或“你 >”后输入。

okfile chat --server https://hkokfile.pckee.com

已配置 API Key 的用户可以直接进入聊天。CLI 会自动使用保存的服务器凭据。

2 · 看懂对话和进度

You > / 你 > 是你的输入,OkFile > 是系统回复;终端支持时用不同颜色区分。

1不确定怎么说时,在聊天中输入。

帮助

上传、下载期间照常显示已传大小、速度、实际并行数量、已用时间和 ETA,进度在同一行刷新;顺序传输显示并行 1。任务结束后回到输入提示。复制示例时只复制命令或任务句子,不要复制提示符。

3 · 上传一个文件

在资源管理器复制文件的完整路径,路径有空格时保留英文引号。一次描述一个任务。

1在聊天中输入,路径换成自己的。

上传 "C:\素材\报告.pdf"

2英文输入也可以,界面仍按你设置的语言回复。

upload "C:\files\report.pdf"

上传进度会显示本次实际并行数量;顺序上传显示并行 1。文件传完后会给出下载链接。手动复制链接交给接收方;普通分享链接的持有者可以访问文件。

4 · 用密码加密后上传

适合不希望中心服务器看到原始文件的分享。加密在本机完成,不需要密钥文件。

1输入任务后,在单独提示中设置至少 6 个字符的密码,只输入一次。

加密上传 "C:\素材\报告.pdf"

2英文的本地基础说法。

upload "C:\files\report.pdf", encrypt

密码输入会显示在终端,但不会发送给模型或服务器,也不会写入聊天状态。不要把密码直接写在任务句子中。把链接和密码分别交给接收方;密码丢失后无法恢复。

5 · 下载与解密

先向发送方取得真实下载链接,示例中的 FILE_ID 必须替换。

1普通文件直接下载。

下载 https://hkokfile.pckee.com/d/FILE_ID,保存到 "C:\下载\报告.pdf"

2对方用了本机密码加密时,也可直接下载;新版会自动识别并询问解密密码。

下载 https://hkokfile.pckee.com/d/FILE_ID,保存到 "C:\下载\报告.pdf"

3英文下载并解密;未指定保存位置时使用当前目录或聊天默认下载目录。

download https://hkokfile.pckee.com/d/FILE_ID, decrypt

解密成功后会显示文件保存位置。加密标记不含密码,链接路径不变。下载访问密码只限制链接访问,本机加密密码用于解密原文,二者可能不同;仅设置访问密码的文件请说“下载 链接,输入密码”。

6 · 完成后提醒我

上传和下载都支持邮件通知,使用已登录账户邮箱或指定通知邮箱。

1先保存常用收件邮箱。

通知邮箱 you@example.com

2任务结束后发送提醒。

上传 "C:\素材\报告.pdf",通知我

3不再默认发邮件时输入。

关闭通知

通知只在本次传输成功后申请发送;失败或中断不会发送成功提醒。邮件不包含加密密码。服务器需启用邮件服务。

7 · 中断后继续

传输中按 Ctrl+C 会暂停并保留恢复信息。重新进入聊天后继续上次未完成的任务。

1继续上传,加密文件会再次询问原密码。

继续上传

2继续下载。

继续下载

3确定不再上传时,可取消未完成的上传。

取消上传

已经完成的任务不会重复传输。恢复加密上传需输入同一个密码;关闭窗口不需要把密码保存到配置文件。

8 · 切换语言

默认英文,当前完整提供英文 en 与中文 zh。任务可以用多语言描述,模型回复遵循已保存的界面语言。

1在聊天里切换中文,立即生效;也可以直接说“中文”或“设置成中文”。

说中文

2在聊天里切回英文,也可以输入 language en。

设置成英文

3在普通终端也可设置。

okfile config set language zh

语言写入 config.json,退出后仍保留。命令参数、文件名和 JSON 字段不会随语言翻译。

9 · API Key 在哪里?

API Key 是服务器访问凭据;文件加密使用单独的密码,不会生成 .key 文件。

1查看本机实际配置路径和掩码信息,不会显示完整 Key。

查看密钥存放位置

2需要新 API Key 时明确说明用途。

申请 API 密钥 工作电脑

API Key 自动保存在 config.json 的 api_key 字段。accounts.json 保存账户会话,请勿分享这两个文件。不要将 Key 粘贴到聊天描述里。

先拿链接,边传边下

发送方会在传输内容前看到分享链接,接收方无需等整个文件上传完成。

1在聊天中开启边传边下。

上传 "C:\素材\视频.mp4",边传边下

2同时使用本机密码加密。

加密上传 "C:\素材\视频.mp4",边传边下

3接收方拿到链接即可在聊天中下载。

下载 https://hkokfile.pckee.com/d/FILE_ID

4加密分享也直接下载,新版会自动询问解密密码。

下载 https://hkokfile.pckee.com/d/FILE_ID

未完成的数据只放在临时文件中,整文件校验通过后才显示完成;传输暂停时可以直接说“继续”“继续上载”或“继续上传”,这些续传指令在本机执行,不依赖模型解析。

直接从云存储下载

聊天下载会自动选择链路,不需要记住云平台地址。界面会说明是“直接从对象存储下载”还是“通过 OkFile 服务器下载”。

1普通分享和本机密码加密文件优先直连 S3 兼容对象存储。

下载 https://hkokfile.pckee.com/d/FILE_ID

2在普通终端可强制使用转发下载。

okfile download "粘贴下载链接" --via-server

现有 S3 兼容存储均共用预签名下载接口;R2 与其他平台按同一机制处理。已完成的大文件默认使用 4 个 Range 连接并行下载。队列、限次、阅后即焚及本地磁盘文件继续经过 OkFile,以保留现有权限规则。

10 · 智能模式与本地模式

默认 auto:后台启用模型时使用 DeepSeek 理解灵活语序;未启用时使用本地基础规则。

1模型不可用时,退出聊天,在终端运行这一条进入本地模式。

okfile chat --mode local --server https://hkokfile.pckee.com

2结束当前聊天。

退出

DeepSeek 只接收任务描述、必要的近期上下文和语言设置,返回受校验的任务参数。CLI 再执行固定操作,不运行模型生成的系统命令。文件内容、单独提示中输入的密码、验证码与凭据不发送给模型。模型故障时可切换本地模式,按本页基础示例操作。