前言¶
在 DeepSeek Harness（DSH）里使用 CLIProxyAPI 后面的模型时，常见做法是手工维护端点和模型列表。dsh-cliproxyapi-provider 把这件事简化为本地自动发现、模型目录动态同步，并让 CLIProxyAPI 中的模型进入 DSH 原生模型选择器。
下面介绍它的定位、能力、安装方式，以及几个典型使用步骤。
这是什么¶
dsh-cliproxyapi-provider 是 ChadCSong 维护的一个 DeepSeek Harness 插件，定位为 CLIProxyAPI provider。
它主要解决这几类问题：
- 本地 CLIProxyAPI 服务需要被 DSH 发现；
- CPA 返回的模型目录需要同步到 DSH；
- DSH 会话中需要方便地切换 CPA 下的模型；
- 主模型仅支持文本时，需要先用视觉模型处理图片。
该插件是标准 DSH bundle，适用于 DSH Web、headless profiles 和 DSH Desktop，不是 Desktop-only 扩展。许可证为 MIT。
核心能力¶
这个插件提供的能力都比较具体：
- 本地自动发现 CLIProxyAPI，探测
127.0.0.1:8317、localhost:8317和[::1]:8317。 - 从
/v1/models?client_version=pi读取模型目录，并支持标准data[].id回退。 - 模型在 DSH 原生模型选择器中以
CLIProxyAPI (auto)组出现，支持原生模型切换。 - 同一模型族内按最新版本优先排序。
- 支持从自动加载目录中选择视觉模型；当主模型仅文本时，先调用视觉模型描述图片，再将文本发送给主模型。
- 当 CPA 报告时，同步上下文/输出限制、推理支持、图像输入和服务等级。
- CPA 账户或模型变化后自动刷新，无需重装插件。
- API key 通过 DSH credential service 存储，不写入
settings.yaml。 - 提供
/cpa-status和/cpa-refresh命令。 - 默认推理协议为
openai-completions，使用 CPA 的/v1/chat/completions路由；可选openai-responses。
版本要求¶
使用前需要确认当前环境满足以下条件：
- DeepSeek Harness
0.1.0-rc.7或0.1.0-rc.8 - Node.js
22.19+或24+ - 一个运行中的 CLIProxyAPI 实例
该插件当前针对 DSH 0.1.0-rc.8 公共契约构建，并保留与 rc.7-based DSH Desktop 的运行时兼容。安装后需要重启对应 DSH 进程一次。
安装与启用¶
下面是官方给出的安装命令示例，以 web profile 为例：
dsh plugin --profile web add github:ChadCSong/dsh-cliproxyapi-provider
如果你是从本地代码安装，可以按下面步骤执行：
git clone https://github.com/ChadCSong/dsh-cliproxyapi-provider.git
cd dsh-cliproxyapi-provider
pnpm install
pnpm build
dsh plugin --profile web add "$PWD"
安装完成后，重启对应 DSH 进程一次。
典型用法¶
先启动 CLIProxyAPI，再在 DSH 中启用插件，最后回到会话选择模型。
- 启动 CLIProxyAPI。如果它监听默认端口
8317，URL 留空即可。 - 在 DSH 打开
Settings → Plugins → CLIProxyAPI (auto discovery)。 - 如果启用了 CPA bearer authentication，输入一次 API key。
- URL 和 key 有效后，从自动加载下拉框中选择 vision model。
- 回到会话，在 DSH 原生选择器中选择
CLIProxyAPI (auto)下的任意模型。
如果只是想确认当前接入状态，可以使用：
/cpa-status
/cpa-status 用于查看当前端点和已同步模型数量。
如果想立即重新探测 CPA 并刷新 DSH 模型目录，可以使用：
/cpa-refresh
视觉模型处理¶
这个插件的视觉模型选择和主模型选择是两件事。
如果主模型本身支持图像，图片可以直接进入主模型。
如果主模型仅支持文本，插件会先调用你选择的视觉模型描述图片，再把描述文本发送给主模型。这样可以在不修改 DSH 本身的前提下，让包含图片的会话继续使用仅文本的 CPA 模型。
需要注意的是，DSH 内置的 DeepSeek provider 不在这个插件的路由内。当会话已经包含图片时，DSH 仍会拒绝切换到仅文本的内置模型。插件不会修改、封装或重标内置 DSH DeepSeek 模型。
配置与凭据¶
这个插件在凭据处理上比较明确：
- API key 通过 DSH credential service 存储，不写入
settings.yaml。 apiKeyEnv是 credential reference，不是密钥本身。- 默认引用为
CLIPROXYAPI_API_KEY。
端点方面，自动发现只连接 loopback 地址。非 loopback 服务仅在你显式配置 baseURL 时访问。
推理协议默认使用 openai-completions，对应 CPA 的 /v1/chat/completions 路由。如果你的 CPA 部署通过 Responses API 暴露目标模型，可以选择 openai-responses。
适用场景与注意¶
这个插件适合本地运行 CLIProxyAPI，并且希望 DSH 自动发现模型目录、动态切换模型的开发者。
安装前建议检查源码、构建产物和许可证。该插件以当前 DSH 进程权限运行，接入本地模型服务时，端点、API key 和模型目录都会被纳入实际调用链路，需要自己确认来源可信。
另外需要注意：
- 自动发现只连接 loopback 地址；
- 插件不会把明文 API key 写入 settings、模型缓存或日志；
- DSH 内置 DeepSeek 模型仍由 DSH 自身管理；
- 设置命名空间保持
dsh-cliproxyapi，以兼容升级。
链接¶
GitHub：
https://github.com/ChadCSong/dsh-cliproxyapi-provider
插件线索给出的目录页为：
https://www.skillhub.cn/plugins/ChadCSong/dsh-cliproxyapi-provider
该目录页 URL 未在本文核实资料中确认为稳定入口，使用前请自行核对。
