Skip to content
Back to search

dsh-codex-effort-slider

Codex 风格的推理等级滑条(DeepSeek Harness 插件):可拖动连续滑条 + 高档位渐变星尘特效

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/Microqian2th/dsh-codex-effort-slider with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/Microqian2th/dsh-codex-effort-slider'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/microqian2th--dsh-codex-effort-slider/badge.svg)](/listings/microqian2th--dsh-codex-effort-slider)

HTML

<a href="/listings/microqian2th--dsh-codex-effort-slider"><img src="/api/listings/microqian2th--dsh-codex-effort-slider/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

首选: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 → 最新版**](https://github.com/Microqian2th/dsh-codex-effort-slider/releases/latest)。

**只走 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。)

两条路:

1. **面板安装**(推荐):**设置 → 插件 → 添加插件** → 填本地目录路径 → 安装 → 重启 DSH Desktop。 面板会校验两件事,本插件都已满足:是有效的插件包、声明了组合包(`dsh.bundle.patch`)。 2. **手工安装**(当面板本身不可用时——例如 `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 与拖动数学都是从真产物抽出来的)。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 333 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # dsh-codex-effort-slider
  2. [![npm version](https://img.shields.io/npm/v/dsh-codex-effort-slider?color=8b5cf6&label=npm)](https://www.npmjs.com/package/dsh-codex-effort-slider) [![npm downloads](https://img.shields.io/npm/dm/dsh-codex-effort-slider?color=4d93f8&label=downloads)](https://www.npmjs.com/package/dsh-codex-effort-slider) [![license](https://img.shields.io/badge/license-MIT-4d93f8)](https://raw.githubusercontent.com/Microqian2th/dsh-codex-effort-slider/main/LICENSE)
  3. 给 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)(DSH)用的 **Codex 风格推理等级滑条**。
  4. **一档一色、越往右越"通电"**:填充从蓝渐变到紫罗兰,高档位亮起紫色星云与星尘粒子,
  5. 连官方那一行的数值文字也跟着变色(`Off` 档保持官方灰)。
  6. ## 怎么用
  7. 1. **拖**:在模型菜单里那条滑条上按住拖动 —— 跟手连续运动,**拖到哪一档就即时变成哪一档**
  8. (滑过档位边界就把官方档位切过去,不用等松手)。
  9. 2. **右键**:在**滑条上点右键**打开设置面板
  10. 3. 设置**即时生效并记住**;出问题时点一下「复制诊断」把逐帧记录导出。
  11. <img src="https://raw.githubusercontent.com/Microqian2th/dsh-codex-effort-slider/main/preview/screenshots/context-menu.png" width="330" alt="右键滑条打开设置面板:动画效果(快速/简洁/完整,三档都不受系统减少动态影响)、已到达档位的刻度点(亮白/同色/隐藏)、复制诊断 / 恢复默认 / 关闭">
  12. | 设置项 | 可选 | 说明 |
  13. |---|---|---|
  14. | **动画效果** | **快速动画** / 简洁动画 / 完整动画 | 三种**都不受系统「减少动态效果」影响**(否则系统一开就退化成"瞬跳")。**快速**复刻 Codex 桌面版手感 —— 旋钮**不跟手**、停在档位格上,指针越过 1/3 档距才切下一格(后退要退回 2/3,带滞回),**约 70~85ms 吸附到位且无回弹**;**简洁**更干脆;**完整**最跟手、惯性更长 |
  15. | **已到达档位的刻度点** | 亮白显示 / 与未到达同色 / 隐藏 | 控制轨道上那些定位小点的可见性 |
  16. | | | **复制诊断**(逐帧记录,反馈问题时用)/ **恢复默认** / **关闭** |
  17. ## 装好之后长这样(真机截图)
  18. 收起态:档位就在输入框里那枚模型席按钮上,**点开之前**也按档位着色。
  19. ![收起态:输入框里的档位显示](https://raw.githubusercontent.com/Microqian2th/dsh-codex-effort-slider/main/preview/screenshots/shot-01.png)
  20. 点开模型菜单后(左列浅色主题 / 右列深色主题,四档从上到下):
  21. | 档位 | 浅色主题 | 深色主题 |
  22. |---|---|---|
  23. | **Max** | ![浅色 Max](https://raw.githubusercontent.com/Microqian2th/dsh-codex-effort-slider/main/preview/screenshots/shot-02.png) | ![深色 Max](https://raw.githubusercontent.com/Microqian2th/dsh-codex-effort-slider/main/preview/screenshots/shot-06.png) |
  24. | **High** | ![浅色 High](https://raw.githubusercontent.com/Microqian2th/dsh-codex-effort-slider/main/preview/screenshots/shot-03.png) | ![深色 High](https://raw.githubusercontent.com/Microqian2th/dsh-codex-effort-slider/main/preview/screenshots/shot-07.png) |
  25. | **Low** | ![浅色 Low](https://raw.githubusercontent.com/Microqian2th/dsh-codex-effort-slider/main/preview/screenshots/shot-04.png) | ![深色 Low](https://raw.githubusercontent.com/Microqian2th/dsh-codex-effort-slider/main/preview/screenshots/shot-08.png) |
  26. | **Off** | ![浅色 Off](https://raw.githubusercontent.com/Microqian2th/dsh-codex-effort-slider/main/preview/screenshots/shot-05.png) | ![深色 Off](https://raw.githubusercontent.com/Microqian2th/dsh-codex-effort-slider/main/preview/screenshots/shot-09.png) |
  27. 对比度都算过(最高档的数值文字:白底 **4.23:1**、深色底 **4.02:1**)。
  28. **不用安装也能先玩**:**[▶ 在线试玩](https://htmlpreview.github.io/?https://raw.githubusercontent.com/Microqian2th/dsh-codex-effort-slider/main/preview/panel.html)** —— 或者下载仓库后**双击本地** `preview/panel.html`。可拖动、切浅深色、切 4/2/6 档模型,动画三档(快速 / 简洁 / 完整)都能试。
  29. > ⚠️ 直接点 `raw.githubusercontent.com` 的链接只会看到**源码** ✗ —— 它以文本形式返回文件;要看效果请用上面的「在线试玩」或本地打开。
  30. (另有脚本生成的实现示意图:[`preview/seat-color.png`](https://raw.githubusercontent.com/Microqian2th/dsh-codex-effort-slider/main/preview/seat-color.png)、[`preview/distribution.png`](https://raw.githubusercontent.com/Microqian2th/dsh-codex-effort-slider/main/preview/distribution.png))。
  31. 它不新增入口:**直接改造官方模型菜单里的「推理等级」那一行** ——
  32. 那一行被加高上下内距、允许折行,滑条作为第二行铺满整行宽度;拖到最高档时整条轨道亮起紫色能量层。
  33. ```
  34. 点开官方模型菜单后:
  35. ┌────────────────────────────────────┐
  36. │ 模型 DeepSeek-V41-Flash › │ ← 官方原样
  37. ├────────────────────────────────────┤
  38. │ 推理等级 Max › │ ← 官方原样(label / value / chevron 一个没动)
  39. │ ●━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ │ ← 插件注入的滑条(这一行因此被加高)
  40. └────────────────────────────────────┘
  41. 输入框工具行:**不加任何东西**(没有胶囊、没有浮层)
  42. ```
  43. 拖到最高档:轨道变为**紫色星云**(流向渐变 + 扫光 + 22 颗错峰星尘粒子),那一行同时描一圈紫边。
  44. **30 秒上手**:下载/克隆本仓库 → 双击 `install.cmd`(或按下面的「安装」一节)→
  45. **完全退出并重开** DSH Desktop。
  46. ## 安装
  47. ### 首选:npm 一条命令(已发布到 registry)
  48. ```powershell
  49. # 非 desktop profile
  50. dsh plugin --profile <你的 profile> add dsh-codex-effort-slider
  51. ```
  52. > **DSH Desktop 用户**:桌面版的 profile 由 Electron 独占管理,命令行装不了它 —— 请走
  53. > **设置 → 插件 → 添加插件**,在输入框里填 **`dsh-codex-effort-slider`**(包名,现在直接走 npm),
  54. > 或填 `github:Microqian2th/dsh-codex-effort-slider`,点安装,**完全退出并重开** DSH Desktop。
  55. > 装出来的就是上面那组真机截图的样子。
  56. 不想用 npm 也没问题 —— 下面两条路一样有效。
  57. > 直接下载打包好的 zip:[**Releases → 最新版**](https://github.com/Microqian2th/dsh-codex-effort-slider/releases/latest)。
  58. **只走 DSH Desktop 自己的插件面板**——命令行装不了 `desktop` profile:
  59. ```powershell
  60. dsh plugin --profile desktop add link:"F:\Work Space\DeepSeek Harness\dsh-codex-effort-slider"
  61. # error: profile "desktop" is managed exclusively by the Electron application
  62. ```
  63. (这不是配置问题:`bin.js` 里对 `desktop` 直接 `program.error`,只有 Electron 应用本人被允许管理这个保留 profile。)
  64. 两条路:
  65. 1. **面板安装**(推荐):**设置 → 插件 → 添加插件** → 填本地目录路径 → 安装 → 重启 DSH Desktop。
  66. 面板会校验两件事,本插件都已满足:是有效的插件包、声明了组合包(`dsh.bundle.patch`)。
  67. 2. **手工安装**(当面板本身不可用时——例如 `profileContext` 没挂上,`dsh-base` 会把
  68. `plugin-manager` 整行 `disabled`,设置侧栏里就看不到「插件」):
  69. 备份 profile 的 `package.json` → 加一条 `link:` 依赖 → `dsh.profile.bundles` 追加本包名 →
  70. 在 `profiles/<profile>/node_modules/` 下建一个指向本目录的 junction → 重启。
  71. > 卸载用面板;手工装的用 `cmd /c rmdir <junction>`(**不要**用 `Remove-Item -Recurse`,
  72. > 那可能顺着 junction 把插件目录里的文件删掉)。
  73. 想先看观感、不装也行:`node preview/make-preview.mjs` 生成 `preview/panel.html`,
  74. 用浏览器打开即可拖动、切浅深色、切 4/2/6 档模型(页面里连官方菜单外壳都复刻了,
  75. CSS 与拖动数学都是从真产物抽出来的)。
  76. ## 分享给别人
  77. ### 打包
  78. ```powershell
  79. npm run pack # = powershell -NoProfile -ExecutionPolicy Bypass -File pack-dist.ps1
  80. ```
  81. 产出 `dist/dsh-codex-effort-slider-<version>.zip`(约 350 KB)。本插件**零运行时依赖、无构建步骤** ——
  82. 解开就能装,接收方不需要 `pnpm install`。若要让人从 GitHub / npm 装,把**本目录的内容**推到仓库根
  83. (`package.json` 必须在仓库根,pnpm 才能把它当包解析)。
  84. ### 接收方怎么装(三种,按省事程度排序)
  85. 1. **面板安装(推荐)**:DSH Desktop → **设置 → 插件 → 添加插件**,填三者之一:
  86. - **本地目录路径**(解开 zip 后那一层目录)
  87. - **`github:<用户名>/<仓库>`**(面板会先做一次 GitHub 连接检查,再交给 pnpm 拉取)
  88. - **npm 包名 `dsh-codex-effort-slider`**(**已发布**,走 registry;DSH 默认已配 npm 镜像作为回退)
  89. 2. **命令行**(**只有非 desktop profile 能这么装**):
  90. ```powershell
  91. dsh plugin --profile tui add link:"<插件的绝对路径>"
  92. dsh plugin --profile tui add github:<用户名>/<仓库>
  93. ```
  94. `desktop` 是 Electron 保留 profile,命令行会被直接拒绝
  95. (`error: profile "desktop" is managed exclusively by the Electron application`)。
  96. 3. **脚本**(desktop profile 且设置里没有「插件」面板时):
  97. ```powershell
  98. install.cmd # 装进 desktop
  99. install.cmd -Profile tui # 装进别的 profile
  100. install.cmd -Uninstall # 卸载
  101. ```
  102. `install-profile.ps1` 做四件事:备份 profile 的 `package.json` → 加一条 `link:` 依赖 →
  103. 把包名追加进 `dsh.profile.bundles` → 在 profile 的 `node_modules` 下建链接
  104. (Windows 用 junction,其它平台用符号链接),最后校验这三项都成立。
  105. **已用一个假 profile 完整跑过安装与卸载**,并确认卸载只删链接、不会顺着链接删掉插件本体。
  106. ### 注意事项
  107. - `link:` 里是**绝对路径**,所以每台机器装完都必须指向自己的目录(面板/脚本会自动写对)。
  108. - 改过 `lib/client.js` 后**必须完全退出并重开** DSH Desktop 才生效 —— 宿主在启动时把插件读进内存,
  109. 只关窗口不够。
  110. - **卸载**:面板卸载,或 `install.cmd -Uninstall`;手工建过 junction 的用 `cmd /c rmdir <junction>`。
  111. **不要**用 `Remove-Item -Recurse`,它可能顺着链接把插件目录里的文件删掉。
  112. - **兼容性**:DOM 锚点全部是官方**语义属性**(`aria-haspopup` / `aria-expanded` / `aria-controls` / `role`)
  113. 加两个官方 class;哈希前缀不依赖(收起态那段档位文字是**按文字**认的)。官方若改语义,插件
  114. **静默不生效**(fail-open),不会把官方界面改坏。本插件**不注册任何宿主钩子、不注入消息**
  115. (测试里有 `ctx.on` 监视断言守着这一点)。
  116. - 许可 MIT(见 `LICENSE`)。`package.json` 已去掉 `"private"`,并发布在 npm 上:**`dsh-codex-effort-slider`**。
  117. ## 它怎么工作(两半)
  118. | 半边 | 干什么 |
  119. |---|---|
  120. | `lib/index.js`(宿主) | 空逻辑 + 一次客户端产物静态核对。存在的唯一理由是让本包成为 cordis 树上的一行,否则 `dsh.client` 的 bundle 不会被扫进启动图 |
  121. | `lib/client.js`(客户端) | 一个不可见锚点(注册进 `conversation.input.right`,用来拿 `sessionId` 与 `ctx`)+ **DOM 桥** + 滑条(`react-dom` portal 注入官方那一行) |
  122. ### DOM 桥依赖的官方锚点(全部是**语义属性**,不是哈希 class)
  123. | 锚点 | 官方产物里的形状 |
  124. |---|---|
  125. | 席:`button[aria-haspopup="menu"][aria-expanded="true"]` | `<button aria-haspopup="menu" aria-expanded={open} aria-controls={…}>` |
  126. | 菜单:席的 `aria-controls` → `getElementById(…)` | 菜单 `id={…-menu}`,portal 到 body |
  127. | 目标行:菜单里 `button[role="menuitem"]` 的**第 2 个** | 根面板恰好两行(模型 / 推理等级);子面板用 `menuitemradio`,所以 `menuitem` 唯一标识根面板 |
  128. | 归属判定:从自己的锚点向上找 `[data-composer-card]` | composer 卡片带这个标记;打开的那颗席必须在**自己的** composer 里 |
  129. **只改那一行**:写 4 个内联样式(`height:auto` / `flex-wrap:wrap` / `padding-block:10px`)+ append 一个容器;
  130. 关菜单或插件卸载时逐个还原。不碰官方 class、不改官方文字与 chevron。
  131. **fail-open**:任何一步认不出(没有 `aria-controls`、不是根面板、不是自己的 composer、
  132. 目录里没有档位、会话作用域没就绪)就**什么都不做** —— 官方菜单保持原样,绝不会因为本插件点不开。
  133. 官方菜单是"测量后固定定位"的,插件加高那一行后会派发一次 `resize`,
  134. 官方自己的 `place()` 会重新读 `offsetHeight` 并重新夹取位置。
  135. ## 数据路径(只用官方公开面)
  136. | 用途 | 接口 |
  137. |---|---|
  138. | 读档位 | `directoryFor(sessionId).store.getSnapshot()` → `groups[].models[].reasoning.efforts` |
  139. | 写档位 | `directory.select({ provider, model, reasoningEffort })`(与官方菜单同一写入口) |
  140. | 订阅 | `store.subscribe()` + `React.useSyncExternalStore` |
  141. ## 色彩与粒子(**由位置连续驱动**,与档位数无关)
  142. 拖到哪,颜色与粒子就跟到哪。三个纯函数(都有断言):
  143. | 位置 `pct` | 颜色 `fillColorFor` | 能量 `energyFor` | 粒子数 `particleCountFor` | 速率 `speedFor` |
  144. |---|---|---|---|---|
  145. | 0(第一档) | 蓝 `#4d93f8` | 0 | 0 | 0.35× |
  146. | 1/3(第二档) | 蓝(**第一档到第二档恒为蓝**) | 0 | 0 | 0.35× |
  147. | 2/3(high) | 紫 `#9333ea` | 0.5 | 11 / 22 | **1×(就是"现在这个速度刚刚好")** |
  148. | 1(max) | 深紫 `#4c1d95` | 1 | 22 / 22 | **2×** |
  149. - **颜色**:填充层是 `linear-gradient(90deg, 蓝, 当前位置的颜色)` —— **左端恒为蓝、右端是当前位置的颜色**,
  150. 所以 high 档自然呈现"左蓝右紫",越往右右端越深(深紫 `#4c1d95`)。
  151. - **能量层**(紫色星云 + 扫光)强度 = `energyFor`,它在第二档以前是 0 —— 所以左半段是**干净的蓝**,
  152. 往右才逐渐"通电";官方那一行的紫边透明度也跟着能量走(`0.16 + 0.34 × energy`)。
  153. - **能量条只覆盖已填充那一段**:能量层宽度与填充层完全相同(都到旋钮圆心),
  154. 所以**档位右边没达到的部分不会出现能量条**,只剩轨道底色。
  155. - **Off 档在"两个界面"里都保持官方灰**(`isOffLevel` + `valueColorFor` 返回**空串**):
  156. Off 档时既不给菜单里那一行的数值文字上色,也不给收起态席按钮上的档位文字上色 ——
  157. 空串 = 不写内联色 = 官方原本的颜色。档位是不是"关"按 **id 和 name 都认**(`off`/`none`/`关闭`/`无`,
  158. 大小写与空格不敏感;DeepSeek 的真实档位表见 `dsh-llm-deepseek/lib/index.js` 的 `REASONING_EFFORTS`)。
  159. Off 档本身也没有能量层(energy 0 → 纯蓝、无星云、无星尘)。
  160. - **刻度点更小更淡**(用户要求):`5px → 3px`;已达刻度 `rgba(255,255,255,.92) → .5`,
  161. 未达刻度 `color-mix(... 38% → 26%)`。改小改淡之后它们不再和星尘粒子抢眼。
  162. - **星空(所有出现粒子的档位都用这一套,动画已统一)**:
  163. - **不消失**:外层是一条**整轨宽度**的轨道,自己在做 `translate3d(-100%)` 的连续横穿;
  164. 残影只在 0%/6% 与 94%/100% 淡出淡入 —— 那两端在可视区外,所以看起来星星**从不消失**。
  165. (旧的"短掠过 + 原地淡出"那套逻辑与 CSS 已整体删除,有断言守着 `.ces-particle` / `ces-drift` 不再存在。)
  166. - **亮度随机、越亮越大**:每颗的亮度/大小系数由确定性伪随机给出,落在 **0.5 ~ 1** 之间
  167. (1 = 3px 与亮度 100%);圆点用 `opacity:var(--ces-b)` + `transform:scale(var(--ces-b))`,
  168. 所以"亮的那颗同时更大"。
  169. - **速度随位置变化(保留)**:横穿时长 = `STARFIELD_DURATION_MEAN × MAX_SPEED_FACTOR / speedFor(pct)`
  170. —— **MAX 档 1.5s、high 档 3s、第二档附近约 8.6s**(位置速率 2× / 1× / 0.35×)。
  171. - **星星单独一层,不跟星云淡入**:星云层(紫色渐变 + 扫光)的透明度 = 能量强度,high 档只有 0.5;
  172. 若星星套在里面,每颗的实际不透明度会被压到 0.25~0.5,在紫色底上几乎看不见
  173. (用户实测反馈"high 档一打开几乎没粒子")。所以星星放在 `.ces-stars` 独立层,
  174. 透明度 = `starLayerOpacityFor`(high 档 **0.8**、MAX 档 **1.0**),"逐渐出现"交给**粒子数**表达。
  175. **MAX 档观感与之前完全一致(都是 1.0),没有动。**
  176. - **各星之间只差 ±8%**(`STARFIELD_DURATION_SPREAD`):保留"有的稍快有的稍慢"的层次,
  177. 又不会像原来 0.95–2.05s(速度差 **2.16×**)那样快星追上慢星排成一队。
  178. - **高度 = 随机排列的等距槽位,并与相位解耦**(8%~92% 用满轨道高度):
  179. 早期版本高度和相位**取自同一个数** `frac((i+1)×φ)`,于是"越靠右的星越高",22 颗排成
  180. 一条斜线(用户实测反馈"太规整,再随机一点";高度↔相位相关系数实测 **0.999**)。
  181. 现在高度是一条**确定性随机排列**(哈希排序,不用 `Math.random`),并自动挑一个盐值
  182. 保证**相位相邻**(会一直并排在轨道上走)的两颗至少差 **28%** 轨道高,不会并成一坨。
  183. 相关系数实测 **−0.110**(有断言守着 `|r| < 0.35` —— 旧版会直接失败)。
  184. - **相位只跟 index 有关、跟"当前显示几颗"无关**(黄金比低差异序列,任意前缀都铺得开):
  185. 拖动改变粒子密度时不会改写已挂载动画的 `animation-delay`,所以**进档那一下不会被整体重排**。
  186. - **时长与相位直接内联**写在元素上(`animationDuration` / `animationDelay`),
  187. **不走 CSS 变量**:真引擎实测(无头 Chromium 逐帧读 `getComputedStyle`)两种写法相位都成立,
  188. 但内联更少一层不确定性,"减少动态效果"的放缓也顺势改到 JS 里算(`REDUCED_MOTION_SLOWDOWN`)。
  189. - 伪随机是**确定性**的(`starHash01`,不用 `Math.random`):重渲染不跳变,且可离线断言。
  190. **"聚集"的量化对照**(模拟真产物参数,轨道 300×28px,两星中心距离 <6px 记为粘住):
  191. | t=0.2s(刚进档) | t=0.4s | t=1s | t=2s | t=3s |
  192. |---|---|---|---|---|
  193. | 3 对 → **0 对** | 1 对 → **0 对** | 4 对 → 2 对 | 7 对 → 4 对 | 4 对 → **0 对** |
  194. **长期行为(如实标注)**:只要每颗星的时长不完全相同,相位就会**缓慢互相错开**,最终趋近随机分布
  195. (22 颗里总会有几对偶尔靠近)。实测粘住对数随每颗星时长浮动变化:
  196. | 每颗星时长浮动 | t=0.5s | t=1s | t=2s | t=5s |
  197. |---|---|---|---|---|
  198. | **±8%(当前)** | 1 | 7 | 9 | 17 |
  199. | ±4% | 0 | 2 | 7 | 10 |
  200. | ±2% | 0 | 0 | 2 | 11 |
  201. | **0%(全同速)** | **0** | **0** | **0** | **0** |
  202. 也就是说:**想彻底永不聚集,就把 `STARFIELD_DURATION_SPREAD` 设成 0**(代价是所有星速度完全一致,
  203. 少了"有的快有的慢"的层次);保留 ±8% 则偶尔会有几颗靠近一下再分开。这个数字由常量控制,随时可调。
  204. - **官方那一行的数值文字("Max" / "High")也会跟着变色**(`valueColorFor`):
  205. 与能量同源,**蓝 → 靛 → 紫罗兰**,越往右越"通电"。写的是内联 `color`(内联优先于官方样式表),
  206. 关菜单时由桥还原;**文字内容一个字都不碰**(断言:内容仍归官方管,标签与"模型"那一行完全不动)。
  207. 终点色 `COLOR_TEXT_VIOLET = #8b5cf6` 是**照着对比度挑的**:白底 **4.23:1**、深色底(#1b1c20) **4.02:1**,
  208. 两种主题都读得清(先试过更亮的 `#c084fc`,浅色主题只有 2.6:1 发虚;测试里有对比度断言挡着)。
  209. **Off 档例外:不上色,保持官方灰**(见上)。
  210. - **收起态的模型席按钮**(`DeepSeek-V41-Flash High ⌄`,**点开菜单之前**就看得见那个档位)同样着色:
  211. 官方那一小段文字是 `triggerEffort` 这个**哈希 class**(前缀随构建变,靠 class 认迟早失效),
  212. 所以按**文字**认 —— 官方 trigger 里的文字就是档位的 `name`,和我们从目录读到的是同一份数据
  213. (已对照官方源码 `dsh-client-ui-model-selection/lib/client.js:860-867` 确认那是个 `<span>`)。
  214. 传的是**全部档位名**而不是"当前那个":档位刚切换、官方还没重渲染席按钮时文字还是旧的,
  215. 只认当前名字会在那一瞬间掉色。
  216. - 席上显示的是**已生效**档位,所以拖动过程中它不跟着草稿跳,提交后才变(有断言)。
  217. - 官方重渲染换了节点 → 桥在重新抓到的那一刻立刻补色(不必等 React 再渲染一次)。
  218. - 组件卸载时还原;认不出任何已知档位名就**什么都不做**(fail-open:绝不动模型名等别的文字)。
  219. - **`prefers-reduced-motion`**:**放缓而不是冻住** —— 收起扫光、粒子周期 ×2.6,并在滑条的 `title`
  220. 里说明原因(冻成静态图会让"能量在流动"这个表达整个消失)。
  221. - **配色跟随主题**:轨道底色用 `--dsw-alias-border-l1`;浅色/深色都自动跟随。
  222. ## 旋钮几何(顶头适配)
  223. 旋钮是**正圆,直径 = 轨道高度**(`TRACK_HEIGHT = KNOB_SIZE = 28px`),
  224. 圆心只在 `[14px, 宽度 − 14px]` 之间移动:
  225. ```
  226. left = calc(14px + pct × (100% − 28px)) ← 旋钮、填充终点、刻度共用这一个几何
  227. ```
  228. 所以 `pct=0` 时圆心落在左端圆角内、`pct=1` 时落在右端圆角内,圆**永远是完整的圆**
  229. (之前圆心跑到两端之外,圆被官方菜单的 `overflow:hidden` 切掉右半边,
  230. 看起来就像个圆角方块 —— 这也是把直径加大到与轨道同高的原因)。
  231. 指针映射也用同一套内缩几何(`pctAt`),所以拖到最左/最右必定命中端点档位。
  232. ## 稳健性(每条都有断言)
  233. - `directoryFor()` 在会话作用域就绪前**按设计抛错** → 退避重试(60ms 起,约 9 秒)+ 自愈;
  234. 档位数是**后到**的,桥会在档位数变化时主动重扫(DOM 不会因为 store 变化而产生 mutation)。
  235. - 写入失败 / 超时(10s)→ 回滚到真实档位并显示原因,**不谎报成功**。
  236. - 拖动写入有**同档位去重 + 在途合并 + 120ms 降频**:1 秒内 60 次拖动最多 3 次写回,
  237. 落在当前档位时 0 次;松手必定落地。
  238. - 滑条吞掉自己的 pointer/click/方向键事件,**不会误触官方那一行的 onClick**(那会跳进等级列表)。
  239. - 组件卸载时清掉降频定时器;桥卸载时还原那一行的样式并摘掉容器。
  240. ## 开发
  241. 无构建步骤:`lib/client.js` 就是发布产物(手写、可读,`require("react")` 与 `require("react-dom")`
  242. 走宿主模块表的平台种子词)。
  243. ```powershell
  244. npm test # 离线断言套件(272 项:几何/色彩/星空/注入/失败回滚/无注入回归)
  245. npm run preview # 生成 preview/panel.html
  246. ```
  247. 测试台 `test/harness.mjs` 里有一份**保状态**的 React 桩、够用的假 DOM(含 portal、MutationObserver、
  248. 多属性选择器)、以及一个**假官方菜单**(形状逐字对齐官方产物)。本机没有可离线使用的真 React
  249. (`app.asar` 里不带),所以渲染层是桩件驱动的;数据路径与 DOM 注入路径跑的都是真代码。
  250. 第 12 节断言会**直接读解包出来的官方产物**校验那 4 个语义锚点还在(`aria-haspopup` / `aria-expanded` /
  251. `aria-controls` / `role="menuitem"` + 官方文案 + `resize` 重测),官方改版导致锚点漂移时会先炸测试,
  252. 而不是静默失效。本机没有解包产物时该节自动跳过。
  253. ## 已知限制
  254. - 需要重启 DSH Desktop 才生效(客户端 bundle 在启动时注入)。
  255. - 控制项活在官方菜单里,所以**必须先点开模型菜单**才能改档位;输入框工具行上没有常驻读数。
  256. - 依赖官方菜单的 DOM 语义属性。官方若改成非 `menuitem` 结构、去掉 `aria-controls`、
  257. 或不再用 `data-composer-card`,本插件会**静默退回"什么都不做"**(官方菜单照常可用)。
  258. - 那一行加高约 20px + 滑条 28px,菜单总高会变大;官方会自己重测位置,但极小屏幕上可能出现
  259. 菜单贴边(官方自身的 `max-height` 与夹取逻辑仍在)。
  260. - 主题令牌缺失时回退到中性灰 + `#4d93f8` 蓝,观感可用但不如在 DSH 内贴合。
  261. ## 许可
  262. MIT。无第三方代码:闪电标/雪弗龙是自己画的路径,粒子层是自己写的 DOM/CSS。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.