dsh-plugin-model-capabilities

DSH 后台守护插件：自动补全 llm-pi-ai 各路由模型条目缺失的能力字段（上下文窗口、输出上限、输入模态、推理档位、compat），补完的配置经 settings 服务写入 ~/.dsh/settings.yaml，热加载即时生效。

行为

• 触发：启动（llm-pi-ai 命名空间注册后）／llm-pi-ai 设置变更（防抖 5s）／每 12h 定期重扫。
• 来源链（按优先级）：
  1. ~/.dsh/model-capabilities.overrides.json — 本地覆盖，最高优先，插件只读不写；
  2. 最新 pi-ai npm catalog（npmmirror 拉取，缓存 24h）；
  3. 运行时已安装的 pi-ai catalog（零网络）；
  4. models.dev 聚合数据（gh api 拉取，缓存 24h）。
• 安全性：只补缺失字段，永不覆盖已写字段；写入走 settings 服务，llm-pi-ai 自己的 assertServiceable 校验拒绝坏数据（整次写入拒收、不落盘）；写入冲突自动重扫一次收敛。
• 仅处理显式声明了 api 的路由（自定义中转路由）；catalog 路由自带完整数据无需帮助。
• 每次补全写一行日志（pm2 logs dsh-web 可见）：model-capabilities: <route>/<model> <- <source>: <fields>。

新模型刚发布时

上游（pi-ai / models.dev）通常滞后 1–3 天收录。当天在 ~/.dsh/model-capabilities.overrides.json 加一条即可（见文件内注释），字段形状与 settings.yaml 的模型条目一致。

安装 / 更新

./install.sh          # 部署到 ~/.dsh/profiles/node_modules/
# 挂载行（~/.dsh/profiles/web/cordis.patch.yml）：
#   - id: model-capabilities
#     name: dsh-plugin-model-capabilities
pm2 restart dsh-web   # host 半改动需重启生效

验证

• 部署后：cd ~/.dsh/profiles/web && node -e "await import('dsh-plugin-model-capabilities')"
• 扫描预检（不动真实 settings）：node scripts/smoke-scan.mjs
• 运行日志：pm2 logs dsh-web --lines 50 --nostream | grep model-capabilities