dsh-reasoning-effort

把 Codex 风格的“模型 + 推理强度”控件直接带进 DeepSeek Harness。

English · 最新发行版 · 反馈问题

在 DSH 输入框下方切换模型、拖动推理强度，并让八帧“大肥鱼”随拖动加速。档位来自当前模型，选择结果与 /model 命令保持同步。

• 跟随模型档位：自动适配档数、名称和顺序，提交失败时回滚。
• 贴合 DSH 界面：支持深浅主题，简体中文与英文跟随 DSH 语言即时切换。
• 可选动态外观：默认启用大肥鱼，支持普通按钮及系统“减少动态效果”设置。
• 自定义模型指引：提供可复制的配置片段，并可一键复制整份简报交给 Agent 排查并代填。

本次更新 · 安装与更新 · 桌面端安装 · 版本支持 · 外观设置 · 常见问题

v0.8.1 更新内容

• 模型与推理强度菜单采用 DSH 原生的半透明背景、背景模糊和浮层阴影，浅色与深色均跟随当前主题。
• 修正无效的背景变量，移除额外的实体边框，让弹层外观更贴合 DSH 自带界面。
• 修正警告提示的主题变量名称，使文字与背景颜色正确适配主题。

菜单的位置、尺寸、打开动画及交互方式保持不变。

完整记录见 v0.8.1 发布说明 和 CHANGELOG。

版本支持政策

本插件仅针对相对稳定的 DSH RC 版本进行适配、测试和问题修复，不单独维护 alpha 版本。alpha 阶段的客户端 API、依赖结构和插件加载机制可能频繁发生破坏性变更；持续兼容多个过渡版本会增加维护成本，也难以保证可靠性。

当前发行版为 插件 v0.8.1，支持 DSH 0.2.0-rc.1 的 Web Profile，以及 DSH 0.2.0-rc.2 的 Web 和 Desktop Profile。桌面端使用 DSH 的 Web 客户端界面，但有独立的插件安装与激活状态。DSH 0.1.x 用户请继续使用 v0.7.3。RC 仍属于候选发布版本，不代表所有历史或未来 RC 都自动兼容。

安装与更新

Web：安装固定发行版

在你启动 DSH 时使用的终端环境执行：

dsh plugin --profile web add github:HanaAyane/dsh-reasoning-effort#v0.8.1
dsh --profile web --dump-config

确认输出中出现 name: dsh-reasoning-effort。已有安装也使用同一条 add 命令更新。开发体验可将 #v0.8.1 换成 #main，但主分支可能包含未发布改动。

也可以从 v0.8.1 Release 下载插件包。

请为 DeepSeek Harness 的 web Profile 安装 dsh-reasoning-effort v0.8.1。
只执行下面两条命令，不要修改其他 Profile：
dsh plugin --profile web add github:HanaAyane/dsh-reasoning-effort#v0.8.1
dsh --profile web --dump-config
确认配置中出现 dsh-reasoning-effort 后告诉我结果。
不要关闭或重启正在运行的 DSH；提醒我手动重启 Web Host 并刷新页面。

Web：重启并刷新

插件在 Web Host 启动时载入。安装完成后，手动重启 DSH Web Host，再刷新页面。

选择模型与强度

打开一个会话，点击输入框下方的模型入口。拖动滑块或点击轨道，释放后吸附到最近的有效档位；点击下方模型行可展开模型列表。

DSH 桌面端安装

适用于 DSH Desktop 0.2.0-rc.2。桌面端的插件保存在独立的 desktop Profile 中；安装在 web Profile 的插件不会自动出现在桌面端。

1. 先启动一次桌面应用，让它初始化 Desktop Profile，然后从应用菜单或系统托盘完全退出应用。仅关闭窗口可能仍让应用在后台运行。

2. 在桌面应用的 管理 dsh 命令… 中安装或修复其内置命令，打开新终端，确认 dsh --version 显示 0.2.0-rc.2。若电脑还装有 npm 版 dsh，用 Get-Command dsh 确认终端实际调用的是桌面版命令；Windows 也可以直接调用安装目录下的 resources/runtime/cli/bin/dsh.cmd。

