Kalospacer/dsh-model-capabilities

dsh-model-capabilities

给 DSH 的设置里加一页 模型能力：为 pi-ai 路由编辑上下文窗口、最大输出 token、图像输入和真实思考值。

安装与使用

dsh plugin --profile web add github:Kalospacer/dsh-model-capabilities#main

安装后重启 DSH Web Host，打开 设置 → 模型能力。

页面分为路由筛选、模型列表和能力编辑三个区域。窄屏会转为上下排列；手机上点击模型会滚动到编辑区域。

1. 在线目录加载后，为新出现、尚未处理的模型寻找可信匹配，并自动生成空白字段的默认草稿。
2. 检查候选来源和实际发送值，必要时搜索另一个模型、切换候选或手动修正。
3. 点击 保存此模型 或 保存全部。自动预填和套用都不会静默写入设置。

仅在模型能力页打开时扫描当前模型与宿主推送的新模型；不修改 DSH 自己的模型发现流程，也不在后台探测或发送聊天请求。

四项能力

数字字段留空表示继承；清空已保存的覆盖值后保存，会删除这个字段的覆盖。

思考值不是通用档位名

左侧是 DSH 的界面选项，右侧是模型或当前线路实际接受的字符串。两者不一定同名：

reasoningEfforts:
  off: none
  low: low
  high: high
  xhigh: extra

• 选择 off 时，发送 none，而不是擅自改成 off。
• 选择 xhigh 时，可以发送 extra；也可以手动填写当前网关要求的其他值。
• 非 off 选项必须有实际发送值。low: null 不是“默认发送 low”，会被当前宿主拒绝。
• off: null 是特例，表示关闭选项不发送思考参数。
• reasoningEfforts: false 表示不支持推理，不等同于 off → none。

自动映射仅处理明确的界面别名（none → off、extra → xhigh），右侧原值保留大小写。不会按数组位置映射，也不猜测 ultra、supra 等未知值的强弱；遇到未知值或冲突时显示提示，思考设置保持原状，允许手动修正。

OpenRouter 匹配与默认值

数据源：https://openrouter.ai/api/v1/models。

• context_length → 上下文窗口。
• top_provider.max_completion_tokens → 最大输出 token。
• architecture.input_modalities → 图像/文本能力。
• reasoning.supported_efforts → 思考真实值。
• reasoning.default_effort 仅展示参考，不写入宿主未声明的字段。

名称搜索采用 token 边界与稀有词加权的匹配方式。不存在于目录中的自拟前缀可以忽略；只有版本与有效名称完整吻合，或 ID/slug 精确吻合且没有歧义时才自动补齐。模糊结果仍能手动选取，但不会自动认领成某个模型。置信标签表示名称匹配质量，不是官方正确率。

OpenRouter 是聚合目录，不保证其发送值等同于每条接入线路的原生 API。 保存前应核对线路实际接受的值；插件不会因为模型叫 Claude 就把所有 xhigh 擅自改成 extra。目录没有思考枚举时，也不会补一套猜测的 low / medium / high。

不覆盖已有修正

• 自动生成与 补齐空白项 只补未声明的字段，不覆盖基础层配置、保存值或正在编辑的草稿。
• 替换为这份元数据 会先确认，再替换目录确实提供的字段；仍需保存才生效。
• 当前列表可一次补齐所有可信的空白项；已有草稿保持不变。
• 恢复继承 清除这四项能力覆盖，其他字段不动；撤销此模型草稿 只取消未保存的修改。
• 浏览器记忆已经处理过的模型，避免撤销或恢复继承后，每次刷新又自动塞回草稿。需要再次填充时，可显式使用补齐按钮。浏览器存储禁用时只在当前页面记忆。
• 未保存的修改保留在当前页面内，离开或刷新时浏览器会提示；草稿不是持久化设置。

目录在浏览器缓存 6 小时，共享一次请求。联网失败时可以保留旧缓存并标记；没有缓存时仍可完整使用手动配置。公开目录请求不携带线路密钥、Cookie，也不会把本地模型名称发送到 OpenRouter；搜索在本地完成。