dsh-effort-config

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

演示截图

特性

• 设置页入口：设置面板新增「思考努力度」页（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）

工作原理

全部数据走现有 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 映射速查

故障排查

• 设置页看不到「思考努力度」：确认已重启 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。可自由分享与演绎，使用时请按要求署名。