eloimovo/better-dsh-codex-effort-slider

better-dsh-codex-effort-slider

给 DeepSeek Harness（DSH）用的 Codex 风格推理等级滑条： 把输入框那颗模型席按钮换成一条可拖动的连续滑条 —— 一档一色、越往右越"通电"，高档位亮起紫色星云与星尘。

A Codex-style reasoning-effort slider for DeepSeek Harness. Continuous drag, per-level colors, particle effects that intensify with effort, light/dark aware.

浅色主题同样可读（档位文字对比度算过：白底 4.23:1、深色底 4.02:1）： preview/value-color-light.png。 两张图都是真机截图（在 DSH Desktop 里逐个档位截下来再拼接），不是渲染稿。

---

目录

• 特性
• 安装
• 使用
• 配置
• 兼容性
• 常见问题
• 已知限制
• 开发
• 打包与发布
• 项目结构
• 文档
• 致谢与许可

---

特性

• 一条连续的滑条，不是几个离散按钮：拖动即改档位，颜色与粒子由位置连续驱动，与模型有几档无关。
• 一档一色：填充层从蓝渐变到紫罗兰，右端是当前位置的颜色；官方那一行的数值文字也跟着变色 （Off 档保持官方灰）。
• 越往右越"通电"：高档位亮起紫色星云与星尘粒子，粒子数与横穿速度随位置变化。
• 接管官方模型席，不并排：输入区仍然只有一颗 模型名 · 档位名 ⌄，点开是自建的两级面板 （provider 列表 → 模型列表 + 搜索），点模型不关面板、滑条立刻跟到新模型的档位。
• 换模型默认落在中间档：总档数为偶数时取"中间的下一个"（4 档 → 第 3 档）。
• 深浅主题自适应：面板用官方菜单那套毛玻璃材料（blur(40px) saturate(150%)）+ 半透明底 + 阴影； 星尘与旋钮是固定浅色（它们永远落在蓝紫填充层上）。
• 失败可读、fail-open：读不到目录、宿主没列 provider、加载失败 —— 面板都会写出原因原文 （含宿主逐 provider 的报错）；任何一步认不出就退回"什么都不做"，绝不把官方界面改坏。
• 零运行时依赖，离线断言 911 项。

---

安装

不想 clone：直接下载本仓库 Releases 里打包好的 zip（better-dsh-codex-effort-slider-<version>.zip）。

三种方式，按省事程度排序：

1. 插件面板（推荐）

DSH Desktop → 设置 → 插件 → 添加插件，填三者之一：

• 本地目录路径（clone 或解开 zip 后那一层目录）
• github:eloimovo/better-dsh-codex-effort-slider
• npm 包名（走 registry）

安装后完全退出并重开 DSH Desktop（宿主在启动时把插件读进内存，只关窗口不够）。

2. 一键脚本

当设置里没有「插件」面板时（dsh-base 会把 plugin-manager 整行 disabled）：

install.cmd                    # 装进 desktop profile
install.cmd -Profile tui       # 装进别的 profile
install.cmd -Uninstall         # 卸载

install-profile.ps1 做四件事：备份 profile 的 package.json → 加一条 link: 依赖 → 把包名追加进 dsh.profile.bundles → 在 profile 的 node_modules 下建链接（Windows 用 junction）， 最后校验这三项都成立。已用假 profile 完整跑过安装与卸载，并确认卸载只删链接。

3. 命令行（只有非 desktop profile 能这么装）

dsh plugin --profile tui add link:"<插件的绝对路径>"
dsh plugin --profile tui add github:eloimovo/better-dsh-codex-effort-slider

desktop 是 Electron 保留 profile，命令行会被直接拒绝：

error: profile "desktop" is managed exclusively by the Electron application

升级与卸载

• 升级：面板里重装 / 重新指向新目录，然后完全退出并重开 DSH Desktop。
• 卸载：面板卸载，或 install.cmd -Uninstall；手工建过 junction 的用 cmd /c rmdir <junction>。 ⚠️ 不要用 Remove-Item -Recurse，它可能顺着链接把插件目录里的文件删掉。

---

使用

收起态（输入框右侧，就一颗按钮）：

[ DeepSeek-V41-Flash  Max  ⌄ ]

点开是两级面板：

细节：面板右缘与输入框右缘对齐、底边贴按钮上方 8px；页面滚动或窗口缩放时只重新定位、不关闭 （助手流式输出时聊天区会一直自动滚动）；助手运行期间宿主会藏起控件行，此时面板保持原位。

---

配置

插件是编译期配置（没有运行时设置界面），常量都在源码里、改完重新构建 + 重启：

面板材料（模糊、底色、阴影）在 lib/client.picker.src.js 的 GLASS_VARS 里 —— 想更透/更实就改那两个 alpha。

---

兼容性

---

常见问题

装完没反应？ 先完全退出并重开 DSH Desktop（不是关窗口）。还不行 → 设置 → 插件 点开插件详情， 那行有没有 error：宿主读 package.json 是直接 JSON.parse，清单有问题（例如 BOM）会让整包被丢弃， 界面毫无反应的根因就在那里。

面板说「宿主没有列出任何 provider」？ 这句说明宿主的模型目录是空的 —— 不是插件的问题：官方 /model 命令此刻同样是空的。 去 DSH 的设置 → 模型 / 账号看：通常是没有可用 provider，或账号 provider 拿不到令牌 （端点与账号登录不匹配时会静默返回空列表）。

面板说「会话目录未就绪，正在重试…」，下面还有一行字？ 那行就是宿主的原话（例如 ui-model-selection: session "…" resolved no scope）。它内含是哪个会话 id， 把这行发出来即可定位；插件会自己退避重试 + 心跳自愈，通常几秒内恢复。

