按 PR #607 复核意见修掉 9 项（D1/D2/D3/D4/D5/D6/D7/D8/D9）

- D1 档位点被轨道压住且与圆钮错位：容器改 `display: flex; justify-content: space-between; padding: 0 6.5px`（= 圆钮半径 10 − 半点宽 3.5），首末点中心因此落在圆钮两端极限位置；`z-index: 2` 抬到 range 之上；当前档位那一点 `opacity: 0`（圆钮已压在那儿）；点改深暖底 `--platform-text-strong` + `--platform-input-highlight` 描边。无头 Chromium 实测（222px 轨道）：5 个点中心与圆钮算式偏移全部 0.00px（旧实现 +12.19/+6.09/−0.02/−6.11/−12.20）、点与相邻轨道对比度 10.51~10.59:1（旧 1.21~1.23:1）、当前档位点被圆钮覆盖（中心差 ≤0.5px）
- D2 状态文案（`role="status"`）也会把那排控件顶成两行高：`ConversationModelSelect` 的 notice 与失败分开两条浮层通道（`onNotice` / `onUnavailable`，各自去重），`ComposerReasoningEffortSelect` 加 `noticePresentation: 'inline' | 'toast'` + `onNotice`；`toast` 形态下两种常驻行都不渲染，状态浮层用 `tone="neutral"`、失败仍 `tone="error"`。Direct 用 `toast`，首页/策划/画布默认 `inline` 行为不变
- D4 `forced-colors` 下焦点完全不可见（thumb 的 box-shadow 会被系统丢弃）：加 `@media (forced-colors: active)` 回退 `outline: 2px solid Highlight; outline-offset: 2px`（系统色，亮色观感不变）
- D5 键盘长按每个事件都落盘：`selectEffort` 比对「最近一次落盘成功的档位」（`persistedEffortRef`，挂载回读时种上），相同不写。真实按键序列实测：单击 1 次；长按 1.5s（34 个重复事件）4 次（每个新档位一次）；已在最高档继续长按 1.2s（28 个事件）0 次（旧行为 ~30 次/秒）
- D6 拖动中途卸载会丢档位：卸载 cleanup 里 flush 一次预览值（读 ref，不碰已卸载组件的 state）。实测：拖到「中」未松手落盘 0 次，`unmount()` 后恰好 1 次；单次拖动（按下 + 6 步横移 + 松手）全程 1 次且终值 = 松手位置
- D7 文档与实现对齐：pitfalls 里 `--strength-progress` → `--strength-ratio`、圆钮改实心 `--platform-panel-fill` + `--platform-subpanel-border` 1px 描边、输入盒最高高度 254 → 256（工具栏行高由 30px 模型钮决定）、「提示改成控件排内独占一行」按现行浮层口径改写
- D8 去掉 10 处新硬编码色值 `rgb(112 57 30 / x%)`：卡片投影改用既有 token `--platform-desktop-hover-shadow`，圆钮/焦点影由 `color-mix(in srgb, var(--platform-accent) …)` 派生，不新增 token
- D9 注释与实现不一致：`.resource-reference-input` 的 `min-height: 0 / padding: 0` 写回前面那条六类规则（不再依赖源码顺序），末尾那条只留网格与行距，注释同步改成「不依赖源码先后」
- D3 深色主题焦点环间隙不可靠：只在 pitfalls 记录（深色 `--platform-input-fill` 仅 5% 不透明；工作台根节点固定 `platform-theme--light`，暂不可达）
- 测试：`chat-composer.suite.ts` 新增「notice 走浮层且输入区无 `[role=status]`/`[role=alert]`」「键盘长按同一档位只写一次、换档仍写」「拖动中途卸载恰好提交一次」；`chatDialogFrameLayout.test.ts` 新增档位点对齐/层级/激活点隐藏的声明级断言
- 校验：相关 vitest（chat-composer / chatDialogFrameLayout / design-agent / project-development）、typecheck、eslint、prettier、encoding、spacetime-schema、diff-check

Refs #600, PR #607

docs/project-memory/shared-memory/pitfalls.md

@@ -2,6 +2,16 @@
 
 这里只记录对当前开发仍有用的症状、根因、排查方法和风险边界。同一事实保留一个当前口径；退役对象的专属过程与单轮测试结果由 Git 历史追溯。遇到旧路径或版本时，以现行代码和专题文档为准。
 
