- Home
- Plugins
- UI Enhancements
- dsh-codex-model-effort-selector
dsh-codex-model-effort-selector
wanx609/dsh-codex-model-effort-selector
Codex desktop-style model and reasoning-effort selector: one trigger, one popover, a model list pane and a pixel-replica effort slider, with every provider projected onto the official Off/Low/High/Max ladder.
Install
dsh plugin --profile web add github:wanx609/dsh-codex-model-effort-selectorREADME
dsh-codex-model-effort-selector
给 DeepSeek Harness(DSH)用的 Codex 桌面版风格「模型 + 推理强度」选择器: 把输入框上那枚紧凑的模型席按钮,换成 Codex 风格的弹层 —— 一个入口,两块面板。

上图与本文所有截图都由
client.js里真实的 CSS 与类名渲染而成 (生成脚本test/make-readme-shots.mjs直接从源码抽取样式表,只替换 React 运行时), 不是手绘示意图。
English · 中文
目录
这是什么
DSH 输入框上原本只有一枚很小的模型按钮。本插件用 priority: -1 接管它,点开是一个 Codex 风格的弹层,里面是两块面板:
| 面板 | 内容 |
|---|---|
| 推理强度 | 逐像素复刻的 Codex 推理滑条:七档等距、每档一色、Ultra 亮起紫罗兰星尘 |
| 模型列表 | 按提供方分组的两级下钻列表(provider → 模型 + 搜索),行右侧带「N 档」徽标 |
一个入口同时管两件事,和 Codex 桌面版一致。
几何不是「看着像」:卡片高度、轨道位置与尺寸、旋钮直径、刻度点、行距全部由 Codex 桌面版录屏的 93 帧逐像素量出
(录屏缩放 1.385×,故 CSS px = 录屏 px ÷ 1.385),配色同样逐帧采样。完整测量数据见 docs/SPEC.md。
功能
推理强度面板

- 档位等距排列:按模型实际公布的档位重排,模型有几档就显示几档。
Codex 阶梯最多 7 档:
关闭 → 极低 → 轻度 → 中 → 高 → 极高 → Ultra - 每档一色:填充、轨道底色、标题文字、收起态按钮同步换色 ——
色相从蓝
216.6°单调推进到紫罗兰263.9°,而不是只有 Ultra 特殊 - 拖动实时跟手:拖动中旋钮连续跟指针(不吸附),松手才吸附到最近档。 手势由 document 持有(不是指针捕获),拖到弹层外面再拖回来也不会中断
- 按压 / 释放形变:按住旋钮会放大到 1.16 倍,松手沿回弹曲线弹回;不加光环、不改阴影,
只缩放
transform,旋钮的布局盒不动,跟手计算不受影响 - 键盘:
←/→或↑/↓移动一档,Home/End到两端 - Ultra 档:轨道切换为紫罗兰流动渐变 + 22 颗星尘粒子,并显示「更快消耗使用额度」警示(1.8 秒)
- 抵达最右端 · 粒子绽放:滑条落到右端那一档的瞬间,旋钮炸开一圈粒子(柔光环 + 18 颗光点), 0.6–0.9 秒扩散淡出。凡是「从别的档位落到右端」都会触发;打开弹层时本来就停在右端则不会
- Fast 开关(⚡):仅视觉效果,不改变实际速度或用量;悬停显示两行说明卡片
(
1.5 倍速/用量更多,「仅视觉效果」保留给读屏器)。开关按会话记住 —— 切换对话再切回来仍然是开,收起态也会带一颗 ⚡ - 重置按钮:恢复模型默认档位(同时关闭 Fast)。provider 没公布默认值时落在中间档, 所以每个 provider 组都真的会动
Fast 开关的开 / 关对比

同一个「高」档位下对比 —— ⚡ 由描边变实心、轨道亮起星尘粒子、收起态多一颗 ⚡,全都不改变真实速度或用量。
模型面板(两级下钻)

| 层级 | 内容 |
|---|---|
| 第一级 | provider 列表;当前模型所在组在行右侧带一个蓝色小圆点,每行只有 provider 名 + 蓝点 + 末尾一个右向雪弗龙 |
| 第二级 | 点 provider 后横向滑入:返回按钮 + provider 标题 + 搜索框 + 该 provider 的模型列表 |
- 每个模型行右侧带 「N 档」徽标;不支持推理的模型显示「不支持」并灰化,当前模型显示勾选标记
- 搜索:大小写不敏感,支持不连续字符按序匹配(官方同款规则)
- 换模型落在中间档:
floor(n/2),4 档 → 第 3 档;无档位的模型整个不发reasoningEffort键 (缺席 = 「对档位没意见」,与显式null不同) - provider 加载失败会如实列出:接管官方席之后,官方那份逐 provider 的失败提示也归本插件负责, 失败行显示「{name} 加载失败:{message}」,而不是一片空白
Escape逐层退避:第二级 → 第一级 → 强度面板 → 关闭
两个容易忽略的细节

