前言¶
用 DeepSeek Harness（DSH）跑智能体，绕不开模型配置。如果你此前一直用 cc-switch 管理 Claude Code / Codex 的中转商配置，这些现成的供应商在 DSH 里并不能直接使用——常规做法是在 DSH 里重新录入一遍 API 地址和密钥，再手工搭好路由。
dsh-cc-switch 要解决的就是这件事：把 cc-switch 里已管理的供应商配置一键同步成 DSH 的模型路由，而且不要求 DSH 上已配置任何模型。换句话说，一个全新的、零模型的 DSH 实例，也能靠它从你已有的供应商起步。DSH 的理念是「一切皆插件」，模型接入这件事同样可以交给插件完成。
下面介绍这个插件的功能、原理与用法。
这是什么¶
dsh-cc-switch 是一个由 LKRCharon 维护的社区插件，以 MIT 协议开源。它读取本地 cc-switch 的 SQLite 数据库，把其中的 Claude Code / Codex 中转商配置映射为 DSH 的 llm-pi-ai 模型路由。
需要说明：这是非官方插件，与 cc-switch 或 DeepSeek 均无关联。
工作原理¶
插件的实现有三个要点。
1、以只读方式打开本地 cc-switch SQLite 数据库，从不修改 cc-switch 本身。
2、通过 DSH settings seam 把供应商映射到 llm-pi-ai 路由。改动在下一次请求即生效，无需重启。
3、API 密钥通过 DSH credential seam 以引用形式存储（CCS_*_KEY），密钥值不会出现在设置、工具输出或模型上下文中。
路由映射规则¶
| cc-switch 供应商 | DSH 路由 |
|---|---|
| codex 供应商 | openai-responses / openai-completions |
| claude 供应商 | anthropic-messages |
| 官方 OAuth 供应商 | 跳过（pi-ai 无法 OAuth） |
| gemini / claude-desktop | 暂跳过（roadmap） |
安装与启用¶
先执行安装命令，再重启 DSH：
dsh plugin --profile web add dsh-cc-switch
插件默认 syncOnStart: true，DSH 启动时自动同步一次，cc-switch 里的供应商会立即出现在模型选择器中。
如果你的 DSH 还从未启动过，也可以先在终端直接同步，无需安装任何东西：
npx dsh-cc-switch # 立即同步
npx dsh-cc-switch --dry-run # 仅预览
四种同步方式¶
同步可以在四个入口触发，按需选用：
1、终端 CLI：运行 npx dsh-cc-switch 立即同步，加 --dry-run 仅预览。无需安装，首次启动 DSH 之前也可用。
2、启动自动同步：syncOnStart 默认开启，DSH 启动时插件自动执行同步。
3、人类命令：在 composer 输入 /ccswitch 同步，/ccswitch dry 仅预览。需要 DSH 正在运行。
4、代理工具：让代理调用 ccswitch_sync 工具完成同步。需要有可用模型且 DSH 正在运行。
配置项¶
可以在 profile 的 cordis.patch.yml 中按行覆盖配置。例如关闭启动自动同步：
- id: cc-switch
config:
syncOnStart: false
全部可配置项及默认值如下：
| 配置项 | 默认值 | 说明 |
|---|---|---|
dbPath |
~/.cc-switch/cc-switch.db |
cc-switch 数据库位置 |
prefix |
ccs- |
路由 id 前缀 |
apps |
['codex', 'claude'] |
要同步的应用类型 |
syncOnStart |
true |
插件加载时执行一次同步 |
适用场景与注意事项¶
适合两类场景：
- 已经在用 cc-switch 管理 Claude Code / Codex 中转商，想把这批配置直接带进 DSH；
- 全新的 DSH 实例、还没有任何模型配置，想从已有供应商起步。
使用前注意：
- 这是非官方社区插件，以当前 dsh 进程的权限运行，会读取本地 cc-switch 数据库。安装前建议先查看源码与许可证，仓库地址见文末。
- 插件已针对 2026-08 的 cc-switch DB schema 与 DSH v0.1 developer preview 测试。两边迭代都快，建议锁定版本。当前版本 0.1.0，要求 Node >= 22.13，依赖 @deepseek-ai/dsh-tools ^0.0.1-rc.1 与 yaml ^2.6.0。
- 在 cc-switch 中已删除的供应商，暂不会从 DSH 设置中自动移除，需要在 Settings → Models 手动删除残留的
ccs-*路由。 - 官方 OAuth 供应商会被跳过；gemini 映射、Models 设置页的「从 cc-switch 导入」按钮、DB 变更监听均为计划中的功能。
小结¶
经过上面的步骤，cc-switch 里管理的供应商就能直接变成 DSH 的模型路由：不需要重新录入密钥，也不要求实例上已有模型。对同时使用 cc-switch 和 DSH 的人来说，这是一条现成的接入路径。
- 插件目录页：https://www.skillhub.cn/plugins/LKRCharon/dsh-cc-switch
- GitHub 仓库：https://github.com/LKRCharon/dsh-cc-switch
（注：目录页来自独立运营的社区插件目录，与 DeepSeek 或幻方无官方从属关系。）
