dsh-reasoning-effort
September 8, 2026 · View on GitHub
在 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 里自己声明的模型,插件才会给指引:
- 打开模型菜单。若当前模型是你自定义声明、且目录读不到档位(或声明与知识库不符),菜单里会出现 查看档位声明指引;
- 面板展示建议档位(知识库命中时,如 GLM-5.2 的 minimal/low/medium/high)、一段可直接复制的完整条目 YAML(含
- id:行,原有 name 等字段自动保留)以及 settings.yaml 的路径; - 复制后用其整体替换 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
注意:插件只提供片段,不会替你修改任何配置;内置目录里的档位集合(即使只有一档)也不会被标记——那是上游的刻意数据。
大肥鱼滑块
插件默认启用八帧奔跑小人作为滑块按钮。若想换回纯白按钮:
- 打开 设置 → 通用设置。
- 找到“外观”下方的 大肥鱼滑块。
- 关闭开关,再回到模型入口。
大肥鱼只替换按钮外观,不改变档位吸附、键盘控制、辐射特效或模型选择。拖动时动画会自动加速;系统启用“减少动态效果”后会停留在稳定帧。
同一页面中的 推理强度滑块 总开关可以临时关闭整个增强控件。关闭后无需卸载,DSH 原生模型选择器会立即恢复。两个开关都只保存在当前浏览器。
常见问题
安装后看不到滑块
请依次确认:
- 使用发行说明中的目标 RC 与对应插件版本;
0.7.1包含 DSH0.1.2-rc.1的模型控件注入修复。 - 安装后已经重启 DSH Web Host。
- 设置 → 通用设置 → 推理强度滑块 处于启用状态。
- 当前模型在 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