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

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

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

版本支持政策

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

建议使用发行说明中注明的 RC 版本。如需继续使用 alpha，请自行进行临时适配。RC 仍属于候选发布版本，不代表所有历史或未来 RC 都自动兼容。

项目	当前说明
插件发行版	v0.7.1
本次修复目标	DSH 0.1.2-rc.1，Web Profile
验证范围	类型检查、国际化检查和构建通过；浏览器实测待完成
alpha 版本	不单独适配，请自行临时修复或切换至目标 RC

安装与更新

1. 安装固定发行版

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

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 帮你安装：复制这段提示词

请为 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 里追加到插件自己的命名空间即可，条目优先于内置：

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. 关闭开关，再回到模型入口。

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

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

常见问题

安装后看不到滑块

请依次确认：

1. 使用发行说明中的目标 RC 与对应插件版本；0.7.1 包含 DSH 0.1.2-rc.1 的模型控件注入修复。
2. 安装后已经重启 DSH Web Host。
3. 设置 → 通用设置 → 推理强度滑块 处于启用状态。
4. 当前模型在 DSH 模型目录中公开了至少两档推理强度（未声明的模型见下一条），且部署没有关闭 thinking。

模型没有声明档位怎么办

先查看模型菜单中的 查看档位声明指引。若需要手动配置，请根据当前模型和端点文档填写 settings.yaml 中对应模型的 reasoningEfforts 与 compat，不要直接套用其他模型的档位或上下文参数。

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

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

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

如何确认插件已经载入

运行：

dsh --profile web --dump-config

配置中应当出现 name: dsh-reasoning-effort。

如何卸载

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

卸载后重启 DSH 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