模型能力编辑 qingshanjiluo/dsh-model-caps

dsh-model-caps

拉取服务商真实的 /models 列表，查看它暴露的能力字段（上下文窗口、最大输出、图片输入），在一个页面里编辑，然后存回 llm-pi-ai。

有些目录查询拿模型名称去匹配静态表，这个插件不一样：它直接问配置好的上游，只显示上游真正返回的内容。缺失的字段留空，不猜；视觉支持可以用真实图片探测来验证。

为什么需要它

llm-pi-ai 支持为每个模型配置 contextWindow、maxTokens 和 input，但大多数 OpenAI 兼容网关的 GET /models 只返回一个 id。手动填这些字段容易出错，按名称匹配的目录对私有路由也不适用。这个插件让人留在流程里：拉取、检查、编辑、保存。

安装

dsh plugin --profile web add github:qingshanjiluo/dsh-model-caps

然后重启配置档；如果已经装了 dsh-hotswap，也可以让它直接挂载。

使用

1. 在与 Web UI 相同的浏览器会话里打开 http://127.0.0.1:3080/model-caps/（cookie 负责页面鉴权）。
2. 选一个服务商。列表来自 llm-pi-ai.providers。
3. 点 Fetch upstream。插件用该服务商 apiKeyEnv 指向的凭据存储里的 key，调用 GET {baseURL}/models。
4. 检查表格。来自上游返回内容的字段会在备注列标出；空白表示上游没有暴露该字段。
5. 可选：选中若干行，点 Probe vision。插件会发一张 32x32 的红蓝 PNG，只有模型用颜色作答，才算支持图片输入。
6. 编辑任意单元格，然后点 Save。插件通过 settings.mutate 写入 llm-pi-ai.providers.<id>.models，没动过的字段原样保留。

页面文件

编辑器 UI 放在 dsh/model-caps.html，每次请求都从磁盘读取，所以改完 UI 刷新即可生效，不用重启 DSH。

编辑器

编辑器是独立页面，位于 /model-caps/，由 dsh/model-caps.html 提供，每次请求都从磁盘读取，所以改完 UI 刷新即可生效，不用重启 DSH。页面分页显示（每页 80 行），筛选做了防抖，50 个以上模型的服务商也能保持流畅。

接口

| 方法 | 路径 | 用途 |
| GET | /model-caps/ | 编辑器页面 |
| GET | /model-caps/providers | 已配置的服务商、apiKeyEnv、模型数量 |
| POST | /model-caps/fetch | { provider } -> 上游行与当前配置合并 |
| POST | /model-caps/vision | { provider, ids } -> 每个模型的图片支持情况 |
| POST | /model-caps/save | { provider, rows } -> 把模型列表写回 |

解析的能力字段

读取逻辑接受网关常见的几种写法：

- 上下文：context_length、context_window、max_context_length、 max_input_tokens、max_model_len、top_provider.context_length、 limits.context
- 输出：max_tokens、max_output_tokens、max_completion_tokens、 top_provider.max_completion_tokens、limits.output
- 图像输入：architecture.input_modalities、input_modalities、 modalities.input、capabilities.vision、supports_vision、vision

安全

- 页面和端点与 Web UI 共用同一道认证关卡；请求没有有效会话就会被拒绝。
- 只有你选中的服务商才会被联系上游，而且只在你按下按钮时才会发生。
- 保存会替换该服务商的模型列表。上游没有的条目会标记出来，除非你保留它们，否则会被丢弃。
- API key 始终不离开主机：浏览器与 DSH 通信，DSH 再与服务商通信。

许可证

MIT