DeepSeek Harness 插件:dsh-llm-commandcode

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

典型用法

  1. 启用 UI:安装 dsh-llm-providers-ui 插件以启用 UI 页面。
  2. 信任主机:使用 dsh web --trusted-host 指令信任浏览器主机,完成浏览器认证流程。
  3. 配置设置:打开设置,进入 LLM Providers 菜单,找到 Command Code 卡片。
  4. 获取模型:点击卡片上的 Fetch models 按钮获取模型列表并选择模型。
  5. 调整功能:
    • 若不需要查看配额,可在配置中设置 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 查看。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