前言¶
在使用 DeepSeek Harness (DSH) 管理多个提供商时,提供商的 /v1/models 端点可能会发生变更,导致已存储的模型列表与实际端点不一致。手动刷新列表效率较低。该插件通过查询每个提供商的端点并替换存储的模型列表,解决了这一维护成本问题。
插件简介¶
这是一个为 DeepSeek Harness 提供商提供一键/自动模型同步的插件,由 zhangyqjiaoshou-oss 维护。版本为 1.0.0,遵循 MIT 许可证。插件通过官方的 llm.discoverModels 和 settings.mutate API 与 DSH 交互,不依赖自定义 Host RPC。
核心功能¶
- 手动同步:在设置的“模型同步”面板中,可以一键同步所有配置的提供商。
- 自动同步:每当对话页面打开时,插件会自动触发重新同步(监听
agent/session-start事件,包含 10 秒防抖)。自动同步开关持久化在插件的model-sync设置命名空间及 localStorage 中。 - 替换语义:查询到的列表即为最终列表。端点不再列出的模型会被移除,新增的模型会被正确反映。
- 失败隔离:单个提供商同步失败不会影响其他提供商,失败的提供商会保留其之前的配置。
安装与启用¶
推荐使用 npx 方式安装,无需预先安装任何依赖。
npx github:zhangyqjiaoshou-oss/dsh-model-sync install
此命令会将插件安装到当前的 DSH web profile 中。
典型用法¶
- 打开 设置,进入 模型同步 面板。
- 点击 同步所有模型 立即执行同步,或者开启 对话打开时自动同步 选项,以便在打开对话页面时自动刷新模型列表。
- 每个提供商会报告
✅ N total (+added -removed),同步失败则显示❌及原因。
适用场景与注意¶
该插件适用于需要频繁更新模型列表的场景。使用前请注意:
* 插件依赖官方 API,运行于当前 DSH 进程权限下。
* 安装前应检查源码与许可证(MIT)。
* 需要使用 DSH web profile 进行 npx 安装。
结语¶
通过该插件,可以降低 DSH 提供商模型列表的维护成本,确保列表与端点保持一致。