CPA 中转站 cslkkl/dsh-cpa-switch

dsh-cpa-switch

在 DSH 里管好你的 AI 渠道账号余额、签到、任务、切号，不用离开 DSH

简体中文 · English

看余额、签到、跑任务、切账号 —— 在 DSH 里管理 CLIProxyAPI（CPA）的账号，不用再开它的网页控制台。

装完插件即可用：CPA 本体、渠道插件、配置与密钥都由插件自动备好。

[!NOTE]
密钥不出宿主：面板里的所有操作都由插件代劳，管理密钥只保存在宿主侧，网页拿不到。

它做什么

打开 DSH 的 插件 → CPA 切换器，或点左侧栏的 CPA 切换器（与「插件 / 自动任务 / 用量统计 / SSH」并列的那一行），四个渠道各一个标签：

- 看账号余额：可用 / 已用 / 额度池 / 套餐包数；token 与积分分开显示，不混加。
额度数字到百万级自动缩写（508M tokens；只上一档 M，不改写成 B）
- 额度包周期提醒：上游明确给出结束日期的额度包，在周期结束前 7 天可展开查看账号、包名、余量和结束时间；周期结束不等于未用额度一定失效
- 一键签到 / 一键任务：整个渠道一次点完；每个账号也可以单独操作
- 启用 / 禁用账号：每个账号一个开关；「只用这一个」一步把同渠道其余账号全部禁用
- 添加账号：每个渠道列表末尾的「+ 添加账号」，在浏览器里完成 OAuth 登录即可
- 记住你的选择：重启 DSH 后，在用的仍是你上次选的号；运行期间被别处改回去（渠道插件会按额度自动重新启用账号）时，面板会照你的选择恢复并提示一句——期间开关不会反复跳回「全开」再弹回来
- 自动签到：按渠道开关；DSH 没开而漏掉的签到，插件启动时补一次
- 进程托管：DSH 开则 CPA 起（已在跑就复用），DSH 关则一并停止
- 起不来时说清为什么：端口被别的 CPA 占用、配置代际不符、配置加载失败各自点明；端口被外部实例占着时不再假装「运行中」
- 对话模型自动注册：装完插件、加完账号，四个渠道的模型自动出现在 DSH 的模型选择器里
- 只让常用的模型出现在选择器里：面板工具栏上有个「模型」按钮，点开取消勾选某个模型并保存，它就从对话界面的下拉里消失（面板里照旧列出全部，随时可以勾回来）；不勾只是不在下拉里，模型本身照常能调通
- 侧栏入口默认不显示：面板最底部有一个「侧栏入口」开关（默认关）。打开后入口在 侧栏的「更多」菜单里（不占栏上那一行）；关掉（默认）时面板只从插件页进 ——侧栏是宿主和大家共用的地方，插件不默认占位

支持四个渠道

| 渠道 | 账号数 | 余额单位 | 签到 | 任务 |
| WorkBuddy | 多号 | 积分 | ✅ | ✅ |
| Trae | 多号 | 积分 | ✅ | — |
| Qoder | 单号 | 积分 | ✅ | — |
| ZCode | 单号 | token | — | — |

四个渠道上报的余额字段不是一套：Trae 只有一个余额池，上游不给总额与已用，所以它那格显示 —、也不画进度条 —— 那是「上游没说」，不是「用了 0」。

按能力降级：渠道不支持的功能不显示，不给"点了没反应"的按钮。

安全

管理密钥只保存在宿主侧，永不下发浏览器 —— 细节见 架构说明。

前置条件

只需要 DSH（DeepSeek Harness）。CPA 本体、渠道插件、管理密钥都不用你准备 ——插件首次启动时自动下载并配好；机器上已有 CPA 时直接复用，不会覆盖。

下载需要能访问 GitHub Release，直连不通时配好代理即可。

渠道插件不会被自动升级（上游随时可能改行为，静默替换风险太大）。
面板上会显示「渠道插件 a → b」，需要时点一次「更新渠道插件」：它会先停 CPA、保留一份旧件、失败自动还原，换完不自动重启。

