面向操作员的人工步骤与单条命令。逐条复制到终端，把文件路径、下载链接和邮箱换成实际值即可。
CLI 2.15.5逐条复制 · 手动操作打开终端，逐条运行下面的命令。每次只复制一条；不需要编写脚本。
1安装或升级客户端（使用官方源，避免镜像同步延迟）。
python -m pip install --upgrade --index-url https://pypi.org/simple okfile==2.15.52设置一次服务器地址，以后的命令会自动使用它。
okfile config --server https://hk.okfile.com3查看版本，确认显示 2.15.5。
okfile --version4用自己的邮箱注册，按提示输入邮件中的验证码。验证成功后自动保存 API Key。
okfile register "你的邮箱@example.com"之后直接使用下面的上传、下载命令。路径和文件名按你的实际情况填写；带空格的路径保留双引号。
首次使用 register 注册；已有账户使用 login。邮箱验证码在终端中可见输入。输错后可再输入三次；过期或次数耗尽时重新获取验证码。验证成功自动保存默认 API Key，不需要打开管理网页。
1登录已有账户；本机已有有效 Key 时会继续使用它。
okfile login "你的邮箱@example.com"2查看当前邮箱账户。
okfile whoami3查看自己申请的 Key，只显示前缀，不显示完整密钥。
okfile apikey list4为新用途创建 Key 并设为本机默认。切换 Key 后，队列权限按新 Key 判断。
okfile apikey create --name "我的电脑" --use5确认不再需要某个 Key 时，填写列表中的 Key ID 将它撤销。
okfile apikey revoke "key_替换为实际ID"6退出本机账户，移除本机保存的登录信息。
okfile logout注册与登录采用同一种邮箱验证；新邮箱验证后自动创建账户。完整 Key 仅创建时返回。退出登录不会撤销其他设备的 Key；撤销 Key 也不会删除已有文件。
适合大文件跨电脑交付。发送方登录后默认开启边传边下，无需加参数，完成本机准备后、发送文件内容前就会打印分享链接。接收方只下载已上传且校验通过的部分。用 --no-live 可关闭提前分享；受限上传自动使用普通模式。CLI 2.15.0 边读边算摘要并上传，不再预先扫描整个文件；实时接收方也请升级到 2.15.0。新版始终打印下载链接，并说明是立即接收还是完成后下载；旧普通任务续传保持原模式。升级后请退出并重新进入聊天。
1发送方启动实时分享，看到提前显示的链接就可以复制给接收方。
okfile upload "C:\素材\视频.mp4"2接收方马上运行下载，缺少的部分会自动等待。
okfile download "提前拿到的下载链接" -o "C:\下载\视频.mp4"3如果希望服务器也看不到原文，发送方同时启用本机密码加密。
okfile upload "C:\素材\视频.mp4" --encrypt-password4加密文件的接收方输入同一密码；完整密文和整文件摘要确认后才生成明文。
okfile download "提前拿到的下载链接" --decrypt-password -o "C:\下载\视频.mp4"发送方暂停后，接收方保留进度并等待；取消、会话到期或摘要错误会停止交付，不生成完整文件。默认连续 1 小时没有新数据时保存进度并退出，可用 --wait-timeout 调整，重新运行原命令可恢复。浏览器只显示等待页，上传完成后才能下载；边传边下需要新版 CLI。暂不与队列、限次、阅后即焚组合。
新版 CLI 优先协商对象存储直连；浏览器打开普通下载链接也可直连。服务器只负责验证和签发短期地址。
1正常下载即可自动选择合适链路，终端会显示直连或转发。
okfile download "粘贴下载链接" -o "C:\下载\报告.pdf"2网络需要或希望固定经过服务器时，加这个参数。
okfile download "粘贴下载链接" --via-server -o "C:\下载\报告.pdf"适用于现有 S3 兼容后端，包括 R2 以及其他兼容平台；具体兼容性以平台实现和实测为准。本机加密文件也能直连。队列、限次、阅后即焚及本地磁盘文件继续转发。短期签名链接最长 5 分钟，续传时自动重新获取，且不把 OkFile 凭据发给云存储。R2 免出站流量费，但存储及请求仍按用量计费；其他平台按各自套餐计费。
管理员登录后台后，打开 Download traffic 标签即可查看每次下载的时间、文件、存储、传输模式和字节数。
1在浏览器打开管理员后台并完成邮箱验证码登录。
https://hk.okfile.com/admin/OkFile 转发下载显示 measured（实际写出字节）；对象存储直连和边传边下的云端签发显示 estimated grant（按签发范围估算）。顶部会分别汇总实际流量和直连估算流量，便于按不同云平台的计费规则估算成本。直连请求若中途取消，实际云端流量可能低于签发估算；重试签发会分别计入。
默认使用英文。语言会保存到 config.json，重新打开 CLI 后仍然生效；命令、文件名和 JSON 字段保持原样。
1切换为中文。
okfile config set language zh2切回英文。
okfile config set language en聊天中也可输入 language zh 或 language en。验证码和密码在单独的本机提示中可见输入，不会发送给模型。聊天时仍显示实时上传、下载进度。
先运行 okfile chat；之后的中文指令只在 okfile > 提示符中输入，不是在 PowerShell 提示符中输入。后台启用 DeepSeek 后支持灵活语序和多语言；无需在客户端填写模型 Key。未启用时使用本地基础指令。
1进入聊天模式，沿用已配置的服务器和 API Key。
okfile chat2在 okfile > 中输入，文件路径换成自己的文件。
上传 "C:\素材\报告.pdf"3需要密码和完成提醒时输入这一句，密码按单独提示输入。
上传 "C:\素材\报告.pdf"，设置密码，通知我4下载时粘贴链接并填写保存位置。
下载 粘贴下载链接，保存到 "C:\下载\报告.pdf"5传输中断后可重新进入聊天，再输入这一句。已完成的任务不会重复传输。
继续上传6查看 API Key 的实际保存位置和用途，不会显示完整秘密。
查看密钥存放位置7查看支持的说法，或输入“退出”结束聊天。
帮助还可以说“登录 你的邮箱”“申请密钥 工作电脑”“使用队列 inbox”“通知邮箱 你的邮箱”“下载目录 C:\下载”。聊天默认设置会保存，无需每次重复填写；输入“查看配置”查看当前值。
先在电脑上选好文件，把下面的示例路径换成它的完整路径。
1上传文件，等待终端显示完成。
okfile upload "C:\素材\视频.mp4"从上传结果中手动复制下载链接，发给接收方。接收方可以用浏览器打开链接，也可以用下一节的命令下载。普通分享链接的持有者可以访问文件。
先向发送方取得下载链接，再选择电脑上的保存位置。已完成的云存储文件默认使用 4 个连接并行下载。
1把“粘贴下载链接”换成实际链接；保存位置的文件夹需事先建好。
okfile download "粘贴下载链接" -o "C:\下载\视频.mp4"进度行会显示实际并行数量；顺序下载显示并行 1。完成后打开保存位置检查文件。目标文件已存在时，换一个文件名；确认需要覆盖时才加 --force。高级用户可用 --download-concurrency 调整为 1 至 16。
发送方设置密码，接收方输入密码后即可边上传边下载，无需额外 live 参数。下载密码控制访问；若要让服务器也看不到原文，请使用“加密后上传”。
1发送方运行上传命令，按终端提示输入密码。
okfile upload "C:\素材\视频.mp4" --password2接收方取得下载链接与密码后，运行此命令并按提示输入密码。
okfile download "粘贴下载链接" --password -o "C:\下载\视频.mp4"把下载链接和密码分别交给接收方。接收方也可以直接在浏览器打开下载链接，在页面上输入密码。
网络临时故障会自动重试。关闭窗口或按 Ctrl+C 后，保留原文件和本机上传记录。
1重新打开终端，再执行原来的上传命令；发现可恢复任务时按提示继续。
okfile upload "C:\素材\视频.mp4"2确定不再上传这个文件时，取消尚未完成的任务。此命令可选。
okfile cancel "C:\素材\视频.mp4"继续上传会补传缺失部分。加密上传中断后，仍需使用原来的 --encrypt-password 参数与同一个密码。
保留下载目录里的临时文件，使用同一个下载链接和保存路径。
1再次执行原来的下载命令。
okfile download "粘贴下载链接" -o "C:\下载\视频.mp4"客户端会核对文件身份，再从已下载的位置继续。带访问密码的下载仍加 --password；新版加密文件会自动询问解密密码，旧链接可继续加 --decrypt-password。
服务器只保存密文，密码不上传给服务器或模型。无需密钥文件，使用至少 6 字符的长密码。
1发送方运行后，可见输入一次加密密码即可。
okfile upload "C:\素材\视频.mp4" --encrypt-password2把下载链接和密码分别交给接收方。新版会识别加密标记并自动询问同一密码。
okfile download "粘贴下载链接" -o "C:\下载\视频.mp4"加密标记不含密码，下载链接无需改成特殊路径。密码加密与 --password 下载访问密码是两项不同功能。密码丢失后服务器无法恢复原文。旧链接仍可加 --decrypt-password；旧密钥文件加密的文件需用 CLI 2.9.1 和原密钥先解密。
上传和下载都可指定一个通知邮箱。先在安装与连接中保存管理员提供的 API Key；队列命令使用对应队列凭据。
1上传完成后给自己发邮件。将示例邮箱换成你的邮箱。
okfile upload "C:\素材\视频.mp4" --notify-email "you@example.com"2下载完成后给自己发邮件。加密下载会等待解密成功才通知。
okfile download "粘贴下载链接" -o "C:\下载\视频.mp4" --notify-email "you@example.com"每次命令成功只申请一条通知，中断或失败不发送成功提醒。服务器需配置邮件服务；邮件失败会单独提示，不会让已完成的上传或下载重做。邮件不包含密码、队列凭据或解密密钥。
平时无需记住全部参数，按需要查看对应命令的帮助。
1检查是否有新版本。
okfile upgrade --check2安装托管启动器或更新客户端。启用自动更新后，启动器会定期检查并在下次启动切换版本。
okfile upgrade3查看上传参数。
okfile upload --help4查看下载参数。
okfile download --help如果安装成功却显示旧版本，到高级使用中的“测试清理、升级与诊断”查看排查方法。