DeepSeek Harness(DSH)通过插件化架构支持多种模型接入。当需要通过 DSH 访问 Command Code 的 Provider API 时,需要一个独立的 Provider 路由和配置入口。dsh-llm-commandcode 插件提供了这一能力,通过 DSH 的 PiAiAdapter 将 Command Code API 接入 DSH 的聊天协议体系。
插件定位¶
这是一个 Command Code Provider API 的 LLM 插件。由 NOirBRight 维护。它作为一个独立的 Provider 路由 (commandcode) 和设置命名空间 (llm-commandcode) 存在。Chat 使用 Command Code 的文档化 Provider API,通过 DSH 的 PiAiAdapter 进行协议转换。账户配额追踪是 Host 端的额外功能,为尽力而为且不会阻塞聊天。
核心功能¶
- 协议支持:支持 Claude-* 模型(Anthropic Messages)和 OpenAI 聊天补全协议。模型 ID 决定了具体使用的协议端点。
- 功能集成:支持序列化、Server-Sent Events (SSE)、工具调用、附件和推理功能。
- 账户管理:账户配额追踪(Host-only, best-effort)。配额功能为尽力而为,失败不会阻塞聊天。
- 数据安全:API 密钥仅在 Host 凭证服务中安全存储,Host 永不返回明文。
- 模型发现:从 Provider API 获取模型列表。
- 配置选项:Context Window Override 功能。
安装与启用¶
安装前请确认本地 DeepSeek Harness 版本为 0.1.7-alpha.2 或 0.1.7-rc.1。安装命令如下:
dsh plugin --profile web add --force https://github.com/NOirBRight/dsh-llm-providers-ui/releases/download/v0.2.13/dsh-llm-providers-ui-0.2.13.tgz
dsh plugin --profile web add --force https://github.com/NOirBRight/dsh-llm-commandcode/releases/download/v0.1.35/dsh-llm-commandcode-0.1.35.tgz
dsh web
典型用法¶
- 启用 UI:安装
dsh-llm-providers-ui插件以启用 UI 页面。 - 信任主机:使用
dsh web --trusted-host指令信任浏览器主机,完成浏览器认证流程。 - 配置设置:打开设置,进入 LLM Providers 菜单,找到 Command Code 卡片。
- 获取模型:点击卡片上的
Fetch models按钮获取模型列表并选择模型。 - 调整功能:
- 若不需要查看配额,可在配置中设置
usageEnabled: false隐藏配额面板。 - 若需保护隐私,在设置中开启零数据留存(ZDR)。
- 若不需要查看配额,可在配置中设置
适用场景与注意¶
该插件适合需要在 DSH 环境中使用 Command Code Provider API 的开发者。使用时请注意以下事项:
- 配额机制:配额功能为 Host-only 且为尽力而为,失败不会阻塞聊天。
- 零数据留存(ZDR):该功能为可选。不可用时,上游可能返回 HTTP 422 错误。
- 密钥存储:API 密钥仅存储在 Host 凭证服务中,Host 永不返回明文。
- Headless 模式:在没有 UI 拥有者(Headless)的情况下,Host 路由
commandcode仍然可用。 - API 限制:仅支持官方固定的 Provider API URL。
总结¶
该插件为 DSH 提供了接入 Command Code Provider API 的标准方式,支持主流的聊天协议与功能特性。相关源码与目录信息可访问 GitHub 或 SkillHub 查看。