面板说「还没有会话 —— 发一条消息后就能选模型」？ 你正停在"新会话"的空白壳上，输入区此时还没有会话 id。发一条消息、或打开一个已有会话即可。

改了源码 / 换了版本，界面还是旧的？ 宿主给客户端 chunk 的 URL 带 ?rev=，而这个 rev 是按 lib/client.js 的 mtime/size 算的， 响应头还是 immutable。只改 picker 不会让 rev 变，浏览器会拿一年缓存的旧 chunk。 解法：Ctrl+Shift+R 硬刷新（或重启 DSH），或让时间戳动一下：

(Get-Item lib/client.js).LastWriteTime = Get-Date

为什么只有一颗按钮？ 官方那颗席按钮和自建按钮都是 conversation.input.model（single 槽）的占用者： 插件用 priority: -1 遮蔽官方那颗，所以不会并排出现两颗。代价见「已知限制」。

---

已知限制

• 需要重启 DSH Desktop 才生效（客户端 bundle 在启动时注入）。
• 官方模型菜单没有入口了：那颗席按钮是官方菜单（模型列表 / 档位列表 / 键盘导航 / aria）的唯一入口， 被接管之后就打不开了。切模型仍有两条路 —— 本插件的面板，以及官方的 /model 命令。 想回退成"官方菜单 + 里面长滑条"，把 ENABLE_OFFICIAL_MENU_SLIDER 改成 true。
• 依赖官方语义锚点（aria-haspopup / aria-expanded / aria-controls / role，不依赖哈希 class）。 官方若改成非 menuitem 结构或不再用 data-composer-card，插件静默退回"什么都不做"（fail-open）。
• 模型列表与档位来自宿主目录：目录没列到的模型，面板里也就看不到；徽标的"几档"同样以目录为准 （目录还没列到、又不在本地兜底清单里时，宁可不显示徽标）。
• 模型列表的"新 → 旧"是启发式的：宿主目录不带发布日期，顺序由 id / 显示名里的版本号与日期算出； 名字里完全看不出新旧的模型一律沉底并保持宿主原顺序。只排自建面板那一屏（官方菜单里的顺序不动）。
• 8 档模型只有末档满能量这条观感与参考实现不同：本插件是连续曲线（8 档 Max = 11/14）， 见 MODIFICATIONS.md 第七节第 4 条，是有意取舍。
• 老路 A（ENABLE_OFFICIAL_MENU_SLIDER = true）会给官方那一行加高约 20px + 滑条 28px， 极小屏幕上可能出现菜单贴边（官方自身的 max-height 与夹取逻辑仍在）。

---

开发

npm run build     # lib/client.picker.src.js → lib/client.picker.js（幂等；生成物别手改）
npm test          # 离线断言套件（911 项；pretest 会自动先 build）
npm run preview   # 生成 preview/panel.html（浏览器打开即可拖、切深浅色、切 4/2/6 档）

包本身零依赖，不需要 npm install：上面三条脚本都只是 node xxx.mjs 的包装， 直接 node build/pack-picker.mjs / node test/client.test.mjs / node preview/make-preview.mjs 等价。

源码是三层：lib/client.js（手写接线 + DOM 桥）、lib/client.picker.src.js（自建浮层，需构建）、 lib/index.js（宿主侧一行）。改完 picker 记得 npm run build，并注意上面那条 chunk 缓存 rev 的坑。

预览页支持几个给无头截图用的参数（README 里那两张 preview/value-color-*.png 就是这么生成的）： ?level=<档位 id> 定位到某一档、?dark=1 进深色、?shot=1 只留「模型 + 推理等级 + 滑条」两行。 例：preview/panel.html?shot=1&level=max。

实现细节（两套 UI、接管时序、DOM 锚点、色彩与粒子数学、旋钮几何、稳健性清单、测试台策略） 都在 ARCHITECTURE.md。

---

打包与发布

npm run pack        # 运行时包：dist/better-dsh-codex-effort-slider-<version>.zip
npm run pack:src    # 源码包：…-<version>-src.zip

源码包是自足的：解开后 npm run build 可重现同一份 chunk，npm test 直接跑完整套断言。 两个 zip 与 SHA256SUMS.txt 都落在 dist/（已 gitignore），是给 GitHub Releases 用的附件。

想发到 npm 的话：package.json 里现在是 "private": true，需要先删掉这一行。

---

项目结构

lib/
  index.js              宿主侧插件（让本包成为 cordis 树上的一行）
  client.js             客户端接线 + DOM 桥 + 官方菜单那行的滑条（手写产物）
  client.picker.src.js  自建浮层源码（滑条面板）
  client.picker.js      上面那个的构建产物（包内 chunk，别手改）
build/pack-picker.mjs   把 picker 源码包成自注册 chunk
test/
  client.test.mjs       离线断言套件（911 项）
  harness.mjs           保状态 React 桩 + 假 DOM + 假官方菜单
preview/
  make-preview.mjs      生成 preview/panel.html（观感预览页）
  *.png                 文档里的效果图
install.cmd             profile 安装脚本入口（desktop profile 的兜底）
pack-dist.ps1           打发布 zip
cordis.patch.yml        bundle 补丁层（声明本插件在组合里的一行）

---

文档

---

致谢与许可

• 本仓库是 Microqian2th/dsh-codex-effort-slider （1.0.0）的修改分支：滑条观感、连续能量曲线、自建浮层与后续修复都在这里。
• 目标宿主是 deepseek-ai/deepseek-harness， 本插件只使用它的公开面（槽位、modelDirectories 服务与语义 DOM 锚点）。
• 许可 MIT（见 LICENSE）。无可选第三方代码：闪电标 / 雪弗龙是自己画的路径， 粒子层是自己写的 DOM/CSS。