DSH 模型插件 · dsh-model-sync-plugin

为 DeepSeek Harness (DSH) 监控各服务商上游 /models，列出当前可用模型；勾选添加、取消勾选移除，保存后一次性生效。

不自动删除、不自动改写、不覆盖你在原生「模型」模块的编辑。

本仓库是独立第三方插件，不是 DeepSeek 官方项目。

已实测：DSH Desktop 2.0.18，kernel 0.2.1-rc.2。

Nextgen / Next GUI 未适配：相关分支的改动尚未在本插件中完成适配，本版本不承诺兼容 Nextgen 或 Next GUI，也不把它们的界面行为纳入验证范围。请仅在稳定 DSH Desktop 环境中使用；如果使用 Nextgen/Next GUI，请先隔离 profile 并自行承担兼容风险。

package.json#engines.dsh 声明 >=0.1.2-rc.1 <0.3.0-0；DSH 0.2.1+ 在安装和启动时执行兼容检查。旧版本 tag 已清理，不作为回退安装入口。

• 默认不勾选：每次检查后不自动添加任何模型；用户显式勾选后才生效。
• 全量模型视图：展开服务商后展示当前上游可用的全部模型，并区分「已添加」「未添加」。
• 双向编辑：勾选未添加模型、取消勾选已添加模型；点「保存变更」后一次性提交添加和移除。
• 添加/移除反馈：保存后卡片保持展开；显示聚合 Toast；最新状态在后台同步，不阻塞主操作。
• 服务商一行一张卡片：按服务商纵向堆叠；卡片默认收起。
• 厂商分组：模型按厂商分组，使用多列瀑布流填充高度；支持厂商组三态勾选。
• 搜索与筛选：按模型 id/名称搜索，支持 全部 / 未添加 / 已添加。
• 快捷操作：卡片内提供「全选」和「清空」。全选作用于当前筛选结果中的未添加模型；清空同时清除新增选择和待移除标记。
• 维护与诊断：最近一次检查发现的下架模型、无法判定协议的模型、检查失败、协议修正、检查范围和上次添加记录，收在每张卡片的折叠区；主列表不主动展示这些信息。
• 命令：/model-sync check 只读检查；/model-sync status 查看上次结果。
• OpenCode 会话头：为 OpenCode / OpenCode Go 路由按会话附带 x-opencode-session。
• 写前备份：写入 settings 前尝试备份 settings.yaml（文件不存在时跳过）。

前置：DSH Desktop 或 dsh CLI，且 profile 目录可被 pnpm 管理。

# 当前稳定版
dsh plugin --profile desktop add github:chen1pengvincent/dsh-model-sync-plugin#v0.9.6

版本历史仅用于说明，不再提供旧版本回退安装命令。Next GUI 预发布版 v0.9.2 仍保留在 Releases，但 Nextgen / Next GUI 未适配，不建议作为稳定环境安装。

或使用本地路径：

dsh plugin --profile desktop add /path/to/dsh-model-sync-plugin

安装后完全退出 DSH（⌘Q）再冷启动；仅关闭窗口或刷新页面可能继续加载旧客户端。若 dsh 提示找不到 pnpm，请先让 pnpm 进入 PATH。

安装后确认 profile 的 package.json#dsh.profile.bundles 包含 dsh-model-sync。该文件位于 profile 目录（如 ~/.dsh/profiles/desktop/），不是本仓库的 package.json。

打开 设置 → 模型更新：

1. 点「检查更新」获取各 provider 当前模型。
2. 展开服务商卡片，搜索或按厂商分组浏览。
3. 勾选未添加模型、取消勾选已添加模型；可点卡片内「全选 / 清空」快速操作。
4. 滚到列表底部点「保存全部变更」，卡片保持展开并显示 Toast；列表在后台同步。

• 无法添加：上游模型存在，但当前无法判定 wire protocol，不会进入主列表；详情在卡片「维护与诊断」中。
• 已下架：上游当前不再提供，但 settings 中仍有记录；只在「维护与诊断」中显示最近一次检查发现的下架模型，历史下架不记录，也不会自动删除。

未配置的 provider 自动跳过；未知 provider 显示为「未纳管」。

OpenCode Go / OpenCode 可能混合 Chat Completions、Anthropic Messages、Responses。插件会在请求层使用主路由 + 按协议的 sibling 路由：

• 模型更新面板按服务商展示，协议分流不作为独立展示层。
• composer / /model 也按服务商合并，不出现 OpenCode Go · Responses 等分组；选中后透明映射回真实协议路由。

opencode 主行属于官方内置目录；新模型只写入 opencode-chat / opencode-messages / opencode-responses，不改写主行的 models / api / baseURL。

OpenCode / OpenCode Go 要求每个推理请求携带按会话稳定的 x-opencode-session，否则可能返回 400 MissingSessionID。插件在请求时通过 llm/stream + AsyncLocalStorage + fetch 注入；调用方已有该头时不覆盖。默认值是每个 DSH 会话随机生成的 UUID，不泄露内部 session id。

配置覆盖（profile 的 cordis.patch.yml）：

- id: dsh-model-sync
  config:
    sessionHeader:
      mode: uuid          # uuid（默认）| session-id
      providers: [opencode-go, opencode]
      enabled: true

sessionHeader: false 等价于 enabled: false。

路径以进程 DSH_HOME 为根（默认 ~/.dsh）：

插件不保存凭证。

• DSH 0.2.1+：桌面端已保存凭据优先，环境变量只是兜底；headless 默认只读环境变量和 .env。若输入框仍只读，查看 credentials.describe 报告的来源是否本身 writable: false。
• DSH ≤0.2.0（历史行为）：同名环境变量会遮蔽凭证文件且只读。移除环境变量后完全退出 DSH 再冷启动。

OpenCode 的免费模型可能仅限官方客户端；插件仍会列出，但调用可能被上游拒绝；与插件凭证/会话头无关。

node --test                 # 单元测试
node scripts/dry-run.mjs    # 真实上游 dry-run（读本机凭证，只读）

依赖 DSH 公开 seam：ctx.settings、ctx.credentials、ctx.webServer、llm/stream、slots。会话头半使用 llm/stream 与 globalThis.fetch，不依赖内核内部符号。

从 profile package.json 的 dependencies 和 dsh.profile.bundles 中移除 dsh-model-sync，删除 node_modules 链接后重启 DSH。已写入的模型不受影响，可在原生「模型」模块中自行增删。

MIT License，Copyright (c) 2026 chen1pengvincent。

本插件按“现状”提供，不附带任何明示或暗示担保；详见仓库根目录 LICENSE。本插件为非官方第三方项目，不代表 DeepSeek；Nextgen / Next GUI 未适配，使用风险由使用者自行承担。