安装

从 npm 安装：

dsh plugin --profile <profile> add dsh-cpa-switch

GUI 的插件管理器里填包名 dsh-cpa-switch 等价。

从本地目录安装（开发用）：

plugin_manager action: install_bundle
target: <本目录绝对路径>

从本仓库源码安装：

cd <本仓库目录>bash
pnpm install
pnpm build
dsh plugin --profile web add .

插件必须装进所选配置档的 node_modules/ 下。装完不显示、或显示「未运行」，见 AGENTS.md 的活跃坑。

配置

| 字段 | 默认 | 说明 |
| adminKey | 空 | CPA 管理密钥；留空则用凭据库里的引用 |
| adminKeyRef | CPA_ADMIN_KEY | 凭据库里的引用名 |
| port | 8317 | CPA 监听端口 |
| exePath | 空 | CPA 可执行文件路径；留空自动探测 |
| manageLifecycle | true | 是否由插件负责 CPA 的启动和停止 |
| autoCheckinOnStart | true | 启动时补一次漏掉的签到 |
| openControlPanel | false | CPA 启动时是否同时打开它自带的网页控制台 |
| reasoningEfforts | true | 是否让模型可切思考档位（关 / 开两档） |
| maxOutputTokens | 384000 | 推给宿主的每模型输出上限；0 = 不声明 |
| startTimeoutSeconds | 30 | 等待 CPA 就绪的最长秒数 |

⚠️ 输出上限：插件把 maxOutputTokens 推给宿主的每个模型（宿主字段 maxTokens），让请求不再被 DSH 兜底的 32768 提前截断。实测它目前只在 WorkBuddy 渠道真正生效 —— qoder 由服务端模板自带上限、客户端值不进请求，trae 会丢弃该字段并自行补大值；给这两家声明是为渠道侧支持后自动生效。默认值 384000（DeepSeek V4 系列的输出上限天花板）是报大方向：上游对超报值不拒绝（实测 384000 发给真实上限 128k 的模型也正常返回），截断职责仍在上游。链路与实测见实测报告的附录。

对话模型

装完插件、加完账号，四个渠道的模型会自动出现在 DSH 的模型选择器里：

- 模型按渠道分组显示：分组标题就是渠道（如 CPA Switch · WorkBuddy），组内每一行是模型名本身（如 deepseek-v4.1-flash）—— 一眼看出请求会走谁
- 这个服务商在 DSH 里显示为 CPA Switch —— 你在模型选择器里看到的就是它
- 同一个模型被多个渠道供给时，每个渠道各出一条 —— 选了哪个渠道，就只用那个渠道的号，不会跨渠道轮询消耗你的其它号
- 只列能用的：已被禁用、已报错或当前不可用的账号，它的模型不会出现 —— 选择器里不会有「点了才发现调不通」的条目
- 只列这四个渠道：CPA 上可能还装着本插件不管理的渠道，它们的模型不出现；插件不认的渠道不会有管理入口，与其给你一个选不上的名字，不如不列
- 启动时不会先给一份残缺的清单：重启 DSH 后如果第一次读到的目录还不完整（CPA 刚起、账号还在分批加载），插件会继续用上一次的完整清单，并在几秒内自动重读补齐 —— 不会出现「只剩一两条模型」或「只剩一个渠道」的中间态

加了新账号、删了账号，模型清单自动跟着变。机制与设计见架构说明。

思考档位

模型选择器里每个模型可以切思考档位 —— 两个选项：

- 关：不让模型输出思考过程，直接给答案
- 开（默认）：模型先想再答，思考过程在对话里看得见

默认打开（reasoningEfforts: true）。想整体关掉就去插件设置里关这个开关 —— 关掉后 Effort 那一行会消失，回到不带档位的老行为。

