模型能力配置 bamboostrip/dsh-llm-capabilities

dsh-llm-capabilities

DSH 插件：为 llm-pi-ai 自动检测并配置模型能力（reasoningEfforts + capacities）。
接替 dsh-reasoning-efforts —— 官方 llm-pi-ai 界面里那些自建网关无法配置的字段，现在一个面板就能补上。

为什么需要它

官方 llm-pi-ai 设置页里，自定义服务商只能改 contextWindow。真正影响路由的字段却藏了起来：

1. 思考等级（reasoningEfforts）—— 模型接受哪些 off/minimal/low/medium/high/xhigh/max，以及每个等级对应到线上的拼写（max: ultra）。没有它，强度滑块只会显示「该模型不提供可选的思考等级」。

视觉能力（input）原本是第二个缺口，但官方界面现在自己声明输入模态了 —— 所以从 0.2.0 起，本插件完全不碰 input（每次保存都原样保留已有值）。

如果你是从 dsh-reasoning-efforts 过来的：留着它，它照样能用。dsh-llm-capabilities 同时服务两个端点（/model-capabilities/raw-models 和旧的 /thinking-levels/raw-models），老客户端不受影响。新装的话请用这个包。

它做什么

- 一个设置页 Settings → Model Capabilities
- 选中即自动检测：选好服务商后，服务端会请求 GET {baseURL}/models（凭据在主机侧解析，密钥不外泄），并解析：
- supported_features: ["reasoning"]、supported_parameters、supports_reasoning、reasoning_effort …… → 推理能力
- context_length、max_output_tokens …… → 容量
- 结合目录：把 llm.models()（pi-ai 自带的知识）作为补充来源合并进来 —— 是或否以端点为准，等级集合由目录细化，端点没给信息时由目录顶上。
- 已配置状态会回显：重新检测不会抹掉已保存的 reasoningEfforts —— 配置过的模型会显示自己的等级（包括自定义的线上拼写），不管端点有没有列出信号。
- 新模型：端点列出的模型你还没配置 → 它会带着 not configured 标记出现，保存后即加入。
- 保留视觉能力：input 从不写入也从不删除；官方界面声明过什么就保持什么。
- 吸底保存栏：滚动时列表底部固定一个「Save changes」按钮 —— 不用再滚回顶部；磨砂玻璃质感，列表内容不会透出来。
- 安全写入：用 settings.mutate 加 expectedRevision，深拷贝 models 数组，不碰其他服务商字段。

安装

published
dsh plugin --profile web add dsh-llm-capabilities

local dev
dsh plugin --profile web add link:D:\AllCode\dsh\dsh-llm-capabilities

需要 DHS >= 0.1.1-rc.2、node >= 22.13。

用法

1. 照常到 Settings → Models 里添加服务商（route、baseURL、apiKeyEnv）。
2. 打开 Settings → Model Capabilities，选择服务商——检测会自动运行。
3. 按模型切换 Offer thinking levels：可选 off/low/medium/high/xhigh/max；需要时用铅笔图标自定义线上拼写。
4. 保存更改 → 写入 llm-pi-ai（providers.<route>.models）。强度滑块立即更新；input/vision 保持官方 UI 设置的样子。

Go 会话请求头（x-opencode-session）

OpenCode Go 要求第三方智能体发送稳定的 x-opencode-session 请求头，用于提示词缓存亲和（文档）。宿主侧会包装 globalThis.fetch，对 URL 包含 opencode.ai/zen/go 的请求设置该请求头（覆盖 ocg-c / ocg-r / ocg-a）。其他请求原样放行。

- 会话键（默认）： ses_ + 32 位十六进制，由 dsh 会话 id 经 sha256 派生，因此同一聊天在重启后仍保持同一个 OpenCode 会话。标题调用使用独立命名空间；压缩沿用会话的命名空间，因为它会重放历史（推理 encrypted_content 绑定到签发它的账号）。
- 加密推理自愈： 如果网关仍返回 400 … reasoning 'encrypted_content' was not issued to this caller（网关侧会话→账号亲和丢失），包装层会剥离重放的加密推理项后重试一次，而不是让本轮失败。用 sessionHeaders.encryptedContentRetry: false 关闭。
- 绝不改动：user-agent（保持 deepseek-harness/...——Go 要求如实标识）和 authorization。
- 不卸载也能禁用（配置档 cordis.patch.yml）：

- insert:
- id: model-capabilities
name: dsh-llm-capabilities
config:
sessionHeaders:
enabled: false

写入的配置结构

llm-pi-ai:
providers:
my-gateway:
baseURL: https://gateway.example/v1
api: openai-completions
models:
- id: gpt-4o
input: [text, image] # vision — written by the official UI, preserved by this plugin
reasoningEfforts: # thinking — written by this plugin off: null low: low medium: medium high: high
- id: text-only-model
input: [text]
reasoningEfforts: false # explicitly no reasoning

检测如何工作

llm.discoverModels 在宿主侧被刻意收窄为 id/name/contextWindow/maxTokens。本插件新增一条宿主路由，返回原始列表：

GET /model-capabilities/raw-models?route=<route>

它从你自己的 llm-pi-ai 设置里读取 baseURL/apiKeyEnv，通过 ctx.credentials 解析凭据，请求 {baseURL}/models，返回 {ok, data}，全程不回显密钥。只有你已配置的路由可访问（浏览器信任围栏：拒绝跨站，校验 Origin/Host）。

开发

pnpm install
pnpm run typecheck
pnpm run build
pnpm run dev # watch

Web 产物是 window.__ModuleLoader__.load({id, factory}) 闭包 —— 不是 ESM —— 所以客户端 import 只能引用平台模块（react、@deepseek-ai/dsh-client-*）。

与 dsh-reasoning-efforts 的关系

| | dsh-reasoning-efforts | dsh-llm-capabilities（本插件） |
| reasoning 自动检测 | ✅ | ✅（已移植，严格 TS） |
| vision | ❌ | 由官方 UI 处理；保存时保留 input |
| 宿主路由 | /thinking-levels/raw-models | /model-capabilities/raw-models + 旧版兼容 |

准备好就迁移 —— 过渡期间两者可以共存。

许可证

MIT © hank reed (bamboostrip)