+## 2026-10-05 PR #607 复核修复：档位点对齐/对比度、状态文案也走浮层、键盘去重、卸载 flush
+
+- **档位点被轨道压住且与圆钮错位（D1）**：旧实现把 5 个点放进 `grid-auto-columns: 1fr`，点中心落在 22.19 / 66.59 / 110.98 / 155.39 / 199.80，而圆钮中心只在 `10 + ratio * (W - 20)`（10 / 60.5 / 111 / 161.5 / 212）——两端各差 **±12.2px**；且点画在 range（`z-index: 1`）**下面**，实测点中心像素被 6px 轨道盖成轨道色，点填充与相邻轨道对比度只有 **1.21:1**。现行口径：容器 `display: flex; justify-content: space-between; padding: 0 6.5px`（6.5 = 圆钮半径 10 − 半点宽 3.5），首末点的**中心**因此正好落在圆钮两端极限位置；容器 `z-index: 2`（高于 range）把点画到轨道之上；**当前档位那一点 `opacity: 0`**（圆钮已经压在那儿，再画就是"靶心"）；点 7px、`background: var(--platform-text-strong)`、`border: 1.5px solid var(--platform-input-highlight)`。实测（无头 Chromium / 222px 轨道）：5 个点中心与圆钮算式偏移 **全部 0.00px**（旧实现 +12.19/+6.09/−0.02/−6.11/−12.20），点中心像素 `rgb(61,31,16)`、与相邻轨道对比度 **10.51~10.59:1**（旧 1.21~1.23:1）；当前档位那一点被圆钮覆盖（点中心像素 = 圆钮填充色，圆钮中心与点中心差 ≤0.5px）。
+- **状态文案（`role="status"`）也会顶高那一排（D2）**：`notice`（「模型列表已刷新」「正在刷新模型列表」「默认模型已停用」、推理档读取/保存失败）原先无条件渲染成控件里的 `role="status"`，`toast` 形态只接管了 `error`，于是 Direct 输入区仍会被一行状态文字顶成两行高。现行口径：`toast` 形态下失败与状态**分两条通道**（`onUnavailable` / `onNotice`，各自去重、清空后可再报），状态用 `tone="neutral"`、失败用 `tone="error"`；`errorPresentation === 'toast'` 时两种常驻行都不渲染。判据：`chat-composer.suite.ts`「routes model-list notices to the toast…」断言 Direct 输入区子树里 `[role='status']` 与 `[role='alert']` **都为 0**，且浮层在输入区之外。
+- **键盘长按每个事件都落盘（D5）**：range 的方向键在 Chromium 里每次重复都会补 `change`，旧行为 ~30 次/秒全量写盘（写链 + 持久化 + 回读）。现行口径：`selectEffort` 先比对「最近一次**落盘成功**的档位」（`persistedEffortRef`，挂载回读时就种上），相同则不写；连续调整只写**每个新档位**一次，钳位后的重复事件 0 次。实测（真实按键序列）：单击方向键 **1** 次落盘；长按 1.5s（34 个重复事件）**4** 次（`low/medium/high/max`，即每个新档位一次）；已在最高档继续长按 1.2s（28 个事件）**0** 次。
+- **拖动中途卸载会丢档位（D6）**：预览值只在 `change`/`keyup`/`pointerup`/`blur` 落盘，拖到一半被 Esc 关掉菜单或宿主卸载时不会提交。现行口径：卸载 cleanup 里 flush 一次（读 ref，不碰已卸载组件的 state）。实测：拖动到「中」未松手时落盘 0 次，`unmount()` 后恰好 **1** 次（`medium`）；单次拖动（按下 + 6 步横移 + 松手）全程 **1** 次（`high`），终值 = 松手位置。
+- **`forced-colors` 下焦点不可见（D4）**：高对比模式会丢弃 thumb 的 `box-shadow`，而焦点环正是画在 thumb 上的阴影。现行口径：加 `@media (forced-colors: active)` 回退 `outline: 2px solid Highlight; outline-offset: 2px`（系统色，不算新色值；只在 forced-colors 生效，亮色观感不变）。
+- **注释与实现必须同口径（D9）**：`.resource-reference-input` 的 `min-height: 0 / padding: 0` 原先写在文件末尾那条六类规则里靠**源码顺序**盖住前面的 `min-height: 56px / padding: 0 0 4px`，与「不依赖源码顺序」的注释矛盾。现行口径：几何（内边距 / 高度下界）写回 11520 行那条六类规则，末尾那条只留网格与行距，注释同步改成"不依赖源码先后"。
+- **深色主题下焦点环间隙不可靠（D3，仅记录不改代码）**：间隙色取 `--platform-input-fill`，深色主题该 token 只有 5% 不透明（`rgba(255,255,255,0.05)`），间隙会与焦点环颜色几乎一样。当前工作台根节点固定 `platform-theme--light`，走不到这条分支；将来真要启用深色主题，把间隙换成不透明 token 再验一次。
+
 ## 2026-10-04 输入区不放常驻状态行：那一排控件容不下第二行文字
 
 - **现象**：AGC 工作台输入区里模型失败提示常驻一行红字，工具条上还浮着一个半透明的「模型 ⌄」压在 `@ + 默认 ⌄` 那一排上；用户复核口径是"完全没对齐"，并要求改成 toast。
