dsh-model
把多家模型汇成一个 OpenAI 兼容地址，dsh 和你的其他软件都能直接用。
English · 中文
它是什么
你可能同时有好几个模型来源：WorkBuddy 的免费积分、OpenCode Zen 的 key，还有已经付费的 Codex、Kimi 订阅。它们的接口和登录方式各不相同，每个软件都要分别配置。
dsh-model 把它们合成一个地址、一种 key：
- dsh 里：装好后自动出现在 dsh 的模型列表里，按来源分组，不用手动配置。
- 其他软件：编辑器、脚本，凡是支持 OpenAI 接口的，填上同一个地址和 key 就能用全部模型。
- 省心：一条命令装好；始终要求 key，不会出现谁都能用的情况；卸载时把 dsh 的配置原样还原。
- 服务器上：可以和 dsh-vps 装在同一台 VPS 上，自动用 dsh 的域名开一个对外地址，你的电脑、手机都能访问。
个人自用工具：一个人、每家一个账号，不对外提供服务。
快速开始
npm install -g dsh-model
dsh-model setup
服务器上（装了 dsh-vps 的 VPS）用 sudo dsh-model setup。Windows 上在普通的 PowerShell 或命令提示符里执行即可，不需要管理员。
setup 可以重复执行，它会依次：
- 下载并校验引擎，在本机
127.0.0.1:8317/v1 上运行，强制 key 鉴权；
- 接入 WorkBuddy（dsh-model 自己的 bridge）。安装时不问任何 key，OpenCode Zen 等要 key 的来源，需要时在管理页里打开；
- 把管理页装进 dsh，把模型同步进 dsh；
- 在 VPS 上，额外开通对外地址
https://<dsh 的域名>:9443/v1（没有域名时用 <IP>.sslip.io）。
在 dsh 里管理：设置 → dsh-model
| 区块 | 内容 |
|---|
| 访问地址 | 本机地址和外网地址，各带「复制」按钮 |
| 来源 | 每家一个开关：打开就接入（没登录会弹出登录框），关闭只停用、保留登录。每行标出「免费 / 免费·额度少 / 需付费」，下面显示套餐用量或剩余积分 |
| 选模型 | 每个来源选哪些模型显示在 dsh 里，默认每家推荐 5 个，其余的经统一地址照样可用；每个模型旁边有「测一下」 |
| 自动切换 | 同一个模型在几个来源都有时，dsh 里多一组「自动切换（多来源）」，一个来源限流或出错就自动换另一个 |
| 最近失败 | 最近 24 小时失败的请求：哪个模型、为什么、该怎么办（不记录对话内容） |
| API key | OpenAI 格式，每台设备一把。显示 24 小时内的请求数、成功率、延迟和速度，可复制、轮换、吊销 |
| 模型统计 | 按模型显示成功率、延迟和速度 |
| 关于 | 当前版本和 npm 上的最新版本；「更新」「卸载」一键完成（VPS 上要 root，这里给出命令） |
还没在这台机器上装好服务时，这一页会说明缺什么，并提供「一键安装」按钮，安装过程实时显示。刚装好时有「开始使用」向导；插件更新后还没重启 dsh 时页面顶部会提示（dsh-vps 上可一键重启）；额度快用完时，dsh 任何页面的右下角都会提醒。所以也可以先从 dsh 的插件市场装 dsh-model，再在这一页里点安装。
登录全由 dsh-model 自己完成，服务器上不装各家的 CLI，也不需要浏览器：
- WorkBuddy、Codex、Kimi、Grok、Muse：打开链接授权即可，要验证码的弹窗里会给出；
- Devin、Claude、Antigravity：这几家会把浏览器跳到一个固定的本机地址，页面打不开是正常的。把地址栏里的地址带回来，点「从剪贴板粘贴」即可。
已登录但没有可用套餐的来源（比如 Kimi 账号没有开通 Kimi Code），dsh-model 会实测出来，把它的模型从 dsh 里隐藏，并给出开通链接。
更新 dsh-model 后，要重启一次 dsh，管理页的新代码才会生效。模型和开关的变化不需要重启。
来源与费用
| 来源 | 费用 | 说明 |
|---|
| WorkBuddy / WorkBuddy AI | 免费 | 账号自带积分 |
| Ollama / LM Studio | 免费 | 本机运行的模型。装好并启动后自动出现，不用登录 |
| Gemini（Google AI Studio）、Groq | 免费·额度少 | 填免费 API key 即可，每天 / 每分钟有上限 |
| OpenRouter | 免费·额度少 | 名字带 :free 的模型免费（每天约 50 次） |
| 硅基流动 | 免费·额度少 | 实名认证后部分小模型免费 |
| DeepSeek 官方、其他 OpenAI 兼容服务 | 需付费 | 填 API key（其他服务还要填地址） |
| Codex | 需付费 | ChatGPT Plus / Pro |
| Kimi | 需付费 | Kimi Code 套餐 |
| Grok | 需付费 | SuperGrok / X Premium+ |
| Muse | 需付费 | Muse Code 套餐 |
| Devin | 需付费 | 免费档实测调用会被拒 |
| OpenCode Zen | 需付费 | 充值后按量计费；它的免费模型只能在 OpenCode 软件里用 |
| Claude、Antigravity | 高风险，默认隐藏 | 服务商有封禁第三方使用的先例 |
dsh-model 只负责转接，不提供额度。
常用命令
| 命令 | 作用 |
|---|
setup | 安装 / 修复全部（可重复执行） |
sources | 来源列表：开关、费用、登录状态、用量 |
source enable|disable|logout <来源> | 打开（需要时登录）/ 关闭 / 退出登录 |
key list|add|revoke|rotate <名称> | 访问 key，每台设备一把 |
failures | 最近 24 小时失败的请求和建议 |
stats | 按 key、来源、模型的成功率、延迟和速度 |
status / doctor [--e2e] | 总览 / 逐项自检 |
models [sync] | 列出模型 / 同步到 dsh |
remote enable --via caddy|ssh|tailscale / remote disable | 远程访问（VPS 上 setup 已自动开通 caddy） |
engine version|upgrade|rollback | 引擎版本 |
logs [--bridge] / repair | 日志 / 修复 |
update [--to 版本] | 更新到 npm 上的最新版：程序、dsh 插件和服务一起更新 |
uninstall | 干净卸载 |
所有命令都支持 --lang zh|en 和 --json。
架构
dsh · 编辑器 · 脚本 ──Bearer key──▶ 引擎 127.0.0.1:8317/v1（唯一入口）
│ ▲ VPS：Caddy https://<dsh 域名>:9443
┌────────────────────────┼────────────────────────┐
▼ ▼ ▼
订阅 OAuth（Codex、Kimi…） opencode/*（你的 key） workbuddy/* → dsh-model 的 bridge
详见 设计文档。
注意
- 订阅和 WorkBuddy 的凭据在官方客户端之外使用，可能不符合服务商的条款，账号有风险，请自行判断。
- 支持 Windows 10 / 11（x64、ARM64）、macOS、Linux，需要 Node ≥ 20。
- Windows：后台服务登录后自动运行、不弹窗口。如果被杀毒软件拦下（程序不见了或启动不了），把
%USERPROFILE%\.dsh-model 加入信任，再执行 dsh-model repair。
License
MIT
