dsh-codex-effort-slider
给 DeepSeek Harness（DSH）用的 Codex 风格推理等级滑条。
一档一色、越往右越"通电"：填充从蓝渐变到紫罗兰，高档位亮起紫色星云与星尘粒子，
连官方那一行的数值文字也跟着变色（Off 档保持官方灰）。
怎么用
- 拖：在模型菜单里那条滑条上按住拖动 —— 跟手连续运动，拖到哪一档就即时变成哪一档
（滑过档位边界就把官方档位切过去，不用等松手）。
- 右键：在滑条上点右键打开设置面板 👇
- 设置即时生效并记住；出问题时点一下「复制诊断」把逐帧记录导出。
右键滑条打开设置面板：动画（简洁/完整）、已到达档位的刻度点（亮白/同色/隐藏）、复制诊断 / 恢复默认 / 关闭
| 设置项 | 可选 | 说明 |
|---|
| 动画 | 简洁动画 / 完整动画 | 两种都不受系统「减少动态效果」影响（否则系统一开就退化成"瞬跳"）。完整动画更跟手、惯性更长；简洁动画更干脆 |
| 已到达档位的刻度点 | 亮白显示 / 与未到达同色 / 隐藏 | 控制轨道上那些定位小点的可见性 |
| | 复制诊断（逐帧记录，反馈问题时用）/ 恢复默认 / 关闭 |
装好之后长这样（真机截图）
收起态：档位就在输入框里那枚模型席按钮上，点开之前也按档位着色。
收起态：输入框里的档位显示
点开模型菜单后（左列浅色主题 / 右列深色主题，四档从上到下）：
对比度都算过（最高档的数值文字：白底 4.23:1、深色底 4.02:1）。
不用安装也能先玩：浏览器打开 preview/panel.html，可拖动、切浅深色、切 4/2/6 档模型
（另有脚本生成的实现示意图：preview/seat-color.png、preview/distribution.png）。
它不新增入口：直接改造官方模型菜单里的「推理等级」那一行 ——
那一行被加高上下内距、允许折行，滑条作为第二行铺满整行宽度；拖到最高档时整条轨道亮起紫色能量层。
点开官方模型菜单后：
┌────────────────────────────────────┐
│ 模型 DeepSeek-V41-Flash › │ ← 官方原样
├────────────────────────────────────┤
│ 推理等级 Max › │ ← 官方原样（label / value / chevron 一个没动）
│ ●━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │ ← 插件注入的滑条（这一行因此被加高）
└────────────────────────────────────┘
输入框工具行：**不加任何东西**（没有胶囊、没有浮层）
拖到最高档：轨道变为紫色星云（流向渐变 + 扫光 + 22 颗错峰星尘粒子），那一行同时描一圈紫边。
30 秒上手：下载/克隆本仓库 → 双击 install.cmd（或按下面的「安装」一节）→
完全退出并重开 DSH Desktop。
安装
首选:npm 一条命令（已发布到 registry）
# 非 desktop profile
dsh plugin --profile <你的 profile> add dsh-codex-effort-slider
DSH Desktop 用户：桌面版的 profile 由 Electron 独占管理，命令行装不了它 —— 请走
设置 → 插件 → 添加插件，在输入框里填 dsh-codex-effort-slider（包名，现在直接走 npm），
或填 github:Microqian2th/dsh-codex-effort-slider，点安装，完全退出并重开 DSH Desktop。
装出来的就是上面那组真机截图的样子。
不想用 npm 也没问题 —— 下面两条路一样有效。
直接下载打包好的 zip：Releases → 最新版。
只走 DSH Desktop 自己的插件面板——命令行装不了 desktop profile：
dsh plugin --profile desktop add link:"F:\Work Space\DeepSeek Harness\dsh-codex-effort-slider"
# error: profile "desktop" is managed exclusively by the Electron application
（这不是配置问题：bin.js 里对 desktop 直接 program.error，只有 Electron 应用本人被允许管理这个保留 profile。）
两条路：
- 面板安装（推荐）：设置 → 插件 → 添加插件 → 填本地目录路径 → 安装 → 重启 DSH Desktop。
面板会校验两件事，本插件都已满足：是有效的插件包、声明了组合包（
dsh.bundle.patch）。
- 手工安装（当面板本身不可用时——例如
profileContext 没挂上，dsh-base 会把
plugin-manager 整行 disabled，设置侧栏里就看不到「插件」）：
备份 profile 的 package.json → 加一条 link: 依赖 → dsh.profile.bundles 追加本包名 →
在 profiles/<profile>/node_modules/ 下建一个指向本目录的 junction → 重启。
卸载用面板；手工装的用 cmd /c rmdir <junction>（不要用 Remove-Item -Recurse，
那可能顺着 junction 把插件目录里的文件删掉）。
想先看观感、不装也行：node preview/make-preview.mjs 生成 preview/panel.html，
用浏览器打开即可拖动、切浅深色、切 4/2/6 档模型（页面里连官方菜单外壳都复刻了，
CSS 与拖动数学都是从真产物抽出来的）。
分享给别人
打包
npm run pack # = powershell -NoProfile -ExecutionPolicy Bypass -File pack-dist.ps1
产出 dist/dsh-codex-effort-slider-<version>.zip（约 350 KB）。本插件零运行时依赖、无构建步骤 ——
解开就能装，接收方不需要 pnpm install。若要让人从 GitHub / npm 装，把本目录的内容推到仓库根
（package.json 必须在仓库根，pnpm 才能把它当包解析）。
接收方怎么装（三种，按省事程度排序）
- 面板安装（推荐）：DSH Desktop → 设置 → 插件 → 添加插件，填三者之一：
- 本地目录路径（解开 zip 后那一层目录）
github:<用户名>/<仓库>（面板会先做一次 GitHub 连接检查，再交给 pnpm 拉取）- npm 包名
dsh-codex-effort-slider（已发布，走 registry；DSH 默认已配 npm 镜像作为回退）
- 命令行（只有非 desktop profile 能这么装）：
dsh plugin --profile tui add link:"<插件的绝对路径>"
dsh plugin --profile tui add github:<用户名>/<仓库>
desktop 是 Electron 保留 profile，命令行会被直接拒绝
（error: profile "desktop" is managed exclusively by the Electron application）。
- 脚本（desktop profile 且设置里没有「插件」面板时）：
install.cmd # 装进 desktop
install.cmd -Profile tui # 装进别的 profile
install.cmd -Uninstall # 卸载
install-profile.ps1 做四件事：备份 profile 的 package.json → 加一条 link: 依赖 →
把包名追加进 dsh.profile.bundles → 在 profile 的 node_modules 下建链接
（Windows 用 junction，其它平台用符号链接），最后校验这三项都成立。
已用一个假 profile 完整跑过安装与卸载，并确认卸载只删链接、不会顺着链接删掉插件本体。
注意事项
link: 里是绝对路径，所以每台机器装完都必须指向自己的目录（面板/脚本会自动写对）。- 改过
lib/client.js 后必须完全退出并重开 DSH Desktop 才生效 —— 宿主在启动时把插件读进内存，
只关窗口不够。
- 卸载：面板卸载，或
install.cmd -Uninstall；手工建过 junction 的用 cmd /c rmdir <junction>。
不要用 Remove-Item -Recurse，它可能顺着链接把插件目录里的文件删掉。
- 兼容性：DOM 锚点全部是官方语义属性（
aria-haspopup / aria-expanded / aria-controls / role）
加两个官方 class；哈希前缀不依赖（收起态那段档位文字是按文字认的）。官方若改语义，插件
静默不生效（fail-open），不会把官方界面改坏。本插件不注册任何宿主钩子、不注入消息
（测试里有 ctx.on 监视断言守着这一点）。
- 许可 MIT（见
LICENSE）。package.json 已去掉 "private"，并发布在 npm 上：dsh-codex-effort-slider。
它怎么工作（两半）
| 半边 | 干什么 |
|---|
lib/index.js（宿主） | 空逻辑 + 一次客户端产物静态核对。存在的唯一理由是让本包成为 cordis 树上的一行，否则 dsh.client 的 bundle 不会被扫进启动图 |
lib/client.js（客户端） | 一个不可见锚点（注册进 conversation.input.right，用来拿 sessionId 与 ctx）+ DOM 桥 + 滑条（react-dom portal 注入官方那一行） |
DOM 桥依赖的官方锚点（全部是语义属性，不是哈希 class）
| 锚点 | 官方产物里的形状 |
|---|
席：button[aria-haspopup="menu"][aria-expanded="true"] | <button aria-haspopup="menu" aria-expanded={open} aria-controls={…}> |
菜单：席的 aria-controls → getElementById(…) | 菜单 id={…-menu}，portal 到 body |
目标行：菜单里 button[role="menuitem"] 的第 2 个 | 根面板恰好两行（模型 / 推理等级）；子面板用 menuitemradio，所以 menuitem 唯一标识根面板 |
归属判定：从自己的锚点向上找 [data-composer-card] | composer 卡片带这个标记；打开的那颗席必须在自己的 composer 里 |
只改那一行：写 4 个内联样式（height:auto / flex-wrap:wrap / padding-block:10px）+ append 一个容器；
关菜单或插件卸载时逐个还原。不碰官方 class、不改官方文字与 chevron。
fail-open：任何一步认不出（没有 aria-controls、不是根面板、不是自己的 composer、
目录里没有档位、会话作用域没就绪）就什么都不做 —— 官方菜单保持原样，绝不会因为本插件点不开。
官方菜单是"测量后固定定位"的，插件加高那一行后会派发一次 resize，
官方自己的 place() 会重新读 offsetHeight 并重新夹取位置。
数据路径（只用官方公开面）
| 用途 | 接口 |
|---|
| 读档位 | directoryFor(sessionId).store.getSnapshot() → groups[].models[].reasoning.efforts |
| 写档位 | directory.select({ provider, model, reasoningEffort })（与官方菜单同一写入口） |
| 订阅 | store.subscribe() + React.useSyncExternalStore |
色彩与粒子（由位置连续驱动，与档位数无关）
拖到哪，颜色与粒子就跟到哪。三个纯函数（都有断言）：
位置 pct | 颜色 fillColorFor | 能量 energyFor | 粒子数 particleCountFor | 速率 speedFor |
|---|
| 0（第一档） | 蓝 #4d93f8 | 0 | 0 | 0.35× |
| 1/3（第二档） | 蓝（第一档到第二档恒为蓝） | 0 | 0 | 0.35× |
| 2/3（high） | 紫 #9333ea | 0.5 | 11 / 22 | 1×（就是"现在这个速度刚刚好"） |
| 1（max） | 深紫 #4c1d95 | 1 | 22 / 22 | 2× |
- 颜色：填充层是
linear-gradient(90deg, 蓝, 当前位置的颜色) —— 左端恒为蓝、右端是当前位置的颜色，
所以 high 档自然呈现"左蓝右紫"，越往右右端越深（深紫 #4c1d95）。
- 能量层（紫色星云 + 扫光）强度 =
energyFor，它在第二档以前是 0 —— 所以左半段是干净的蓝，
往右才逐渐"通电"；官方那一行的紫边透明度也跟着能量走（0.16 + 0.34 × energy）。
- 能量条只覆盖已填充那一段：能量层宽度与填充层完全相同（都到旋钮圆心），
所以档位右边没达到的部分不会出现能量条，只剩轨道底色。
- Off 档在"两个界面"里都保持官方灰（
isOffLevel + valueColorFor 返回空串）：
Off 档时既不给菜单里那一行的数值文字上色，也不给收起态席按钮上的档位文字上色 ——
空串 = 不写内联色 = 官方原本的颜色。档位是不是"关"按 id 和 name 都认（off/none/关闭/无，
大小写与空格不敏感；DeepSeek 的真实档位表见 dsh-llm-deepseek/lib/index.js 的 REASONING_EFFORTS）。
Off 档本身也没有能量层（energy 0 → 纯蓝、无星云、无星尘）。
- 刻度点更小更淡（用户要求）：
5px → 3px；已达刻度 rgba(255,255,255,.92) → .5，
未达刻度 color-mix(... 38% → 26%)。改小改淡之后它们不再和星尘粒子抢眼。
- 星空（所有出现粒子的档位都用这一套，动画已统一）：
- 不消失：外层是一条整轨宽度的轨道，自己在做
translate3d(-100%) 的连续横穿；
残影只在 0%/6% 与 94%/100% 淡出淡入 —— 那两端在可视区外，所以看起来星星从不消失。
（旧的"短掠过 + 原地淡出"那套逻辑与 CSS 已整体删除，有断言守着 .ces-particle / ces-drift 不再存在。）
- 亮度随机、越亮越大：每颗的亮度/大小系数由确定性伪随机给出，落在 0.5 ~ 1 之间
（1 = 3px 与亮度 100%）；圆点用
opacity:var(--ces-b) + transform:scale(var(--ces-b))，
所以"亮的那颗同时更大"。
- 速度随位置变化（保留）：横穿时长 =
STARFIELD_DURATION_MEAN × MAX_SPEED_FACTOR / speedFor(pct)
—— MAX 档 1.5s、high 档 3s、第二档附近约 8.6s（位置速率 2× / 1× / 0.35×）。
- 星星单独一层，不跟星云淡入：星云层（紫色渐变 + 扫光）的透明度 = 能量强度，high 档只有 0.5；
若星星套在里面，每颗的实际不透明度会被压到 0.25~0.5，在紫色底上几乎看不见
（用户实测反馈"high 档一打开几乎没粒子"）。所以星星放在
.ces-stars 独立层，
透明度 = starLayerOpacityFor（high 档 0.8、MAX 档 1.0），"逐渐出现"交给粒子数表达。
MAX 档观感与之前完全一致（都是 1.0），没有动。
- 各星之间只差 ±8%（
STARFIELD_DURATION_SPREAD）：保留"有的稍快有的稍慢"的层次，
又不会像原来 0.95–2.05s（速度差 2.16×）那样快星追上慢星排成一队。
- 高度 = 随机排列的等距槽位，并与相位解耦（8%~92% 用满轨道高度）：
早期版本高度和相位取自同一个数
frac((i+1)×φ)，于是"越靠右的星越高"，22 颗排成
一条斜线（用户实测反馈"太规整，再随机一点"；高度↔相位相关系数实测 ）。
现在高度是一条（哈希排序，不用 ），并自动挑一个盐值
保证（会一直并排在轨道上走）的两颗至少差 轨道高，不会并成一坨。
相关系数实测 （有断言守着 —— 旧版会直接失败）。
"聚集"的量化对照（模拟真产物参数，轨道 300×28px，两星中心距离 <6px 记为粘住）：
| t=0.2s（刚进档） | t=0.4s | t=1s | t=2s | t=3s |
|---|
| 3 对 → 0 对 | 1 对 → 0 对 | 4 对 → 2 对 | 7 对 → 4 对 | 4 对 → 0 对 |
长期行为（如实标注）：只要每颗星的时长不完全相同，相位就会缓慢互相错开，最终趋近随机分布
（22 颗里总会有几对偶尔靠近）。实测粘住对数随每颗星时长浮动变化：
| 每颗星时长浮动 | t=0.5s | t=1s | t=2s | t=5s |
|---|
| ±8%（当前） | 1 | 7 | 9 | 17 |
| ±4% | 0 | 2 | 7 | 10 |
| ±2% | 0 | 0 | 2 | 11 |
| 0%（全同速） | 0 | 0 | 0 | 0 |
也就是说：想彻底永不聚集，就把 STARFIELD_DURATION_SPREAD 设成 0（代价是所有星速度完全一致，
少了"有的快有的慢"的层次）；保留 ±8% 则偶尔会有几颗靠近一下再分开。这个数字由常量控制，随时可调。
- 官方那一行的数值文字（"Max" / "High"）也会跟着变色（
valueColorFor）：
与能量同源，蓝 → 靛 → 紫罗兰，越往右越"通电"。写的是内联 color（内联优先于官方样式表），
关菜单时由桥还原；文字内容一个字都不碰（断言：内容仍归官方管，标签与"模型"那一行完全不动）。
终点色 COLOR_TEXT_VIOLET = #8b5cf6 是照着对比度挑的：白底 4.23:1、深色底(#1b1c20) 4.02:1，
两种主题都读得清（先试过更亮的 #c084fc，浅色主题只有 2.6:1 发虚；测试里有对比度断言挡着）。
Off 档例外：不上色，保持官方灰（见上）。
- 收起态的模型席按钮（
DeepSeek-V41-Flash High ⌄，点开菜单之前就看得见那个档位）同样着色：
官方那一小段文字是 triggerEffort 这个哈希 class（前缀随构建变，靠 class 认迟早失效），
所以按文字认 —— 官方 trigger 里的文字就是档位的 name，和我们从目录读到的是同一份数据
（已对照官方源码 dsh-client-ui-model-selection/lib/client.js:860-867 确认那是个 <span>）。
传的是全部档位名而不是"当前那个"：档位刚切换、官方还没重渲染席按钮时文字还是旧的，
只认当前名字会在那一瞬间掉色。
- 席上显示的是已生效档位，所以拖动过程中它不跟着草稿跳，提交后才变（有断言）。
- 官方重渲染换了节点 → 桥在重新抓到的那一刻立刻补色（不必等 React 再渲染一次）。
- 组件卸载时还原；认不出任何已知档位名就什么都不做（fail-open：绝不动模型名等别的文字）。
prefers-reduced-motion：放缓而不是冻住 —— 收起扫光、粒子周期 ×2.6，并在滑条的 title
里说明原因（冻成静态图会让"能量在流动"这个表达整个消失）。- 配色跟随主题：轨道底色用
--dsw-alias-border-l1；浅色/深色都自动跟随。
旋钮几何（顶头适配）
旋钮是正圆，直径 = 轨道高度（TRACK_HEIGHT = KNOB_SIZE = 28px），
圆心只在 [14px, 宽度 − 14px] 之间移动：
left = calc(14px + pct × (100% − 28px)) ← 旋钮、填充终点、刻度共用这一个几何
所以 pct=0 时圆心落在左端圆角内、pct=1 时落在右端圆角内，圆永远是完整的圆
（之前圆心跑到两端之外，圆被官方菜单的 overflow:hidden 切掉右半边，
看起来就像个圆角方块 —— 这也是把直径加大到与轨道同高的原因）。
指针映射也用同一套内缩几何（pctAt），所以拖到最左/最右必定命中端点档位。
稳健性（每条都有断言）
directoryFor() 在会话作用域就绪前按设计抛错 → 退避重试（60ms 起，约 9 秒）+ 自愈；
档位数是后到的，桥会在档位数变化时主动重扫（DOM 不会因为 store 变化而产生 mutation）。- 写入失败 / 超时（10s）→ 回滚到真实档位并显示原因，不谎报成功。
- 拖动写入有同档位去重 + 在途合并 + 120ms 降频：1 秒内 60 次拖动最多 3 次写回，
落在当前档位时 0 次；松手必定落地。
- 滑条吞掉自己的 pointer/click/方向键事件，不会误触官方那一行的 onClick（那会跳进等级列表）。
- 组件卸载时清掉降频定时器；桥卸载时还原那一行的样式并摘掉容器。
开发
无构建步骤：lib/client.js 就是发布产物（手写、可读，require("react") 与 require("react-dom")
走宿主模块表的平台种子词）。
npm test # 离线断言套件（272 项：几何/色彩/星空/注入/失败回滚/无注入回归）
npm run preview # 生成 preview/panel.html
测试台 test/harness.mjs 里有一份保状态的 React 桩、够用的假 DOM（含 portal、MutationObserver、
多属性选择器）、以及一个假官方菜单（形状逐字对齐官方产物）。本机没有可离线使用的真 React
（app.asar 里不带），所以渲染层是桩件驱动的；数据路径与 DOM 注入路径跑的都是真代码。
第 12 节断言会直接读解包出来的官方产物校验那 4 个语义锚点还在（aria-haspopup / aria-expanded /
aria-controls / role="menuitem" + 官方文案 + resize 重测），官方改版导致锚点漂移时会先炸测试，
而不是静默失效。本机没有解包产物时该节自动跳过。
已知限制
- 需要重启 DSH Desktop 才生效（客户端 bundle 在启动时注入）。
- 控制项活在官方菜单里，所以必须先点开模型菜单才能改档位；输入框工具行上没有常驻读数。
- 依赖官方菜单的 DOM 语义属性。官方若改成非
menuitem 结构、去掉 aria-controls、
或不再用 data-composer-card，本插件会静默退回"什么都不做"（官方菜单照常可用）。
- 那一行加高约 20px + 滑条 28px，菜单总高会变大；官方会自己重测位置，但极小屏幕上可能出现
菜单贴边（官方自身的
max-height 与夹取逻辑仍在）。
- 主题令牌缺失时回退到中性灰 +
#4d93f8 蓝，观感可用但不如在 DSH 内贴合。
许可
MIT。无第三方代码：闪电标/雪弗龙是自己画的路径，粒子层是自己写的 DOM/CSS。
