前言¶
DeepSeek Harness (DSH) 采用插件化架构，而 CLIProxyAPI (CPA) 的账号管理通常需要单独打开网页控制台。dsh-cpa-switch 插件将 CPA 的管理功能集成到 DSH 的插件面板中，支持账号余额查看、签到、任务执行以及账号切换。
该项目由 cslkkl 维护，采用 MIT 许可证，目前 Star 数为 1。安装插件后，CPA 本体、渠道插件以及管理密钥会由插件自动处理，无需手动准备。
安装与启用¶
通过 DSH 的插件管理器安装该插件：
dsh plugin --profile <profile> add dsh-cpa-switch
插件首次启动时会自动下载并配置 CPA 本体、渠道插件以及所需的密钥。如果宿主机上已有 CPA，插件会尝试复用现有配置。
核心功能¶
该插件提供以下能力：
- 账号管理：查看余额（可用/已用）、执行一键签到与任务、切换当前使用的账号。
- 进程托管：由插件控制 CPA 的启动与停止，实现 DSH 开启则 CPA 运行、关闭则 CPA 停止。
- 模型自动注册：安装并添加账号后，四个渠道的对话模型会自动出现在 DSH 的模型选择器中。
- 模型选择限制：可以通过面板工具栏取消勾选模型，将其从对话界面的下拉列表中隐藏，但模型本身依然可用。
- 思考档位：支持开启或关闭模型的思考过程输出。
使用方法¶
安装并启动插件后，按以下步骤操作：
- 打开面板：在 DSH 界面进入“插件” -> “CPA 切换器”。面板内会以四个标签页分别展示 WorkBuddy、Trae、Qoder、ZCode 四个渠道的状态。
- 添加账号：在每个渠道列表末尾点击“+ 添加账号”，系统会唤起浏览器进行 OAuth 登录。
- 模型选择：在 DSH 的模型选择器中，模型以“渠道 · 模型名”的形式显示。选择模型时，只会使用当前渠道下的账号，不会跨渠道轮询。
- 隐藏模型：在 CPA 切换器面板的工具栏中，点击“模型”按钮，取消勾选不需要的模型并保存，即可在对话界面隐藏该模型。
- 思考档位：在模型选择器中，每个模型支持切换“关”或“开”两个档位。默认开启思考过程。
配置说明¶
主要配置项包括：
manageLifecycle：控制是否由插件负责 CPA 的启停（默认 true）。reasoningEfforts：控制模型是否可切思考档位（默认 true）。maxOutputTokens：设置推给宿主的每模型输出上限，用于避免 DSH 兜底截断（默认 384000）。注意：此配置目前仅在 WorkBuddy 渠道真正生效，其他渠道可能由服务端或客户端自行处理。autoCheckinOnStart：设置 DSH 启动时是否自动补签（默认 true）。
注意事项¶
- 平台限制：当前仅支持 Windows 系统，CPA 以 Windows 可执行文件形式提供。
- 下载限制：插件首次运行需要从 GitHub Release 下载文件，需确保网络能访问。
- 状态显示：面板显示“启用”不代表账号现在可用，可能因限流等原因暂时不可用，需在对话中验证。
- 密钥安全：管理密钥仅保存在宿主机侧，不会发送到浏览器，由插件代劳所有操作。
- 渠道插件更新：渠道插件不会被自动升级，面板会提示更新，需手动点击更新以避免兼容性问题。
- 输出上限：对于 Qoder 和 Trae 渠道，声明输出上限可能不会立即生效，需等待上游支持或自行调整。
总结¶
dsh-cpa-switch 通过插件化方式将 CLIProxyAPI 的管理流程融入 DSH，解决了账号管理需要频繁切换窗口的问题。对于需要管理多渠道 AI 账号的用户，它提供了一个集中化的控制面板。
- 项目主页：https://github.com/cslkkl/dsh-cpa-switch
- 目录页：https://www.skillhub.cn/plugins/cslkkl/dsh-cpa-switch