- Fast 说明浮层必须渲染在弹层之外:弹层要画官方菜单材质(
backdrop-filter), 而非none的backdrop-filter会让弹层成为position:fixed子元素的包含块 —— 浮层若还挂在弹层里,视口坐标会被当成相对弹层的坐标解释,再被overflow:hidden裁掉, 表现就是「悬停完全没反应」。所以它是弹层的兄弟节点,显隐由pointerenter/leave+focus/blur驱动 - Ultra 警示的时序:从非 Ultra 档进入 Ultra 的那一刻,中列与左右两个工具按钮一起淡出、 警示文字淡入并走一次扫光(1.1s,延迟 0.2s),持续 1.8 秒后自动淡回档位标题。 也就是说警示是立刻出现、而不是等 1.8 秒才出现; 期间停留在 Ultra 不会重复触发,一旦离开 Ultra 则立即恢复(不必等满 1.8 秒)
- 右端的旋钮是唯一抓手:旋钮 30px、轨道 26px,旋钮上下各多出 2px。那 2px 若不可命中, 按上去命中的就是面板、拖不动 —— 所以轨道上下各加了一条透明抓取带,把悬出部分一起纳入命中范围
- 拖动不能被「半路打断」:旋钮保持
pointer-events:none,整段手势始终落在同一个目标(轨道)上; 即使指针捕获被丢掉,document 捕获阶段的监听仍在驱动滑条,不会出现「按住到一半变成无法选中」
深色模式

