前言¶
在 DeepSeek Harness（dsh）里接模型，常见情况是手里不止一种来源：ChatGPT Plus 带的 Codex、Kimi 编程套餐、WorkBuddy 积分、Gemini / Groq 的免费 key，还有本机 Ollama。每家接口和登录方式不同，每个客户端都要单独配；某一来源限流或额度用尽，还要手动换下一个。
下面介绍的 dsh-model（维护者 AIcivilization，GitHub：AIcivilization/dsh-model）把这些来源合成 一个 OpenAI 兼容地址、一种 key。dsh、Cline、Continue、Cherry Studio 以及任意支持 OpenAI 接口的工具，填同一组地址和 key 即可。插件分类为「模型推理」，npm 包名 dsh-model，当前资料中的版本为 0.22.1，许可证 MIT；要求 Node ≥ 20、DeepSeek Harness ≥ 0.2.0-rc.2，支持 Windows / macOS / Linux。
这是什么¶
dsh-model 在本机（或配合 dsh-vps 的 VPS）运行统一网关：对外暴露 OpenAI 格式的 /v1，对内把请求路由到各「来源」（订阅 OAuth、API key、本机模型、WorkBuddy bridge 等）。引擎基于 CLIProxyAPI（资料中锁定 8.0.13），WorkBuddy 协议层参考 dsh-workbuddy-connect。
没有安装 dsh 也能用：命令行 dsh-model 可管理全部功能；装上 dsh 后，会在 设置 → dsh-model 提供图形管理页，并把模型同步进 dsh 的 provider 配置。
核心功能¶
统一接入¶
- 本机默认入口：
http://127.0.0.1:8317/v1，强制 API key 鉴权（每台设备可单独发 key，可轮换、吊销）。 - 在 dsh 里按来源分组展示模型；其他软件使用同一地址和 key。
- VPS 上
setup后，可额外对外提供https://<dsh 的域名>:9443/v1（无域名时资料说明可用<IP>.sslip.io）。
来源与费用标注¶
资料中的来源包括（插件只转接，不提供额度）：
| 类型 | 示例 |
|---|---|
| 免费 | WorkBuddy、本机 Ollama / LM Studio |
| 免费·额度少 | Gemini（Google AI Studio）、Groq、OpenRouter（:free 模型）、硅基流动部分小模型 |
| 需付费 | DeepSeek 官方、Codex（ChatGPT Plus / Pro）、Kimi Code、Grok、Muse、Devin、OpenCode Zen 等 |
| 默认隐藏 | Claude、Antigravity（资料标注为高风险） |
管理页对每个来源有开关；未登录会引导登录，无可用套餐的来源会实测后隐藏模型并给出开通说明。
failover 与组合¶
- 组合切换：按顺序配置多个模型，限流、额度用尽或出错时自动试下一个；对外模型名为
combo/<id>。 - 自动切换：同一逻辑模型在多个来源存在时，可在 dsh 中使用「自动切换（多来源）」组。
签到与可观测性¶
- 每日签到：WorkBuddy 国内版、Qoder、Trae 可自动签到（也可
dsh-model checkin手动执行）。 - 最近失败：近 24 小时失败请求（模型、原因、建议；不记录对话内容）。
- 统计：按 key、来源、模型的成功率、延迟、速度；套餐用量与重置倒计时、积分到期等可在管理页查看。
安装与卸载¶
- 一条命令全局安装；
uninstall时若 dsh 中仅写入 provider 与refs.DSH_MODEL_API_KEY且未手改，会逐字节还原 dsh 配置。
安装与启用¶
官方快速开始（来自 README，可重复执行 setup 做安装或修复）：
npm install -g dsh-model
dsh-model setup
在已安装 dsh-vps 的服务器上使用：
sudo dsh-model setup
Windows 在普通 PowerShell 或命令提示符下执行即可，资料说明不需要管理员权限。
setup 会依次：下载并校验引擎并在 127.0.0.1:8317/v1 启动且强制 key 鉴权；接入 WorkBuddy（安装时不询问 key，需 key 的来源在管理页开启）；把管理页装入 dsh 并同步模型；在 VPS 上额外开通对外 HTTPS 地址。
也可先从 dsh 插件市场安装 dsh-model，在 设置 → dsh-model 使用「一键安装」，未装服务时页面会说明缺项并显示安装过程。
更新 npm 包后需 重启一次 dsh，管理页新代码才会生效；模型与开关变更无需重启。
典型用法¶
在 dsh 中管理¶
路径：设置 → dsh-model。主要区块包括：访问地址（本机 / 外网复制）、来源开关与用量、选模型（默认每家推荐 5 个，其余仍可通过统一地址调用）、组合切换、自动切换、每日签到、最近失败、API key、模型统计、关于（更新 / 卸载）。
登录由 dsh-model 在本机完成，服务器上不需要安装各家的 CLI，也不需要浏览器（部分来源需在本机浏览器打开固定地址后「从剪贴板粘贴」回调 URL）。
命令行¶
常用命令（均支持 --lang zh|en 与 --json）：
dsh-model sources # 来源列表与登录状态
dsh-model source enable <来源> # 打开来源（需要时登录）
dsh-model key add <名称> # 为本机添加访问 key
dsh-model combo add <名称> <模型…> # 创建组合 failover
dsh-model status # 总览
dsh-model doctor [--e2e] # 自检
dsh-model failures # 最近失败与建议
dsh-model update # 更新程序、dsh 插件与服务
dsh-model uninstall # 卸载
其他客户端配置方式与 OpenAI API 相同：Base URL 填本机或 VPS 的 /v1 地址，API Key 填 dsh-model 发放的 key，模型名使用 dsh 或 dsh-model models 列出的名称（组合使用 combo/<id>）。
架构示意（资料原文）：
dsh · 编辑器 · 脚本 ──Bearer key──▶ 引擎 127.0.0.1:8317/v1（唯一入口）
│ ▲ VPS：Caddy https://<dsh 域名>:9443
┌────────────────────────┼────────────────────────┐
▼ ▼ ▼
订阅 OAuth（Codex、Kimi…） opencode/*（你的 key） workbuddy/* → dsh-model 的 bridge
适用场景与注意¶
适合谁：个人开发者希望把已有订阅、免费额度和本机模型收拢到一条 OpenAI 兼容链路，并在 dsh 与其他工具之间共用同一套配置；需要在限流或额度用尽时自动切换来源的场景。
权限与安全：插件与 dsh-model 服务以当前用户（或 VPS 上 setup 时的权限）运行；默认始终要求 key。安装前建议阅读 仓库源码 与 MIT 许可证，自行评估是否满足合规要求。
条款与风险（README 明确说明）：
- 面向个人使用，不宜作为对外公共服务。
- 在官方客户端之外使用订阅或 WorkBuddy 凭据，可能违反服务商条款，存在账号风险，需自行判断。
- Claude、Antigravity 等来源默认隐藏；Windows 若被杀毒拦截，可将
%USERPROFILE%\.dsh-model加入信任后执行dsh-model repair。
DeepSeek Harness 生态强调「一切皆插件」；社区目录 SkillHub 上的 dsh-model 页 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-model 把多来源模型收敛到 一个 OpenAI 兼容入口，在 dsh 内可视化管理，在命令行与其他 OpenAI 客户端中复用同一地址与 key，并支持组合 failover、自动切换与用量观测。进一步了解可查看 GitHub 仓库 与 SkillHub 目录页。
