前言¶
DeepSeek Harness (DSH) 采用插件化架构。在使用第三方模型时，开发者往往需要手动管理 API Key，或在模型选择与协议适配（如 Anthropic Prompt Cache）上花费精力。zenmux/dsh-plugins 插件解决了这一痛点，它允许通过浏览器 OAuth 登录，直接使用 ZenMux 的模型库，并自动根据模型特性选择最优协议。
插件定位¶
这是一个由 ZenMux 维护的 DSH 插件。它的核心功能是在 DSH 中接入 ZenMux 模型，支持通过浏览器 OAuth 登录，无需手动复制 API Key。插件内置了 150 个可搜索的文本模型，并根据模型特性自动路由至 Anthropic Messages（支持 Prompt Cache）或 OpenAI Chat Completions 协议。
核心功能¶
- 浏览器 OAuth 登录：支持通过浏览器完成授权，Token 具备自动刷新能力。
- 模型搜索：内置 150 个文本模型，支持在 Web 界面直接按名称或 ID 搜索。
- 协议感知路由：
- 126 个模型通过 Anthropic Messages 路由，支持 Prompt Cache 控制。
- 24 个模型通过 OpenAI Chat Completions 路由。
- 会话关联：每次 ZenMux 推理请求都会在请求头中携带当前 DSH 会话 ID (
x-zenmux-session-id)。 - 命令行交互：提供
/zenmux login、/zenmux status、/zenmux logout和/zenmux models refresh等命令。
安装与启用¶
安装该插件需要通过 DSH 命令行更新。确保当前环境已安装 DeepSeek Harness。
dsh plugin --profile web update @zenmux/dsh-plugins --latest
dsh web
执行上述命令后，启动 DSH Web 界面，插件即处于可用状态。
典型用法¶
- 登录：在 DSH 聊天窗口中输入
/zenmux login，按提示在浏览器中完成授权。 - 状态检查：使用
/zenmux status确认连接状态。 - 登出：如需断开连接，输入
/zenmux logout。 - 模型选择：在 Web 界面打开模型选择器，直接输入模型名称或 ID 进行搜索。根据分类，模型分为“ZenMux · Anthropic”和“ZenMux · OpenAI”。
更新与维护¶
更新插件需要停止当前 DSH 进程，执行更新命令，然后重启：
dsh plugin --profile web add @zenmux/dsh-plugins@latest
dsh web
若需刷新模型列表（从 ZenMux 拉取最新数据），可在会话中运行 /zenmux models refresh。此命令会更新配置文件，建议随后重启 DSH。
注意事项¶
- 手动列表覆盖：如果插件显示的模型数量少于预期，可能是因为旧的本地手动列表覆盖了内置目录。需编辑
~/.dsh/settings.yaml，删除llm-pi-ai.providers.zenmux和llm-pi-ai.providers.zenmux-models下的models:数组，并重启 DSH。 - 认证错误：如果遇到
API key is invalid或AUTH错误，请重新执行/zenmux login。 - 网络与 TLS：OAuth 请求默认直连，可配置显式的 HTTP(S) 或 SOCKS 代理。若使用自定义 TLS 拦截，需在启动 DSH 前设置环境变量
NODE_EXTRA_CA_CERTS。 - 许可证：该插件遵循 MIT 许可证。
结语¶
该插件为 DSH 用户提供了无需手动维护 Key 的模型接入方案，并优化了 Prompt Cache 的使用。DeepSeek Harness 的生态由社区驱动，插件目录（如 SkillHub）与 DeepSeek 或幻方没有官方从属关系。更多细节与源码，请访问其 GitHub 仓库。
