dsh-model-sync-plugin

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

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

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

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

版本与兼容状态

版本 · 定位 · 说明 v0.9.6 · 当前稳定版 · DSH Desktop 2.0.18 / kernel 0.2.1-rc.2 已验证 v0.9.2 · Next GUI 预发布版（历史） · 保留的 pre-release；不承诺 Nextgen / Next GUI 兼容

已实测：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 · 上游端点 deepseek-official · api.deepseek.com/models opencode-go · opencode.ai/zen/go/v1/models opencode · opencode.ai/zen/v1/models（回退 opencode.ai/inference/v1/models） kimi-coding · api.kimi.com/coding/v1/models openrouter · openrouter.ai/api/v1/models

未配置的 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 Go 的 x-opencode-session

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_HOME/model-sync/state.json · 上次检查/应用、纳管开关、sibling 账本、插件添加模型账本、面板打开时间与各服务商最近更新时间 $DSH_HOME/model-sync/models.dev.json · models.dev 元数据缓存（24h TTL，用于协议分类与厂商识别） $DSH_HOME/model-sync/backups/ · settings.yaml 写前备份（最近 20 份；文件不存在时跳过）

插件不保存凭证。

已知问题与排查

API Key 在设置页只读

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

免费模型被上游拒绝

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

版本历史

版本 · 日期 · 说明 v0.9.6 · 2026-10-25 · 单列表服务商卡片、更新徽标、列表底部保存、默认不预选 v0.9.5 · 2026-10-25 · 全量模型视图、双向编辑、移除修复、Nextgen/Next GUI 未适配声明 v0.9.4 · 2026-10-25 · 渐进式模型更新面板与服务商卡片 v0.9.3 · 2026-10-24 · composer / /model 按服务商合并协议分流 v0.9.2 · 2026-10-22 · DSH 0.2.1 / NEXT 兼容预发布；Next GUI 预发布版 v0.9.1 · 2026-10-19 · 修复最后一个协议分流模型删除时的空 models 写入 v0.9.0 · 2026-10-19 · 托管模型并入官方模型目录、批量移除能力 v0.8.0 · 2026-10-19 · 官方模型行样式与托管模型目录渲染 v0.7.0 · 2026-10-19 · 托管模型面板与官方样式复用 v0.6.0 · 2026-10-19 · 隐藏协议分流卡、主卡托管模型面板 v0.5.2 · 2026-10-19 · OpenCode Console sibling-only 安全模式 v0.5.1 · 2026-10-09 · 适配 DSH 2.0.17 条目式 settings v0.5.0 · 2026-10-09 · 凭证遮蔽检测与未收录模型路由修正 v0.4.0 · 2026-10-06 · OpenCode 会话头按会话附带 v0.3.0 · 2026-09-12 · /model-sync 只读命令与 dshWorkshop 清单

开发

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 未适配，使用风险由使用者自行承担。