dsh-aurora-effort-slider

Readme

# dsh-aurora-effort-slider

把 DeepSeek Harness 模型座位里的「推理等级」那一行，换成一条可以直接拖动的**星河滑轨**。

不用先钻进等级列表再点一下——拖到哪就是哪。

![浅色主题 · MAX](preview/shots/light-max.png)

![深色主题 · MAX](preview/shots/dark-max.png)

| 浅色 · High | 深色 · High |
|---|---|
| ![浅色 High](preview/shots/light-high.png) | ![深色 High](preview/shots/dark-high.png) |

## 特性

- **直接拖动**：滑轨长在官方「推理等级」那一行里，档位随拖动即时切换；也支持方向键 / `Home` / `End`。
- **星河视觉**：深空轨道 + 星云填充 + 34 颗星点（亮度越亮、颗粒越大），光刃停在当前档位。
- **MAX 曲速**：到达最高档时，**原本就在的粒子加速向左掠过**（不是新发射一批），拖尾随之拉长，
  随后 2.2 秒内继续"上红线"加力并轻微呼吸。
- **滑停而不是急刹**：离开 MAX 时用 smoothstep 衰减（两端导数为 0）；若在滑行途中又推回 MAX，
  会**接管当前速度继续加速**，而不是归零重来。
- **MAX 光环与文字染色**：卡片套上紫色描边 + 随蓄能增强的辉光；菜单行的数值与收起态触发器上的
  档位文字一并染色，非 MAX 时干净还原官方颜色。
- **不做卡片位移**：所有反馈由光承担（刻度一闪、光刃过曝、星流），窗口和卡片纹丝不动。
- 跟随 DSH 的深色主题（`data-ds-dark-theme`）；尊重 `prefers-reduced-motion`，此时退化为静态状态。

## 安装

只走 **DSH Desktop 自己的插件面板**——命令行装不了 `desktop` profile
（`bin.js` 对保留 profile 直接报错：`profile "desktop" is managed exclusively by the Electron application`）。

1. 打开 DSH Desktop，进入 Web 侧边栏 → **Plugins** → **添加插件**；
2. 填入**本目录的绝对路径**（或已解压的发布包目录），安装；
3. 在应用内**刷新页面**。若没出现，重启 DSH Desktop。

### 更新 / 卸载

- **更新代码**：本地目录安装的本质是 `link:` 依赖——宿主读的就是这个目录里的 `lib/client.js`。
  改完代码**刷新页面即可生效，不需要卸载重装**。
- **改包名则必须重装**：profile 里记录的是**包的名称**（`dependencies` 条目 +
  `dsh.profile.bundles` 列表）。一旦改动 `package.json` 的 `name`（例如把 `@local/xxx` 改成
  公开发布名 `dsh-aurora-effort-slider`），刷新页面是不够的——滑轨会直接不出现，必须在插件面板
  **卸载旧的、再按新目录安装**。这也是从发布包升级时要卸载重装的原因。
- **卸载**：Plugins 页面里卸载，或先禁用。插件卸载时会把官方节点、样式、观察器**全部还原，零残留**。

<details>
<summary>手动安装（面板本身不可用时）</summary>

1. 备份 profile 的 `package.json`（macOS 上是
   `~/Library/Application Support/DSH/profiles/desktop/package.json`，以实际安装位置为准）；
2. 加一条依赖：`"dsh-aurora-effort-slider": "link:/绝对路径/dsh-aurora-effort-slider"`；
3. 在 `dsh.profile.bundles` 数组里追加 `"dsh-aurora-effort-slider"`；
4. 在 `profiles/desktop/node_modules/` 下建一个指向该目录的符号链接；
5. 重启 DSH Desktop。

卸载时先把链接删掉再用面板/手改配置文件——**不要**用递归删除去删符号链接，那可能顺着链接把插件目录里的文件删掉。
</details>

## 它是怎么工作的

### 两半

| 半边 | 职责 |
|---|---|
| `lib/index.js`（宿主） | 空逻辑 + 一次客户端产物静态核对。存在的唯一理由：让本包成为 cordis 树上的一行，否则 `dsh.client` 的 bundle 不会被扫进启动图 |
| `lib/client.js`（客户端） | 注册席取得 session 作用域 + 官方数据面读写 + 用 portal 把滑轨注入官方那一行 |

### 集成模型（三条，全部照 DSH 生态里已被验证过的形状）

1. **成为一个席**：注册进官方插槽 `conversation.input.right`，从框架拿到 `sessionId`。
   席本身只渲染一个不可见锚点，用来定位"我自己这张 composer 卡片"。
