前言¶

在 DeepSeek Harness（DSH）里使用 OpenRouter 时，模型列表通常写在 profile 的 provider 配置里。OpenRouter 侧「当前免费」的模型会变动，若只靠手工改 patch，列表容易滞后，选模型时也可能和 OpenRouter 实际可用集合不一致。

dsh-openrouter-sync 由社区维护者 bosenok 发布，归类为联网工具，作用是把 DSH 里 openrouter provider 的模型列表与 OpenRouter 当前免费模型保持同步。下面介绍它的定位、安装方式以及使用时的前提条件。

这是什么¶

dsh-openrouter-sync 是 DeepSeek Harness 插件，以 DSH bundle 形式打包：package.json 声明 dsh.bundle.patch，cordis.patch.yml 会在当前启用的 profile 中插入 openrouter-sync 相关配置。

插件简介（与仓库 README 一致）：Keep the DSH openrouter provider model list in sync with OpenRouter’s currently-free models.

当前 package 版本为 0.1.0，要求 DSH 版本 >=0.2.1-rc.2 <0.3.0。许可证为 MIT。

核心功能¶

根据仓库说明，该插件为 仅 host 侧 逻辑：

1. 每 六小时 拉取 OpenRouter 当前免费模型信息，并重写当前 profile patch 里 openrouter provider 的 models 列表。
2. 运行中的 DSH 应用可通过 HMR 重新组合 profile，无需为改列表而手动重启（启用 bundle 时文档仍建议：HMR 会应用到运行中的 app，重启 可确保 client 半部分也被正确重建）。

除上述同步外，插件不引入单独的「业务配置项」；能否完成联网同步，取决于你是否已配置 OpenRouter 与 API Key（见下一节）。

安装与启用¶

安装命令须使用 README 中的写法，按你的使用场景选择一种即可。

桌面应用

在 Plugins 页面安装 github:bosenok/dsh-openrouter-sync。若仓库为私有，需先让本机具备 git 访问权限，安装后 启用 bundle。

CLI（指定 profile）

dsh plugin --profile <profile> add github:bosenok/dsh-openrouter-sync

本地目录

dsh plugin --profile <profile> add file:/path/to/dsh-openrouter-sync

启用 bundle 后插件才会挂载；HMR 会对运行中的应用生效。

关于 desktop profile 的说明

对应用托管的 desktop profile，执行 dsh plugin --profile desktop add 只会安装依赖并复制包，不会像普通 profile 那样自动启用 bundle。需要任选其一：

• 在 ~/.dsh/profiles/desktop/package.json 里把包名加入 dsh.profile.bundles；
• 或在桌面端的 Plugins 页面启用。

其他 profile 在安装后一般会 自动启用 已安装的 bundle。

API Key 与 OpenRouter 配置¶

同步依赖访问 OpenRouter。host 侧解析 OPENROUTER_API_KEY 的顺序为：

1. Harness 凭证服务；
2. 进程环境变量；
3. ~/.dsh/.credentials.yaml。

若没有 Key，在 provider 已按常规方式配置的前提下，仍可能列出该 provider 的模型，但 同步步骤会被跳过。除配置 OpenRouter provider 或在凭证存储 / 环境层提供 OPENROUTER_API_KEY 外，README 未要求额外插件专属配置。

适用场景与注意¶

适合谁

• 已在 DSH profile 中使用 openrouter provider，并希望 models 列表定期对齐 OpenRouter 当前免费 模型，减少手工维护 patch 的工作。

使用前请知悉

• 插件以 当前 dsh 进程的权限 运行，会周期性联网并重写 profile patch；安装前建议阅读 GitHub 仓库 源码与 MIT 许可证。
• 社区插件目录 SkillHub 上的条目 与 DeepSeek / 幻方无官方从属关系，DSH 生态奉行「一切皆插件」，本文信息以仓库 README 与 package 元数据为准。

结尾¶

dsh-openrouter-sync 把「OpenRouter 当前免费模型」与 DSH 里 openrouter provider 的 models 列表绑在一起，用定时同步和 HMR 减轻手工改列表的负担。需要进一步了解分类与简介时，可查看目录页；安装与行为细节以 GitHub 为准。

• 目录页：https://www.skillhub.cn/plugins/bosenok/dsh-openrouter-sync
• GitHub：https://github.com/bosenok/dsh-openrouter-sync