与其他配图同一套排版、同一份真实 CSS,只是在官方深色表面下渲染:七档实渲染 + Ultra 警示态 + 收起态。深色主题下整套配色按官方深色表面重新求解:
- 主题判定读官方信号:
<body>上的data-ds-dark-theme属性(官方主题启动脚本写入、官方深色 token 全挂在这选择器上), 刻意不用prefers-color-scheme—— 用户固定选「深色」而系统是浅色时,媒体查询会与实际生效的色板相反。 用MutationObserver订阅,在设置里切换主题即时变色,无需重载 - 七档全部重新求解:v1.0.0 的浅色 ink 在深色卡片上全部跌破 AA(「高」档仅 1.83:1,几乎不可见); 深色表保留同一色相轴(蓝→紫),但亮度随档位上升 —— 深色底上「更暗」意味着「更看不清」
- 轨道换成内嵌凹槽
#232324:浅灰#e8e7e8在深色卡片上是一条 11.3:1 的刺眼亮条 - 旋钮换成亮色圆钮:原 token 在深色下解析成
#2c2c2e,与轨道几乎同色而消失 - Ultra 警示扫光带反转:浅色主题在紫罗兰底上扫一条深带,深色卡片上会掉到对比度以下, 深色改成扫亮带;流动渐变 15 个色标也全部抬到轨道对比度之上
- 浅色主题逐位未动:两套色板由
test/palette.mjs各自校验全部 WCAG 下限(24 项), 并有回归断言防止浅色色值回流到深色表
无障碍与稳健性
role="slider"+aria-valuemin/max/now/valuetext;弹层aria-expanded/aria-haspopup/aria-busy,收起时inert- 每档填充色与文字色都过了 WCAG 对比度下限,浅色/深色两套色板各验一遍(
test/palette.mjs逐条断言) - 深色模式:见上文专节 —— 官方信号判定、官方深色表面求解、切换即时变色
- fail-open:不注册任何宿主钩子、不发事件、不碰官方 class 与文字; 任何一步认不出(目录未就绪、不是自己的会话、subagent 会话)就什么都不做,官方界面保持原样
安装
前置
- DSH
0.2.0-rc.2(本插件按该版本的 slot 契约编写) - 无需构建:
client.js就是发布产物,手写、可读,便于静态审计
方式一:DSH Desktop 插件面板(推荐)
桌面版的 profile 由 Electron 独占管理,命令行装不了,请走面板:
- 把本目录复制到本机任意位置(安装后不要移动或删除)
- 打开 DSH Desktop → 设置 → 插件 → 添加插件
- 填入本目录的完整路径(不是 zip,也不是
package.json) - 勾选信任确认 → 安装 → 立即启用
- 若提示需要重启,完全退出并重开 DSH Desktop(只关窗口不够)
方式二:命令行(仅非 desktop profile)
dsh plugin --profile web add link:"<本目录的绝对路径>"
dsh --profile web --dump-config # 确认出现 dsh-codex-model-effort-selector
验证已生效
重开 DSH 后,点开输入框下方的模型名 —— 应该展开成「推理滑条 + 模型列表」的 Codex 风格弹层。
dsh plugin --profile desktop list | Select-String codex-model-effort
升级与卸载
- 升级:面板里重装 / 重新指向新目录,然后完全退出并重开 DSH Desktop。
- 卸载:面板卸载;手工装的用
dsh plugin --profile <profile> remove dsh-codex-model-effort-selector。 - ⚠️ 不要用
Remove-Item -Recurse删 junction(可能顺着链接删掉插件本体)。
使用
收起态(输入框右侧,就一颗按钮,同样带档位色):
[ ⚡ DeepSeek-V4.1-Pro-Expe… 高 ⌄ ]
名字过长时只省略模型名,档位标签始终完整显示(Fast 打开多占一个 ⚡ 也一样)。
点开后:
| 操作 | 结果 |
|---|---|
| 拖滑条 / 点轨道 | 改档位;拖动期间连续跟手,松手吸附到最近档 |
←/→ ↑/↓ / Home End | 键盘改档 |
| 点中间的档位标题 | 翻到模型列表第一级 |
| 点 provider 行 | 横向滑入该 provider 的模型列表(带搜索框) |
| 点某个模型 | 切换模型并回到强度面板,档位落在中间档 |
Esc | 逐层退避:第二级 → 第一级 → 强度面板 → 关闭 |
| ⚡ | Fast 视觉开关(仅视觉效果) |
| ↻ | 重置为模型默认档位 |
兼容性与已知限制
| 项 | 说明 |
|---|---|
| DSH | 已在 DSH Desktop 0.2.1-rc.2(Windows) 实机验证;0.2.0-rc.2 仍可用(renderSlot 缺失时回退) |
| 运行时依赖 | 无(client.js 手写,零构建、零第三方代码) |
| 主题 | 跟随 DSH 主题令牌(--dsw-*),令牌缺失时回退到中性灰 + #4d93f8 蓝 |
| 平台 | Windows 实机验证;其余平台未测 |
- 需要重启 DSH Desktop 才生效(客户端 bundle 在启动时注入)
- 依赖官方 slot 契约:官方若改动
conversation.input.model的形状,本插件会静默退回「什么都不做」,不会破坏官方界面 - 子槽位声明是独占的,插件不去抢:
conversation.input.model.label只在声明它的条目挂载期间存在, 而官方那条席位也在声明它 —— 注册表对第二个声明者直接抛slot "..." is already declared。本插件不声明、不渲染这个子槽位: 抢声明会把官方的注册打掉,插件一关,消息栏里的模型选择器就整个消失(官方那颗回不来, 因为它从来没注册成功过)。代价是官方那个装饰模型名的「1017」徽标在本插件占用座位期间不显示 —— 徽标是装饰,模型选择器是功能,详见 docs/INCIDENTS.md 第 20 条 - 官方模型菜单没有入口了:那颗席按钮是官方菜单的唯一入口,被遮蔽后打不开;切模型仍有本插件面板与官方
/model命令两条路 - 档位由模型决定:滑条只显示当前模型实际公布的推理强度;模型没有推理元数据时显示「此模型未提供推理强度」
- Ultra 命名:
max档在 Codex 里叫 Ultra,本插件沿用该命名;若某模型把最高档命名为别的 id,则显示模型自己的名字 - 模型列表顺序以宿主目录为准:目录没列到的模型,面板里也看不到
开发
包本身零依赖,不需要 npm install:
# 语法检查
node --check client.js
# 离线断言套件(47 项:加载 / 注册契约 / 遮蔽 / 几何 / 配色 / 主题接线 / fail-open / 无障碍 / 两级下钻 / 悬浮窗 / 绽放 / 形变 / 抓手 / 0.2.1 子槽位归属)
node test/verify.mjs
# 配色断言(24 项:浅色 + 深色各过一遍三条 WCAG 下限 + 色相单调 + 色度 + 去重)
node test/palette.mjs
# 折叠 bug 回归(6 项:同时跑有 bug 与修好后的两个状态机)
node test/collapse-regression.mjs
# 席位生命周期回归(8 项:用**随包发布的真实 SlotCore** 复刻「装载 → 遮蔽 → 关掉插件」)
node test/seat-lifecycle.mjs
# 自定义 DSH 安装位置:设置 DSH_ASAR 或 DSH_RESOURCES 环境变量
# 对着真实 DSH 的集成测试(9 项;0.2.1 对着随包源码断言子槽位契约,找不到 DSH 安装时自动跳过)
node test/slots-integration.mjs
# 编码守卫(26 项:所有文本文件必须是无 BOM 的干净 UTF-8)
node test/encoding.mjs
# 重新生成 README 截图(从 client.js 抽取真实 CSS;需要 Edge/Chrome)
node test/make-readme-shots.mjs
# 生成浏览器预览页(同样抽取真实 CSS,浅色/深色并排)
node test/make-preview.mjs # 然后打开 test/preview.html
# 重新生成深色模式对比图(浅色 vs 深色,真实 CSS 无头渲染)
node test/make-dark-shot.mjs # 输出 docs/images/dark-mode.png
几个测试台的设计值得说明:
test/verify.mjs会真正执行client.js,捕获它注册的 slot,并断言注册形状与官方文档一致test/palette.mjs从源码里读出真实色值再算对比度,色值一改就会重新校验test/collapse-regression.mjs把有 bug 的状态机也实现了一遍:先证明它确实会「一次全开」,再证明修好后的版本不会 —— 回归测试不该只测好版本test/seat-lifecycle.mjs从app.asar里解包出随包发布的真实SlotCore,复刻整条席位生命周期:官方那条必须注册成功、关掉插件后官方那颗必须接管;另有一条对照组用旧的(有缺陷的)形状跑一遍,证明那条失败路径确实会被捕获test/slots-integration.mjs从app.asar里解包出真实的 SlotCore,用本插件真实的注册定义驱动它,端到端验证遮蔽与卸载恢复
项目结构
client.js 发布产物:浏览器 bundle,手写、零构建、可静态审计
index.js 宿主半边,空实现 —— 只为让本包成为 cordis 树上的节点
cordis.patch.yml 把本包 insert 进 profile 的组合层
package.json 声明 dsh.bundle.patch 与 dsh.client(含 inject 依赖)
locale/{zh,en}.json 插件在插件管理页里的标题与描述
icon.svg 插件图标(蓝→紫对角渐变 + 白色闪电,按参考图逐像素量出)
docs/ 架构、事故复盘、像素规格与本文截图
test/ 离线断言 + 配色断言 + 折叠回归 + 真实 SlotCore 集成 + 截图生成器
文档
| 文档 | 内容 |
|---|---|
| docs/ARCHITECTURE.md | 怎么实现的:席位接管、状态机、几何、色彩、粒子数学、无障碍、测试台策略 |
| docs/INCIDENTS.md | 事故复盘:现象 → 根因 → 修法 → 断言。界面不对时先翻这份 |
| docs/SPEC.md | 逐像素测量规格与复刻保真度对照(原版 vs 本插件) |
| CHANGELOG.md | 逐版改动 |
常见问题
装完没反应?
先完全退出并重开 DSH Desktop(不是关窗口)。还不行就检查插件详情页有没有报错行 ——
宿主读 package.json 是直接 JSON.parse,清单有问题(例如 BOM)会让整包被丢弃,界面毫无反应。
点开还是官方那个模型菜单?
说明本插件没被加载。确认 profile 里确实启用了本插件,并且完全重启过 DSH Desktop。
本插件用 priority: -1 遮蔽官方席位,test/slots-integration.mjs 会对着真实 SlotCore 断言这一点。
面板说「宿主没有列出任何 provider」?
这句说明宿主的模型目录是空的 —— 不是插件的问题:官方 /model 命令此刻同样是空的。
去 DSH 的设置 → 模型 / 账号看:通常是没有可用 provider,或账号拿不到令牌。
面板说「还没有会话 —— 发一条消息后就能选模型」? 你正停在「新会话」的空白壳上,输入区此时还没有会话 id。发一条消息、或打开一个已有会话即可。
滑条显示的档位和我预期的不一样? 滑条只显示当前模型实际公布的档位。模型没提供推理元数据时,面板会写「此模型未提供推理强度」。
致谢与许可
- 模型列表的交互参照了 Bai-2008/a-better-dsh-codex-effort-slider 的两级下钻实现(本插件据此取代了早期自相矛盾的折叠集合方案)。
- 原版几何与配色以 Codex 桌面版录屏为第一手依据,并与其他社区的 Codex 滑块移植版交叉验证,
详见
docs/SPEC.md的证据来源一节。 - 目标宿主是 deepseek-ai/deepseek-harness,
本插件只使用它的公开面(槽位、
modelDirectories服务与语义 DOM 锚点)。 - 许可 MIT(见 LICENSE)。无可选第三方代码:闪电标 / 雪弗龙是自己画的路径, 粒子层与全部 CSS 均为手写。
来源
本仓库基于 ABING1111/dsh-codex-model-effort-selector(MIT)1.1.2,在其之上打了六处改动,逐条说明见 LOCAL-CHANGES.md。
Related plugins
dsh-web (dsh-task-board)
zhu1090093659/dsh-web
dsh-web (dsh-web-all)
zhu1090093659/dsh-web
dsh-TUI
ccch1mneyyy/dsh-tui
dsh-web-ui (dsh-task-board)
zhu1090093659/dsh-web-ui