# 变更记录

版本号遵循语义化版本：`MAJOR.MINOR.PATCH`。

## 1.0.0

首个公开版本。功能与修复都来自真实使用中的反馈，逐条记录如下。

**集成方式（与官方的关系）**

- 注册进官方插槽 `conversation.input.right` 取得 `sessionId`，读写全部走官方公开数据面
  （`modelDirectories.directoryFor(sessionId).store` 读、`directory.select(...)` 写），
  不点击 DOM、不猜测状态。
- 滑轨用 `ReactDOM.createPortal` 注入官方「推理等级」那一行：React 自己拥有这棵子树，
  官方重渲染不会抹掉它。
- 只认语义属性（`data-composer-card` / `aria-haspopup` / `aria-expanded` / `aria-controls` /
  `role="menuitem"`），任何一步认不出就**静默退回官方原样**（fail-open）。

**视觉与动效**

- 星河滑轨：深空轨道 + 星云填充 + 34 颗星点（亮度决定大小）+ 光刃拖柄。
- MAX 曲速：**已有的粒子加速向左**（不是新生成一批），速度随蓄能爬升，拖尾随之拉长。
- 离开 MAX 时用 smoothstep 滑停（两端导数为 0），起步会**接管当前速度**而不是归零重来。
- MAX 时菜单卡片套紫色描边 + 随蓄能增强的辉光；菜单行的数值与收起态触发器上的档位文字
  一并染色（只在我们标记的元素上，非 MAX 时干净还原官方颜色）。
- 关闭动效偏好（`prefers-reduced-motion`）下退化为静态状态。

**性能（都在不改变呈现的前提下）**

- 动画值写进各元素自己持有的 `--ratio`（`@property` 注册为非继承），避免每次写入让整棵
  子树（约 40 个元素）重算样式。
- 光刃位置用 `transform` 而非 `left`；蓄能量化到 0.05 步进后才写。
- DOM 观察器收窄为三处（body 直接子节点 / 自己卡片 / 仅打开期间的菜单），不再整树监听。
- 刻意**不使用 `will-change`**：未经 DevTools 实测的合成层提升曾导致拖动时整框闪烁。

**已知边界**

- 必须先点开模型菜单才能改档位（滑轨活在官方那一行里）。
- 注入后菜单卡片会高约 28px（高度在官方测量**之前**预留，避免卡片先落低再被顶上去）。
- 依赖官方 DOM 语义属性；官方若改结构会静默失效（官方菜单不受影响）。