思考档位配置 benzhoupo/dsh-effort-config

dsh-effort-config

DeepSeek Harness（dsh）插件：在设置页为第三方模型配置「思考努力度」档位，写入 llm-pi-ai 命名空间；档位调节复用原生模型框的 Effort 面板（composer 模型座 / /model 命令），选择器无需重做——模型声明档位后自动出现。

演示截图

主界面.png

添加界面.png

特性

- 设置页入口：设置面板新增「思考努力度」页（settings.section），只展示已配置的提供商，新添加的在前
- 右上角添加提供商（settings.action 按钮）：候选列表已配置的在前、手写路由优先；点击未配置的内置目录路由即启用（写入空 profile，模型与协议由 pi-ai 内置目录提供）
- 档位编辑：每个模型可声明 7 档 off / minimal / low / medium / high / xhigh / max + wire 拼写（默认建议档位名）
- 什么都没勾选 = 保持「未声明」（不写入档位）
- 只勾 off = 「无思考能力」（reasoningEfforts: false）
- 非 off 档位必须填写非空 wire 值；空 wire / 非法档位名被响亮拒绝且不落盘
- 路由默认档位（reasoning）、Anthropic token 预算（thinkingBudgets，仅协议为 anthropic-messages 时显示）
- 删除提供商（连同其全部思考档位配置），两段式确认
- 持久化：写入 settings.yaml 的 llm-pi-ai 命名空间，重启后仍在
- 自动联动：保存后模型选择框立即刷新（依赖原生 llm/adapters-updated 与 settings/document-updated 事件）
- 双语界面：文案自动跟随 Harness 界面语言（中文 / English）

工作原理

| 层 | 说明 |
| Host 半（index.js） | 空实现（纯 UI 插件）。零运行时 import，不会引发 ERR_MODULE_NOT_FOUND 导致 dsh 启动崩溃 |
| 浏览器半（client.js） | 手写 window.__ModuleLoader__.load bundle（纯 JS，无需 tsdown 工具链），仅 require("react") |

全部数据走现有 wire remote，不依赖自定义 Host Remote（无需 typert 代码生成工具链）：

- connection.api.settings.describe / replace —— 读写 llm-pi-ai 用户层（乐观并发：expectedRevision + 冲突重放重试）
- connection.api.llm.providers / models —— 可配置提供商目录（displayName / declared / active）与宿主模型目录（catalog 路由的模型枚举）
- remote.$on('llm/adapters-updated' | 'settings/document-updated') —— 自动刷新

档位语义遵循 dsh-llm-pi-ai 的 reasoningEfforts 契约（键固定 7 档；值为 provider 端 wire 拼写；off 可留空 null = 不发送参数）。写入经 settings 层的 schema + validate 兜底（如 "offers no level beyond off" 在写入处拒绝），非法值绝不落盘。

排序语义

- 主列表：按 settings.yaml 中 providers 键序倒序（新添加的在前）
- 添加候选列表：已配置（用户自己的）在前、手写路由优先

与动态 Cordis 插件的差异

本包运行在浏览器 realm，无动态 Host 的 node:vm 原型校验问题（settings 层的 isPlainObject 按宿主 Object.prototype 校验，沙箱新建对象会被拒），因此写入逻辑更简单：深拷贝用户层 → 应用操作 → settings.replace。

安装

用 dsh 命令（推荐）：转发给 web profile 下的 pnpm
dsh plugin --profile web add /home/benzhoupo/ds-plugins/dsh-effort-config

或直接手动：
cd ~/.dsh/profiles/web && pnpm add file:/home/benzhoupo/ds-plugins/dsh-effort-config

然后重启 dsh web（补丁行与浏览器 bundle 需要重新组合）。卸载：

dsh plugin --profile web remove dsh-effort-config

使用

1. 打开设置 → 左侧「思考努力度」（位于「模型」与「插件」之间）
2. 若还没有提供商：点右上角「添加提供商」→ 在候选列表中选择（已配置的排在前、标「已配置」不可重复添加）
3. 在提供商卡片中：
- 对每个模型点「编辑档位」→ 勾选档位（wire 默认填档位名，可改）→ 保存
- 「路由默认档位」下拉选择请求默认档位
- Anthropic 兼容提供商（协议 anthropic-messages）显示「Anthropic token 预算」
4. 回 composer：模型座显示「模型名 · 档位」，Effort 面板列出所有档位，直接选择即可
5. 「删除」按钮（两段式确认）移除提供商及其全部思考档位配置

settings.yaml 示例

llm-pi-ai:
providers:
bearlab:
displayName: BearLab
apiKeyEnv: BEARLAB_API_KEY
api: openai-responses
baseURL: https://bearlab.ai/v1
models:
- id: gpt-5.6-sol
name: GPT 5.6 Sol
contextWindow: 256000
reasoningEfforts: # 手写路由：写在 models[] 条目上 xhigh: xhigh # wire 值 = provider 端拼写（openai-responses → reasoning.effort） off: null # off 留空 = 不发送参数 reasoning: xhigh # 路由默认档位 anthropic: # 内置目录路由：走 modelOverrides modelOverrides: claude-sonnet-4-5: reasoningEfforts: high: high thinkingBudgets: # 仅 anthropic 协议有意义（budget_tokens） minimal: 1024 low: 2048 medium: 4096 high: 8192

wire 映射速查

| 协议 | 发送位置 | 档位值建议 |
| openai-completions | reasoning_effort | 档位名（如 high）或网关自有拼写 |
| openai-responses | reasoning.effort | 档位名 |
| anthropic-messages | 自适应思考 effort（或预算型 budget_tokens） | low / medium / high / xhigh / max；预算用路由级 thinkingBudgets |

故障排查

- 设置页看不到「思考努力度」：确认已重启 dsh web、包已安装（dsh plugin --profile web why dsh-effort-config）
- 页面提示「llm-pi-ai 命名空间未注册」：@deepseek-ai/dsh-llm-pi-ai 未加载或已被移除
- 添加后模型列表为空：路由刚注册，点「刷新」（目录模型枚举依赖适配器注册完成）
- 默认模型选了未声明档位的模型：请求会在网络 I/O 前以 UNSUPPORTED_REASONING_EFFORT 失败（pi-ai 原生行为），请为该模型声明档位或清除默认档位

许可

CC BY 4.0（Creative Commons Attribution 4.0 International），署名：benzhoupo。可自由分享与演绎，使用时请按要求署名。