前言¶

在 DeepSeek Harness（DSH）里对话或跑 Agent，模型通常来自 DSH 自带路由或你手动写的 provider 配置。若上游实际跑的是 CLIProxyAPI（CPA）——把多家 CLI / API 渠道统一成 OpenAI 兼容入口——你会遇到另一类问题：CPA 上的模型目录很长，能力和协议各不相同，手工把每个模型写进 DSH 既费时，又容易在 Chat / Responses / Messages 之间选错协议。多账号、多密钥时更明显。

下面介绍社区插件 dsh-cliproxyapi-pro（维护者 TinyBOOOOM）：填服务地址和 API Key 后，从 CPA 拉取模型目录，把勾选的模型连同上下文长度、图片输入、推理档位等同步到 DSH 模型选择器，并按模型家族走最合适的请求协议。插件分类为「模型推理」，适用于 DSH 0.2.0-rc.1 及以上（桌面版与 Web 版）。当前 npm 包版本为 1.7.0，许可证 MIT。

这是什么¶

dsh-cliproxyapi-pro 是 DSH 的 CPA 接入与可视化管理插件：不注册 Agent 工具，不占用模型上下文；API Key 保存在 DSH 凭证服务里，不写入配置文件。可同时接入多个 CPA 账号，每个账号独立地址、密钥、模型勾选与启用状态。

与「只在 DSH 里手写一条 OpenAI 兼容 base URL」相比，它侧重三件事：自动读 CPA 的富元数据模型目录、按家族选择原生协议路由、在设置面板里勾选模型并查看渠道额度（需 CPA 管理密钥）。

核心功能¶

自动发现与模型同步¶

• 服务地址可为本地或远程；/v1、/v1/chat/completions 等后缀会自动规范化。
• 地址留空时依次尝试：已有路由地址、环境变量 CLIPROXYAPI_BASE_URL、本机 127.0.0.1:8317。
• 通过 /v1/models?client_version=pi 读取目录（兼容标准 OpenAI data[]），用 owned_by 判断模型家族；账号按默认 300 秒间隔自动刷新，目录无变化时不写设置。

开箱即用的模型勾选¶

首次连接成功且从未保存过勾选时，会按 CPA 目录为每个模型家族自动勾选最新一个（最多 12 个），避免选择器被上百个模型淹没。支持搜索、家族筛选、批量操作、「恢复推荐精选」，以及包含 / 排除关键词规则。只有勾选的模型出现在模型选择器中；勾选为空时表示全部显示。

单模型可 编辑参数：上下文窗口、最大输出、图片输入、思考等级（off、minimal、low、medium、high、xhigh、max）和请求协议，也可恢复自动探测值。

多账号与协议路由¶

每个账号在模型选择器里以账号名称分组；停用账号会移除路由但保留配置。路由 ID 依次为 cli-proxy、cli-proxy-responses、cli-proxy-messages（第二、第三账号带 -2、-3 等后缀）；密钥引用名为 CLI_PROXY_API_KEY、CLI_PROXY_API_KEY_2……

默认 自动协议 减少 CPA 侧转换：

可改为统一使用某一种协议，或在单模型参数里指定。

额度与更新¶

账号页 连接 / 模型 / 额度 三标签并列。在额度页填写 CPA 管理密钥（remote-management.secret-key；远程需 remote-management.allow-remote）后，可查看按渠道分组的额度；模型选择器左侧徽标显示当前模型可用凭证中最充足的剩余额度（仅对已同步且已填管理密钥的账号）。

插件支持检查稳定 / Beta / 开发通道，可选全球或中国大陆下载源；装有 dsh-market 时可一键或自动安装新版本。包声明 零依赖，无需构建。

安装与启用¶

任选一种官方方式即可；固定版本可写 dsh-cliproxyapi-pro@1.7.0。

方式一（推荐）：DSH 左侧 插件 → 添加插件，输入包名：

dsh-cliproxyapi-pro

安装后 立即启用；中国大陆可切换 安装源 为镜像。

方式二：在对话框让 Agent 安装，例如：

帮我安装 DSH 插件 dsh-cliproxyapi-pro

方式三：命令行（将 <profile 名称> 换成你的 profile，桌面版常为 desktop）：

dsh plugin --profile <profile 名称> add dsh-cliproxyapi-pro

DSH 若在运行，安装后需重启生效。

方式四：从 GitHub 安装，例如在添加插件处填写：

git+https://github.com/TinyBOOOOM/dsh-cliproxyapi-pro.git#v1.7.0

或下载 Releases 中的 dsh-cliproxyapi-pro.tgz 后填写本地绝对路径。

典型用法¶

1. 打开 设置 → 左侧 CLIProxyAPI（账号、模型、协议在此；插件自身更新在 插件 → CLIProxyAPI 或 设置 → 内置插件 → CLIProxyAPI）。
2. 点 + 添加账号，填写名称、服务地址（如 http://127.0.0.1:8317，无需 /v1）和 API Key（本地免密 CPA 可留空），点 连接。成功则创建并启用；失败可看原因或选「仍然添加（不启用）」。
3. 在 模型 标签按需增减勾选，底部 保存并应用。
4. 回到对话框，在以账号名命名的分组里选模型即可。

本机 CPA 默认端口 8317 且无密钥时，插件可自动发现，无需先填地址。也可在安装后让 Agent 配置，例如说明 CPA 地址与密钥。

适用场景与注意¶

适合：已在用或计划用 CPA 聚合多渠道，希望在 DSH 里用图形界面选模型、管多账号、看额度，并尽量让 Claude / GPT 走原生 Messages 或 Responses 协议的用户。

注意：

• 插件以当前 DSH 进程权限运行；安装前请自行查看 GitHub 仓库 源码与 MIT 许可证，确认符合你的安全与合规要求。
• 填写了服务地址的账号只连该地址，连不上会报错，不会静默回退到本机 :8317，避免多账号误指同一服务。
• 额度与管理接口依赖 CPA 侧 remote-management 配置；未配置时仍可使用模型同步与对话，只是额度页能力受限。
• 社区目录 SkillHub 插件页 与 DeepSeek / 幻方无官方从属关系；DSH 生态强调「一切皆插件」，以仓库 README 与 npm 包为准。

结尾¶

dsh-cliproxyapi-pro 把 CPA 的模型目录和协议选择收口到 DSH 设置与模型选择器里，减少手写路由和维护成本。需要细节、斜杠命令、HTTP 接口与常见问题时，以仓库文档为准。

• 社区目录：https://www.skillhub.cn/plugins/TinyBOOOOM/dsh-cliproxyapi-pro
• GitHub：https://github.com/TinyBOOOOM/dsh-cliproxyapi-pro
• npm：https://www.npmjs.com/package/dsh-cliproxyapi-pro