dsh-reasoning-effort 为 DeepSeek Harness 提供 Codex 风格的模型与推理强度滑块

# dsh-reasoning-effort **把 Codex 风格的“模型 + 推理强度”控件直接带进 DeepSeek Harness。** [English](README.en.md) · [最新发行版](https://github.com/HanaAyane/dsh-reasoning-effort/releases/latest) · [反馈问题](https://github.com/HanaAyane/dsh-reasoning-effort/issues) [![v0.7.1](https://img.shields.io/badge/release-0.7.1-6f83ff?style=flat-square)](https://github.com/HanaAyane/dsh-reasoning-effort/releases/tag/v0.7.1) [![DSH RC](https://img.shields.io/badge/DSH-RC-8b5cf6?style=flat-square)](#版本支持政策) [![MIT License](https://img.shields.io/badge/license-MIT-536990?style=flat-square)](LICENSE)

在 DSH 输入框下方切换模型、拖动推理强度，并让八帧“大肥鱼”随拖动加速。档位来自当前模型，选择结果与 `/model` 命令保持同步。 - **跟随模型档位**：自动适配档数、名称和顺序，提交失败时回滚。 - **贴合 DSH 界面**：支持深浅主题，简体中文与英文跟随 DSH 语言即时切换。 - **可选动态外观**：默认启用大肥鱼，支持普通按钮及系统“减少动态效果”设置。 - **自定义模型指引**：提供可复制的配置片段，由你确认并保存。推理强度选择器在 DeepSeek Harness 深色和浅色主题中的真实效果