2. **读写走官方公开数据面**，一个 DOM 都不点、一个状态都不猜：

   | 用途 | 接口 |
   |---|---|
   | 读档位表 / 当前档位 / 提交中 / 失败原因 | `modelDirectories.directoryFor(sessionId).store.getSnapshot()` → `{ current, groups, status, pending, error }` |
   | 写档位 | `directory.select({ provider, model, reasoningEffort })` —— 与官方模型菜单同一个写入口 |
   | 订阅 | `store.subscribe()` + `React.useSyncExternalStore` |

3. **UI 用 `ReactDOM.createPortal` 注入官方那一行**：React 自己拥有这棵子树，官方重渲染不会抹掉它，
   也就不需要悬浮层、补内边距、轮询定位那一套。

### 依赖的官方锚点（全部是语义属性，不是哈希类名）

| 锚点 | 官方产物里的形状 |
|---|---|
| 自己的 composer | `[data-composer-card]` |
| 席位按钮 | `button[aria-haspopup="menu"][aria-expanded="true"]` |
| 菜单 | 席位的 `aria-controls` → `getElementById(...)`（portal 到 body） |
| 目标行 | 菜单里 `[role="menuitem"]` 恰好两行时的第 2 行（子面板用 `menuitemradio`，所以 `menuitem` 唯一标识根面板） |
| 档位文字 | 文本恰好等于档位名的最内层 `span`（官方把档位单独放在一个 span 里） |

**fail-open**：任何一步认不出（拿不到 session / 目录未就绪 / 认不出那一行 / 模型没有推理元数据）
就**什么都不做**，官方界面保持原样——绝不会因为本插件点不开。

### 两个不易察觉的坑（都已在实现里处理）

- **菜单是"测量后固定定位"的**：官方 `place()` 读 `offsetHeight` 算位置，且只在
  `open/pane/state/query` 变化 + `resize` + `scroll` 时重算。所以我们**在菜单一打开就先把那一行加高、
  把高度预留好**（而不是先按矮菜单落位、插进去之后才被顶上去——那会表现为卡片先压住触发器、
  一动档位才跳上去）。高度变化后再分 3 次派发 `resize` 兜住调度竞态。
- **不要给轨道加 `will-change`**：给一个每帧改变内部宽度的容器强制提升合成层，会导致图层反复
  重新栅格化，实测表现为**拖动时整个卡片一闪一闪**。合成层的收益要用 DevTools 量过再谈。

## 开发

```bash
node check.mjs                          # 交付前预检：结构与数据面断言（含发布一致性）
```

`preview/harness.html` 是**不用装 DSH 就能看像素**的离线仿真台：真 React 渲染插件组件 +
假 `modelDirectories` store（形状照抄官方 `createSnapshotStore`）+ 假官方菜单（aria 契约一致）
+ 复刻官方的 `place()` 定位。

```bash
cd dev && npm i        # 仿真台用的真 React（不进安装产物）
open ../preview/harness.html
# URL 片段可叠加：#off / #high / #max / +#dark / +#hover / +#drag / +#shot
```

改完代码先跑预检、再在仿真台看清像素，最后刷新真机——**插件的效果必须先在像素上验证过**，
不要把回归直接推给使用者。

<details>
<summary>仿真台里的两个坑（踩过）</summary>

- **headless 下 `requestAnimationFrame` 不触发**（无 GPU 合成 + 虚拟时间），必须垫成
  `setTimeout(…,16)`，否则曲速循环一帧都不跑，引擎看起来"正常"其实没动。垫片已在 `harness.html` 里。
- 亚像素几何（圆角端头、握把胶囊这类）**看图比统计可靠**：颜色阈值检测很容易把光晕、星点、
  轨道外的白底算进来，我就因此连续误判过三次。

</details>

## 已知边界

- **必须先点开模型菜单**才能改档位——滑轨活在官方那一行里，输入框工具行上没有常驻读数。
- 注入后菜单卡片会高约 28px。
- 依赖官方 DOM 语义属性。官方若改成非 `menuitem` 结构、去掉 `aria-controls` 或
  `data-composer-card`，本插件会**静默退回"什么都不做"**（官方菜单照常可用）。
- 只在 macOS 的 DSH Desktop 上实测过；代码本身是纯 Web，其他平台理论上同样可用。

## 变更记录

见 [CHANGELOG.md](CHANGELOG.md)。

## 许可

[MIT](LICENSE)。无第三方代码：光刃、雪弗龙、粒子层都是自己写的 DOM/CSS。