@@ -18,7 +28,7 @@
 - 关掉旧的独立触发钮（底行元素 2 → 1）；浮层的开合、Esc 与点击外部关闭都由模型菜单既有行为负责，强度区不再自带浮层。
 - **取舍**：强度区随菜单挂载，打开时先显示「默认」再回读成落盘档位（一次 IPC 往返），测试里要 `waitFor`；换掉这一点需要把档位状态提到宿主，暂不做。
 - **判据/取证**：`tests/appSurface/chat-composer.suite.ts`（底行不再有第二颗控件、菜单里改档落同一条持久化通道、Esc/点外部关闭、滑块不在 listbox 内）+ `tests/chatDialogFrameLayout.test.ts`（外壳向上展开 / 强度区网格 / 底行高度不增）+ `tests/appSurface/design-agent.suite.ts`（策划菜单里没有滑块）。
-- **视觉口径（用户复核二次要求）**：卡片与滑块的观感照 Codex 参考图，颜色只取我们自己的暖色 token——卡片圆角 16px、内边距 12px、极淡描边（`--platform-line-soft`）+ 柔和暖色投影（`rgb(112 57 30 / …)`，不用纯黑）、**不画横贯分隔线**（只靠留白）；强度区标题 `--platform-text-strong` 12/600、右侧当前档位 `--platform-text-soft` 11px；轨道 6px 圆头，已选段 `--platform-accent`、未选段 `--platform-subpanel-border`（进度由组件写进来的 `--strength-progress` 驱动渐变），圆钮 20px（`--platform-input-highlight` 底 + `--platform-accent` 2px 描边 + 柔影），档位点 7px 绝对定位叠在轨道中线（`pointer-events: none`，不挡命中）；模型列表行高 34px、行圆角 9px、hover `--platform-nav-item-icon-fill`、选中 `--platform-warm-bg` 轻量 pill + 右侧对勾；列表 `max-height: 170px`（=5×34，不出现半行），滚动条 6px 且平时透明、悬停卡片才显形。
+- **视觉口径（用户复核二次要求）**：卡片与滑块的观感照 Codex 参考图，颜色只取我们自己的暖色 token——卡片圆角 16px、内边距 12px、极淡描边（`--platform-line-soft`）+ 既有暖色投影 token `--platform-desktop-hover-shadow`、**不画横贯分隔线**（只靠留白）；强度区标题 `--platform-text-strong` 12/600、右侧当前档位 `--platform-text-soft` 11px；轨道 6px 圆头，已选段 `--platform-accent`、未选段 `--platform-subpanel-border`（进度由组件写进来的 `--strength-ratio` 驱动渐变 `calc(20px + var(--strength-ratio) * (100% - 20px))`），圆钮 20px **实心**（`--platform-panel-fill`，不用半透明 token，避免透出已选段变成"靶心"）+ `--platform-subpanel-border` 1px 描边 + 从 `--platform-accent` 派生的 `color-mix` 柔影；档位点 7px 绝对定位叠在轨道**之上**（`z-index: 2` > range 的 1）、当前档位那一点隐藏（见本文件顶部 2026-10-05 那条的对齐算式与实测）；模型列表行高 34px、行圆角 9px、hover `--platform-nav-item-icon-fill`、选中 `--platform-warm-bg` 轻量 pill + 右侧对勾；列表 `max-height: 170px`（=5×34，不出现半行），滚动条 6px 且平时透明、悬停卡片才显形。
 - **实测（无头 Chromium 夹具，447px / 900px）**：卡片 260×263（圆角 16 / 内边距 12）、强度区 234×61、滑块 222×26、档位点 7px 且中心与轨道中线重合（点 270 / 轨道 269）、列表行高 34、`max-height` 170（内容 315 → 滚动）、默认档进度 0%，按 `End` 到 100% 且文案变「当前：最高」；卡片右缘未溢出视口。
 
 - **关联**：`features/project-workspace/ConversationModelSelect.tsx`、`view/project-development/chat/components/DirectProjectComposer/{DirectProjectComposer.tsx,ComposerControls.tsx}`、`src/styles.css`。
