dsh-codex-model-effort-selector
Manifest validCodex 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
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。
Comments
Loading…
Similar plugins
by qjcnmd
Codex-style reasoning-effort slider embedded in the model selector.
★ 13
↓ 302/wk
MIT
JavaScript
Oct 18, 2026
dsh plugin --profile web add reasoning-sliderby caidows
Codex-style model picker for the DeepSeek Harness composer: draggable reasoning-effort slider, model list, no default stop.
★ 0
MIT
JavaScript
Nov 9, 2026
dsh plugin --profile web add dsh-codex-model-pickerCodex-style reasoning-effort slider for the DeepSeek Harness composer
★ 0
MIT
JavaScript
dsh plugin --profile web add dsh-thinking-sliderReasoning-effort slider in the model menu for DeepSeek Harness that also appears for providers and models with no declared effort metadata. Based on Microqian2th/dsh-codex-effort-slider — uninstall th
★ 0
dsh plugin --profile web add dsh-effort-slider-universalby Gorkaseto
A plugin for DeepSeek Harness (DSH) that enables effort choice in custom providers and replaces the standard "Effort" menu item with an intuitive, sticky effort slider directly inside the composer model menu.
★ 0
Apache-2.0
JavaScript
Oct 21, 2026
dsh plugin --profile web add dsh-effort-pickerby domitor-syh
Replaces the model button with a Claude Desktop-style model and reasoning-effort switcher, with per-model effort memory, theme-aware styling, smooth slider feel, rounded track, hover highlight, and pi
★ 8
↓ 627/wk
MIT
TypeScript
Nov 14, 2026
dsh plugin --profile web add @domitor-syh/dsh-ui-skin-switcher