[安装与更新](#安装与更新) · [版本支持](#版本支持政策) · [外观设置](#大肥鱼滑块) · [常见问题](#常见问题) ## 版本支持政策本插件仅针对相对稳定的 **DSH RC 版本**进行适配、测试和问题修复，**不单独维护 alpha 版本**。alpha 阶段的客户端 API、依赖结构和插件加载机制可能频繁发生破坏性变更；持续兼容多个过渡版本会增加维护成本，也难以保证可靠性。当前支持 **DSH `0.1.5-rc.1`**，继续使用插件 **`v0.7.1`** 即可，无需额外适配。如需继续使用 alpha，请自行进行临时适配。RC 仍属于候选发布版本，不代表所有历史或未来 RC 都自动兼容。 | 项目 | 当前说明 | | --- | --- | | 插件发行版 | [v0.7.1](https://github.com/HanaAyane/dsh-reasoning-effort/releases/tag/v0.7.1) | | 当前兼容版本 | DSH `0.1.5-rc.1`，Web Profile | | v0.7.1 原始修复目标 | DSH `0.1.2-rc.1` 的模型控件注入错误 | | 升级说明 | 插件保持兼容，继续使用 `v0.7.1`，无需修改插件代码 | | alpha 版本 | 不单独适配，请自行临时修复或切换至目标 RC | ## 安装与更新 ### 1. 安装固定发行版在你启动 DSH 时使用的终端环境执行： ```powershell dsh plugin --profile web add github:HanaAyane/dsh-reasoning-effort#v0.7.1 dsh --profile web --dump-config ``` 确认输出中出现 `name: dsh-reasoning-effort`。已有安装也使用同一条 `add` 命令更新。开发体验可将 `#v0.7.1` 换成 `#main`，但主分支可能包含未发布改动。

让 Agent 帮你安装：复制这段提示词

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

### 2. 重启并刷新插件在 Web Host 启动时载入。安装完成后，手动重启 DSH Web Host，再刷新页面。 ### 3. 选择模型与强度打开一个会话，点击输入框下方的模型入口。拖动滑块或点击轨道，释放后吸附到最近的有效档位；点击下方模型行可展开模型列表。 ## 档位从哪里来滑块读取当前模型在 DSH 模型目录中公开的 `reasoning.efforts`。档数、名称和顺序由模型与路由决定，并非固定三档，也不保证不同端点提供相同档位。模型公开至少两档时显示滑块；不足两档时显示提示。插件提交目录中的档位值，由 DSH 校验和发送，不会绕过模型或部署的能力限制。 ## 档位指引（自定义 provider） DSH 内置路由的档位来自 pi-ai 目录，插件**完全只读、绝不修改**。只有你在 `settings.yaml` 的 `llm-pi-ai` 里自己声明的模型，插件才会给指引： 1. 打开模型菜单。若当前模型是你自定义声明、且目录读不到档位（或声明与知识库不符），菜单里会出现 **查看档位声明指引**； 2. 面板展示建议档位（知识库命中时，如 GLM-5.2 的 minimal/low/medium/high）、一段可直接复制的完整条目 YAML（含 `- id:` 行，原有 name 等字段自动保留）以及 settings.yaml 的路径； 3. 复制后用其**整体替换** settings.yaml 里对应的 `- id:` 条目（不要复制出第二个 `llm-pi-ai:` 根）并保存。DSH 会自动加载；若未生效，重启 Web Host 并刷新页面。知识库未收录的模型会得到带注释的通用模板，按端点文档填值即可。遇到"端点因 developer 角色拒绝请求"之类的情况，面板会直接给出警告与替代建议（例如阿里云百炼端点建议改用内置 zai 路由）。

高级配置：扩展插件知识库

内置知识库目前收录 GLM-5.2（`minimal/low/medium/high`）与 Kimi K3（`low/high/max`）。要补充其他模型，在 `settings.yaml` 里追加到插件自己的命名空间即可，条目优先于内置： ```yaml dsh-reasoning-effort: entries: - id: my-model provider: "*" # provider 路由名，* 通配 model: "my-model-id" # 模型 id，* 通配 note: 说明文字 efforts: # 档位名 → 端点实际接受的取值 low: "low" high: "high" max: "max" compat: # 仅 openai-completions 路由需要 thinkingFormat: "openai" supportsReasoningEffort: true ``` 注意：插件只提供片段，**不会替你修改任何配置**；内置目录里的档位集合（即使只有一档）也不会被标记——那是上游的刻意数据。

## 大肥鱼滑块插件**默认启用**八帧奔跑小人作为滑块按钮。若想换回纯白按钮： 1. 打开 **设置 → 通用设置**。 2. 找到“外观”下方的 **大肥鱼滑块**。 3. 关闭开关，再回到模型入口。 DeepSeek Harness 通用设置中的推理强度滑块和大肥鱼滑块开关

大肥鱼只替换按钮外观，不改变档位吸附、键盘控制、辐射特效或模型选择。拖动时动画会自动加速；系统启用“减少动态效果”后会停留在稳定帧。同一页面中的 **推理强度滑块** 总开关可以临时关闭整个增强控件。关闭后无需卸载，DSH 原生模型选择器会立即恢复。两个开关都只保存在当前浏览器。 ## 常见问题 ### 安装后看不到滑块请依次确认： 1. 用 `dsh --version` 确认实际运行版本；DSH `0.1.5-rc.1` 可继续搭配插件 `v0.7.1` 使用。 2. 安装后已经重启 DSH Web Host。 3. **设置 → 通用设置 → 推理强度滑块** 处于启用状态。 4. 当前模型在 DSH 模型目录中公开了至少两档推理强度（未声明的模型见下一条），且部署没有关闭 thinking。 ### 模型没有声明档位怎么办先查看模型菜单中的 **查看档位声明指引**。若需要手动配置，请根据当前模型和端点文档填写 `settings.yaml` 中对应模型的 `reasoningEfforts` 与 `compat`，不要直接套用其他模型的档位或上下文参数。知识库只提供参考；实际支持的取值以端点能力为准。保存后若未生效，重启 Web Host 并刷新页面。 ### RC 版本仍有问题，如何反馈请在 [Issue](https://github.com/HanaAyane/dsh-reasoning-effort/issues) 中附上 DSH 版本、插件版本、客户端类型（Web 或桌面封装）、复现步骤，以及相关控制台报错。报告前请隐去令牌和凭据。 ### 如何确认插件已经载入运行： ```powershell dsh --profile web --dump-config ``` 配置中应当出现 `name: dsh-reasoning-effort`。 ### 如何卸载 ```powershell dsh plugin --profile web remove dsh-reasoning-effort ``` 卸载后重启 DSH Web Host，原生模型选择器会自动恢复。 ## 开发与构建 ```powershell 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](design/visual-spec.md)，安全问题请按照 [SECURITY.md](SECURITY.md) 报告。 ## 许可证 [MIT](LICENSE) © HanaAyane