heerxingen/dsh-model-capabilities

dsh-model-capabilities

为 DSH Web GUI 提供模型能力编辑器：在「设置 → 模型」的提供方卡片里，为路由上的每个模型声明能力——尤其是图片输入。

自定义模型读不了图，99% 是这个原因：DSH 不会去探测模型能力，它只信适配器声明的 inputModalities。没声明就是纯文本：read_image 直接拒绝、图片附件被拒、请求里的图片被替换成占位文本。而官方 Models 页只能改 id/name/上下文/输出上限，没有任何模态开关。这个插件补上它。

还能顺手做一件事：点一下向端点验证这个模型是不是真的能看图（声明 ≠ 真支持，端点会静默忽略图片）。

安装

前置：DSH 已装好（dsh --version 能跑），用 web profile。pnpm 会在安装时被调用。

方式一：直接从 GitHub 安装（推荐）

dsh plugin --profile web add github:heerxingen/dsh-model-capabilities

lib/ 是随仓库提交的构建产物，所以装完即用，不需要编译。

然后重启一次 dsh web（新插件要在启动时组合进前端模块图），刷新页面即可。

方式二：本地克隆（开发 / 改代码）

git clone https://github.com/heerxingen/dsh-model-capabilities.git
cd dsh-model-capabilities
npm install            # 只有 3 个 devDependency：esbuild + react/react-dom（跑 smoke 测试用）
npm run check          # 单测 + 构建 + 冒烟，装之前先确认环境没问题
dsh plugin --profile web add "$PWD"

同样重启一次 dsh web。之后改前端只要：

npm run watch          # 重建 lib/client.js，浏览器会自动热替换，无需重启、无需刷新

改宿主半（src/node/）需要重启：web profile 里 @deepseek-ai/cordis-plugin-hmr 默认是 disabled 的，node 半不会热加载。

卸载 / 临时关闭

dsh plugin --profile web remove dsh-model-capabilities

或临时禁用（在 ~/.dsh/profiles/web/cordis.patch.yml 里加一行）：

- id: model-capabilities
disabled: true

用起来

设置 → 模型 → DeepSeek（或任意提供方）卡片 → 模型能力

每个模型一行：

| 控件 | 作用 |
|---|---|
| 图片输入 | 声明 image；关掉时会在同一次写入里清掉图片预算（否则适配器会拒绝整份配置） |
| 验证图片 | 向该路由的端点发一张 1×1 PNG，报告它到底看没看到 |
| 能力参数 | 显示名称、描述、图片像素预算、图片字节上限、上下文窗口、最大输出、推理档位 |
| 继承 / 删除 | pi-ai 路由可以丢掉声明交回目录；删除会移除该条目（二次确认） |
| 底部 | 添加模型；pi-ai 保留目录的路由可以「列出目录模型」，点选即可建覆盖 |

勾上「图片输入」后当次请求就生效，不用重启：适配器每个请求都会重读自己的设置段。

前置要求

| 项 | 要求 |
|---|---|
| DSH | 0.1.x，带 web profile（插件注册进 settings.models.provider-card 插槽） |
| Node | >= 20（开发时需要；直接安装不需要） |
| pnpm | 安装插件时 dsh plugin 会转发给它 |
| 适配器 | llm-deepseek 和/或 llm-pi-ai 已挂载（默认 web profile 两个都有） |

排错

| 现象 | 原因 / 处理 |
|---|---|
| 模型页看不到「模型能力」 | 插件没挂载。确认 dsh --profile web --dump-config 输出里有 - id: model-capabilities，然后重启 dsh web |
| 点「验证图片」显示"宿主半未加载" | 宿主半的路由还没注册——重启一次 dsh web 即可 |
| 验证结果说"端点忽略了图片" | 声明与实际不符：这个端点对不支持图片的模型是静默忽略的，别给它勾图片输入 |
| 勾了图片输入但发图仍失败 | 端点真的不支持该模型；或检查验证结果，必要时换用已知的视觉模型 |
| 改了 src/node/ 不生效 | node 半需要重启（见上） |

更多

- 设计细节、能力字段对照表、探测路由协议、构建说明：docs/design.md
- 许可：MIT