模型配置同步 (Model Config Sync)

一个 DeepSeek Harness (DSH) 可安装插件包(bundle):把 pi-ai 已安装目录(预设)中某个模型的上下文、输出上限与推理档位配置,一键应用到已配置的自定义提供商上;也可以不选预设,作为高级模型配置器手动填写模型条目并写入。

背景

DSH 默认 LLM 提供商链路基于 @deepseek-ai/dsh-llm-pi-ai,底层是 @earendil-works/pi-ai 的安装目录 catalog(内置各提供商的模型、上下文、推理能力数据)。

问题:

• 新模型发布而目录未更新时,原生「自定义提供商」卡片无法给出预设模型的 contextWindow / reasoningEfforts 等数据,只能手查;
• 原生卡片刻意不提供推理档位(reasoning effort)编辑——它认为这是模型级能力,而模型选择器(composer)需要这些数据才能给出正确档位;
• 手写模型条目没有推理能力声明时,模型不会按预期推理。

本插件把「复制预设模型配置 / 手动编写模型条目」做成一个独立设置页,直接写入 llm-pi-ai 的 providers..models,无需等待目录更新。

安装

本插件以 DSH bundle 形式发布:通过 dsh plugin 命令(在 profile 内执行 pnpm 并合并 bundle 层)安装。

# 而 pnpm 对 `add ` 使用符号链接,宿主端 ESM 依赖解析会失效,请走 tarball)
npm pack
dsh plugin --profile web add ./dsh-model-config-sync-0.1.0.tgz

然后重启 Web 服务器并刷新页面:

• Host 插件挂载为 dsh-model-config-sync;Client bundle 由 /plugins/dsh-model-config-sync/client.js 提供;
• 打开 Web 设置 → 左侧导航「模型配置同步」(Models 页之后)。

安装要求:pnpm(在 PATH 中)、DSH 0.1.0-rc.6 或更高版本。卸载:dsh plugin --profile web remove dsh-model-config-sync。

功能

• 独立设置页「模型配置同步」(挂在 settings.section,与官方 Models 页并列,零侵入);
• 预设来源可选:
  • 选择预设提供商 + 模型 → 自动填充下方字段(快速填充);
  • 不选预设 → 纯手动填写(高级配置器),可自由添加/删除推理档位;
• 同步/编辑字段:
  • 模型 ID、显示名称
  • contextWindow(上下文窗口)
  • maxTokens(最大输出)
  • 输入模态 input(text / image)
  • 推理档位 reasoningEfforts(档位 → wire 值的字典,off 留空 = 不发送)
• 目标:任意已配置的 llm-pi-ai 路由(含自定义提供商与内置目录路由);
• 内置目录路由应用后自动转为显式 models 列表,保留全部目录模型,modelOverrides 折叠进对应条目,不丢失;
• 同名模型需勾选「覆盖」;写入经 settings 校验器,立即生效,官方 Models 页自动刷新;
• 只写 settings 文档,不接触、不存储任何 API 密钥。

仓库结构

├── package.json        bundle 清单:dsh.bundle.patch / dsh.client / exports
├── cordis.patch.yml    bundle patch:插入 dsh-model-config-sync 条目
├── dsh.plugin.json     插件元数据(id/main/engines)
├── lib/
│   ├── index.js        Host 半区:modelConfigSync Typert Remote 服务(5 个方法)
│   ├── contract.js     线契约:Invocation descriptors + Host Typert manifest
│   └── client.js       Client 半区(自包含 ModuleLoader bundle):设置页
└── README.md

架构

┌─ Client(浏览器)────────────────────────────────┐
│ settings.section 注册 React 页面(zh/en 双语)   │
│   ├─ ① 预设(可选)  ② 目标提供商  ③ 字段编辑   │
│   └─ remote.modelConfigSync.*  ←→  Typert RPC  │
└─────────────────────────────────────────────────┘
                  │  Connection /api 网关
┌─ Host(主进程)───────────────────────────────────┐
│ ModelConfigSyncRuntime (TypertRemoteService)    │
│   presetProviders   llm.listConfigurableProviders│
│   presetModels      llm.listModels / discoverModels│
│   presetModelInfo   llm.resolveModelInfo(+目录)  │
│   targetProviders   settings.get('llm-pi-ai')   │
│   applyModelConfig  构建 models 数组 + settings.mutate│
│ + ctx.typert.register(manifest) 严格描述符解析   │
└─────────────────────────────────────────────────┘

Remote 方法一览

方法	参数	说明
presetProviders	—	目录 + 已配置提供商(带 declared/configured 标记)
presetModels	provider	已注册走 listModels,休眠走 discoverModels
presetModelInfo	provider, model	上下文/输出/模态/推理档位(合并 resolve + discovery)
targetProviders	—	已配置路由及其现有/目录模型列表、writable
applyModelConfig	route, entry, overwrite	校验 → 构建 → settings.mutate('llm-pi-ai', ops)

已知限制

• 推理档位名:仅对已注册(已配置)的预设提供商可精确获取(resolveModelInfo);休眠目录提供商不暴露推理元数据。
• wire 值:精确映射(pi-ai 目录的 thinkingLevelMap,如 opencode-go 的 {minimal:null, low:null, medium:null, high:"high", max:"max"})只存在于 pi-ai 安装目录的 JSON 中,适配器未通过 llm 服务暴露。默认按「档位名 = wire」预填(对绝大多数 OpenAI 兼容网关正确),逐档可改;deepseek 系 minimal/low/medium 通常应留空(不发送)。
• 目标路由必须已配置(先在官方 Models 页创建);使用 modelOverrides 的路由自动折叠后写入。

使用

1. 安装 bundle 并重启 Web 服务器(见上);
2. 打开 Web 设置 → 左侧导航「模型配置同步」(Models 页之后);
3. ①(可选)选择预设提供商/模型快速填充;②选择目标提供商;③编辑模型字段与推理档位;
4. 「预览写入内容」核对 → 「应用配置」;
5. 写入立即生效,官方 Models 页自动刷新;$DSH_HOME/settings.yaml 中 llm-pi-ai.providers. 出现 models: 列表。

兼容性

• 依赖 Host 服务:typert(注入)、llm、settings(后两者通过 ctx.get 可选读取,缺失时优雅报错);
• 依赖 Client:slots(settings.section)、locale(zh/en)、remote(Typert 网关);
• 与官方 dsh-client-ui-settings-models 页并列运行,不遮蔽、不替换官方 UI。

License

MIT

使用

1. 安装 bundle 并重启 Web 服务器(见上);
2. 打开 Web 设置 → 左侧导航「模型配置同步」(Models 页之后);
3. ①(可选)选择预设提供商/模型快速填充;②选择目标提供商;③编辑模型字段与推理档位;
4. 「预览写入内容」核对 → 「应用配置」;
5. 写入立即生效,官方 Models 页自动刷新;$DSH_HOME/settings.yaml 中 llm-pi-ai.providers. 出现 models: 列表。