dsh-model-capabilities

English | 中文

为 DSH 自定义提供方声明逐模型能力:为自定义模型目录里的每个模型声明图片输入与推理档位(模型支持哪些思考档位、每档实际发送的取值),直接在 Models 设置页上编辑。官方 pi-ai 设置命名空间一直就承载这些字段——本插件补上的正是设置页刻意没做的编辑入口。

功能

• 占位官方扩展区:注册 Models 页的 settings.models.provider-card 插槽(key 为 llm-pi-ai 适配器家族),该家族的每张提供方卡片(手填的网关、OpenAI 兼容端点、命名厂商)都会获得一个可折叠的「模型能力」扩展区。
• 提供方禁用/启用:一键把该提供方的 profile 存档到插件自己的设置命名空间,再通过官方「移除提供方」同款操作(unset llm-pi-ai.providers.<route>)下线路由——该提供方随即离开模型目录,输入框模型选择器与子代理可选列表同时消失,所有已打开的界面即时生效,无需重启。启用则原样恢复存档的 profile(API 密钥存放在凭据服务中,禁用/启用完全不触及)。已禁用的提供方列在 Models 页底部的存档区,可从那里恢复。
• 逐模型图片输入:每个模型一个勾选框,写入 profile 的 input 模态声明(["text", "image"] 或 ["text"])。声明图片正是 DSH 允许向手填的视觉模型发送图片附件的开关;只声明文本则可以纠正「目录声称支持、网关实际不服务」的目录模型。未声明(继承)状态会如实展示并保留,不会被隐藏。
• 逐模型推理档位:每个模型三态编辑——不声明(继承)、声明无推理(reasoningEfforts: false,模型选择器不再提供思考档位)、或显式档位字典。档位从 off 到 max;每个启用的档位带一个发送值输入框(请求实际发送的取值,默认与档位同名),另有一键填入常用的 low/medium/high。off 的发送值可留空,含义是「支持,但发送时不带参数」。
• 走官方线路写入:保存是一次路径操作,整体替换 llm-pi-ai 设置命名空间里该提供方的整个 models 数组——与官方卡片首次编辑时相同的整数组覆盖。本插件不编辑的字段(模型 ID、显示名称、上下文窗口、compat 开关)在每次保存后原样保留;写入即时生效,无需重启。
• 写入前先校验:编辑器执行与适配器一致的接受规则(档位字典必须含 off 以外的档位;off 以外档位必须有非空发送值),并直接说明草稿会被拒绝的原因,而不是让 host 事后拒绝。
• 冲突安全:每次保存都携带面板读取时的 revision;配置在其他界面被改动时,面板重新读取并提示重试,绝不盲写覆盖。

安装

通过家族聚合包

dsh-web-all 聚合 bundle 已包含本插件,挂载聚合包即可。

独立挂载(开发)

git clone https://github.com/gestaltrun/dsh-web.git
cd dsh-web
pnpm install
pnpm -r build
dsh plugin --profile web add link:$(pwd)/packages/dsh-model-capabilities

重启 dsh web。打开 Web 设置的 Models 页,每张自定义提供方卡片在目录编辑器下方都会出现模型能力扩展区。

配置

插件注册一个自己的设置命名空间 dsh-model-capabilities,里面只存放已禁用提供方的存档,没有需要手工配置的项。能力声明与禁用/启用状态分别保存在官方 llm-pi-ai 命名空间和这个存档里,全部在 Models 页上编辑。

语义须知

• 声明是断言,不是探测:任何环节都不会去询问网关它接受什么。模型声称支持图片而端点拒绝时,会在回合中途被提供方拒绝;发送值端点不认识时,会在请求时失败——这些字段存在的意义正是「没有任何途径可以推断它们」。
• 面板只编辑已声明的模型:路线还在直接服务内置 pi-ai 目录(没有 models 数组)时,面板显示指引而非编辑器,因为浏览器侧无法枚举该目录。请先在卡片的模型目录里添加模型行(id 与目录模型相同的条目会逐字段覆盖它),再回到这里声明能力。
• 推理档位即选择器词汇:声明的档位就是输入区模型选择器为该模型提供的选项;发送值是随请求发送的内容。off 留空发送值表示选中该档位时不发送参数。
• 禁用 = 先存档、后下线:profile 先写入存档、路由后下线,即使某一步失败,最坏也只是留下一条无害的重复存档,绝不会丢配置。启用时若该路线已出现新的配置,恢复会被拒绝,存档绝不会覆盖更新的配置。提供方禁用期间,对它的委派在 host 侧直接失败(NO_ADAPTER),不只是 UI 上不显示。

已知限制

• 不提供文本、图片以外的模态:pi-ai 适配器的模态词表只有 text | image,声明视频、PDF 无法端到端生效。
• 不覆盖 DeepSeek 直连适配器(llm-deepseek):它的目录固定,推理强度控制已存在于 Models 页。
• 仍未保存的草稿提供方卡片不会分发扩展区;请先保存提供方。
• 禁用只作用于用户设置层的 profile——即 Models 页写出的手填提供方。声明在组合(composition base)层的 profile 无法从客户端下线:设置合并机制保证用户写入删不掉它,因此这类卡片不提供禁用开关。