dsh-reasoning-effort

English | 中文

>  > 

一个正式的 DSH 插件，让官方内置的模型选择器支持推理强度（Reasoning Effort）选择。支持任何 provider、任何模型；通过 dsh plugin 一键安装。

---

中文文档

安装方式一：让 Agent 安装（推荐）

如果当前 Agent 可以执行终端命令，把下面这段话完整发送给它：

请帮我为 DeepSeek Harness 的 web Profile 安装推理强度插件。

先检查一下是否已安装，运行：
dsh --profile web --dump-config

如果输出中已经有 dsh-reasoning-effort 条目，告诉我"已安装"即可，不用重复装。
如果还没有，请帮我安装（只操作 web Profile，不要动其他 Profile）：
dsh plugin --profile web add github:byxumi/dsh-reasoning-effort#main

安装时注意：如果 pnpm 输出 "Ignored build scripts"（或
"Ignored build scripts: dsh-reasoning-effort ... Run pnpm approve-builds"），
说明安装钩子被 pnpm 拦截了。请打开
C:\Users\<用户名>\.dsh\profiles\web\pnpm-workspace.yaml ，
把 allowBuilds 里 dsh-reasoning-effort 那一行结尾的
"set this to true or false" 改成 true（保持缩进、引号不变），
然后重新运行一次上面的安装命令。
（这一步只放行插件的自动打补丁钩子，不会执行任何其他代码）

安装完成后，再运行确认一次：
dsh --profile web --dump-config

告诉我最终结果——配置里是否出现了 dsh-reasoning-effort。
全程不要关闭或重启我当前正在运行的 DSH；安装完成后提醒我手动重启 DSH Web Host 才能生效。

Agent 应当返回检查结果和安装状态。如果已经安装，它会告诉你"已安装"；如果刚装上，它会汇报配置中已出现 dsh-reasoning-effort。

安装后手动重启 DSH Web Host 使插件生效。

> 关于自动打补丁：仓库的 package.json 带有 prepare/postinstall 钩子， > 安装时会自动运行 node install.js --off，把本机所有 pi-ai 适配器副本（profiles、 > npx 缓存、npm 全局、桌面版运行时）打上 compat 补丁，避免网关返回 > 400 developer is not one of [...]。pnpm 首次会拦截该钩子并要求在 > pnpm-workspace.yaml 的 allowBuilds 中确认（上面提示词已包含此步骤）； > 即使未确认，插件加载时也会通过自愈逻辑补丁，但需要多一次重启。

#### 给 Agent 的卸载提示词

需要卸载时，把下面这段发给 Agent：

请帮我从 DeepSeek Harness 完全卸载推理强度插件。

按下面步骤执行：
1. 在本机找到或下载卸载脚本 uninstall.js：
   - 如果当前目录或 ~/.dsh/ 下已有 uninstall.js，跳过下载。
   - 否则先用 curl 下载：
     curl -fsSL -o uninstall.js https://raw.githubusercontent.com/byxumi/dsh-reasoning-effort/main/uninstall.js
   - 如果 curl 不可用（Windows 旧系统），改用 PowerShell：
     Invoke-WebRequest -Uri https://raw.githubusercontent.com/byxumi/dsh-reasoning-effort/main/uninstall.js -OutFile uninstall.js
2. 运行（会清理 pi-ai 补丁、settings.yaml 推理声明和 Profile 配置，一步到位）：
   node uninstall.js --all
3. 如果 node 也不可用，直接告诉我"缺少 Node.js 环境"，不要硬装。

运行后告诉我结果，并提醒我手动重启 DSH Web Host。

#### Agent 获得的提示词

插件安装并重启后，Agent 会自动获得以下提示词能力：

1. 注册 reasoning-effort skill——模型可调用它查看完整使用说明 2. 系统提示词注入——每次对话的系统提示中加入 Reasoning Effort 段落，Agent 会主动知道推理强度是由用户在模型选择器 Effort 菜单中控制的

安装后，你可以在新会话中直接问 Agent：*"你能控制推理强度吗？"*，Agent 会回答它知道这个功能并指导你使用。

功能

所选等级会以 reasoning_effort 参数随请求发送给模型网关。

插件做了什么

1. 注册推理等级 skill（reasoning-effort），可被模型/用户调用查看说明 2. 最关键的是：作为 profile bundle 挂载后，配合 settings.yaml 中模型声明的 reasoningEfforts，官方模型选择器自动显示 Effort 入口

配置模板

llm-pi-ai:
  providers:
    你的provider:
      api: openai-completions
      baseURL: https://your-gateway/v1
      models:
        - id: your-model
          name: your-model
          compat:
            supportsReasoningEffort: true
            supportsDeveloperRole: false
            supportsStore: false
            maxTokensField: max_tokens
          reasoningEfforts:
            off: null
            low: low
            medium: medium
            high: high
            xhigh: xhigh
            max: max

> supportsDeveloperRole: false 避免 pi-ai 把 system 改成 developer role。 > supportsStore: false / maxTokensField: max_tokens 让请求体匹配 OpenAI 兼容网关。

卸载

一步完成（清理 pi-ai 补丁 + settings.yaml 推理声明 + Profile 配置）：

node uninstall.js --all

> 注意：uninstall.js 位于插件包内，运行前请先确认当前目录或全局可访问。 > 如果只想移除 Profile 插件行而不清理配置，可用 dsh plugin --profile web remove dsh-reasoning-effort， > 但推理声明会保留，需配合上面的脚本才彻底。

问题排查

---

License

[MIT](LICENSE)

社区文档

• [贡献指南](CONTRIBUTING.md)
• [行为准则](CODE_OF_CONDUCT.md)
• [安全政策](SECURITY.md)