⚠️ 只给两档是有意的，不是没做完。 实测上游对「低/中/高/最大」这类中间刻度不按刻度办事（同一档位内的波动比档位之间的差还大），给了就是在制造错误预期。所以只暴露两个语义确定的值：关与开。理由与实测数据见决策记录。

⚠️ 「关」发出去的那个词按渠道自动适配（zcode 只认 none、不认 off），所以四个渠道上选「关」都不会因为用词被上游拒。

⚠️ 如果上游某个时刻拒绝档位值（整轮对话报错），把上面那个开关关掉即可恢复。

菜单里为什么有一行 Default：它是 DSH 在「路由没声明默认档位」时补的，语义就是什么都不发、由上游自己决定。档位这事各模型差别很大、上游还常改，所以插件不钉默认值 —— Default 就是那个兜底，另外两行是插件给的两档。曾经钉过（high）以去掉这一行，但那会把摘掉档位的模型整轮打崩，已撤。原理与取舍见决策记录。

已知限制

- 仅 Windows：CPA 目前以 Windows 可执行文件 + DLL 插件形式提供。
- 下载要能访问 GitHub Release：直连不通时需要代理。
- 被限流的号界面看不出：面板显示"启用"不代表"现在能用"，只有实际对话报错才发现 —— 详见架构说明的防错清单。

文档维护者文档地图见 AGENTS.md。常用入口：

| 想看什么 | 去哪 |
| 为什么这样设计（不变决策、契约边界、防错清单） | docs/ARCHITECTURE.md |
| 宿主半边各模块、内部 HTTP 路由表 | src/README.md |
| 浏览器半边 | src/client/README.md |
| 环境准备 | src/setup/README.md |
| 测试覆盖与运行 | tests/README.md |
| 下一步做什么、当前卡在哪 | docs/PLAN.md |

开发 powershell
pnpm install
pnpm build # tsdown 双目标构建 → lib/
pnpm check # typecheck + lint + format + build + verify:artifacts + test

改了源码要重新构建：宿主加载的是构建产物，pnpm build 之后宿主侧重启 DSH、浏览器侧刷新页面。

致谢

本项目站在以下开源项目之上，特此致谢：

| 部分 | 参考来源 |
| 工程骨架与插件机制：tsdown 双目标构建、双 tsconfig、vitest / eslint / prettier、Cordis 集成、配置 schema、React 面板 UI、生命周期写法 | dsh-workbuddy-bridge |
| 被管理宿主：多渠道中转 ProxyAPI，以及账号文件、路由策略等管理 API（上游代码） | CLIProxyAPI |
| 渠道协议与多渠道路由能力：WorkBuddy / Trae / Qoder / ZCode 渠道插件，以及账号聚合、签到、任务、余额协议 —— 面板的渠道能力面由它定义 | cpa-multi-plugins · workbuddy-bridge-0.1.2-source（WorkBuddy 渠道协议参考） |
| 宿主平台 | DeepSeek Harness |
CLIProxyAPI 运行时产物发布自 cslkkl/CLIProxyAPI（release-windows 工作流）；开发与调研另参考 zlZayn/CLIProxyAPI（local-autobrowser 分支）。二者与上游 router-for-me/CLIProxyAPI 本质同源，仅存放位置与分支不同。

免责声明

本项目仅供个人学习与研究使用，与 WorkBuddy / Trae / Qoder / ZCode 等各平台官方无关，非官方产品。

- 使用本项目产生的账号风险、额度变动及其它后果，均由使用者自行承担
- 请勿用于商业用途
- 各渠道平台有权随时调整其服务策略，本项目不保证任何功能的持续可用
- 因使用本项目造成的任何损失，作者不承担任何责任

贡献

欢迎提 Issue 与 PR。提交前请确保 pnpm check 全绿。

怎么起步、提交与 PR 的纪律、文档同步要求 → CONTRIBUTING.md。

本仓的约定写在 AGENTS.md：改动要同步文档网络，文档改动后跑一次链接校验（命令见该文件）。

许可

MIT