dsh-effort-dial
dsh-effort-dial
DeepSeek Harness（DSH）插件：输入框里的「推理强度滑杆」。
拖动鲸鱼娘选择思考档位，松手吸附到停位并写入当前会话；支持「自动区间」（在选定区间内按失败升级派档）、
可选「模型路由」（按任务类型挑 provider/model）。档位数不写死，跟着模型声明的 reasoningEfforts 走。
功能
- 档位自适应：读当前模型声明的思考档（过滤
off/auto），声明几档就画几根刻度，顺序固定 minimal → max。
- 鲸鱼娘滑块：8 帧奔跑立绘（悬停/拖拽时跑），松手吸附；位置与刻度由同一套百分比坐标驱动。
- 三级特效：
medium 及以下：只有轨道底纹与进度；xhigh：2 段波形 + 6 条粒子 + 弱光晕；max：3 段波形 + 峰尖 + 像素噪点 + 14 条粒子 + 十字光带 + 呼吸脉冲。
- 自动区间：
A 键开关；区间内无错误停在下限，1 次工具错误升一档，2 次及以上再升一档，封顶上限。
胶囊显示 medium→max · xhigh（区间 + 宿主上一轮实际跑的档位）。
- 模型路由：
routine / deep 两个桶各自绑定 provider/model 与区间；按用户消息里的 cue 分类，
一次分类同时决定「用哪个模型」与「档位区间」；目标模型没声明的档位会就近收敛。
- 设置页（设置 → 推理强度滑杆）：动画开关、A 按钮显隐、轨道宽度、自动区间上下限与预览、模型路由。
- 失败可见：写入被宿主拒绝时胶囊红框并显示原因，不再静默回弹。
交互
| 操作 | 行为 |
|---|
| 拖动轨道 | 跟手（拖拽时无过渡、同步落位），松手吸附并提交 |
← / →（↑ / ↓） | 微调一档 |
PageUp / PageDown | 跳两档 |
Home / End | 到最低 / 最高档 |
A 键 / 点 A / 点标签 | 切换自动区间（区间在设置页调） |
| 双击轨道 | 回到自动区间 |
安装
# 从 npm（推荐）
dsh plugin --profile <profile> add @zengevent/dsh-effort-dial
# 本地目录
dsh plugin --profile <profile> add /path/to/dsh-effort-dial
# 或本仓库内（DSH 宿主）
# plugin_manager install_bundle file:/path/to/dsh-effort-dial
装完重启 DSH（bundle 只在宿主启动时装载）。要求 dsh >= 0.2.0-rc.1。
配置写入 profile 的 .effort-dial/state.json（区间、路由、每会话最近一次派档）。
模型前提
宿主只接受 off / minimal / low / medium / high / xhigh / max 七个档位键；写别的键（例如把网关的
ultra 当键）会让整条模型配置校验失败。ultra 这类只存在于网关线缆层的值，只能作为「值」绑到合法键上。
测试
node test/contract.test.mjs # 契约预检：客户端工厂 id / 补丁 name 必须等于包名
node test/band.test.mjs # 策略与提取的纯函数单测
./test/run.sh # 真实 React + DOM 渲染与交互断言（headless Chrome 截图）
test/dial.test.html 覆盖：渲染、拖动提交、被拒回弹、父级重渲染下仍跟手、区间编辑与同步、
实际档位显示与定位、三级特效的像素能量比较。
结构
| 文件 | 作用 |
|---|
lib/client.js | 浏览器半边：胶囊、滑块、特效、设置页 |
lib/index.js | 宿主半边：区间状态、agent/request 派档、路由、/effort-dial/state 与 /effort-dial/band |
lib/policy.js | 纯函数：任务分类、区间派档、模型能力收敛、路由解析 |
test/ | 单测与界面断言 |
License
MIT