3. 使用桌面版内置命令安装并检查插件：

   dsh plugin --profile desktop add github:HanaAyane/dsh-reasoning-effort#v0.8.1
   dsh plugin --profile desktop list
   

   确认列表中有 dsh-reasoning-effort，再重新打开桌面应用。已有安装使用同一条 add 命令更新。也可以在桌面应用内的插件管理器安装本插件；安装后按界面提示重新启动应用。

桌面应用的内置命令与单独 npm 安装的 dsh 有不同的运行时。请勿用 npm 版 dsh 修改 desktop Profile；桌面端启动后会从自己的 Profile 加载插件。DSH Desktop 官方说明 解释了两者的边界。

档位从哪里来

滑块读取当前模型在 DSH 模型目录中公开的 reasoning.efforts。档数、名称和顺序由模型与路由决定，并非固定三档，也不保证不同端点提供相同档位。

模型公开至少两档时显示滑块；不足两档时显示提示。插件提交目录中的档位值，由 DSH 校验和发送，不会绕过模型或部署的能力限制。

给任意自定义模型声明档位

这一节与厂商无关，适用于你在 llm-pi-ai 里自己声明的任何模型。

为什么读不到档位：DSH 的模型目录只报告适配器声明的能力。没有继承内置目录元数据的自定义模型，需要显式声明 reasoningEfforts 才能公开档位；目录没有档位并不证明端点不能推理。

怎么填：打开指引面板显示的配置文件（目标 Profile 的 cordis.patch.yml），在 llm-pi-ai 的对应模型条目下加 reasoningEfforts，并保持原有缩进。键是 DSH 档位，值是端点接受的写法；没写的档位视为不支持：

models:
  - id: <你的模型 id>
    reasoningEfforts:
      low: "<端点接受的取值>"
      high: "<端点接受的取值>"

什么时候还要加 compat（与 reasoningEfforts 平级，只在端点需要时写）：

不写 compat 时由适配器按端点地址自行判断：它不认识的地址按标准 OpenAI 处理，认识的厂商端点会自动套用该厂商的格式，所以猜错格式比不写更糟。

怎么验证：保存后检查配置解析和目录档位，再核对实际请求。滑块出现只说明目录已读到元数据，不能证明端点接受参数或强度确实改变。插件内置的知识条目只是参考，不是必要条件。

档位指引（自定义 provider）

DSH 内置路由的档位来自 pi-ai 目录，插件完全只读、绝不修改。只有你在 llm-pi-ai 配置里自己声明的模型，插件才会给指引：

1. 打开模型菜单。若当前模型是你自定义声明、且目录读不到档位（或声明与知识库不符），菜单里会出现 查看档位声明指引；
2. 面板展示建议档位（知识库命中时给出该模型记录的档位，未收录时给出通用模板）、按当前配置文件缩进生成的 YAML、文件路径与条目位置；
3. 按面板提示替换对应的 - id: 条目，或把字段块插入该条目；保留其他配置，保存后让 DSH 重新加载。若未生效，重启 Web Host 并刷新页面。

知识库未收录的模型会得到通用的、可直接修改的模板。遇到"端点因 developer 角色拒绝请求"之类的情况，面板会给出警告和对应的 compat 开关（例如提示 supportsDeveloperRole: false）。

不想自己填、想调整已有档位、或者配置后仍然报错，就点 复制给 Agent。你声明的模型即使已有有效档位，也会显示这个入口。复制内容包含当前路由、模型 ID、实际配置路径、条目位置、目录档位和通用声明规则；不会把内置知识库的预设档位或兼容字段作为建议配置交给 Agent。

把提示词发给你的 coding agent。它会先读取目标路由的实际 api / baseURL，查证端点官方文档，区分力度枚举、思考开关、token 预算和别名，再最小修改目标模型条目。资料不足时询问缺失信息；无法访问文件时提供补丁。提示词要求保留已有配置，并分别报告配置解析、目录元数据和实际请求的验证结果。

