dsh-ui-polish

dsh-ui-polish

DSH（DeepSeek Harness）桌面端的 UI 打磨插件：宿主界面哪里粗糙，这里补哪里。 浏览器侧纯注入，不改宿主结构、不碰会话数据，卸载即恢复原样。

它做什么

1. 浮层毛玻璃

宿主的菜单、选择器等浮层本该是毛玻璃，但材质层被父级的 isolation: isolate 截断了 backdrop，实际看起来是"半透明发虚"。本插件把材质画到浮层自己身上， 底色跟随宿主主题变量，浅色/深色自动适配。

2. 推理强度滑杆

把「模型选单 → 推理等级 → 4 个单选项」换成一条可拖动的滑杆：

• 拖动实时跟手，松手吸附到最近档位；
• 提交直接调用宿主的 select()，菜单全程不关、不闪；
• 档位名从 DOM 读取，换模型、换界面语言都跟着变，不写死；
• 支持键盘（←/→ 换档、Home/End 到两端）与读屏。

3. 填充物的质感

填色条不再是一张平色纸，材质分三层叠出来（配色与观感对齐 qjcnmd/dsh-reasoning-slider）：

• 厚度：上沿一道 1px 亮边、下沿一道 1px 暗边，填色看着是一根实心条； 轨道自己也压一道内阴影，变成「凹槽」。
• 光泽：自顶向下的柔光渐变（顶部亮、下半略沉），配合上面的边光给出一致的受光方向。
• 流动颗粒：6 组极小亮片按不同周期横移，像一层会流动的磨砂；最高档更亮更快。

⚠️ 填色条是用 scaleX 缩出来的（为了和滑钮同走合成器，见下），所以写死的 1px 会被一起拉粗。边光与颗粒层因此都用 1/sx 反缩放把像素厚度还原，并被填色 overflow:hidden 裁掉溢出部分——否则颗粒会漏到右边还没填的轨道上。 两道凹槽内阴影的强度跟着宿主的 color-scheme 走（深色用更强的一档：颜色写死 一套的话，深色下轨道是一块平灰板，凹槽根本看不出来）。 系统开启「减弱动效」时颗粒静止、高对比模式下整套材质交还系统配色。 边光与光泽是静态材质，fx:false 只关掉流动颗粒、粒子、绽放和 Max 紫渐变。

4. 滑杆特效（fx）

• 流动粒子：填色里的小点从左向右飘，途中逐渐淡出；粒子被裁剪在填色盒子内， 因此右端永远贴着滑钮，不会飘到轨道外。
• Max 档渐变：只有档位名叫 Max（或「最大」）的那一档带紫色特效——滑到它时 填色换成 10 段蓝紫渐变（色阶取自上面那个参考实现），顶部档位名同步变色。 顶档叫 xHigh 等的模型不变紫：特效认名字不认位置。
• 一次性绽放：只有在拖进 Max 档的那一瞬间，滑钮周围才散开一圈紫白粒子。 已经在 Max 档时重复拖动不会再放，打开菜单也不会开场就爆。
• 光标：平时是普通箭头，只有按住并移动时才变成抓握拳头（单按不动仍是箭头）。
• 常驻小箭头：换档提交时宿主会把触发器的箭头临时换成转圈图标，闪一下。 本插件把这两个可替换图标都隐藏，箭头改由按钮的常驻伪元素绘制，开合朝向 跟随 aria-expanded，换档不再闪。

实心填色条与滑钮的落位都走 transform（合成层属性，同一条曲线，永不脱节）， 粒子层只沿水平方向流动；系统开启「减弱动效」或高对比模式时自动降级。

5. 更顺的模型选择流程

• 点输入框上的模型控件，一次点击直达档位页（滑杆）；
• 点顶部模型行，直达模型列表；
• 在列表里选了带推理档位的模型，自然过渡回滑杆页；没有档位的模型直接完成选择；
• Esc 一次关闭整个菜单，不会退回中间层；
• 触发器上的「模型 · 档位」名称实时更新。

安装

# dsh CLI 在你本机 DSH 安装目录下的 bin\dsh.cmd，按实际路径改
$dsh = '<DSH_INSTALL_DIR>\resources\runtime\cli\bin\dsh.cmd'
& $dsh plugin --profile desktop add "file:."

装完刷新窗口（Ctrl+R）。改过源码后需要 remove 再 add（pnpm 对 file: 依赖是拷贝）。

卸载：

& $dsh plugin --profile desktop remove dsh-ui-polish

配置

cordis.patch.yml 的 config 段：

运行时开关（DevTools 控制台，立即生效不用刷新）：

dshUiPolish.setTint(0.6)       // 调浓淡
dshUiPolish.off()              // 整层关闭，界面回到宿主原样
dshUiPolish.on()               // 恢复
dshUiPolish.setSlider(false)   // 只要毛玻璃、不要滑杆
dshUiPolish.setFx(false)       // 只要滑杆、不要特效

开发与测试

npm install
npm test    # 6 套 Playwright 回归：freeze / glass / nav / selftest / slider / fx```

测试用系统 Chrome（可用 `DSHP_CHROME` 指定路径），无需下载浏览器。
`test/live-verify.mjs` 可在真机 DSH 实例里验证毛玻璃与滑杆，用法见脚本头注释。

开发过程中的排查记录、宿主 DOM 契约和踩坑笔记（白屏根因、滑杆几何、Esc 行为、
异步提交窗口等）整理在 [docs/development-notes.md](docs/development-notes.md)，
改 `lib/client.js` 之前建议先读它。

## 注意事项

- 只认宿主的契约属性（`data-*`、`role`），不依赖哈希类名，宿主升级不易误伤；
- 系统开启「减少透明」或浏览器不支持 `backdrop-filter` 时自动加厚底色；
  `forced-colors` 下交还系统配色；
- 外来菜单（权限选单等非模型菜单）不会被插件接管。