# Session Handoff — 2026-05-11

> 用法：在新 session 中**直接整段复制**作为首条 user message。
> 协议格式见 `tvu-design-system/docs/multi-session-collaboration-rules.md` "Session Handoff Protocol" 段。

---

## 起手必读（按顺序）

1. `tvu-design-system/AGENTS.md`
2. `tvu-design-system/docs/meta-rules.md`
3. `tvu-design-system/docs/internal/mockup-conventions.md`
4. `MicroApps Console/docs/MICROAPPS_PRODUCT_CONTEXT.md`
5. `tvu-design-system/docs/internal/retrospection/2026-05-11-library-key-confusion.md` ← 本次根因
6. 本文件（继续上下文）

---

## 上个 Session 已完成

### MicroApps Console Figma mockup（4 frame）

| Frame | 状态 |
|---|---|
| MicroApps · Master Console / 1920 (`3278:1835`) | ✅ Console-readonly + Health + 9 UX 标注 |
| MicroApps · Master Console / 1440 (`3289:2530`) | ✅ 同上规则 |
| MicroApps · My Sessions / 1920 (`3289:2726`) | ✅ Full authoring + Health + 3 UX 标注 |
| MicroApps · My Sessions / 1440 (`3289:2922`) | ✅ 同上 |

### Mockup 内具体变更

- **8 个 `+ New Session` 按钮**：MC-1920 + MC-1440 全部隐藏
- **8 个 Action Cluster Clone 图标**：MC-1920 + MC-1440 全部隐藏（URL/ID copy 按钮保留）
- **10 个 URL placeholder**："Click to set input/output URL" → `—`
- **24 个 Health Indicator**：MC 8 + MS 8 + MC-1440 8，每个绑 TVU UX Design System 库（**全部 line 风格统一**，2026-05-11 修正自 v1 误选 fill 变体）：
  - `icon/Message/Success 1` (`UX/Brand/Brand` #2fb54e) × 15 — outline circle + check
  - `icon/Message/warning 1` (`UX/Orange/Default` #f68512) × 6 — outline circle + `!` — tooltip "Bitrate fluctuation detected" / "Output URL latency high"
  - `icon/Message/Error 3` (`UX/Red/Default` #ea4233) × 3 — outline triangle + `!` — tooltip "Output bitrate dropped to zero"
- **Auto-refresh Widget** (`3274:1856`)：Running 加 pause `||` 在 progress bar 与 dropdown 之间；Paused 用 ▶ 替换原 `||` indicator
- **Figma Requirements doc** (`2956:4546`)：原 "Creating new sessions..." bullet 改成 Console-readonly / MS-authoring 表述 + 加 "Master Console vs My Sessions" 段
- **10 个 UX 交付标注全量重写**（A1 / A2 / A3 / A4 / A5 / A6 / A7 / A8 / A_State / A_Order）按 spec 改：Enterprise → Company、3-type Action Cluster matrix、Health Indicator section、cross-context color reuse 等

### 文档（落仓库 / 文件系统）

| 文件 | 状态 |
|---|---|
| `MicroApps Console/docs/MICROAPPS_PRODUCT_CONTEXT.md` §3 / §5 / §9 | ✅ 加 3 段（Page-scoped restriction / Per-session Health Indicator / Auto-refresh manual pause） |
| `MicroApps Console/docs/decisions/2026-05-09-master-console-readonly.md` | ✅ |
| `MicroApps Console/docs/decisions/2026-05-09-auto-refresh-pause-button.md` | ✅ |
| `MicroApps Console/docs/decisions/2026-05-09-session-health-indicator.md` | ✅（含 TVU UX Design System 真实 component key + bound variable）|
| `tvu-design-system/docs/internal/retrospection/2026-05-11-library-key-confusion.md` | ✅ 库 key 混淆复盘 |

---

## 本 Session 待做（user 已 confirm，未执行）

### 🟢 P0 架构搭建（1 件待做，原 6 件中 2 件已先补完、3 件用户决定不做）

| # | 操作 | 落到哪 | 状态 |
|---|---|---|---|
| ~~1~~ | ~~Trigger J（加规则前必须查重）~~ | `tvu-design-system/docs/meta-rules.md` | ✅ 2026-05-11 已加 |
| ~~2~~ | ~~§13 Figma mockup row 扩~~ | `MicroApps Console/docs/MICROAPPS_PRODUCT_CONTEXT.md` §13 | ✅ 2026-05-11 已扩 |
| ~~3~~ | ~~PRODUCT-CLAUDE.md.template~~ | — | ❌ 用户砍（YAGNI，未来起新产品再说）|
| ~~4~~ | ~~MicroApps Console/CLAUDE.md~~ | — | ❌ 用户砍（依赖 #6 全局兜底）|
| ~~5~~ | ~~AGENTS.md 加"起新产品"段~~ | — | ❌ 用户砍（与 #3 / #4 配套）|
| 6 | **`~/.claude/CLAUDE.md` 加 TVU keyword trigger 段** | 用户级全局 | ⏳ 唯一待做（new session 执行）|

详见 retrospection: `tvu-design-system/docs/internal/retrospection/2026-05-11-library-key-confusion.md` "应对" 段。

### 🟡 P1 视觉 polish（可选）

- **A5 Auto-refresh 标注高度**：rebuild 后高 615px，伸到 MC frame 下方约 716px。考虑压缩内容（合并 USER FLOW 进 PAUSED STATE）或移到其他位置
- **其他 9 个标注布局**：已 cascade-fix 防重叠，但坐标可能不是最优；可手动微调

### 🔵 P2 已知 open issue（无关本架构）

- 3 个 MicroApp 缺 APP Icon variants（Color Correction / Graphics Insertion / Test Pattern Generator）—— 等设计师补
- Health Indicator hover tooltip 现在用 plugin data 存文案（`uxAnno.tooltip`），未来开发时绑到真 Tooltip 组件

---

## Cold-start keyword trigger 设计要点（待 user 在新 session 决定保守版 / 激进版）

如要在 `~/.claude/CLAUDE.md` 加 TVU 自动识别段，需 user 拍板：

- **保守版**（推荐）：严格 keyword（"TVU 设计系统 / TVU Design System / TVU library / 基于 TVU"），漏触发让 user 补一句
- **激进版**：扩到通用词（"button / mockup / 效果图 / 设计"），命中多但误触发也多

---

## 验证锚点

新 session 起手做完必读后，问 AI 答出下列即视为 onboard 成功：

1. TVU UX Design System libraryKey 是？ → `lk-057f6ba0...`
2. 当前 mockup 已经隐藏了 MC 的哪两类元素？ → New Session 按钮 + Action Cluster 内的 Clone 图标
3. Health Indicator 三个状态分别绑哪个 color variable？ → `UX/Brand/Brand` / `UX/Orange/Default` / `UX/Red/Default`
4. 本次 retrospection 暴露了多少个 root cause？ → 3 个（onboarding 不严格 / 不知道有同名近似库陷阱 / 加规则前没查重）

答不出 → 没真读规则，让 AI 重读。