内置条目只覆盖少数模型，作用仅是省去手填。要补充其他模型，在 Profile 中已有 id: reasoning-effort 条目的 config 下添加 entries。下面只展示相对内容，粘贴时保持所在条目的缩进；用户条目优先于内置：

entries:
  - id: my-model
    provider: "*"          # provider 路由名，* 通配
    model: "my-model-id"   # 模型 id，* 通配
    note: 说明文字
    efforts:               # 档位名 → 端点实际接受的取值
      low: "low"
      high: "high"
      max: "max"
    # compat:              # 只在端点需要固定格式时才写
    #   thinkingFormat: "qwen"
    #   supportsReasoningEffort: false

条目里的 compat 会原样写进生成的片段，所以只在端点确实需要固定格式时才填：不填时适配器按端点地址自行判断（未识别地址按标准 OpenAI，已识别厂商自动套用该厂商格式），写错格式会覆盖掉这个正确判断；而在不接受该字段的协议上（例如 anthropic-messages），粘贴后那条路由会直接解析失败。

注意：插件只提供片段，不会替你修改任何配置；内置目录里的档位集合（即使只有一档）也不会被标记——那是上游的刻意数据。

大肥鱼滑块

插件默认启用八帧奔跑小人作为滑块按钮。若想换回纯白按钮：

1. 打开 设置 → 通用设置。
2. 找到“外观”下方的 大肥鱼滑块。
3. 关闭开关，再回到模型入口。

大肥鱼只替换按钮外观，不改变档位吸附、键盘控制、辐射特效或模型选择。拖动时动画会自动加速；系统启用“减少动态效果”后会停留在稳定帧。

同一页面中的 推理强度滑块 总开关可以临时关闭整个增强控件。关闭后无需卸载，DSH 原生模型选择器会立即恢复。两个开关都只保存在当前浏览器。

常见问题

安装后看不到滑块

请依次确认：

1. 确认实际运行版本与上面的支持表一致；桌面端可在 关于 DeepSeek Harness 中查看版本。
2. 安装后已经重启对应的 Web Host 或完全退出并重新打开桌面应用。
3. 设置 → 通用设置 → 推理强度滑块 处于启用状态。
4. 当前模型在 DSH 模型目录中公开了至少两档推理强度（未声明的模型见下一条），且部署没有关闭 thinking。

模型没有声明档位怎么办

先查看模型菜单中的 查看档位声明指引。若需要手动配置，请根据面板给出的实际文件路径和当前模型、端点文档填写对应条目的 reasoningEfforts 与 compat，不要直接套用其他模型的档位或上下文参数。

知识库只提供参考；实际支持的取值以端点能力为准。保存后若未生效，重启 Web Host 并刷新页面。

RC 版本仍有问题，如何反馈

请在 Issue 中附上 DSH 版本、插件版本、客户端类型（Web 或桌面封装）、复现步骤，以及相关控制台报错。报告前请隐去令牌和凭据。

如何确认插件已经载入

运行：

dsh --profile web --dump-config

Web 配置中应当出现 name: dsh-reasoning-effort。桌面端请在应用完全退出后使用其内置命令运行 dsh plugin --profile desktop list，确认列表中有插件。

如何卸载

dsh plugin --profile web remove dsh-reasoning-effort

桌面端请在应用完全退出后使用桌面版内置命令运行 dsh plugin --profile desktop remove dsh-reasoning-effort。卸载后重启对应的 Web Host 或桌面应用，原生模型选择器会自动恢复。

开发与构建

pnpm install
pnpm run check
pnpm pack

开发环境使用 Node.js 22.19+（同时满足目标 DSH 的要求）和 pnpm@11.7.0。pnpm run check 会进行 TypeScript 与国际化校验，并重建 Host 入口、浏览器模块及类型声明。完整交互与颜色约定见 design/visual-spec.md，安全问题请按照 SECURITY.md 报告。

许可证

MIT © HanaAyane