dsh-cliproxyapi-pro
用于 DeepSeek Harness 的 CLIProxyAPI 自动发现提供商和管理界面——支持多个账户、动态模型同步、能力检测和可视化设置。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-cliproxyapi-pro@1.4.1Cliproxyapi Pro 以 dsh-cliproxyapi-pro 发布，当前版本为 1.4.1。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
中文 | English
把 CLIProxyAPI（CPA）里的模型，一键接进 DeepSeek Harness（DSH）的模型选择器。
填好服务地址和 API Key，插件会自动读取 CPA 的模型目录，把你勾选的模型连同上下文长度、图片输入、推理档位一起同步到 DSH；每个模型自动走它最合适的协议。可以同时接入多个 CPA 账号，每个账号单独启用或停用。
cliproxyapi 工具帮你配置。适用于 DSH 0.2.0-rc.1 及以上版本（含桌面版与 Web 版）。
插件已发布到 npm：dsh-cliproxyapi-pro，中国大陆镜像（npmmirror）同步可用。任选一种方式安装即可。
打开 DSH，点击左侧栏的 插件。
点击页面顶部的 添加插件。
在输入框中填写包名：
dsh-cliproxyapi-pro
需要固定版本时可以写成 dsh-cliproxyapi-pro@1.4.1。
点击 安装，完成后点击 立即启用。
在中国大陆下载慢，可以点输入框旁的 安装源，切换到 中国大陆镜像源。
在 DSH 对话框里直接说：
帮我安装 DSH 插件 dsh-cliproxyapi-pro
Agent 会调用 plugin_manager 完成安装和启用（视权限设置，可能需要你批准）。装好后可以接着让它配置，例如「把 CLIProxyAPI 地址设为 http://127.0.0.1:8317，密钥是 sk-…」。
dsh plugin --profile <profile 名称> add dsh-cliproxyapi-pro
这条命令从 npm 下载插件，并把它加入该 profile 已启用的插件列表，一步完成。DSH 桌面版的 profile 通常叫 desktop；如果 DSH 正在运行，重启后生效。
在插件页的 添加插件 中，或作为 plugin_manager 的 target，也可以填写：
| 来源 | 填写内容 |
|---|---|
| 某个发布版本 | git+https://github.com/TinyBOOOOM/dsh-cliproxyapi-pro.git#v1.4.1 |
| 最新开发版 | git+https://github.com/TinyBOOOOM/dsh-cliproxyapi-pro.git#main |
| 离线安装包 | 下载 dsh-cliproxyapi-pro.tgz（始终是最新版），填写它的本地绝对路径 |
| 本地源码（开发用） | 克隆后的仓库目录绝对路径；以链接方式安装，改代码后重载插件即生效 |
所有版本见 Releases。
http://127.0.0.1:8317，不用加 /v1）和 API Key（本地免密的 CPA 可留空），点 保存设置并应用。CPA 就在本机默认端口 8317 且没有设置密钥时，什么都不用填，插件会自动发现它。
1. 账号栏与账号状态。 顶部账号栏列出所有账号：绿点表示已连接，灰点加「未启用」标记表示已停用。图中刚用「+ 添加账号」新增了第二个账号「CLI Proxy API 2」：它默认停用，拥有独立的路由 cli-proxy-2；由于还没填写服务地址，探测提示本地没有找到 CPA 服务。
2. 模型显示筛选。 从 CPA 服务发现的全部 168 个模型，支持全部发现 / 已勾选 / 未勾选切换、家族标签（GPT、CLAUDE、GEMINI、GROK……）、搜索与批量操作。只有勾选的模型会同步到 DSH 模型选择器；每个模型显示将使用的协议（图中为 OpenAI Responses）、图片输入、推理档位与上下文长度，「编辑参数」可打开单模型参数覆盖。
3. 连接与认证配置。 每个账号独立的设置：「启用此账号」开关、服务地址、保存在该账号独立引用名（CLI_PROXY_API_KEY_2）下的 API Key、接口协议、账号名称、可折叠的高级设置，以及「保存设置并应用」与「删除此账号」。
/v1、/v1/chat/completions、/v1/messages 等后缀会自动去掉。CLIPROXYAPI_BASE_URL、本机 127.0.0.1:8317。/v1/models?client_version=pi 的富元数据目录（也兼容标准 OpenAI data[] 格式），并用 /v1/models 的 owned_by 判断模型家族。已勾选模型的 编辑参数 可以单独设置：上下文窗口、最大输出、图片输入、思考等级（off、minimal、low、medium、high、xhigh、max）和请求协议，也可一键恢复自动探测值。
cli-proxy / cli-proxy-responses / cli-proxy-messages，之后依次为 cli-proxy-2*、cli-proxy-3*……；密钥引用名依次为 CLI_PROXY_API_KEY、CLI_PROXY_API_KEY_2……。模型选择器按账号名称分组。:8317，避免两个账号指向同一个服务。CPA 对每个模型同时提供 OpenAI Chat、OpenAI Responses、Anthropic Messages 三种入口，入口协议和上游不一致时需要转换。默认的自动模式让每个模型直接使用上游协议：
模型家族（依据 owned_by 与模型 id） | 协议 | 路由（以 cli-proxy 为例） |
|---|---|---|
Claude（含 devin/claude-*、Antigravity Claude） | Anthropic Messages /v1/messages | cli-proxy-messages |
| OpenAI / Codex / GPT、xAI Grok | OpenAI Responses /v1/responses | cli-proxy-responses |
| Gemini、DeepSeek、Kimi、GLM、SWE、gpt-oss 等 | OpenAI Chat /v1/chat/completions | cli-proxy |
generateContent，所以 Gemini 走 OpenAI Chat。agent-default-model 会自动跟随。effort），更早的 Claude 使用 token 预算。retryPolicy）会被保留。cliproxyapi 工具DSH 的 Agent 可以用这个工具查看和配置插件，你只需用自然语言提要求。
action | 作用 |
|---|---|
status | 查看所有账号（或 account 指定的账号）的状态与模型 |
refresh | 立即探测并同步；不带 account 时刷新全部账号 |
configure | 修改一个账号（默认第一个），保存后立即刷新 |
add_account | 新增账号；给了 baseURL 时默认启用，否则停用 |
remove_account | 删除 account 指定的账号及其路由 |
参数（除 action 外都可选）：
| 参数 | 说明 |
|---|---|
account | 账号 id（如 default、account-2），也可用路由 ID 或账号名称 |
enabled | 启用 / 停用该账号 |
baseURL | CPA 地址，如 http://127.0.0.1:8317；空字符串表示自动发现 |
apiKey | Bearer 密钥，保存到该账号的 apiKeyEnv 引用名下 |
apiKeyEnv | 密钥引用名（[A-Za-z_][A-Za-z0-9_]*） |
provider | llm-pi-ai 路由 ID，每个账号唯一 |
displayName | 账号名称，也是模型选择器中的分组名 |
protocolMode | auto（按家族走原生协议，默认）或 fixed |
protocol | fixed 时使用的协议：openai-completions / openai-responses / anthropic-messages |
selectedModels | 显示在选择器中的模型 id 列表；[] 表示全部 |
includePrefix / excludePrefix | 逗号分隔的模型 id 关键词 |
modelOverrides | { [modelId]: { contextWindow?, maxTokens?, image?, reasoningLevels?, protocol? } }，整体替换 |
示例：
{ "action": "configure", "baseURL": "http://127.0.0.1:8317", "apiKey": "sk-...", "selectedModels": ["gpt-6.1-sol", "claude-opus-5-5"] }
{ "action": "add_account", "displayName": "Backup CPA", "baseURL": "https://other-cpa:8317", "apiKey": "sk-...", "selectedModels": ["gpt-6-astra"] }
{ "action": "configure", "account": "account-2", "enabled": false }
{ "action": "remove_account", "account": "account-2" }
输出包含 accounts[]（每个账号的 id、displayName、provider、enabled、state、endpoint、modelCount、totalDiscovered、error）和文字摘要 summary。state 取值：idle、probing、connected、disabled、error。
/cpa-status：显示所有账号的状态。/cpa-refresh：立即刷新所有账号（也会探测停用账号的模型列表）。供设置面板使用，需要 DSH Web 会话的认证；POST 只接受来自本机或受信任主机的同源请求。
| 方法 | 路径 | 请求体 | 说明 |
|---|---|---|---|
| GET | /api/dsh-cliproxyapi/status | — | { ok, global, accounts[] } |
| POST | /api/dsh-cliproxyapi/refresh | { accountId? } | 刷新一个或全部账号 |
| POST | /api/dsh-cliproxyapi/save | { accountId?, …账号字段, apiKey?, clearApiKey?, refreshIntervalSeconds?, probeTimeoutMs? } | 保存账号（缺省为第一个）；只有全局字段时只保存全局设置 |
| POST | /api/dsh-cliproxyapi/accounts/add | 账号字段（可选） | 新增账号，默认停用；返回 createdId |
| POST | /api/dsh-cliproxyapi/accounts/remove | { accountId } | 删除账号及其路由 |
状态文件：<Profile 目录>/.dsh-cliproxyapi/state.json，保存账号、勾选和参数覆盖（不含密钥）。
{
"version": 2,
"refreshIntervalSeconds": 300,
"probeTimeoutMs": 5000,
"accounts": [
{
"id": "default", "enabled": true, "provider": "cli-proxy", "displayName": "CLI Proxy API",
"baseURL": "https://cpa.example.com", "apiKeyEnv": "CLI_PROXY_API_KEY",
"protocol": "openai-completions", "protocolMode": "auto",
"includePrefix": "", "excludePrefix": "", "selectedModels": ["gpt-6.1-sol"], "modelOverrides": {}
}
]
}
文件每次读取都会重新加载，手动修改后点「立即探测刷新」即可生效。旧版（1.3.x 及以前）的单账号文件会自动迁移为 id 为 default 的账号，路由、密钥和勾选保持不变，原文件备份为 state.v1.json。
密钥：通过 DSH 的 credentials 服务按引用名存取；凭证服务里没有时，回退读取同名环境变量。
环境变量：CLIPROXYAPI_BASE_URL 只用于服务地址留空的账号的自动发现。
插件行配置：cordis.patch.yml 中本插件行的 config 会在启动时叠加到状态文件上：包含 accounts 时替换账号列表，否则其中的字段作用于第一个账号。一般保持 {}，用面板或工具配置即可。
dsh plugin --profile <profile 名称> add dsh-cliproxyapi-pro@latest。账号、勾选和参数保存在 profile 目录里，密钥保存在凭证服务里，重装不会丢失。模型选择器里看不到模型？
确认账号已打开「启用此账号」，并且至少勾选了一个模型（或勾选为空，表示全部）。可以运行 /cpa-status 查看每个账号的状态。
提示「none of the selected models matched」？ 已勾选的模型在这台服务器上都不存在（常见于换了服务器）。面板里仍会列出该服务器的模型，重新勾选，或点「恢复推荐精选」后保存。
连接失败 / no usable CPA service found？ 检查服务地址是否能从运行 DSH 的机器访问、API Key 是否正确。填写了地址的账号不会改连其他地址，报错里会列出尝试过的地址和原因。
刚发布的新版本装不上？
DSH 使用的 pnpm 可能设置了新版本发布后的等待期（minimumReleaseAge），安装界面会说明实际装到的版本。稍后再装，或明确写出版本号。
给 DeepSeek Harness 中的 AI Agent：用户要求安装或配置本插件时按以下步骤执行。本包没有 npm 依赖，也没有构建脚本。
plugin_manager：{"action": "install_bundle", "target": "dsh-cliproxyapi-pro", "enabled": true}。查看结果中的 application 与 warnings；restart-required 表示需要重启 DSH 后新代码才会运行。cliproxyapi 工具。
http://127.0.0.1:8317 且无鉴权：无需配置，调用 {"action": "refresh"}。{"action": "configure", "baseURL": "...", "apiKey": "..."}（作用于第一个账号）；额外的账号用 {"action": "add_account", ...}；指定账号时传 "account": "<id>"。selectedModels（取自 status 输出中的精确 id）精简模型选择器。{"action": "status"} 中每个启用的账号 state 为 connected 且 modelCount > 0。告诉用户模型已出现在 DSH 模型选择器中（按账号名称分组），可在 左侧栏 → 插件 → CLIProxyAPI 或 设置 → 内置插件 → CLIProxyAPI 管理账号。不要把 API Key 回显给用户，也不要写入任何文件。
lib/index.js Host 插件（发现、同步、多账号控制器、工具、命令、HTTP 接口）
lib/client.js Web 设置面板（ModuleLoader 格式，手写，无需构建）
locale/*.json 插件管理器中显示的标题与描述
cordis.patch.yml Bundle patch，插入 dsh-cliproxyapi-pro 行
tests/ node:test 单元与集成测试
.github/workflows/ CI（测试）与发版（GitHub Release + npm 受信任发布）
assets/screenshots/ README 截图（同时登记在 screenshots.json 中供插件市场展示）
AGENTS.md 给编码 Agent 的开发约定、架构与不变量
git clone https://github.com/TinyBOOOOM/dsh-cliproxyapi-pro.git
cd dsh-cliproxyapi-pro
npm test # 运行测试
npm run check # 语法检查 + 测试
npm run pack:check # 查看打包文件列表
发版只需推送 v<版本号> 标签：GitHub Actions 会运行测试、创建 GitHub Release 并附上安装包，再通过 npm 受信任发布（不使用任何 token）上传到 npm，并附带来源证明。
修改代码前请阅读 AGENTS.md；变更记录见 CHANGELOG.md。欢迎提交 Issue 和 Pull Request，修改说明文档时请同时更新中英文两份。