aerince/dsh-models-dev-reasoning

从 models.dev 为 DeepSeek Harness 补齐第三方模型的模型发现、思考档位和上下文元数据。

本插件是 OpenChamber / OpenCode 两个插件的 DSH 移植版：

• openai-model-discovery.ts — 调 ${baseURL}/models 发现模型
• openai-compatible-hermes-variants.ts — 从 models.dev 匹配模型并生成推理档位

功能

1. 模型发现：对每个在 llm-pi-ai 中手工声明、带 baseURL 的 OpenAI 兼容路由请求 /models，过滤 embedding / 语音 / 图像 / 已下线模型后合并进该路由的 models 列表。
2. 推理档位：按模型 ID 匹配 models.dev 目录，把 reasoning_options 映射成 DSH 的 reasoningEfforts（off: null、low: "low"……），模型选择器即可显示思考档位。
3. 上下文元数据：补齐 contextWindow、maxTokens，以及目录声明的图片输入能力。
4. 自动更新：目录缓存 24 小时；每次启动、设置变更、配置重载时重新对齐；运行时每 6 小时做一次检查。
5. 不覆盖已有配置：模型行已声明的字段一律保留，只填空缺字段。

工作方式

1. 插件注入 settings，DSH 启动后等待 llm-pi-ai 命名空间可用，再延迟约 1.5 秒开始第一轮。
2. 读 https://models.dev/api.json；失败时退回磁盘上的旧缓存，两者都没有则跳过推理档位。
3. 逐路由请求 /models；apiKeyEnv 通过 ctx.credentials 解析，解析不到就跳过该路由的发现（不影响档位补齐）。
4. 用 ctx.settings.mutate("llm-pi-ai", ops, revision) 写入；遇到 SETTINGS_CONFLICT 自动重试。
5. 缓存文件：$DSH_HOME/cache/models-dev-reasoning.json（DSH_HOME 未设置时用 ~/.dsh）。

触发时机：启动、settings/document-updated（llm-pi-ai）、loader/volatile-update、app-boot/config-reload、6 小时定时器。

可选配置

在 cordis.patch.yml 的插件行上加 config，全部可省略：

键	默认	说明
discovery	true	是否请求 /models
reasoning	true	是否从 models.dev 补档位/元数据
ttlHours	24	目录缓存有效期
refreshIntervalHours	6	运行期检查间隔
catalogUrl	https://models.dev/api.json	目录地址，可换镜像
timeoutMs	20000	单个 /models 请求超时
catalogTimeoutMs	30000	目录请求超时
cacheFile	空	自定义缓存路径
providers	[]	只处理这些 provider id；空表示全部
transport	auto	/models 的传输层：auto（先 HTTP/2，失败回退 fetch）、http2、fetch
minIntervalMs	60000	两次完整 reconcile 的最小间隔，避免事件风暴重复请求
debounceMs	2000	设置事件防抖
bootDelayMs	1500	启动后首轮延迟

部分 OpenAI 兼容网关会重置 Node fetch 的 HTTP/1.1 连接（curl 或 ALPN h2 正常），因此 auto 默认先走 Node 的 HTTP/2，再回退 fetch。

安装

命令行安装（需要可用的 dsh 与 pnpm）：

dsh plugin --profile web add github:aerince/dsh-models-dev-reasoning

# 可复现安装：固定 release
dsh plugin --profile web add github:aerince/dsh-models-dev-reasoning#v0.2.0

# 不可变 commit pin
dsh plugin --profile web add github:aerince/dsh-models-dev-reasoning#8a1a18a6b2ed76bea464f45871dbf5fb0d4a635a

本包是零构建 JavaScript，没有 prepare，不需要 pnpm allowBuilds。兼容 DSH >=0.2.1-rc.2 <0.3.0；不满足该范围的版本会被当前 DSH 兼容性检查拒绝。

本地开发安装（无 dsh CLI）

把插件行写进用户级 patch 层 $DSH_HOME/cordis.patch.yml（不存在就新建；该层在 profile 补丁之后加载）：

- insert:
    - id: models-dev-reasoning
      name: '/path/to/dsh-models-dev-reasoning/index.js'

name 用绝对路径指向本目录的 index.js，然后重启 DSH。

验证

1. 启动后日志出现 models-dev-reasoning: refreshed models.dev catalog (...) 或 evaluated ...，写入时出现 updated N provider model list(s)。
2. 设置 → 模型页：手写路由下出现 /models 返回的新模型；models.dev 标记为 reasoner 的模型出现思考档位。
3. 缓存文件已生成：$DSH_HOME/cache/models-dev-reasoning.json。
4. 已有 reasoningEfforts 或 contextWindow 的模型保持不变。

离线自测（不依赖 DSH）：

node test.mjs

边界

• 声明了 modelOverrides 的路由会被跳过（models 与 modelOverrides 不能同时存在）。
• 只有 toggle 型推理（如部分 Qwen 的 enable_thinking）的模型不会映射成档位，因为 DSH reasoningEfforts 只接受档位。
• /models 列表很大的路由会把返回的文本模型全部加进配置，可用 providers 限制范围。
• 发现需要能解析出 apiKeyEnv；凭据缺失时只跳过发现，档位仍会补齐。

卸载

dsh plugin --profile web remove dsh-models-dev-reasoning

本地开发安装则删除 $DSH_HOME/cordis.patch.yml 中的对应行并重启。

License

MIT