@@ -27,8 +37,8 @@
 
 - **现象**：#600 截图里用户输入区域「元素堆叠」——空草稿时「AI 润色」按钮就压在输入内容区右下角（实测与编辑器相交 28×24px），模型控件的失败提示「本地模型服务不可用」直接画在第 3~4 行文字上（70×36px，长草稿时把整段文字盖住）；面板越窄越糟：280px 面板下推理档整颗压在「添加文件」上（28×28px），「插入素材引用」与推理档也相交（20×28px）。
 - **原因**：两条「靠绝对定位把控件挪出流」的旧写法叠在一起：① `.resource-reference-input-actions` 被写成 `position: absolute; right: 0; bottom: 0`，浮到编辑器右下角（同一份样式早前其实是网格第二行，见文件里 11893 行那条注释，被后写的绝对定位规则盖掉）；② `ConversationModelSelect` 的 `[role='alert'] / [role='status']` 是 `bottom: 36px` 的浮层，锚点就在输入盒正下方，提示必然落在文字上。另外 `.project-chat-composer-controls-right` 写死 `flex: 0 0 auto`，宽度不够时既不收缩也不换行，整组向右溢出输入盒（360px 面板下溢出 34px、280px 下 114px）。
-- **处理（现行口径）**：`.project-chat-composer.is-direct-codex` 是单列网格（`gap: 8px`），三层自上而下——输入内容区 / 工具栏 / 状态提示区；输入内容区自己是两行网格（编辑器横跨两列，第二行左放润色状态、右放「AI 润色 / 恢复原文」操作排），操作排 `position: static` 回到行里；模型提示改成控件排内独占一行（`position: static; flex: 1 1 100%`），不再浮在输入区上方；工具栏允许换行、右侧组改 `flex: 1 1 auto`，模型钮封顶 160px 且名字走省略号（收缩由它承担，推理档 `flex: 0 0 auto` 不参与收缩，避免把「默认」截成半个字）。
-- **判据/取证**：`apps/ai-game-creator-shell/tests/chatDialogFrameLayout.test.ts` 用层叠求值钉住三层几何与操作排 `grid-row: 2 / position: static`、输入盒最高高度算式（12+160+6+28+0+8+28+12 = 254）；`tests/appSurface/project-development.suite.ts` 钉住 composer 的 `gap: 8px`。真实渲染对照见 #600 PR：同一夹具在 495/438/360/296/280px 面板 × 空 / 长多行 / 队列+提示 四态下，改前 2~4 处相交（含文字被提示盖住），改后 0 处相交、0 处溢出。
+- **处理（现行口径）**：`.project-chat-composer.is-direct-codex` 是单列网格（`gap: 8px`），三层自上而下——输入内容区 / 工具栏 / 状态提示区；输入内容区自己是两行网格（编辑器横跨两列，第二行左放润色状态、右放「AI 润色 / 恢复原文」操作排），操作排 `position: static` 回到行里；工具栏允许换行、右侧组改 `flex: 1 1 auto`，模型钮封顶 160px 且名字走省略号（收缩由它承担，推理档 `flex: 0 0 auto` 不参与收缩，避免把「默认」截成半个字）。**模型失败提示后来改成走浮层**（见本文件顶部 2026-10-04 / 2026-10-05 两条）：控件排里既不留常驻红字、也不留常驻状态文字——「控件排内独占一行」那次快照已退役，行高回到由模型触发钮决定。
+- **判据/取证**：`apps/ai-game-creator-shell/tests/chatDialogFrameLayout.test.ts` 用层叠求值钉住三层几何与操作排 `grid-row: 2 / position: static`、输入盒最高高度算式（12 盒内上内边距 + 160 编辑器 + 6 输入区行距 + 28 操作排 + 0 输入区下内边距 + 8 输入盒与工具栏行距 + **30 工具栏行高（模型触发钮 30px 撑起来，发送/语音是 28px）** + 12 盒内下内边距 = **256**）；`tests/appSurface/project-development.suite.ts` 钉住 composer 的 `gap: 8px`。真实渲染对照见 #600 PR：同一夹具在 495/438/360/296/280px 面板 × 空 / 长多行 / 队列+提示 四态下，改前 2~4 处相交（含文字被提示盖住），改后 0 处相交、0 处溢出。
 - **关联**：`apps/ai-game-creator-shell/src/styles.css`（文件末尾「输入区工具栏与状态提示」区块）、`docs/【功能说明】AGC聊天AI润色与发送前提醒-2026-09-10.md`。
 
 ## 2026-10-03 AGC 随包 plugins 的 feature 档位必须与消费方一致，且门禁会因 build.rs 未重跑而假通过