普通用户使用手册

这份手册只介绍日常需要用到的功能。从开户到第一次对话，按下面顺序操作即可。

1. 登录自己的账户#

1. 请管理员先开通账户，确认登记的手机号。访问 https://protokener.com/login，选择短信登录。
2. 首次登录后按提示设置密码。之后可以选择短信或密码登录；忘记密码时使用页面的“忘记密码”。
3. 手机号未登记、账户暂停或验证码过期时请联系管理员，不要反复尝试注册。

2. 确认积分，再创建密钥#

1. 打开“充值与订阅”，切换到流量充值时查看流量积分；切换到订阅套餐时查看整期可用积分、使用进度和到期时间。
2. 进入“API 密钥”，为每个应用单独创建密钥并选择需要的模型。密钥不绑定某一个订阅周期，系统会按账户当前状态优先使用订阅积分。
3. 订阅不足或模型不在套餐范围内时，只有主动开启“使用流量积分”，后续请求才会使用流量包；不自动续费、不扣银行卡。API Key 积分上限只是消费限制，不是充值。
4. 不理解 IP 白名单、RPM、TPM 时保留管理员建议的默认值。密钥不要发给他人或放进公开代码。

订阅积分一览#

新订阅在有效期内共享整期积分，不设每周上限；到期未用完不结转。存量订阅保留购买时的权益快照，到期后购买新套餐时采用当前上架版本。

3. 连接你的客户端#

1. CodeBuddy / WorkBuddy：进入“API 密钥 → 客户端”，先选客户端和密钥，再下载一个完整配置 ZIP。
2. Windows 右键 ZIP → 全部提取，打开文件夹后双击对应 install.cmd；Mac 解压后双击 install.command。配置已在包内，工具自动准备运行环境。
3. 安装完成后重新打开客户端，新建对话，选择实时目录中的 pt/ 前缀模型。原有第三方模型会保留。
4. Codex / Claude Code：选择“客户端”中的对应教程；其他客户端填写自己的 API Key、平台地址与准确模型 ID。

4. 在桌面和 Protalker 查看余量#

1. Protalker 与 Protokener 共用账户。访问 https://protalker.cn 后登录或完成授权，页面顶部会显示当前购买模式、套餐、积分余量（显示两位小数）、使用进度和到期时间。

5. 看懂费用和退款#

模型按实际用量扣积分。余额、汇总与每笔使用记录统一显示两位小数，内部结算保留原精度。系统不预估本次费用：实际可用积分大于 0 即可开始，结束后最多扣到 0；余额耗尽后的下一次请求才提示充值，或按用户设置接续流量积分。

申请退款后查看订单退款进度。审核中、渠道处理中都不代表已到账；只有渠道确认成功后再核对原支付账户。页面未变化或长时间不到账，请提供订单号、支付方式和时间给管理员，不要重复付款。

6. 模型不见了或调用失败#

1. 模型列表异常：先完全退出客户端，在“API 密钥 → 故障恢复”下载对应恢复工具。Windows 双击 repair.cmd；恢复不需要 AI 模型，也不需要自己输入 node 命令。
2. 看到“已修复”后重启客户端、新建对话；看到“未发现这类问题”不代表已经修好。只有某个项目异常时，把项目路径和截图发给管理员。
3. 提交问题请附发生时间、客户端、模型、错误码和 Trace ID。不要发送完整密钥、密码或短信验证码。