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）

工作原理

层	说明
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。可自由分享与演绎，使用时请按要求署名。