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