模型类比添加 axtrask/dsh-model-analogs

dsh-model-analogs

给 DSH 增加模型的方式是「按类比」：从已安装的 pi-ai 目录里挑一个模型，指定新的 id，插件就会复制这个类比模型的能力，并把模型写进配置档的配置。

为什么需要

Settings → Models 页面只能按目录里的字符串添加模型：如果某个 id 不在目录里（比如服务商新出的模型），就得手动填上下文、maxTokens、模态和推理等级。插件把这一步变成一次选择，顺便自己写好配置。

工作原理

- Models 页面上的卡片（插槽 settings.models.footer）通过 ctx.llm.listModels 读取目录，通过 ctx.llm.resolveModelInfo 读取类比模型的能力（上下文、模态、推理等级集合）。
- 写入走 ctx.settings.update('llm-pi-ai', …)：改动落到 profiles/<profile>/cordis.patch.yml 里 llm-pi-ai 那一行下面，由它的 schema 校验，并即时生效。
- 模型放在单独的 route 上（默认 openrouter-analog），而不是 openrouter：在 llm-pi-ai 里，models 列表会整体替换 route 的目录，所以往 openrouter 里补一个模型，就得把它的约 400 个模型全导进去。

安装

插件作为普通 bundle 接入 DSH 配置档——不用手动复制文件、创建 junction。

从 Git 安装

把包加进配置档的依赖：

cd <profile>
pnpm add git+https://github.com/axtrask/dsh-model-analogs.git

然后在 profiles/<profile>/package.json 里把 "dsh-model-analogs" 加进 dsh.profile.bundles，重启配置档（dsh web）。

另一种方式：让智能体调用 plugin_manager，传 install_bundle 和同一个 Git 地址，它会自己装好包并启用 bundle。

从本地检出安装

开发时可以用链接方式绑定包：在配置档的 dependencies 里写 "dsh-model-analogs": "link:<检出目录的绝对路径>"，再执行 pnpm install。改动在重启配置档后生效：已挂载插件的配置改动即时生效，但新增的插件行只在启动时挂载。

配置（cordis.patch.yml）

| 字段 | 含义 |
| settingsNs | 哪个插件的配置接收 route（llm-pi-ai） |
| catalogRoute | 类比模型从哪来（openrouter） |
| route / routeName | 新建 route 的键和显示名 |
| apiKeyEnv、baseURL、api | route 如何访问服务商 |
| thinkingFormat、offWire、supportsDeveloperRole、supportsStrictMode | 推理的 wire 开关 |
| defaultMaxTokens | 模型没设自己的上限时，用作回复上限的兜底值 |
| path | 卡片的 HTTP 通道（/model-analogs/api） |

限制

- 目录不发布 maxTokens（seam 只对配置里设了上限的模型返回它），所以卡片里有 maxTokens 字段，值取自 defaultMaxTokens。
- Models 页面上的 Restore default models 和手动删除 route 都会移除插件的模型——在卡片里重新添加即可恢复。
- 类比取自已安装的 pi-ai 目录：如果目录里还没有新模型，这就是正常场景——参照上一个模型「按类比」把它加进去。