{"type":"system","subtype":"hook_started","hook_id":"e88a9b4f-0a3f-4926-af77-b9306f58d0a0","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"80fed7b6-3c0e-4254-bcb2-ed46f7c3b233","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"hook_started","hook_id":"1720d27c-3139-4043-8c87-6943775c0ad8","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"b2084d4e-d451-43b9-a769-6164c721fca9","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"hook_response","hook_id":"e88a9b4f-0a3f-4926-af77-b9306f58d0a0","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"{\"hookSpecificOutput\": {\"hookEventName\": \"SessionStart\", \"additionalContext\": \"⛔ MANDATORY ONBOARDING（两层；链路 SoT = docs/STATUS.md §起手必读链路）— 第一个**项目相关**回答 / 推荐 / 任务前必须完成。机制：用 TodoWrite 为 L-core 每项 + 命中的 L-ref 项各建 1 个 todo, 逐项 Read 完才能回答。\\n\\n【L-core — 全文必读, 禁 grep/跳读/摘要替代】\\n1. Read docs/FIGMA_AS_SOURCE_OF_TRUTH.md (⭐ 最高优先级 — Figma 真源原则)\\n2. Read docs/STATUS.md (项目状态 SoT + 链路 SoT — 含 L-ref 完整触发表)\\n3. Read docs/PROJECT_GOAL.md (项目目标 + 5 个能力 + 受众 + 约束)\\n4. Read docs/internal/_plans/next-session-pickup-2026-07-08-full-lifecycle-optimization.md (当前 sprint 操作手册)\\n\\n【L-ref — 最小集必读, 命中触发再深读（完整触发表在 STATUS §L-ref）】\\n- AGENTS.md §硬规则表 + §Onboarding Gate（每 session 最小集）\\n- 接手 sprint task → backlog.md 对应 entry **全文 Read 不是 grep**\\n- 排期/版本决策 → tracker 全读（最小集 = §排期原则）\\n- 写 prompt/设计机制 → meta-rules.md 反模式清单\\n- Mockup 任务 → AGENTS §Mockup Write Gate + §必读链路 7-10 整链 mandatory\\n\\n【⛔ 两条「绝对不能违反、但没有任何入口会主动告诉你」的规则 —— 它们不在 AGENTS §硬规则表里, 所以上面那条最小集覆盖不到】\\n1. **changeset 纪律**：本次改动若碰到 package.json 的 files[] 白名单内的资产 (src/** · src/tokens/** · 导出 index.ts · eslint-plugin/** · templates/** · 白名单内那批 scripts/), 必须在**同一个 commit** 里写 changeset (跑 pnpm changeset)。判据是「该文件在不在 files[] 里」, files[] 是唯一真源 (npm pack --dry-run 可查); 纯 docs/ tests/ playground/ react-pilot/ 不写。真源 = AGENTS.md §直 commit master 时：写 changeset（版本日志）。⚠️ CONTRIBUTING.md 此前反向教过「手改 CHANGELOG + 手改版本号」, 别照那个做。\\n2. **VISUAL_COMMIT_APPROVED**：docs 站视觉改动的 pre-commit 视觉门要这个环境变量才放行, 而 **AI 不得自设** —— 它的含义是「owner 看过实际效果并说出口了」, 自设等于伪造签核。合批只减少问几次, 不改变必须由 owner 说出口。真源 = AGENTS.md §docs 站内部 demo / 页面样式改动的快车道 条 2。\\n（这两条的发现路径此前只有「撞上 pre-commit 才知道」; 2026-08-17 [[INFRA-F125]] ① 把它们提到 SessionStart 注入面 —— 选 hook 而不是新建 skill, 因为 skill 靠唤醒词概率命中 = 要求使用者先懂流程, 而 hook 是 cwd 一进来就注入、零条件。）\\n\\n违反信号 (命中任一立即停下重读):\\n- L-core 没读完就回答 ('我已经知道大概了'/'跳一步') → 错\\n- L-core 或 backlog entry 用 grep/摘要替代全文 Read → 错\\n- 命中 L-ref 触发却只读标题/最小集 → 错\\n- 'memory 兜底替代 SoT' → 错 (memory 是 AI 缓存, 项目契约真源在仓库)\\n\\n例外1 (跳过): 用户首条 query 明显非项目相关 (如 '今天日期' / 闲聊 / 角色唤醒词)。\\n例外2 (减档 = 微改档, owner 2026-08-13 裁定): 改动是**单文件 + 纯文案/措辞 + 不换组件不改 token 不加删元素 + 非 mockup 写操作**时, L-core 减为 **#1 (FIGMA_AS_SOURCE_OF_TRUTH 全文) + AGENTS §硬规则表**, 省下 STATUS / PROJECT_GOAL / pickup 三份。⛔ 判据不确定就是不满足; 一旦发现要换组件 / 改 token / 加删元素 / 动第二个文件 / 触组件选型或 Figma 真源判断 → **当场停下补读完整 L-core 再继续**。判据与升级条件的唯一 SoT = docs/STATUS.md §微改档, 别照本行推测边界。\\n\\n两个例外的完整定义详见 docs/STATUS.md §起手必读链路 + AGENTS.md §Onboarding Gate。\\n\\n历史实证: 2026-05-13 session 10 跳过 PROJECT_GOAL + AGENTS → 首轮推荐缺 4 项硬约束 → 用户返工纠偏。\\n\\n⚠️ **⚠️ **探测失败**（CLAUDE_PROJECT_DIR 未设或不指向 git 仓库）—— 按 fail-closed 照发本段：**当作有并行 session****（owner 2026-08-13 裁定）。\\n- ⛔ **本 session 若要写任何仓库文件，起手就开 worktree**（走 `superpowers:using-git-worktrees`），别靠事后 pathspec 补救 —— 判据是「并行线在写代码吗」，**不是「我只出 .md 吗」**：纯 .md 一样会被别人的裸 commit 卷走。\\n- 那些 dirty/untracked 文件**先假设是别 session 进行中**，不主动消化、不替它们 commit。\\n- 若确实不开 worktree（只读任务 / owner 明示不开）：commit 必须 `git commit -F -- <显式路径>`，且**提交后紧跟 `git reset -- <同样路径>`** 清幻影 staged。\\n- worktree 三坑：无 node_modules（symlink 主仓那份）· 无 dist-wc（`pnpm build:wc`）· husky 跑主仓 hooks。\"}}\n","stdout":"{\"hookSpecificOutput\": {\"hookEventName\": \"SessionStart\", \"additionalContext\": \"⛔ MANDATORY ONBOARDING（两层；链路 SoT = docs/STATUS.md §起手必读链路）— 第一个**项目相关**回答 / 推荐 / 任务前必须完成。机制：用 TodoWrite 为 L-core 每项 + 命中的 L-ref 项各建 1 个 todo, 逐项 Read 完才能回答。\\n\\n【L-core — 全文必读, 禁 grep/跳读/摘要替代】\\n1. Read docs/FIGMA_AS_SOURCE_OF_TRUTH.md (⭐ 最高优先级 — Figma 真源原则)\\n2. Read docs/STATUS.md (项目状态 SoT + 链路 SoT — 含 L-ref 完整触发表)\\n3. Read docs/PROJECT_GOAL.md (项目目标 + 5 个能力 + 受众 + 约束)\\n4. Read docs/internal/_plans/next-session-pickup-2026-07-08-full-lifecycle-optimization.md (当前 sprint 操作手册)\\n\\n【L-ref — 最小集必读, 命中触发再深读（完整触发表在 STATUS §L-ref）】\\n- AGENTS.md §硬规则表 + §Onboarding Gate（每 session 最小集）\\n- 接手 sprint task → backlog.md 对应 entry **全文 Read 不是 grep**\\n- 排期/版本决策 → tracker 全读（最小集 = §排期原则）\\n- 写 prompt/设计机制 → meta-rules.md 反模式清单\\n- Mockup 任务 → AGENTS §Mockup Write Gate + §必读链路 7-10 整链 mandatory\\n\\n【⛔ 两条「绝对不能违反、但没有任何入口会主动告诉你」的规则 —— 它们不在 AGENTS §硬规则表里, 所以上面那条最小集覆盖不到】\\n1. **changeset 纪律**：本次改动若碰到 package.json 的 files[] 白名单内的资产 (src/** · src/tokens/** · 导出 index.ts · eslint-plugin/** · templates/** · 白名单内那批 scripts/), 必须在**同一个 commit** 里写 changeset (跑 pnpm changeset)。判据是「该文件在不在 files[] 里」, files[] 是唯一真源 (npm pack --dry-run 可查); 纯 docs/ tests/ playground/ react-pilot/ 不写。真源 = AGENTS.md §直 commit master 时：写 changeset（版本日志）。⚠️ CONTRIBUTING.md 此前反向教过「手改 CHANGELOG + 手改版本号」, 别照那个做。\\n2. **VISUAL_COMMIT_APPROVED**：docs 站视觉改动的 pre-commit 视觉门要这个环境变量才放行, 而 **AI 不得自设** —— 它的含义是「owner 看过实际效果并说出口了」, 自设等于伪造签核。合批只减少问几次, 不改变必须由 owner 说出口。真源 = AGENTS.md §docs 站内部 demo / 页面样式改动的快车道 条 2。\\n（这两条的发现路径此前只有「撞上 pre-commit 才知道」; 2026-08-17 [[INFRA-F125]] ① 把它们提到 SessionStart 注入面 —— 选 hook 而不是新建 skill, 因为 skill 靠唤醒词概率命中 = 要求使用者先懂流程, 而 hook 是 cwd 一进来就注入、零条件。）\\n\\n违反信号 (命中任一立即停下重读):\\n- L-core 没读完就回答 ('我已经知道大概了'/'跳一步') → 错\\n- L-core 或 backlog entry 用 grep/摘要替代全文 Read → 错\\n- 命中 L-ref 触发却只读标题/最小集 → 错\\n- 'memory 兜底替代 SoT' → 错 (memory 是 AI 缓存, 项目契约真源在仓库)\\n\\n例外1 (跳过): 用户首条 query 明显非项目相关 (如 '今天日期' / 闲聊 / 角色唤醒词)。\\n例外2 (减档 = 微改档, owner 2026-08-13 裁定): 改动是**单文件 + 纯文案/措辞 + 不换组件不改 token 不加删元素 + 非 mockup 写操作**时, L-core 减为 **#1 (FIGMA_AS_SOURCE_OF_TRUTH 全文) + AGENTS §硬规则表**, 省下 STATUS / PROJECT_GOAL / pickup 三份。⛔ 判据不确定就是不满足; 一旦发现要换组件 / 改 token / 加删元素 / 动第二个文件 / 触组件选型或 Figma 真源判断 → **当场停下补读完整 L-core 再继续**。判据与升级条件的唯一 SoT = docs/STATUS.md §微改档, 别照本行推测边界。\\n\\n两个例外的完整定义详见 docs/STATUS.md §起手必读链路 + AGENTS.md §Onboarding Gate。\\n\\n历史实证: 2026-05-13 session 10 跳过 PROJECT_GOAL + AGENTS → 首轮推荐缺 4 项硬约束 → 用户返工纠偏。\\n\\n⚠️ **⚠️ **探测失败**（CLAUDE_PROJECT_DIR 未设或不指向 git 仓库）—— 按 fail-closed 照发本段：**当作有并行 session****（owner 2026-08-13 裁定）。\\n- ⛔ **本 session 若要写任何仓库文件，起手就开 worktree**（走 `superpowers:using-git-worktrees`），别靠事后 pathspec 补救 —— 判据是「并行线在写代码吗」，**不是「我只出 .md 吗」**：纯 .md 一样会被别人的裸 commit 卷走。\\n- 那些 dirty/untracked 文件**先假设是别 session 进行中**，不主动消化、不替它们 commit。\\n- 若确实不开 worktree（只读任务 / owner 明示不开）：commit 必须 `git commit -F -- <显式路径>`，且**提交后紧跟 `git reset -- <同样路径>`** 清幻影 staged。\\n- worktree 三坑：无 node_modules（symlink 主仓那份）· 无 dist-wc（`pnpm build:wc`）· husky 跑主仓 hooks。\"}}\n","stderr":"","exit_code":0,"outcome":"success","uuid":"f681ae20-79bf-4e8c-b229-b1af0c84694b","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"hook_response","hook_id":"1720d27c-3139-4043-8c87-6943775c0ad8","hook_name":"SessionStart:startup","hook_event":"SessionStart","output":"{\n \"hookSpecificOutput\": {\n \"hookEventName\": \"SessionStart\",\n \"additionalContext\": \"\\nYou have superpowers.\\n\\n**Below is the full content of your 'superpowers:using-superpowers' skill - your introduction to using skills. For all other skills, use the 'Skill' tool:**\\n\\n---\\nname: using-superpowers\\ndescription: Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions\\n---\\n\\n\\nIf you were dispatched as a subagent to execute a specific task, ignore this skill.\\n\\n\\n\\nIf you think there is even a 1% chance a skill might apply to what you are doing, you ABSOLUTELY MUST invoke the skill.\\n\\nIF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.\\n\\nThis is not negotiable. You cannot rationalize your way out of this.\\n\\n\\n## The Rule\\n\\n**Invoke relevant or requested skills BEFORE any response or action** — including clarifying questions, exploring the codebase, or checking files. If it turns out wrong for the situation, you don't have to use it.\\n\\n**Before entering plan mode:** if you haven't already brainstormed, invoke the brainstorming skill first.\\n\\nThen announce \\\"Using [skill] to [purpose]\\\" and follow the skill exactly. If it has a checklist, create a todo per item.\\n\\n## Skill Priority\\n\\nWhen multiple skills apply, process skills come first — they set the approach, then implementation skills (frontend-design, etc.) carry it out. Brainstorming and systematic-debugging are Superpowers' most common process skills, but the rule holds for any of them.\\n\\n- \\\"Let's build X\\\" → superpowers:brainstorming first, then implementation skills.\\n- \\\"Fix this bug\\\" → superpowers:systematic-debugging first, then domain skills.\\n\\n## Red Flags\\n\\nThese thoughts mean STOP—you're rationalizing:\\n\\n| Thought | Reality |\\n|---------|---------|\\n| \\\"This is just a simple question\\\" | Questions are tasks. Check for skills. |\\n| \\\"I need more context first\\\" | Skill check comes BEFORE clarifying questions. |\\n| \\\"Let me explore the codebase first\\\" | Skills tell you HOW to explore. Check first. |\\n| \\\"I can check git/files quickly\\\" | Files lack conversation context. Check for skills. |\\n| \\\"Let me gather information first\\\" | Skills tell you HOW to gather information. |\\n| \\\"This doesn't need a formal skill\\\" | If a skill exists, use it. |\\n| \\\"I remember this skill\\\" | Skills evolve. Read current version. |\\n| \\\"This doesn't count as a task\\\" | Action = task. Check for skills. |\\n| \\\"The skill is overkill\\\" | Simple things become complex. Use it. |\\n| \\\"I'll just do this one thing first\\\" | Check BEFORE doing anything. |\\n| \\\"This feels productive\\\" | Undisciplined action wastes time. Skills prevent this. |\\n| \\\"I know what that means\\\" | Knowing the concept ≠ using the skill. Invoke it. |\\n\\n## Platform Adaptation\\n\\nIf your harness appears here, read its reference file for special instructions:\\n\\n- Codex: `references/codex-tools.md`\\n- Pi: `references/pi-tools.md`\\n- Antigravity: `references/antigravity-tools.md`\\n- Hermes Agent: `references/hermes-tools.md`\\n\\n## User Instructions\\n\\nUser instructions (CLAUDE.md, AGENTS.md, GEMINI.md, etc, direct requests) take precedence over skills, which in turn override default behavior. Only skip skill workflows or instructions when your human partner has explicitly told you to.\\n\"\n }\n}\n","stdout":"{\n \"hookSpecificOutput\": {\n \"hookEventName\": \"SessionStart\",\n \"additionalContext\": \"\\nYou have superpowers.\\n\\n**Below is the full content of your 'superpowers:using-superpowers' skill - your introduction to using skills. For all other skills, use the 'Skill' tool:**\\n\\n---\\nname: using-superpowers\\ndescription: Use when starting any conversation - establishes how to find and use skills, requiring skill invocation before ANY response including clarifying questions\\n---\\n\\n\\nIf you were dispatched as a subagent to execute a specific task, ignore this skill.\\n\\n\\n\\nIf you think there is even a 1% chance a skill might apply to what you are doing, you ABSOLUTELY MUST invoke the skill.\\n\\nIF A SKILL APPLIES TO YOUR TASK, YOU DO NOT HAVE A CHOICE. YOU MUST USE IT.\\n\\nThis is not negotiable. You cannot rationalize your way out of this.\\n\\n\\n## The Rule\\n\\n**Invoke relevant or requested skills BEFORE any response or action** — including clarifying questions, exploring the codebase, or checking files. If it turns out wrong for the situation, you don't have to use it.\\n\\n**Before entering plan mode:** if you haven't already brainstormed, invoke the brainstorming skill first.\\n\\nThen announce \\\"Using [skill] to [purpose]\\\" and follow the skill exactly. If it has a checklist, create a todo per item.\\n\\n## Skill Priority\\n\\nWhen multiple skills apply, process skills come first — they set the approach, then implementation skills (frontend-design, etc.) carry it out. Brainstorming and systematic-debugging are Superpowers' most common process skills, but the rule holds for any of them.\\n\\n- \\\"Let's build X\\\" → superpowers:brainstorming first, then implementation skills.\\n- \\\"Fix this bug\\\" → superpowers:systematic-debugging first, then domain skills.\\n\\n## Red Flags\\n\\nThese thoughts mean STOP—you're rationalizing:\\n\\n| Thought | Reality |\\n|---------|---------|\\n| \\\"This is just a simple question\\\" | Questions are tasks. Check for skills. |\\n| \\\"I need more context first\\\" | Skill check comes BEFORE clarifying questions. |\\n| \\\"Let me explore the codebase first\\\" | Skills tell you HOW to explore. Check first. |\\n| \\\"I can check git/files quickly\\\" | Files lack conversation context. Check for skills. |\\n| \\\"Let me gather information first\\\" | Skills tell you HOW to gather information. |\\n| \\\"This doesn't need a formal skill\\\" | If a skill exists, use it. |\\n| \\\"I remember this skill\\\" | Skills evolve. Read current version. |\\n| \\\"This doesn't count as a task\\\" | Action = task. Check for skills. |\\n| \\\"The skill is overkill\\\" | Simple things become complex. Use it. |\\n| \\\"I'll just do this one thing first\\\" | Check BEFORE doing anything. |\\n| \\\"This feels productive\\\" | Undisciplined action wastes time. Skills prevent this. |\\n| \\\"I know what that means\\\" | Knowing the concept ≠ using the skill. Invoke it. |\\n\\n## Platform Adaptation\\n\\nIf your harness appears here, read its reference file for special instructions:\\n\\n- Codex: `references/codex-tools.md`\\n- Pi: `references/pi-tools.md`\\n- Antigravity: `references/antigravity-tools.md`\\n- Hermes Agent: `references/hermes-tools.md`\\n\\n## User Instructions\\n\\nUser instructions (CLAUDE.md, AGENTS.md, GEMINI.md, etc, direct requests) take precedence over skills, which in turn override default behavior. Only skip skill workflows or instructions when your human partner has explicitly told you to.\\n\"\n }\n}\n","stderr":"","exit_code":0,"outcome":"success","uuid":"551d14f6-950c-4f11-a08c-5f9d5ebd3101","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"init","cwd":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","tools":["Task","Artifact","CronCreate","CronDelete","CronList","DesignSync","EnterWorktree","ExitWorktree","Glob","Grep","ListAgents","Monitor","PushNotification","Read","RemoteTrigger","ReportFindings","ScheduleWakeup","SendMessage","ShareOnboardingGuide","Skill","TaskOutput","TaskStop","ToolSearch","WebFetch","WebSearch","Workflow"],"mcp_servers":[],"model":"claude-opus-5","permissionMode":"acceptEdits","slash_commands":["daily-report","monthly-summary","role-english-teacher","role-translator","role-ux","setup-tvu-consumer","shared-vocab-rules","deep-research","frontend-design:frontend-design","figma:figma-code-connect","figma:figma-create-new-file","figma:figma-design-to-code","figma:figma-generate-design","figma:figma-generate-diagram","figma:figma-generate-library","figma:figma-implement-motion","figma:figma-swiftui","figma:figma-use","figma:figma-use-figjam","figma:figma-use-motion","figma:figma-use-slides","superpowers:brainstorming","superpowers:dispatching-parallel-agents","superpowers:executing-plans","superpowers:finishing-a-development-branch","superpowers:receiving-code-review","superpowers:requesting-code-review","superpowers:subagent-driven-development","superpowers:systematic-debugging","superpowers:test-driven-development","superpowers:using-git-worktrees","superpowers:using-superpowers","superpowers:verification-before-completion","superpowers:writing-plans","superpowers:writing-skills","design","design-sync","dataviz","artifact-design","artifact-diagramming","artifact-capabilities","update-config","verify","debug","code-review","simplify","batch","fewer-permission-prompts","doctor","loop","schedule","claude-api","run","run-skill-generator","agents","auto-mode-setup","autocompact","clear","color","compact","config","context","effort","fast","heapdump","init","mcp","import","model","__remote-workflow","workflow-launch-exec","reload-skills","rename","security-review","usage-credits","extra-usage","usage","insights","recap","goal","design-consent","design-revoke","list-agents","team-onboarding"],"terminal_slash_commands":["doctor","color"],"apiKeySource":"none","claude_code_version":"2.1.241","output_style":"default","agents":["affordance-search","claude","claude-code-guide","design-review","Explore","general-purpose","Plan","statusline-setup"],"skills":["daily-report","monthly-summary","role-english-teacher","role-translator","role-ux","setup-tvu-consumer","shared-vocab-rules","deep-research","frontend-design:frontend-design","figma:figma-code-connect","figma:figma-create-new-file","figma:figma-design-to-code","figma:figma-generate-design","figma:figma-generate-diagram","figma:figma-generate-library","figma:figma-implement-motion","figma:figma-swiftui","figma:figma-use","figma:figma-use-figjam","figma:figma-use-motion","figma:figma-use-slides","superpowers:brainstorming","superpowers:dispatching-parallel-agents","superpowers:executing-plans","superpowers:finishing-a-development-branch","superpowers:receiving-code-review","superpowers:requesting-code-review","superpowers:subagent-driven-development","superpowers:systematic-debugging","superpowers:test-driven-development","superpowers:using-git-worktrees","superpowers:using-superpowers","superpowers:verification-before-completion","superpowers:writing-plans","superpowers:writing-skills","design","design-sync","dataviz","artifact-design","artifact-diagramming","artifact-capabilities","update-config","verify","debug","code-review","simplify","batch","fewer-permission-prompts","doctor","loop","schedule","claude-api","run","run-skill-generator"],"plugins":[{"name":"frontend-design","path":"/Users/nancy/.claude/plugins/cache/claude-plugins-official/frontend-design/unknown","source":"frontend-design@claude-plugins-official"},{"name":"figma","path":"/Users/nancy/.claude/plugins/cache/claude-plugins-official/figma/2.2.96","source":"figma@claude-plugins-official","version":"2.2.96"},{"name":"superpowers","path":"/Users/nancy/.claude/plugins/cache/claude-plugins-official/superpowers/6.3.0","source":"superpowers@claude-plugins-official","version":"6.3.0"},{"name":"superpowers","path":"/Users/nancy/.claude/plugins/cache/superpowers-marketplace/superpowers/6.0.3","source":"superpowers@superpowers-marketplace","version":"6.0.3"}],"capabilities":["interrupt_receipt_v1","interrupt_cancel_queued_v1","msg_lifecycle_v1"],"analytics_disabled":false,"product_feedback_disabled":false,"uuid":"5173c621-ff2e-40fa-b59d-0b2ade7d7cc9","memory_paths":{"auto":"/Users/nancy/.claude/projects/-Users-nancy-Documents-AICoding-VS-Code-tvu-design-system/memory/"},"messaging_socket_path":"/tmp/cc-socks/24375.sock","fast_mode_state":"off"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"af2809ea-091c-46a4-be82-d4e6e5887200","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":250,"estimated_tokens_delta":200,"uuid":"6e29b3c9-5af6-4e2a-91a3-bd17f7e0d9b9","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":350,"estimated_tokens_delta":100,"uuid":"dcf5367d-8c71-4623-bd07-aa20a75fb3e2","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":550,"estimated_tokens_delta":200,"uuid":"6841d27b-fd63-42d8-94f8-d7b48a3bc91f","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":700,"estimated_tokens_delta":150,"uuid":"c0abc17f-0b8f-48a6-8450-052a70c23bde","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":750,"estimated_tokens_delta":50,"uuid":"114cf787-551c-46ef-99e2-7ce05755bb2d","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":850,"estimated_tokens_delta":100,"uuid":"0b437a68-8dec-4668-ac59-770ff7c3ce27","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":950,"estimated_tokens_delta":100,"uuid":"55e43cc4-7de4-4455-bddf-e2b019742f84","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHuF1uopRXzZwTqD7X6","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"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"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":34249,"cache_read_input_tokens":25099,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":34249},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"510bb9ec-fdb1-4561-991e-71bc3154a193","timestamp":"2026-08-25T10:15:55.594Z","request_id":"req_011CePHuC5YjF5EAFDXiJDsm"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHuF1uopRXzZwTqD7X6","type":"message","role":"assistant","content":[{"type":"text","text":"我先走完这个仓库的 onboarding 链路（mockup 任务是 mandatory 全链），再动手产出。"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":34249,"cache_read_input_tokens":25099,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":34249},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"df83b1de-0cdf-4d39-a654-c5b80652c068","timestamp":"2026-08-25T10:15:57.135Z","request_id":"req_011CePHuC5YjF5EAFDXiJDsm"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHuF1uopRXzZwTqD7X6","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_014NJemK4UeiH4zutLDpQP8o","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/FIGMA_AS_SOURCE_OF_TRUTH.md"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":34249,"cache_read_input_tokens":25099,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":34249},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"ddc77021-a551-492a-89da-b2b445dcdaeb","timestamp":"2026-08-25T10:15:57.698Z","request_id":"req_011CePHuC5YjF5EAFDXiJDsm"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_014NJemK4UeiH4zutLDpQP8o","type":"tool_result","content":"1\t# Figma 是真源（Figma as Source of Truth）\n2\t\n3\t> **适用对象**：任何在本仓库工作的 AI 工具（Claude Code / Codex / Cursor / 其他）/ 开发 / 设计师。\n4\t> **优先级**：**高于** working-principles 任何条款；高于本文件之外的所有规则。\n5\t> **触发时机**：起手必读链路**第 0 步**——比 [`PROJECT_GOAL.md`](./PROJECT_GOAL.md) 还要先读。\n6\t> **历史背景**：2026-05-20 session 实证：纯静态 audit + 启发式 selector 匹配在一连串 finding 分类 / fix prompt 上产生 5 次错估错分，迫使本文件诞生。\n7\t\n8\t---\n9\t\n10\t## 唯一原则\n11\t\n12\t**Figma 设计系统库是真源。Code 组件必须 1:1 还原 Figma 组件的所有视觉属性（Color / Padding / Size / Radius / Opacity / Gap / Border / etc.）。**\n13\t\n14\t唯一允许的\"差异\"是**值形态映射**：Figma 端有些属性写的是 raw hex / px 字面量没走 Variable token；代码层用 token 变量去引用这些值，这是合法的映射层——**视觉等价**，命名形态不同。\n15\t\n16\t例：\n17\t- Figma 节点 fill 写 `#F0F0F0`（raw hex）↔ code `var(--color-grey-3)`（token 引用）—— **合法映射**，视觉等价\n18\t- Figma 节点 fill 绑 `UX/Grey/grey-3` (Variable) ↔ code `var(--color-grey-3)` —— **完美一致**\n19\t- Figma 节点 padding 写 `12px`（raw num）↔ code `padding: var(--sp-sm)` 其中 `--sp-sm: 12px` —— **合法映射**\n20\t\n21\t非例：\n22\t- Figma fill `#F0F0F0` ↔ code `var(--bg-layer4)`（其值是 `#dbdbdb`）—— **❌ 非法**，视觉不等价（这是 2026-05-19 select-chip 案例）\n23\t\n24\t---\n25\t\n26\t## 不允许的差异（违反 = code bug，不是 design choice）\n27\t\n28\t| ❌ 反模式 | 历史案例 |\n29\t|---|---|\n30\t| Code 用 Figma 没绑的 token | `.select-chip background: var(--bg-layer4)` 但 Figma 绑 `--color-grey-3` |\n31\t| Code 用 CSS 技巧替代 Figma 具体设计 | `.tvu-input:disabled { opacity: 0.4 }` 但 Figma 用 token desaturation (`--text-disabled` / `--control-disabled-*`) |\n32\t| Padding / gap / size / radius / opacity 跟 Figma variant 数值不一致 | `.select-chip gap: 4px` 但 Figma 8px；`.dropdown-select width: 240` 但 Figma L variant 300 |\n33\t| Code 自创 status / variant axis 不在 Figma 库里 | 已删除的 `notification.status=\"success\"` / `notification.type` / `badge.type` 形状轴 |\n34\t| Code 用 status-aspirational selector 但 Figma 实际绑别的 | `.select-wrap--error` 强行用 `--red`，但 Figma 在 error variant 实际绑 grey —— **fix code 跟 Figma，不是要求 Figma 改** |\n35\t\n36\t---\n37\t\n38\t## 合法的\"差异\"边界（**允许**，且必须显式登记到 [`src/design-system/translation/divergences-decisions.json`](../src/design-system/translation/divergences-decisions.json)）\n39\t\n40\t| ✅ 合法 | 性质 | 例子 |\n41\t|---|---|---|\n42\t| 值形态映射 | 视觉等价，命名形态不同 | Figma raw `#F0F0F0` ↔ code `var(--color-grey-3)` |\n43\t| 拓扑合成 | code 提供合成层包多个 Figma 单元 | button 8-set → 一个 canonical + 8 axis prop（`button-eight-sets-single-component`）|\n44\t| Figma 设计态 vs 运行态 | Figma axis 是设计预览开关不是 runtime prop | `dark theme=on/off` / `enable` / `UX` 等已登记的 design-state axes |\n45\t| Figma SLOT ↔ Vue slot | API 形态技术不可达 1:1 | `figma-content-slot-vue-slot` |\n46\t| Figma export 工具限制 | Figma API 自身限制 | `icon-variable-resolved-to-hex` (SVG export 把 Variable 解析为 hex) |\n47\t| 用户显式 code-first 拍板 | 项目方向变化，code 走在 Figma 前面 | `chart-color-palette-2026-05-13` / `pill-component-family-2026-05-19` —— **必须**含 \"user approved code-first YYYY-MM-DD\" 注释 |\n48\t\n49\t任何不属于上面 6 条的\"差异\"想登记 divergence ——**stop，重新分析，默认结论是 code bug 按 Figma fix**。\n50\t\n51\t---\n52\t\n53\t## 验证方法（**不允许启发式**）\n54\t\n55\t任何 Figma↔code 验证必须 **deterministic**：\n56\t\n57\t### 推荐机制（manifest-based render verification）\n58\t\n59\t1. 显式 manifest：`figma-data/render-verification-manifest.json`，每条 entry 是 (Figma nodeId, codeComponent, codeProps) 的 1:1 映射\n60\t2. Render harness：docs site 内 `/internal/render-harness/*` 路由按 manifest 渲染每个 variant 孤立实例\n61\t3. Playwright 跑 manifest：逐项 `getComputedStyle()` vs Figma extract 数值精确比较\n62\t4. 输出 per-variant PASS / FAIL（actual vs expected 数值）\n63\t\n64\t### 禁止做法\n65\t\n66\t| ❌ 禁止 | 理由 |\n67\t|---|---|\n68\t| 静态 selector-to-variant BEM 启发式匹配 | 实证假阳率 ≥40%（2026-05-20 session）|\n69\t| 凭 selector 名字字面 (`--error` / `--checked` / `--disabled`) 推 variant 含义 | selector 名字是 code 意图，不是 Figma 真源 |\n70\t| 把 audit finding \"Figma 端不对\" 默认结论为 designer漏标 | 默认是 code 错；designer 漂移需要 designer **明确 ack** |\n71\t| 把\"实现策略差异\"（如 CSS opacity vs token desaturation）登记为 divergence | 实现策略差 = code 偷懒；按 Figma 改 |\n72\t\n73\t---\n74\t\n75\t## AI 工具自检清单（起手必读第 0 步）\n76\t\n77\t在写任何 audit / fix prompt 前，AI 必须确认：\n78\t\n79\t- [ ] 我的 finding 是 deterministic 来源（manifest-based），还是启发式推断？\n80\t- [ ] 我是否在\"猜\" selector 跟哪个 variant 对应？如果是 → **STOP**，重写为 manifest 查表\n81\t- [ ] 我提议的 fix 方向是 code → 跟 Figma，还是 Figma → 跟 code？如果是后者 → 需要设计师 ack，否则默认 code fix\n82\t- [ ] 我登记的 divergence 是否落在上面 6 条合法边界内？如果不是 → 不要登记，按 Figma fix code\n83\t- [ ] 我对\"X-axis cleavage\"/\"100% same binding\"等批量结论是不是验证过**全数据**？还是只看了一部分子集就外推？\n84\t\n85\t任一项打 No → **STOP，重新设计**。\n86\t\n87\t---\n88\t\n89\t## 设计师自检清单（review Figma 真源时）\n90\t\n91\t设计师/用户在 Figma 端发现 binding 看起来不符合直觉（如 error 边框绑 grey 不是 red）时：\n92\t\n93\t- [ ] **默认假设**：Figma 当前 binding 就是设计意图（code 应该 follow）\n94\t- [ ] 如果要\"改 Figma\"（认为 Figma 漂移了），明确 ack：在 git commit message / divergence-decisions entry 写 `designer-acknowledged-figma-fix-needed-YYYY-MM-DD`\n95\t- [ ] 改完 Figma 后跑 `pnpm sync:figma-library` 让 figma-data 同步，audit 自动消化\n96\t- [ ] 不做 ack 直接让 code 端逆向用 status token (如 `--red`/`--brand`) —— ❌ 违反原则\n97\t\n98\t---\n99\t\n100\t## 历史教训（避免再犯，session 2026-05-19/20 实证）\n101\t\n102\t| # | 错误 | 根因 |\n103\t|---|---|---|\n104\t| 1 | 误判 170 case A rebind（实际 38）| axis cleavage 分析只看了 12/126 数据子集就外推 |\n105\t| 2 | 误判 126 dropdown-disabled 同 binding（实际 11）| 同上 |\n106\t| 3 | P3 §Fix 3 改错方向（把对的 200 改成 240）| 读 triage `\"240 -> 200px\"` 文本箭头方向歧义 |\n107\t| 4 | 误把 56 条 figma-drift 归到\"设计师漏标\"| audit selector-to-variant 启发式把 `enable=off` disabled variant 套到 `.select-wrap--error` selector |\n108\t| 5 | 推荐用 divergence 登记 opacity strategy | 没核实 disabled token 已存在；CSS opacity 是 code 偷懒不是必要妥协 |\n109\t\n110\t**共同根因**：缺 deterministic manifest。机制不修，AI（任何工具任何模型）还会重复错。\n111\t\n112\t---\n113\t\n114\t## 文档关系\n115\t\n116\t| 文档 | 用途 |\n117\t|---|---|\n118\t| **本文件**（`FIGMA_AS_SOURCE_OF_TRUTH.md`） | 第 0 步原则——优先级最高 |\n119\t| [`AGENTS.md`](../AGENTS.md) | AI 协作硬规则（含起手必读链路索引）|\n120\t| [`docs/PROJECT_GOAL.md`](./PROJECT_GOAL.md) | 项目目标 / 受众 / 路线图 |\n121\t| [`docs/working-principles.md`](./working-principles.md) | 9 条工作原则（次于本文件） |\n122\t| [`src/design-system/translation/divergences-decisions.json`](../src/design-system/translation/divergences-decisions.json) | 合法 divergence 显式登记表 |\n123\t| [`figma-data/render-verification-manifest.json`](../figma-data/render-verification-manifest.json) | ✅ **已建**（INFRA-F41）deterministic 验证 manifest（936 entries，每条 = Figma nodeId ↔ codeComponent ↔ codeProps + expectedNodes）；由 `pnpm test:render-verification` 跑、`pnpm audit:render-drift-gate` 闸 |\n124\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"1dd1ae4e-81fc-497f-8b96-ba8866360f6a","timestamp":"2026-08-25T10:15:57.720Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/FIGMA_AS_SOURCE_OF_TRUTH.md","content":"# Figma 是真源（Figma as Source of Truth）\n\n> **适用对象**：任何在本仓库工作的 AI 工具（Claude Code / Codex / Cursor / 其他）/ 开发 / 设计师。\n> **优先级**：**高于** working-principles 任何条款；高于本文件之外的所有规则。\n> **触发时机**：起手必读链路**第 0 步**——比 [`PROJECT_GOAL.md`](./PROJECT_GOAL.md) 还要先读。\n> **历史背景**：2026-05-20 session 实证：纯静态 audit + 启发式 selector 匹配在一连串 finding 分类 / fix prompt 上产生 5 次错估错分，迫使本文件诞生。\n\n---\n\n## 唯一原则\n\n**Figma 设计系统库是真源。Code 组件必须 1:1 还原 Figma 组件的所有视觉属性（Color / Padding / Size / Radius / Opacity / Gap / Border / etc.）。**\n\n唯一允许的\"差异\"是**值形态映射**：Figma 端有些属性写的是 raw hex / px 字面量没走 Variable token；代码层用 token 变量去引用这些值，这是合法的映射层——**视觉等价**，命名形态不同。\n\n例：\n- Figma 节点 fill 写 `#F0F0F0`（raw hex）↔ code `var(--color-grey-3)`（token 引用）—— **合法映射**，视觉等价\n- Figma 节点 fill 绑 `UX/Grey/grey-3` (Variable) ↔ code `var(--color-grey-3)` —— **完美一致**\n- Figma 节点 padding 写 `12px`（raw num）↔ code `padding: var(--sp-sm)` 其中 `--sp-sm: 12px` —— **合法映射**\n\n非例：\n- Figma fill `#F0F0F0` ↔ code `var(--bg-layer4)`（其值是 `#dbdbdb`）—— **❌ 非法**，视觉不等价（这是 2026-05-19 select-chip 案例）\n\n---\n\n## 不允许的差异（违反 = code bug，不是 design choice）\n\n| ❌ 反模式 | 历史案例 |\n|---|---|\n| Code 用 Figma 没绑的 token | `.select-chip background: var(--bg-layer4)` 但 Figma 绑 `--color-grey-3` |\n| Code 用 CSS 技巧替代 Figma 具体设计 | `.tvu-input:disabled { opacity: 0.4 }` 但 Figma 用 token desaturation (`--text-disabled` / `--control-disabled-*`) |\n| Padding / gap / size / radius / opacity 跟 Figma variant 数值不一致 | `.select-chip gap: 4px` 但 Figma 8px；`.dropdown-select width: 240` 但 Figma L variant 300 |\n| Code 自创 status / variant axis 不在 Figma 库里 | 已删除的 `notification.status=\"success\"` / `notification.type` / `badge.type` 形状轴 |\n| Code 用 status-aspirational selector 但 Figma 实际绑别的 | `.select-wrap--error` 强行用 `--red`，但 Figma 在 error variant 实际绑 grey —— **fix code 跟 Figma，不是要求 Figma 改** |\n\n---\n\n## 合法的\"差异\"边界（**允许**，且必须显式登记到 [`src/design-system/translation/divergences-decisions.json`](../src/design-system/translation/divergences-decisions.json)）\n\n| ✅ 合法 | 性质 | 例子 |\n|---|---|---|\n| 值形态映射 | 视觉等价，命名形态不同 | Figma raw `#F0F0F0` ↔ code `var(--color-grey-3)` |\n| 拓扑合成 | code 提供合成层包多个 Figma 单元 | button 8-set → 一个 canonical + 8 axis prop（`button-eight-sets-single-component`）|\n| Figma 设计态 vs 运行态 | Figma axis 是设计预览开关不是 runtime prop | `dark theme=on/off` / `enable` / `UX` 等已登记的 design-state axes |\n| Figma SLOT ↔ Vue slot | API 形态技术不可达 1:1 | `figma-content-slot-vue-slot` |\n| Figma export 工具限制 | Figma API 自身限制 | `icon-variable-resolved-to-hex` (SVG export 把 Variable 解析为 hex) |\n| 用户显式 code-first 拍板 | 项目方向变化，code 走在 Figma 前面 | `chart-color-palette-2026-05-13` / `pill-component-family-2026-05-19` —— **必须**含 \"user approved code-first YYYY-MM-DD\" 注释 |\n\n任何不属于上面 6 条的\"差异\"想登记 divergence ——**stop，重新分析，默认结论是 code bug 按 Figma fix**。\n\n---\n\n## 验证方法（**不允许启发式**）\n\n任何 Figma↔code 验证必须 **deterministic**：\n\n### 推荐机制（manifest-based render verification）\n\n1. 显式 manifest：`figma-data/render-verification-manifest.json`，每条 entry 是 (Figma nodeId, codeComponent, codeProps) 的 1:1 映射\n2. Render harness：docs site 内 `/internal/render-harness/*` 路由按 manifest 渲染每个 variant 孤立实例\n3. Playwright 跑 manifest：逐项 `getComputedStyle()` vs Figma extract 数值精确比较\n4. 输出 per-variant PASS / FAIL（actual vs expected 数值）\n\n### 禁止做法\n\n| ❌ 禁止 | 理由 |\n|---|---|\n| 静态 selector-to-variant BEM 启发式匹配 | 实证假阳率 ≥40%（2026-05-20 session）|\n| 凭 selector 名字字面 (`--error` / `--checked` / `--disabled`) 推 variant 含义 | selector 名字是 code 意图，不是 Figma 真源 |\n| 把 audit finding \"Figma 端不对\" 默认结论为 designer漏标 | 默认是 code 错；designer 漂移需要 designer **明确 ack** |\n| 把\"实现策略差异\"（如 CSS opacity vs token desaturation）登记为 divergence | 实现策略差 = code 偷懒；按 Figma 改 |\n\n---\n\n## AI 工具自检清单（起手必读第 0 步）\n\n在写任何 audit / fix prompt 前，AI 必须确认：\n\n- [ ] 我的 finding 是 deterministic 来源（manifest-based），还是启发式推断？\n- [ ] 我是否在\"猜\" selector 跟哪个 variant 对应？如果是 → **STOP**，重写为 manifest 查表\n- [ ] 我提议的 fix 方向是 code → 跟 Figma，还是 Figma → 跟 code？如果是后者 → 需要设计师 ack，否则默认 code fix\n- [ ] 我登记的 divergence 是否落在上面 6 条合法边界内？如果不是 → 不要登记，按 Figma fix code\n- [ ] 我对\"X-axis cleavage\"/\"100% same binding\"等批量结论是不是验证过**全数据**？还是只看了一部分子集就外推？\n\n任一项打 No → **STOP，重新设计**。\n\n---\n\n## 设计师自检清单（review Figma 真源时）\n\n设计师/用户在 Figma 端发现 binding 看起来不符合直觉（如 error 边框绑 grey 不是 red）时：\n\n- [ ] **默认假设**：Figma 当前 binding 就是设计意图（code 应该 follow）\n- [ ] 如果要\"改 Figma\"（认为 Figma 漂移了），明确 ack：在 git commit message / divergence-decisions entry 写 `designer-acknowledged-figma-fix-needed-YYYY-MM-DD`\n- [ ] 改完 Figma 后跑 `pnpm sync:figma-library` 让 figma-data 同步，audit 自动消化\n- [ ] 不做 ack 直接让 code 端逆向用 status token (如 `--red`/`--brand`) —— ❌ 违反原则\n\n---\n\n## 历史教训（避免再犯，session 2026-05-19/20 实证）\n\n| # | 错误 | 根因 |\n|---|---|---|\n| 1 | 误判 170 case A rebind（实际 38）| axis cleavage 分析只看了 12/126 数据子集就外推 |\n| 2 | 误判 126 dropdown-disabled 同 binding（实际 11）| 同上 |\n| 3 | P3 §Fix 3 改错方向（把对的 200 改成 240）| 读 triage `\"240 -> 200px\"` 文本箭头方向歧义 |\n| 4 | 误把 56 条 figma-drift 归到\"设计师漏标\"| audit selector-to-variant 启发式把 `enable=off` disabled variant 套到 `.select-wrap--error` selector |\n| 5 | 推荐用 divergence 登记 opacity strategy | 没核实 disabled token 已存在；CSS opacity 是 code 偷懒不是必要妥协 |\n\n**共同根因**：缺 deterministic manifest。机制不修，AI（任何工具任何模型）还会重复错。\n\n---\n\n## 文档关系\n\n| 文档 | 用途 |\n|---|---|\n| **本文件**（`FIGMA_AS_SOURCE_OF_TRUTH.md`） | 第 0 步原则——优先级最高 |\n| [`AGENTS.md`](../AGENTS.md) | AI 协作硬规则（含起手必读链路索引）|\n| [`docs/PROJECT_GOAL.md`](./PROJECT_GOAL.md) | 项目目标 / 受众 / 路线图 |\n| [`docs/working-principles.md`](./working-principles.md) | 9 条工作原则（次于本文件） |\n| [`src/design-system/translation/divergences-decisions.json`](../src/design-system/translation/divergences-decisions.json) | 合法 divergence 显式登记表 |\n| [`figma-data/render-verification-manifest.json`](../figma-data/render-verification-manifest.json) | ✅ **已建**（INFRA-F41）deterministic 验证 manifest（936 entries，每条 = Figma nodeId ↔ codeComponent ↔ codeProps + expectedNodes）；由 `pnpm test:render-verification` 跑、`pnpm audit:render-drift-gate` 闸 |\n","numLines":124,"startLine":1,"totalLines":124}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHuF1uopRXzZwTqD7X6","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_013CvxeorMLfUCxYNcVNXSDk","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/PROJECT_GOAL.md"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":34249,"cache_read_input_tokens":25099,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":34249},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"3dc3a638-dce8-4ca7-9d3f-2593fab29485","timestamp":"2026-08-25T10:15:58.389Z","request_id":"req_011CePHuC5YjF5EAFDXiJDsm"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHuF1uopRXzZwTqD7X6","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_017Fmidh2PC6yJXKqFvMEuqR","name":"Glob","input":{"pattern":".claude/skills/**/SKILL.md"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":34249,"cache_read_input_tokens":25099,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":34249},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"c24c2e35-c82d-4002-8711-e5bbbbc246bc","timestamp":"2026-08-25T10:15:58.395Z","request_id":"req_011CePHuC5YjF5EAFDXiJDsm"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_013CvxeorMLfUCxYNcVNXSDk","type":"tool_result","content":"1\t# TVU 设计系统 项目目标\n2\t\n3\t> 本文档是项目的最高指导原则。任何 AI 工具（Claude / Codex 等）在新 session 中接手任务时，**第一份必读文档**。\n4\t> 与之配合的还有：[`docs/PROJECT_MAP.md`](./PROJECT_MAP.md)（数据来源 / 组成 / 生成链 / 跨 AI 分工）、[`docs/working-principles.md`](./working-principles.md)（实现原则）、[`src/design-system/translation/`](../src/design-system/translation/)（翻译层 SoT）、[`docs/internal/retrospection/`](./internal/retrospection/)（决策复盘）。\n5\t\n6\t---\n7\t\n8\t## 一句话目标\n9\t\n10\t把 **Figma 已发布的 Library**（组件、Token、图标、Styles）做成 **AI 与开发可消费的双向 Figma↔Code 桥**：\n11\t\n12\t- 开发通过 **Element Plus 风格文档站 + npm install** 即可用（Vue 组件 / 设计 token / 图标 registry / 样式）\n13\t- AI 拿 **Figma URL** → 定位代码并 1:1 还原\n14\t- AI 拿 **代码页面** → 生成 / 还原 Figma 效果图\n15\t > 现状（能力 3 code→Figma，按边界如实分层）：**DS 生成的代码 _可_ 还原回 Figma**——经 `figma-data/render-verification-manifest.json`（936 条 Figma nodeId ↔ code 组件 ↔ props 确定性映射）+ canonical `data-figma-*` 溯源属性，回指**有且只有一个**设计库真源（`figmaFileKey = YbsPRUVmNdsbN40NNwh1Gn`，全 manifest distinct fileKey 实测唯一）。**真正缺的不是\"还原能力\"，而是自动 publish 链路的三块**：① Code Connect `.figma.ts` publish（Figma Professional plan，任何 Code Connect API 调用 401，需 Org/Ent seat；已实证）② 非 DS 代码（库外自绘组件）的反查 ③ Figma MCP 本地未配置。所以标 **DEFERRED（bypass equivalent）** 指的是\"全自动 code→Figma publish\"，**不是**\"code→Figma 不可为\"。详见 `docs/CAPABILITY_3_BYPASS.md` + STATUS §Deferred。\n16\t- AI 拿 **文字 / 链接 / 截图 / 代码任一组合** → 生成符合本规范的：\n17\t - **UX 效果图**（Figma 设计稿 / 截图）\n18\t - **可运行代码网页**（Vue 组件 + 部署）\n19\t > 现状：能力 4 当前实现为**合规守门（gate）+ AI 辅助合成**，非全自动生成器。\n20\t- 每个 Code 组件可追溯到 **Figma 来源**（哪个组件 / 哪个属性）\n21\t\n22\t---\n23\t\n24\t## 操作模型（谁用 / 怎么把关 / 质量如何保证）\n25\t\n26\t> 本节是项目北极星，后续任何流程优化都须遵守。目标架构（自触发脊梁 + 四支柱 + 元层）与差距登记见 `docs/internal/full-lifecycle-assessment-2026-07-08.md`（backlog INFRA-F55），演进中、不冻结进本文件。\n27\t\n28\t- **性质**：企业级设计系统，供多人使用。\n29\t- **角色**：一个 owner 把关质量；设计同事拉分支维护 + 使用；dev / PM 直接用现成系统做产品设计。\n30\t- **工具面（目标 / 现状分列）**：**目标** = Claude Code / Codex / 其它 AI / claude.ai·Design 类工具都要能产出高质量产品设计；**当前** = 仅 Claude Code（hooks + skills 全套）就位，Codex 半套、claude.ai/其它工具适配未齐——补齐是 backlog INFRA-F55 支柱③ 工作（现状诊断见 assessment §2 工具耦合）。\n31\t- **三条核心要求（目标，建设中）**：① **质量与\"用哪个工具\"解耦**（不绑单一工具）② 使用者**不必懂流程**，系统**自行触发**对应流程 ③ 团队成员**一看就知道如何使用**。\n32\t- **质量把关模型**：**非 owner 贡献者的改动走 PR，由 owner review**（目标：自动化 gate 做重活、人只点 merge）；**owner 本人改动直推 master**（fast-lane，见 `AGENTS.md` 硬规则 #7）。**gate 平权原则**：凡拦贡献者 PR 的 gate 同样挂 `push:master`，owner 直推路径不少过任何一关（真源 = [`.gitea/workflows/pr-checks.yml`](../.gitea/workflows/pr-checks.yml) 文件头 —— ⚠️ **2026-08-14 订正**：此处原写「见 backlog **INFRA-F56**」，而该号早已并入 `INFRA-F61`、backlog 全文零命中，是个悬挂指针）。\n33\t- **派生最高目标**：任何人 × 任何工具 → 被系统自动导进正确流程、产出高质量产品设计（code + mockup）。\n34\t\n35\t## Token 架构（Figma 变量 = 原子级真源）\n36\t\n37\t- **Figma Variable = 原子真源，sync-bound + gated**：54 个 Figma 变量含**两层**——原始色板（`--color-grey-*` / `--brand` / `--red` / …）+ **语义颜色层**（Figma `Color Type/*` → `--text-*` / `--icon-*` / `--bg-*` / `--line-*`）。全部由 `pnpm generate` 按名同步、`audit:token-contract` L5 gate 卡；**不可手改代码值，改设计改 Figma**。语义颜色 token 不是摆设，是原子依据。\n38\t- **非颜色 token = 当前值对齐、非变量绑定（保真缺口）**：间距 `--sp-*`、控件尺寸、Effect / Text Style、组件变体 token 不在 Figma Variable 里（Effect / Text 在 Figma 是 Style，间距代码手写），靠人工对齐值、无 gate。是否变量化见 backlog INFRA-F57。\n39\t- **分发形态**：CSS 变量（`dist/style.css`）+ **TS / JSON token 出口已发**（`./tokens` = DTCG `dist/tokens/tokens.json` · `./tokens/js` = resolved TS `dist/tokens/tokens.js`+`.d.ts`，INFRA-F55 支柱①，2026-07-10 起），非 web 工具已可消费。注：token 分发已解决；剩余缺口是**非色 token（spacing/size/effect）仍代码手写、未 Figma-Variable-绑定**（INFRA-F57），以及 DTCG 输出未标 `$extensions.tvu.source` 区分 figma-variable vs code-authored（见 assessment 2026-07-16 §支柱B）。\n40\t\n41\t---\n42\t\n43\t## 各能力的前置约束（写 T3 / T4 prompt 时必读）\n44\t\n45\t下面这些约束是为了让\"双向 + 多模态消费\"能力**不在后期返工**——而不是要现在实现。T3 / T4 prompt 设计时必须前置考虑。\n46\t\n47\t### T3 — EP 分类 + Figma origin 元数据\n48\t\n49\t- metadata schema 必须支持**双向查询**：\n50\t - (a) Figma node ID → code 路径（已规划）\n51\t - (b) **code 路径 → Figma node ID**（反向）\n52\t- 多 code 实体共享 Figma origin 时（如 SelectBoxLine + SelectBoxFilled 共享 `Select.feature=date`）必须支持 **N:1 映射**\n53\t\n54\t### T4a — Code Connect `.figma.ts`\n55\t\n56\t- 不只声明 props 映射，要预留 `reverseGenerationHints`（或类似字段）——后期反向生成器（Code → Figma）读这个字段重建 Figma node 结构\n57\t- 所有映射查 `axis-implementation-map.json` 真源（meta-rules 反模式 #1：不在 `.figma.ts` 自创映射）\n58\t\n59\t### T4b — AI manifest\n60\t\n61\tmanifest 顶层必须含：\n62\t\n63\t- `directions: ['figma-to-code', 'code-to-figma']` — 明示支持的方向\n64\t- `compositionSupport` — 不只描述单组件，还含组件组合规则（如 FormItem 包 Input、Table 包 Pagination）+ 布局/间距规范，让 AI 能合成 **页面级** 输出（不只单组件）。（前瞻约束、非现状：组合契约当前仅内部 `component-affordances.json`、不随包发；随包发是支柱① 工作）\n65\t- 各方向所需的额外锚点（如 code-to-figma 需要 baseline 截图引用、page-level 合成需要布局 token）\n66\t\n67\t### T5 — 视觉回归 baseline\n68\t\n69\tbaseline 截图除了用于回归检测，还作为：\n70\t\n71\t- code-to-figma 反向生成的视觉锚点（生成后跟 baseline diff 验证）\n72\t- 多模态合成（截图输入）的训练 / 校验语料\n73\t\n74\t---\n75\t\n76\t## 受众与他们的关注点\n77\t\n78\t| 角色 | 优先级 | 关注点 |\n79\t|---|---|---|\n80\t| **开发** | P0 主要使用者 | npm 安装、import 用法、props/events/slots、可复制代码示例、TypeScript 类型 |\n81\t| **设计** | P1 查看者 | 与 Figma 对应关系、变体网格、设计 spec、版本变更 |\n82\t| **产品** | P1 查看者 | 业务场景示例、组件能做什么、什么时候用哪个 |\n83\t| **QA** | P1 查看者 | 状态矩阵（hover/disabled/error/empty 等）、可交互测试、边界条件 |\n84\t\n85\t---\n86\t\n87\t## 关键产出物\n88\t\n89\t1. **Code 库**\n90\t - Vue 组件（`src/components/`）\n91\t - 设计 token（`tokens/`）——CSS 变量经 `./style.css` 分发 + **TS/JSON token 出口已发**（`./tokens` DTCG + `./tokens/js` resolved TS，见「Token 架构」节）\n92\t - 图标 registry（`src/icons/` + `icons/index.ts`）\n93\t - Styles（CSS 变量 + 主题）\n94\t\n95\t2. **npm 包发布机制**\n96\t - `package.json` 配置（entry、exports、types）\n97\t - 版本管理（semver）\n98\t - changelog 规范\n99\t - 公司其他项目 `npm install @ux-team/tvu-design-system` 即可使用\n100\t\n101\t3. **文档站（Element Plus 风格）**\n102\t - 参考站：https://element-plus.org/en-US/component/overview\n103\t - 必有结构：标题 + intro / 多段示例（preview + show source）/ API 表（Attributes / Slots / Events / Exposes）/ 右侧 TOC\n104\t - **多角色补充**（不止开发视角）：\n105\t - \"Design Spec\" tab / 段落：Figma 变体网格 + 设计稿对照\n106\t - \"Status Matrix\" tab / 段落：QA 视角的状态测试\n107\t > **scope 显式化（2026-06-10 system-review P2-08）**：Status Matrix 当前只建模 **Figma 导出的变体状态**（设计真源有的轴）；**runtime 态（empty / loading / error / 0 数据 / 超长文本）不在矩阵建模范围**——数据类组件（Table / Select）的 runtime 态 demo 是已知缺口，按需求触发补，不随组件页自动复制（StatusMatrix.vue 头注释同此声明；mockup 侧超长文本由 M43 管）。三视图覆盖与 pending 债务由 `audit:docs-site` + `site-review-manifest.json` views 字段跟踪\n108\t - \"Use Cases\" 段落：产品视角的业务示例\n109\t > 现状：当前落地 = 开发 + QA 双视图；**产品 Use Cases / 设计 Spec 视图为已知缺口**，按需补，不在此写版本 roadmap。⛔ **条数别在这里手抄** —— 真源是 `pnpm audit:docs-site` 自印的 `threeViewPending`（它不只信 manifest 自报，还拿页面源码正则交叉核）+ `site-review-manifest.json` 各 page 的 `views` 字段。此前这里写死的 `0/34 · 1/34` **分母当天就是错的**：34 取自 2026-07-08 的 manifest **总页数**（含 6 overview + 5 foundation），而带 `views` 的只有 component 页 —— 那天与今天都是 **25**（2026-08-07 复核：36 页 = 6+5+25，useCases present 0 / designSpec present 1）。\n110\t\n111\t4. **长期维护机制**\n112\t - **边界翻译层**（`src/design-system/translation/`）：显式管理 Figma↔Code 的命名/结构差异\n113\t - **Figma↔Code 锁定（防 drift）**：`figma connect publish`（Code Connect `*.figma.ts`）当前**不可达**（Figma Professional plan，任何 Code Connect API 调用返回 401，需 Org/Ent Developer seat；已实证）。**当前实际采用的等价同步机制**：硬规则 #6（AI 从 Figma URL 生成必用 `src/canonical/*` 作 SoT）+ 边界翻译层（`src/design-system/translation/`）+ `pnpm sync:figma-library` 14-step audit pipeline + `figma-data/render-verification-manifest.json`（936 entries，Figma nodeId ↔ code 组件 ↔ props 的确定性数值验证）。Code Connect 待 Figma plan 升级后纳入。\n114\t - **视觉层确定性脚本**（`scripts/visual-audit.ts`）：不依赖 AI 的对 diff，CI 可跑\n115\t\n116\t---\n117\t\n118\t## 不要做\n119\t\n120\t- ❌ **不修改 Figma**——Figma 是设计师的真源，代码出现差异时由翻译层登记\n121\t- ❌ **不让 AI 自由发挥**——Codex / Claude 必须读翻译层 + working-principles，不准按\"行业惯例\"补全\n122\t- ❌ **不让单组件深修阻塞 release 节奏**——但这 ≠「永不深修」。**Code 是否 1:1 还原 Figma 的保真度修正，是 post-launch 迭代的持续主线**：非破坏性修正（颜色 / 间距 / a11y / composition 复用）由 [`figma-vs-code-fidelity-audit-2026-05-29.md`](./_archive/_reports/figma-vs-code-fidelity-audit-2026-05-29.md) 驱动、**按 tier 排期（版本归属见 [`STATUS.md`](./STATUS.md) + tracker）**；破坏性 API 改造（如**已完成**的 Button canonical 迁移）走 0.x.0 minor。要点：fidelity 修正不阻塞交付节奏，也不被无限期搁置——**是持续进行的主线，不因某版本收尾而停**\n123\t- ❌ **不混合多语义到一个 prop**——发现同名异义（如 Badge.type = 颜色 vs Figma Type = 形状）必须拆\n124\t\n125\t---\n126\t\n127\t## 当前进度\n128\t\n129\t> ⚠️ **逐版本进度真源 = [`docs/STATUS.md`](./STATUS.md)**（当前版本 + 版本线分组 + Active 余量）**+ [`design-spec-canonical-alignment-tracker.md`](./internal/retrospection/design-spec-canonical-alignment-tracker.md)**（排期 SoT + 逐版本 retrospect）。本文件不再镜像版本路线——此处曾冻结在 v0.6.0 规划态多个版本（2026-06-10 system-review P2-07 de-mirror，同 AGENTS.md \"当前阶段定位\" 段范式）。\n130\t>\n131\t> 已完成的架构里程碑（稳定史实，不随版本滚动）：0-3 架构层（边界翻译层 / working-principles / 翻译层登记）→ 4-5 模式聚类 + B1-B10 决策 → 6.x 翻译层批量登记 + token 替换 → npm 包化 + Element Plus 风格文档站 → 0.x 逐版本 release（v0.2.0 起见 tracker §Release 排期）。\n132\t\n133\t> **排期原则**（不可违背）：项目目标对齐 > 依赖解锁 > 自动化标准化 > 短 cycle 顺路；**不按耗时 / 复杂度 / 成本最低排**。详见 tracker.md §排期原则。\n134\t\n135\t---\n136\t\n137\t## AI 协作规范（Codex / Claude / 其他）\n138\t\n139\t### 必读入口（按优先级）\n140\t1. **本文档**（PROJECT_GOAL.md）—— 知道在做什么\n141\t2. [`docs/PROJECT_MAP.md`](./PROJECT_MAP.md) —— 知道数据来源、项目组成、生成链和跨 AI 分工\n142\t3. [`docs/working-principles.md`](./working-principles.md) —— 知道怎么做\n143\t4. [`src/design-system/translation/`](../src/design-system/translation/) —— 知道已有决策\n144\t5. [`docs/internal/retrospection/`](./internal/retrospection/) —— 知道怎么走到这里的\n145\t\n146\t### Prompt 模板（验证有效）\n147\t位置：[`docs/internal/_prompts/`](./internal/_prompts/)\n148\t- 所有 Codex prompt 都以文件形式版本化\n149\t- 用户通过 `请读取并执行 docs/internal/_prompts/.prompt.md 中的指令` 触发\n150\t- 绕过 VS Code Codex 扩展的剪贴板编码 bug\n151\t\n152\t### Gate 机制（防 AI 漂移）\n153\t- 每个 prompt 末尾必带 \"完成后 STOP，等我决定下一步\"\n154\t- 关键参数（如 variant 枚举值、token 值）必须先返回给用户确认\n155\t- 双向 diff（code 侧 + Figma 侧）后只审 ⚠️ 行\n156\t- 视觉层硬错误（hex / 未定义 token）走脚本，不走 AI\n157\t\n158\t---\n159\t\n160\t## Quick Reference\n161\t\n162\t| 我想知道 | 看哪里 |\n163\t|---|---|\n164\t| 项目目标 | 本文档 |\n165\t| 数据来源 / 项目组成 / 生成链 / 清理规则 | [`docs/PROJECT_MAP.md`](./PROJECT_MAP.md) |\n166\t| 实现原则 | [`docs/working-principles.md`](./working-principles.md) |\n167\t| 当前进度 | [`docs/internal/retrospection/`](./internal/retrospection/)（最新日期） |\n168\t| 已做的决策 | [`src/design-system/translation/`](../src/design-system/translation/) + working-principles 末尾\"决策 Log\" |\n169\t| 下一步要跑的 prompt | [`docs/internal/_prompts/`](./internal/_prompts/) |\n170\t| API diff 状态 | [`docs/internal/api-diff.md`](./internal/api-diff.md) + [`api-diff-patterns.md`](./internal/api-diff-patterns.md) |\n171\t| 资产清单 | [`docs/internal/asset-inventory.md`](./internal/asset-inventory.md) |\n172\t| 组件级映射扫描 | [`docs/internal/component-mapping-scan.md`](./internal/component-mapping-scan.md) |\n173\t| 待补运行时能力 | [`docs/internal/runtime-additions.md`](./internal/runtime-additions.md) |\n174\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"92314bb2-0b7f-4a5d-be4e-cd89e882304e","timestamp":"2026-08-25T10:15:58.405Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/PROJECT_GOAL.md","content":"# TVU 设计系统 项目目标\n\n> 本文档是项目的最高指导原则。任何 AI 工具（Claude / Codex 等）在新 session 中接手任务时，**第一份必读文档**。\n> 与之配合的还有：[`docs/PROJECT_MAP.md`](./PROJECT_MAP.md)（数据来源 / 组成 / 生成链 / 跨 AI 分工）、[`docs/working-principles.md`](./working-principles.md)（实现原则）、[`src/design-system/translation/`](../src/design-system/translation/)（翻译层 SoT）、[`docs/internal/retrospection/`](./internal/retrospection/)（决策复盘）。\n\n---\n\n## 一句话目标\n\n把 **Figma 已发布的 Library**（组件、Token、图标、Styles）做成 **AI 与开发可消费的双向 Figma↔Code 桥**：\n\n- 开发通过 **Element Plus 风格文档站 + npm install** 即可用（Vue 组件 / 设计 token / 图标 registry / 样式）\n- AI 拿 **Figma URL** → 定位代码并 1:1 还原\n- AI 拿 **代码页面** → 生成 / 还原 Figma 效果图\n > 现状（能力 3 code→Figma，按边界如实分层）：**DS 生成的代码 _可_ 还原回 Figma**——经 `figma-data/render-verification-manifest.json`（936 条 Figma nodeId ↔ code 组件 ↔ props 确定性映射）+ canonical `data-figma-*` 溯源属性，回指**有且只有一个**设计库真源（`figmaFileKey = YbsPRUVmNdsbN40NNwh1Gn`，全 manifest distinct fileKey 实测唯一）。**真正缺的不是\"还原能力\"，而是自动 publish 链路的三块**：① Code Connect `.figma.ts` publish（Figma Professional plan，任何 Code Connect API 调用 401，需 Org/Ent seat；已实证）② 非 DS 代码（库外自绘组件）的反查 ③ Figma MCP 本地未配置。所以标 **DEFERRED（bypass equivalent）** 指的是\"全自动 code→Figma publish\"，**不是**\"code→Figma 不可为\"。详见 `docs/CAPABILITY_3_BYPASS.md` + STATUS §Deferred。\n- AI 拿 **文字 / 链接 / 截图 / 代码任一组合** → 生成符合本规范的：\n - **UX 效果图**（Figma 设计稿 / 截图）\n - **可运行代码网页**（Vue 组件 + 部署）\n > 现状：能力 4 当前实现为**合规守门（gate）+ AI 辅助合成**，非全自动生成器。\n- 每个 Code 组件可追溯到 **Figma 来源**（哪个组件 / 哪个属性）\n\n---\n\n## 操作模型（谁用 / 怎么把关 / 质量如何保证）\n\n> 本节是项目北极星，后续任何流程优化都须遵守。目标架构（自触发脊梁 + 四支柱 + 元层）与差距登记见 `docs/internal/full-lifecycle-assessment-2026-07-08.md`（backlog INFRA-F55），演进中、不冻结进本文件。\n\n- **性质**：企业级设计系统，供多人使用。\n- **角色**：一个 owner 把关质量；设计同事拉分支维护 + 使用；dev / PM 直接用现成系统做产品设计。\n- **工具面（目标 / 现状分列）**：**目标** = Claude Code / Codex / 其它 AI / claude.ai·Design 类工具都要能产出高质量产品设计；**当前** = 仅 Claude Code（hooks + skills 全套）就位，Codex 半套、claude.ai/其它工具适配未齐——补齐是 backlog INFRA-F55 支柱③ 工作（现状诊断见 assessment §2 工具耦合）。\n- **三条核心要求（目标，建设中）**：① **质量与\"用哪个工具\"解耦**（不绑单一工具）② 使用者**不必懂流程**，系统**自行触发**对应流程 ③ 团队成员**一看就知道如何使用**。\n- **质量把关模型**：**非 owner 贡献者的改动走 PR，由 owner review**（目标：自动化 gate 做重活、人只点 merge）；**owner 本人改动直推 master**（fast-lane，见 `AGENTS.md` 硬规则 #7）。**gate 平权原则**：凡拦贡献者 PR 的 gate 同样挂 `push:master`，owner 直推路径不少过任何一关（真源 = [`.gitea/workflows/pr-checks.yml`](../.gitea/workflows/pr-checks.yml) 文件头 —— ⚠️ **2026-08-14 订正**：此处原写「见 backlog **INFRA-F56**」，而该号早已并入 `INFRA-F61`、backlog 全文零命中，是个悬挂指针）。\n- **派生最高目标**：任何人 × 任何工具 → 被系统自动导进正确流程、产出高质量产品设计（code + mockup）。\n\n## Token 架构（Figma 变量 = 原子级真源）\n\n- **Figma Variable = 原子真源，sync-bound + gated**：54 个 Figma 变量含**两层**——原始色板（`--color-grey-*` / `--brand` / `--red` / …）+ **语义颜色层**（Figma `Color Type/*` → `--text-*` / `--icon-*` / `--bg-*` / `--line-*`）。全部由 `pnpm generate` 按名同步、`audit:token-contract` L5 gate 卡；**不可手改代码值，改设计改 Figma**。语义颜色 token 不是摆设，是原子依据。\n- **非颜色 token = 当前值对齐、非变量绑定（保真缺口）**：间距 `--sp-*`、控件尺寸、Effect / Text Style、组件变体 token 不在 Figma Variable 里（Effect / Text 在 Figma 是 Style，间距代码手写），靠人工对齐值、无 gate。是否变量化见 backlog INFRA-F57。\n- **分发形态**：CSS 变量（`dist/style.css`）+ **TS / JSON token 出口已发**（`./tokens` = DTCG `dist/tokens/tokens.json` · `./tokens/js` = resolved TS `dist/tokens/tokens.js`+`.d.ts`，INFRA-F55 支柱①，2026-07-10 起），非 web 工具已可消费。注：token 分发已解决；剩余缺口是**非色 token（spacing/size/effect）仍代码手写、未 Figma-Variable-绑定**（INFRA-F57），以及 DTCG 输出未标 `$extensions.tvu.source` 区分 figma-variable vs code-authored（见 assessment 2026-07-16 §支柱B）。\n\n---\n\n## 各能力的前置约束（写 T3 / T4 prompt 时必读）\n\n下面这些约束是为了让\"双向 + 多模态消费\"能力**不在后期返工**——而不是要现在实现。T3 / T4 prompt 设计时必须前置考虑。\n\n### T3 — EP 分类 + Figma origin 元数据\n\n- metadata schema 必须支持**双向查询**：\n - (a) Figma node ID → code 路径（已规划）\n - (b) **code 路径 → Figma node ID**（反向）\n- 多 code 实体共享 Figma origin 时（如 SelectBoxLine + SelectBoxFilled 共享 `Select.feature=date`）必须支持 **N:1 映射**\n\n### T4a — Code Connect `.figma.ts`\n\n- 不只声明 props 映射，要预留 `reverseGenerationHints`（或类似字段）——后期反向生成器（Code → Figma）读这个字段重建 Figma node 结构\n- 所有映射查 `axis-implementation-map.json` 真源（meta-rules 反模式 #1：不在 `.figma.ts` 自创映射）\n\n### T4b — AI manifest\n\nmanifest 顶层必须含：\n\n- `directions: ['figma-to-code', 'code-to-figma']` — 明示支持的方向\n- `compositionSupport` — 不只描述单组件，还含组件组合规则（如 FormItem 包 Input、Table 包 Pagination）+ 布局/间距规范，让 AI 能合成 **页面级** 输出（不只单组件）。（前瞻约束、非现状：组合契约当前仅内部 `component-affordances.json`、不随包发；随包发是支柱① 工作）\n- 各方向所需的额外锚点（如 code-to-figma 需要 baseline 截图引用、page-level 合成需要布局 token）\n\n### T5 — 视觉回归 baseline\n\nbaseline 截图除了用于回归检测，还作为：\n\n- code-to-figma 反向生成的视觉锚点（生成后跟 baseline diff 验证）\n- 多模态合成（截图输入）的训练 / 校验语料\n\n---\n\n## 受众与他们的关注点\n\n| 角色 | 优先级 | 关注点 |\n|---|---|---|\n| **开发** | P0 主要使用者 | npm 安装、import 用法、props/events/slots、可复制代码示例、TypeScript 类型 |\n| **设计** | P1 查看者 | 与 Figma 对应关系、变体网格、设计 spec、版本变更 |\n| **产品** | P1 查看者 | 业务场景示例、组件能做什么、什么时候用哪个 |\n| **QA** | P1 查看者 | 状态矩阵（hover/disabled/error/empty 等）、可交互测试、边界条件 |\n\n---\n\n## 关键产出物\n\n1. **Code 库**\n - Vue 组件（`src/components/`）\n - 设计 token（`tokens/`）——CSS 变量经 `./style.css` 分发 + **TS/JSON token 出口已发**（`./tokens` DTCG + `./tokens/js` resolved TS，见「Token 架构」节）\n - 图标 registry（`src/icons/` + `icons/index.ts`）\n - Styles（CSS 变量 + 主题）\n\n2. **npm 包发布机制**\n - `package.json` 配置（entry、exports、types）\n - 版本管理（semver）\n - changelog 规范\n - 公司其他项目 `npm install @ux-team/tvu-design-system` 即可使用\n\n3. **文档站（Element Plus 风格）**\n - 参考站：https://element-plus.org/en-US/component/overview\n - 必有结构：标题 + intro / 多段示例（preview + show source）/ API 表（Attributes / Slots / Events / Exposes）/ 右侧 TOC\n - **多角色补充**（不止开发视角）：\n - \"Design Spec\" tab / 段落：Figma 变体网格 + 设计稿对照\n - \"Status Matrix\" tab / 段落：QA 视角的状态测试\n > **scope 显式化（2026-06-10 system-review P2-08）**：Status Matrix 当前只建模 **Figma 导出的变体状态**（设计真源有的轴）；**runtime 态（empty / loading / error / 0 数据 / 超长文本）不在矩阵建模范围**——数据类组件（Table / Select）的 runtime 态 demo 是已知缺口，按需求触发补，不随组件页自动复制（StatusMatrix.vue 头注释同此声明；mockup 侧超长文本由 M43 管）。三视图覆盖与 pending 债务由 `audit:docs-site` + `site-review-manifest.json` views 字段跟踪\n - \"Use Cases\" 段落：产品视角的业务示例\n > 现状：当前落地 = 开发 + QA 双视图；**产品 Use Cases / 设计 Spec 视图为已知缺口**，按需补，不在此写版本 roadmap。⛔ **条数别在这里手抄** —— 真源是 `pnpm audit:docs-site` 自印的 `threeViewPending`（它不只信 manifest 自报，还拿页面源码正则交叉核）+ `site-review-manifest.json` 各 page 的 `views` 字段。此前这里写死的 `0/34 · 1/34` **分母当天就是错的**：34 取自 2026-07-08 的 manifest **总页数**（含 6 overview + 5 foundation），而带 `views` 的只有 component 页 —— 那天与今天都是 **25**（2026-08-07 复核：36 页 = 6+5+25，useCases present 0 / designSpec present 1）。\n\n4. **长期维护机制**\n - **边界翻译层**（`src/design-system/translation/`）：显式管理 Figma↔Code 的命名/结构差异\n - **Figma↔Code 锁定（防 drift）**：`figma connect publish`（Code Connect `*.figma.ts`）当前**不可达**（Figma Professional plan，任何 Code Connect API 调用返回 401，需 Org/Ent Developer seat；已实证）。**当前实际采用的等价同步机制**：硬规则 #6（AI 从 Figma URL 生成必用 `src/canonical/*` 作 SoT）+ 边界翻译层（`src/design-system/translation/`）+ `pnpm sync:figma-library` 14-step audit pipeline + `figma-data/render-verification-manifest.json`（936 entries，Figma nodeId ↔ code 组件 ↔ props 的确定性数值验证）。Code Connect 待 Figma plan 升级后纳入。\n - **视觉层确定性脚本**（`scripts/visual-audit.ts`）：不依赖 AI 的对 diff，CI 可跑\n\n---\n\n## 不要做\n\n- ❌ **不修改 Figma**——Figma 是设计师的真源，代码出现差异时由翻译层登记\n- ❌ **不让 AI 自由发挥**——Codex / Claude 必须读翻译层 + working-principles，不准按\"行业惯例\"补全\n- ❌ **不让单组件深修阻塞 release 节奏**——但这 ≠「永不深修」。**Code 是否 1:1 还原 Figma 的保真度修正，是 post-launch 迭代的持续主线**：非破坏性修正（颜色 / 间距 / a11y / composition 复用）由 [`figma-vs-code-fidelity-audit-2026-05-29.md`](./_archive/_reports/figma-vs-code-fidelity-audit-2026-05-29.md) 驱动、**按 tier 排期（版本归属见 [`STATUS.md`](./STATUS.md) + tracker）**；破坏性 API 改造（如**已完成**的 Button canonical 迁移）走 0.x.0 minor。要点：fidelity 修正不阻塞交付节奏，也不被无限期搁置——**是持续进行的主线，不因某版本收尾而停**\n- ❌ **不混合多语义到一个 prop**——发现同名异义（如 Badge.type = 颜色 vs Figma Type = 形状）必须拆\n\n---\n\n## 当前进度\n\n> ⚠️ **逐版本进度真源 = [`docs/STATUS.md`](./STATUS.md)**（当前版本 + 版本线分组 + Active 余量）**+ [`design-spec-canonical-alignment-tracker.md`](./internal/retrospection/design-spec-canonical-alignment-tracker.md)**（排期 SoT + 逐版本 retrospect）。本文件不再镜像版本路线——此处曾冻结在 v0.6.0 规划态多个版本（2026-06-10 system-review P2-07 de-mirror，同 AGENTS.md \"当前阶段定位\" 段范式）。\n>\n> 已完成的架构里程碑（稳定史实，不随版本滚动）：0-3 架构层（边界翻译层 / working-principles / 翻译层登记）→ 4-5 模式聚类 + B1-B10 决策 → 6.x 翻译层批量登记 + token 替换 → npm 包化 + Element Plus 风格文档站 → 0.x 逐版本 release（v0.2.0 起见 tracker §Release 排期）。\n\n> **排期原则**（不可违背）：项目目标对齐 > 依赖解锁 > 自动化标准化 > 短 cycle 顺路；**不按耗时 / 复杂度 / 成本最低排**。详见 tracker.md §排期原则。\n\n---\n\n## AI 协作规范（Codex / Claude / 其他）\n\n### 必读入口（按优先级）\n1. **本文档**（PROJECT_GOAL.md）—— 知道在做什么\n2. [`docs/PROJECT_MAP.md`](./PROJECT_MAP.md) —— 知道数据来源、项目组成、生成链和跨 AI 分工\n3. [`docs/working-principles.md`](./working-principles.md) —— 知道怎么做\n4. [`src/design-system/translation/`](../src/design-system/translation/) —— 知道已有决策\n5. [`docs/internal/retrospection/`](./internal/retrospection/) —— 知道怎么走到这里的\n\n### Prompt 模板（验证有效）\n位置：[`docs/internal/_prompts/`](./internal/_prompts/)\n- 所有 Codex prompt 都以文件形式版本化\n- 用户通过 `请读取并执行 docs/internal/_prompts/.prompt.md 中的指令` 触发\n- 绕过 VS Code Codex 扩展的剪贴板编码 bug\n\n### Gate 机制（防 AI 漂移）\n- 每个 prompt 末尾必带 \"完成后 STOP，等我决定下一步\"\n- 关键参数（如 variant 枚举值、token 值）必须先返回给用户确认\n- 双向 diff（code 侧 + Figma 侧）后只审 ⚠️ 行\n- 视觉层硬错误（hex / 未定义 token）走脚本，不走 AI\n\n---\n\n## Quick Reference\n\n| 我想知道 | 看哪里 |\n|---|---|\n| 项目目标 | 本文档 |\n| 数据来源 / 项目组成 / 生成链 / 清理规则 | [`docs/PROJECT_MAP.md`](./PROJECT_MAP.md) |\n| 实现原则 | [`docs/working-principles.md`](./working-principles.md) |\n| 当前进度 | [`docs/internal/retrospection/`](./internal/retrospection/)（最新日期） |\n| 已做的决策 | [`src/design-system/translation/`](../src/design-system/translation/) + working-principles 末尾\"决策 Log\" |\n| 下一步要跑的 prompt | [`docs/internal/_prompts/`](./internal/_prompts/) |\n| API diff 状态 | [`docs/internal/api-diff.md`](./internal/api-diff.md) + [`api-diff-patterns.md`](./internal/api-diff-patterns.md) |\n| 资产清单 | [`docs/internal/asset-inventory.md`](./internal/asset-inventory.md) |\n| 组件级映射扫描 | [`docs/internal/component-mapping-scan.md`](./internal/component-mapping-scan.md) |\n| 待补运行时能力 | [`docs/internal/runtime-additions.md`](./internal/runtime-additions.md) |\n","numLines":174,"startLine":1,"totalLines":174}}} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_017Fmidh2PC6yJXKqFvMEuqR","type":"tool_result","content":"No files found"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"89a26030-5bf9-4376-912f-916473b847ba","timestamp":"2026-08-25T10:15:58.622Z","tool_use_result":{"filenames":[],"durationMs":221,"numFiles":0,"truncated":false,"totalMatches":0,"countIsComplete":true}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHuF1uopRXzZwTqD7X6","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01Y71nL7bY1yFj7tT8XVbmks","name":"Glob","input":{"pattern":"docs/internal/mockup*.md"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":34249,"cache_read_input_tokens":25099,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":34249},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"aa78b136-b24f-40af-bb91-3b5655a231be","timestamp":"2026-08-25T10:15:58.633Z","request_id":"req_011CePHuC5YjF5EAFDXiJDsm"} {"type":"rate_limit_event","rate_limit_info":{"status":"allowed","resetsAt":1787658600,"rateLimitType":"five_hour","overageStatus":"rejected","overageDisabledReason":"out_of_credits","isUsingOverage":false},"uuid":"0138f8cd-bee9-4315-98c8-6ad5b8a7a5ee","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01Y71nL7bY1yFj7tT8XVbmks","type":"tool_result","content":"docs/internal/mockup-conventions.md"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"d1c66918-9a93-43be-955f-160c454a68d7","timestamp":"2026-08-25T10:15:58.682Z","tool_use_result":{"filenames":["docs/internal/mockup-conventions.md"],"durationMs":46,"numFiles":1,"truncated":false,"totalMatches":1,"countIsComplete":true}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"982a4161-2fff-4eb3-bff1-249a0b7b44c8","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":141,"estimated_tokens_delta":91,"uuid":"25cdc9c0-9b44-4aba-af4c-a983309bca4a","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHvjuzjTf3WWKESaimk","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISqAQKpgEIERgCKkCMgyOuuKycDVitHiDsd/5WW021ts78CqTwfrftH7ew0PjBjdVStw37ikl228refcdHFAbXr08ETxzemKLyvsjbMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAeLWtdQGsAECEgxbcZqrFf6YGn1KADsaDMy+ofRHQSVLt4nbTSIw8yZwzqN7iaTbVxpqJ5hA6liBQqCkEkCZecH/xPw9/TW1WQ7+ermMmqkZlmAdHkvjKq4C6MCrR8R/u3RgRhXHSJ9zyxUoyzp359vKC6UybWX5I7PKZMhQY6wQd6jngs01iVKASjJALUOcPFgwBkoqzCI4vZz4okyULEFB3kiGW52836QwrUPegZtg+18JkJA+VOakzS8tYEdWr6/2Ur3w0MPOEiEWPaEPoRR2vxVcwU/dm/y3x1seD6JVkI0FcxnGKl8+5Os7PlIBH2mw62/3mcmjvgGL4I6Y1UYhQVGERNAE9ilPOV1Styq1cfHVB3hFfzGx51Y8K092cymuR8EwD+06ACKpZdP01t05aOyClHCPzmTTtgg5n/V+ElWsrZ/2un2FnzqGq1VgU6a9yCc1QOravzJccyyWwS5prqiGdBFllQhskwy21lJJQye+E5gTSlW80jpyLZ42SIFzDr2kcAsYAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":12740,"cache_read_input_tokens":59348,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":12740},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"92c8a5e0-35d1-402a-8035-04c627663eb5","timestamp":"2026-08-25T10:16:02.573Z","request_id":"req_011CePHvggnEVWtptMdFEfxU"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHvjuzjTf3WWKESaimk","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01F7SAMnxSeJT8r34AjQRfap","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/STATUS.md"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":12740,"cache_read_input_tokens":59348,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":12740},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"fcf74588-b2d3-4bc7-bf9c-a6da5d13311c","timestamp":"2026-08-25T10:16:03.766Z","request_id":"req_011CePHvggnEVWtptMdFEfxU"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHvjuzjTf3WWKESaimk","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_017DGWKmy8WwB56QcKFudzSY","name":"Glob","input":{"pattern":".claude/**/*.md"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":12740,"cache_read_input_tokens":59348,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":12740},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"a5054684-415d-4285-be05-e8f55ff749d8","timestamp":"2026-08-25T10:16:03.798Z","request_id":"req_011CePHvggnEVWtptMdFEfxU"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_017DGWKmy8WwB56QcKFudzSY","type":"tool_result","content":".claude/agents/affordance-search.md\n.claude/agents/design-review.md"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"721c3b84-394e-4e33-ad9c-2b66e2b118eb","timestamp":"2026-08-25T10:16:03.874Z","tool_use_result":{"filenames":[".claude/agents/affordance-search.md",".claude/agents/design-review.md"],"durationMs":72,"numFiles":2,"truncated":false,"totalMatches":2,"countIsComplete":true}} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01F7SAMnxSeJT8r34AjQRfap","type":"tool_result","content":"1\t# TVU Design System — Status\n2\t\n3\t> **Last updated**: 2026-08-25 —— **落地线第三十轮：mockup conformance 合成单进程引擎 + 给闸的 stdout 定输出契约**（**Active 32 → 32**：新增 [[INFRA-F139]]、删档 INFRA-F132）。执行外部 lab 的两份处方（第 7 / 7b 步），⛔ 不是自选题。
🔴 **本轮最值钱的一条：给 11 条在链闸补一个「分母」字段，当场照出一条 L5 闸的绿三个月来不可解读。** `audit:figma-conformance` 的扫描面 `src/canonical/generated/*.vue` 实测 **0 个文件** ⇒ 每次发版都绿、绿无信息量。修法是 owner 裁定（退役 vs 改指向，两条都改发布链判据强度）⇒ [[INFRA-F139]] + 收割器里具名 shrink-only 豁免（照样每次打印）。**这不是契约引入的缺陷，是契约让一个一直存在的空分母第一次可见。**
**引擎实测**：进程 10 → **1** · 请求 12 → **3** / 大 payload 8 → **1**（请求计数器自证，⛔ 不用耗时代理）· 同一 fileKey 整文件 140s → **27.0s**（且在多跑一条规则的前提下）· 规则 9 → **10**。**规则清单真源从「代码位置」改成「一条命令」**（`--list-rules`）—— 指代码位置本身就是 stale 源。
**契约实测**：11 条在链 `figma-sync` 闸全部上契约，收割器 **11/11 解析出契约块、11/11 读出 findings 计数**（上契约前 10 条在吐 JSON、只有 **4** 条读得出）。选择面**钉 npm key**、⛔ 不钉文件特征。
**B1 = 这一族闸历史上第一个自动执行点**：`.claude/hooks/post-figma-write.sh` 每次 `use_figma` 写后自动后台跑引擎，fileKey **从 prompt 里的 Figma URL 捕获**（不是写死常量）。⚠️ L4，绕过面如实登记。
⚠️ **三条注入证明非空过**，其中一条打的是**接线**（摘掉 `failed` 表达式里一项 → 1 红），纯 import 单测覆盖不到那一半。
⛔ **数别抄，跑**：`pnpm report:gate-output-harvest` · `pnpm audit:mockup-conformance --list-rules`。验收逐条实测 / 两个既有缺陷前后对照 / KNOWN_SILENT 增删行 / 刻意偏离处方的理由 / 处方自身两处数字偏差，全在 [STATUS-CHANGELOG](./internal/STATUS-CHANGELOG.md) 顶条，⛔ 别在本行找。\n4\t> ——\n5\t> **更早各轮（session I–X）摘要已逐字归档**在 [STATUS-CHANGELOG](./internal/STATUS-CHANGELOG.md)；仍需接手人知道的**状态性事实**已各归其唯一真源 —— 主机拓扑 [`DEPLOY.md`](./DEPLOY.md) · docs 站发布口径 [`RELEASING.md`](./RELEASING.md) Step 4 · build 顺序 `scripts/check-dist-wc-freshness.mjs` 头注释 · 各闸的覆盖面与豁免语义在各自脚本头注释且**每次运行自印** · 其余在 [backlog](./internal/backlog.md) 各 entry。⛔ 别再往本段回写完成叙述，闸会拦。\n6\t>\n7\t> ### 一 · 等 owner 拍板（本仓库）\n8\t> 0a. **docs 站 644 张图标预览线上仍坏 —— 源码已修，等一次 docs 站 build + 发布**（`designAssetData.ts` 曾把 dev-server 专用的 `/@fs<绝对路径>` 前缀逐字带进产物）。⛔ 这不是代码待办，是**发布决策**：口径真源 [`RELEASING.md`](./RELEASING.md) §Step 4（= owner 决定，不是 REQUIRED）；测量口 `pnpm check:docs-site-version`（三态，`2` 当 `0` 用就是假绿）。修复经过在 [STATUS-CHANGELOG](./internal/STATUS-CHANGELOG.md) 第二轮那条。**本条 2026-08-18 从顶部摘要区搬来 —— 它是 open 的 owner 项，此前混在「已归档各轮」里容易被读成历史。**\n9\t> 0b. **loading 矩阵免横滚 —— ✅ owner 2026-08-13 已裁定走 ②（把每格 variant 文字 / nodeId 收起），⏳ 待落地**（docs 站视觉改动，走快车道）。裁定理由：② 消除根因（那些文字才是要求 180px 的原因），① 会**失去矩阵对齐** = 牺牲这个页面存在的意义（横向对比 variant）；nodeId 属查证时才用的次要信息，收进 hover / 点击展开即可。⚠️ 落地后仍需 owner 看一眼实际效果。原始两条路：① 把 ≤980 的卡片流降级上提到 ≤1100 / ≤1280（**已否决**）② 见上。背景：2026-08-12 已 ship 的是「够得着」（横滚 + ③ 删掉 ≤1280 反向加宽的列宽覆盖，所需 1260→1040、1280 档横滚量 682→462px）。⛔ 两条**已排除**：拖拽列宽不创造宽度（1280 档 6 列每列只 106px）· 让宽 demo 横跨右侧 CONTENTS 栏不可行（CONTENTS 是 shell 三栏 grid 里的 sticky item，横跨只能负 margin 画到它底下 = F67 (b) 专抓的「被盖住」）。\n10\t> 1. **DG-1 layout 原语 —— token 层 2026-07-31 已 ship，剩下两件事要 owner/designer 的视觉裁定**（owner 当日裁定「根据实际信息来显示即可 + 要有唯一值」→ 不等新表，值取实测现值做成单一定义；八个值逐字取自改动前在用的值、纯命名化零渲染变化，`audit:layout-tokens` L4+L5 上闸）：① ~~3 个存量一次性断点~~ → **✅ 2026-08-12 全部拍完，本子项关闭**：`docs.css` 720 **消除**（owner 拍「拆开归并」并当日 ship）· `progress-demo.css` 900 与 `button-demo.css` 980 **维持豁免不归并**（owner 08-11 / 08-12 分别拍定；判据 = 二者都是 React demo 内部栅格，改它对 DS 消费者零影响，而归并是净损失）。**三条的重开条件已各自写进 [`audit-layout-tokens.mjs`](../scripts/audit-layout-tokens.mjs) 的豁免表**，别在这里找。⚠️ 留一条教训：720 的裁定材料一度**过期**（08-11 那个数字当天就被抽屉导航作废，照它裁 = 按不存在的效果裁）——**「等 owner」条目的实测数字有保质期，隔了一次 ship 要重测再送审**。② ~~容器宽未收口~~ → **✅ owner 2026-08-11 拍定：维持 report-only，不收口**（那批 `max/min-width ≥600px` 是 demo/页面**内容宽**，硬塞进容器档位就是把偶然值当契约。⚠️ **处数别写死，读闸每次运行的自印** —— 这里 2026-08-12 我先把「19 处」改成「22」，**那是错的、当天已订正回来**：22 是闸自己数错的，`extractWidthLiterals`（S5）**不剥 CSS 注释**，把 08-11 抽屉导航那批注释里提到的 3 次 `max-width: 1100px` 当成了真声明。同文件的 `extractMediaWidths`（S3）08-11 修过这个病、S5 那边漏了。已补上同样的注释中和 + 3 条单测（含阴性对照：注释旁的真声明照收），修后实测 **19**，与 07-31 一致 —— **处数从来没漂过，漂的是闸的读数**）。闸的 S5 继续自印剩余处数，**别读成待办**。⚠️ 别读成「布局已收口」；终点仍是 A（Figma 变量），迁移只换真源方向、不改 token 名。详见 [spec §6c](./superpowers/specs/2026-07-30-dg1-layout-primitives-design.md)（§6b「等一张表」那行已就地标注被推翻）。\n11\t> 3. **Gitea registry TLS 化的 owner 残余**（原 INFRA-F74，**2026-08-14 该 entry 已删档 —— 仓库侧全部做完，剩下的只有下面这两件 owner 动作，本行现在是它们的家；⛔ 别再去 backlog 找 F74**）—— ① 人眼看一次新入口 `https://product-demo.tvustream.com/gitea/ux-team/-/packages`（硬纪律，API 绿不免除）· ② 建议轮换主机 `.env`(600) 里那份 `git ls-remote` 仍有效的 `GIT_AUTH`（签发需 owner UI，AI 无此权限）。⛔ **别把 `:3001` 写回 consumer 面 registry 配置** —— 它不是并列的备用入口，是 443 链路上的**中间一跳**，入口拓扑与那次修复的完整真源 = [`GITEA_ENTRYPOINTS.md`](./GITEA_ENTRYPOINTS.md)（⛔ 原先这里指的 `[[INFRA-F89]]` 已删档）。③ 主机上三个 `*.pre-f74*` 回退备份 **暂缓删除**（拿到 SSH 才用得上的唯一回滚源，保留成本为零）—— 三条精确路径已搬进 [`infra/README.md`](../infra/README.md) §主机侧回滚源。\n12\t> 4. **候选回流规则维持候选**（owner 07-29 答「先等等」）—— V4-1827 那批（PRD 措辞锚定产品现状基线 / 交付集与 mockup 同交付区 / 反馈态用文案+状态色、动效交 dev / 删缩元素前先列「谁靠它定位」）+ V4-2333 轮二三条（走查 scope / 偏差要写后果 / wrap-up 步骤有条件）。\n13\t> 5. **[[INFRA-F58]] 残余② 规则三层化 —— 处置待拍（建议整条搁置并重定义）**：2026-08-03 算完三个测量，**器械与目的不匹配** —— 宣称用途是 assessment 支柱① 的「让 claude.ai / Codex 能当 Project Instructions 直接吃」，但那五份文件（`AGENTS.md` + `meta-rules` + `design-process` + `code-conventions` + `mockup-conventions`）**一天涨 54 行、十一天涨 401 行**（08-03 = 7327 → 08-13 = 7674 → **08-14 实测 7728**），而最好可省 150-300 行 —— **可省量追不上分母的增长，比例还在往下走**。⛔ **别读这里的数，自己跑** `wc -l AGENTS.md docs/meta-rules.md docs/internal/{design-process,code-conventions,mockup-conventions}.md`（此处三轮都在漂，本行因此改为只留结论 + 取数命令）。另：原写的 `ds-bundle/reference/` 那组「近逐字搬运」数字（2885→2867 / 1488→1470）**在本仓不可复验** —— `ds-bundle/` 在 `.gitignore` 里、不入库，属外部事实。四块逐块判定 + 六处数字订正 + 两条执行前置见 [backlog F58 entry](./internal/backlog.md)（`e8120010`）。**建议改标「已 scoping、器械与目的不匹配、按需触发」而非留在待做**。⚠️ 若 owner 要真闭合那条 P1 缺口，需要的是**派生式精简产物**（从散文生成紧凑契约、生成而非手维护）—— 那是独立提案、有自己的设计问题（谁是真源 / 怎么防漂），**未立项**。另：任一动它的方案开工前须 owner 显式划清与 2026-06-12 被 reframe 掉的 [`rule-registry`](./internal/rule-registry-design-2026-06-12.md) wholesale reorg 的边界。\n14\t> 6. **DS 系统性评估的两件待办**（评估本身七轴已跑完、finding 已全部立成 [[INFRA-F114]]–[[INFRA-F128]]，叙述见上方摘要与 [评估报告](./internal/_reports/2026-08-13-ds-assessment-axes-abcd.md)）：① **6 份计划仍待起工** —— [闸扩面](./superpowers/plans/2026-08-12-rule-inventory-mirror-gate-extension.md) · [归档](./superpowers/plans/2026-08-12-live-tree-derivative-archive.md) · [场景路由](./superpowers/plans/2026-08-12-scenario-routing-single-source.md) · [PathA增量](./superpowers/plans/2026-08-12-path-a-legacy-host-increment-rule.md) · [判定表](./superpowers/plans/2026-08-12-element-decision-trace-product.md) · [UX场景](./superpowers/plans/2026-08-12-ux-scenario-coverage-expansion.md) ② ~~`AGENTS.md` 快车道「闸的判据」四字等 owner 确认原意~~ → **✅ 2026-08-13 已裁定并落地**（`46234b9f`）：原意 = **`tests/`**，⛔ 不含 `scripts/` 下的闸脚本 ⇒ **改 `scripts/` 的闸脚本不走快车道**。⚠️ **2026-08-13 晚订正本行后半句**（登记为 [[INFRA-F124]] ④）：此前这里与 AGENTS 那段 ⚠️ 注都写「⇒ 照常写 changeset」，而那是**依据 F117 落地前的 §「何时写」**推出来的 —— 同日 F117 已把判据收窄成 `files[]` 白名单。⇒ 正确表述 = **changeset 仍按 §「何时写」的 `files[]` 判据判，不在白名单里的内部 `audit-*.mjs` 属「不写」**。owner 的裁定实质未变，变的只是这半句转述。~~⚠️ 一个联动项：`§228` 把 `scripts/` 整个列为 consumer-facing 必写，F117 落地后要同步改~~ → **✅ 2026-08-13 已随 F117 一并落地（`5844130b`）**：`§228` 改为「`files[]` 白名单内那 20 个 `scripts/`」，并显式声明 **`files[]` 是唯一真源**、不在 AGENTS 里维护第二份会漂的清单。\n15\t>\n16\t> 7. **[[INFRA-F115]] 撤销旧 Figma PAT —— owner 2026-08-13 已同意，⏳ 待 owner 在 Figma UI 执行一步**（Settings → Personal access tokens 撤销那个旧 token）。**AI 侧结构上不可为**（⛔ 禁调 Figma API / 禁重签，见 §三 10），所以「它现在是否仍有效」只能由 owner 在该页确认。**影响面已核（2026-08-13，只看元数据未读任何凭据值）**：本仓所有读 Figma 凭据的脚本都走全仓唯一 parser `scripts/lib/figma-env.mjs` 读 `.env`（当前 PAT）· 旧 PAT 在本机的唯一驻留点就是 `.env.bak.1785390298`（`.env.local` 只有 `GITEA_HOST`、`~/.config/tvu/gitea-token` 是 Gitea 的）· **Gitea 与 GitHub workflow 里零处引用 Figma secret** ⇒ **本仓 / 本机 / CI 三面零影响，新 PAT 完全取代**。⚠️ **唯一核不到的**：`scripts/consumer-postinstall.mjs` 教 consumer 仓库设 GH secret `FIGMA_TOKEN`，MicroApps / NOC 那边那份值是新是旧**看不见**（别的仓库的 secrets）—— 撤销后若某 consumer 的 mockup conformance 报 403，就是它，重配即可。**⚠️ 2026-08-14 影响面重核（零 Figma API 调用、零凭据内容读取，只读元数据）**：那份明文副本当时**仍在**，`find` 全树（含 6 个 worktree）**精确 1 个命中** ⇒「本机唯一驻留点」有判据不只是断言 —— **该副本已于同日删除**（零引用已核、⛔ 未读其内容），但**删本地副本 ≠ 远端失效**，撤销仍只能 owner 在 Figma UI 做；读 Figma 凭据的文件现取 **12 个**（原 11，新增 `scripts/ds-health-scan-mockups.mjs`）、**12/12 全部走唯一 parser**；两 host 5 个 workflow 扫 `FIGMA` **零命中**（配阳性对照 `secrets\\.` 命中 3 行 ⇒ 非空过）。⇒ **三面零影响的结论未变。** 顺带查出一处不属本条的真缺陷（`consumer-postinstall.mjs` 教人配一个所给模板永远不读的 GH secret），已挂 [[INFRA-F115]] entry。\n17\t>\n18\t\n19\t> ### 二 · 等 designer（Figma 侧动手）\n20\t> ⭐ **2026-08-14 新增可交付**：⭐「拿错设计库」的清理清单已机械生成 —— [`_generated/foreign-library-cleanup.md`](./internal/_generated/foreign-library-cleanup.md)，逐个换成当前 DS 库组件。**污染源只有两个 file**（`TVU UX Library` 六文件全中 · `Nancy's Design Assets` 三文件），⛔ 别引用清单里的数（契约 G4：重跑 `pnpm health:mockups` 现算）。它由 `ds-health-scan-mockups.mjs` 全量成功时重写，⛔ **别手改**。\n21\t> 9. **design-review-queue 4 条** —— #4 Notification pop confirm 问句标点不一致（owner 定如实提取、由 designer 在 Figma 统一）+ 3 条 designer-action（off-scale px / multi-select padding outlier / 缺 disabled 变体），全 live 2026-06-11 验证过。详见 [design-review-queue.md](./internal/design-review-queue.md)。**⚠️ 2026-08-03：#3「缺 disabled 变体」多了第 4 个成员 `Tab/Item`**（**条数不变** —— 既有条目长出一个成员，不是新条目）。它把这条从「三个零散控件」变成**需要一次统一裁定**：同族 `select box/filled` / `input box/filled` / `switch` / `radio` **都有** `enable` 轴，缺的这四个不是族惯例、是漏。~~裁定要连数值一起给（0.4 / 0.45 / 第三条路 三选一 + 一个数）~~ → **✅ owner 2026-08-13 已裁定：走 `token desaturation`，且「定一个数」这一问作废**（`--control-disabled-*` / `--text-disabled` / `--icon-disabled` 是 **per-theme 具体色值不是透明度** ⇒ 四分叉 0.4 / 0.45 / ≈0.5 / 0.6 全部作废；依据 = `FIGMA_AS_SOURCE_OF_TRUTH.md:71` 逐字禁止把 opacity-vs-token 当实现策略差 + 实测 token 路线已是多数派 **12 : 8**）。**designer 侧仍待动手** = 在 Figma 给这 4 个成员补 disabled 变体、按 token desaturation 表达 —— ⚠️ **2026-08-14 owner 裁定后它不再是 code 的前置**（Figma 无变体时 code 直接绑既有语义 disabled token 即可，不算发明数值；规则真源 `code-conventions.md` §R9 disabled 行，参照实现 `TabItem.vue`），补变体的目的是补齐设计真源。**code 侧待办** = [[INFRA-F120]]（⚠️ 原并列的 `CANONICAL-F92` 已于 2026-08-14 删档 —— `Tab/Item` 的 code 侧四项实测早在立项前就已 shipped，结论搬进 `design-review-queue.md` §3 那条 🔑，那里另记了一条**待 owner 拍的一致性问题**：Tab 在 Figma 无变体的前提下已绑 token，与 F120 对 `Rating`/`Slider`/`Select` 的「无变体 ⇒ 等 designer」口径互斥）（⚠️ **2026-08-13 订正**：原写「改四个 + `Switch`/`InputNumber` 只需删多余 opacity 行」**已被实测推翻** —— 实为「三改 + 两个转为改 + 一个不动」，且三个改项在 Figma 无 disabled 变体、值仍等本条 designer 产出；观感会变，**必须过 owner 视觉签核**。逐条与证据在 [[INFRA-F120]] entry，另见 §一 7 那条待拍的例外）。\n22\t>\n23\t> ### 三 · 技术项未闭合（详情在 [backlog](./internal/backlog.md) §Active，此处只留最容易被漏的几条；条数别写死 —— 以 `pnpm run audit:status-consistency` 为准）\n24\t> 10. **变量层 ack 2026-10-28 到期即红**（原 INFRA-F79，**2026-08-13 已删档**：⛔ 禁止复现清单已搬进 `audit:variables-freshness` 的 PASS 自印输出 + `variables-staleness-ack.json` 的 `reviewQuestions` 两处真源，别再回写 backlog）。缺口按 **Figma plan = Professional** 的事实已闭合；出路只有 plan 升级（采购）或 Figma plugin 侧导出（未调研）；MCP `get_variable_defs` **只能点验、不能替代 sync**。\n25\t> 11. **[[INFRA-F66]] 残余** —— `tvu-drop-down-list-select` 的 `:host` 尺寸未判定（docs React demo 零渲染实例，且它是 light-DOM CE、`:host` 语义不同不能照搬）。🔴 **2026-08-14 订正触发条件**：原写「触发 = 给它补 React demo 时一并判」并以为硬规则 #8 的闸会推动它 —— **实测那个闸的 in-scope 根本不含它**（无 slot、零 boolean prop），闸绿是空过；React 侧不渲染还是 `Select.tsx` 里一条显式裁定（`F45 OUT`）。⇒ **真触发 = owner 主动把它提为一级 demo 组件**，别等闸。（原 INFRA-F67 已于 2026-08-14 闭合删档 —— 三件残余全部实测已闭；(c-3) 那段「够格独立成 entry」的内容也已全部完成，给已完成的工作立新 entry 违反「完成即删档」。）\n26\t> 12. **尚无人接：只剩 [[INFRA-F75]]，且它的体量 2026-08-14 被推翻** —— 它**不是**「NOC 迁 registry」：实测那份 `upstream-gate` 副本**从来没有** registry/token 配置，与本仓 `templates/upstream-gate-workflow.yml` 逐行比**只差 2 行包名**，且它当前连 `package.json` 都没有、在任何 runner 上都跑不起来。⚠️ 原记的「被 GitHub Actions 额度软阻塞」引的是**7 月**的月度额度，跨月后多半已失效（未实测，待 NOC 侧确认）。致病机制（DS 改 template 包名 → consumer 已复制出去的副本不会跟着改，且无人发现）已搬进 [`MIGRATION_TO_V1.md`](./MIGRATION_TO_V1.md) §3 并把扫描面从 `src` 扩到 `.github/workflows`。（~~INFRA-F90 docs 站 URL 无 section anchor~~ —— **✅ 2026-08-03 已 ship 并从 backlog 删档**，形态 = 路由后多一个尾段 `#/component//`，沿用 `#/changelog/` 的既有先例；**hash 路由只有一个 `#`，不存在第二个 fragment**，所以不可能做成 `#…#anchor`。⚠️ **两条如实登记的边界**：① slug 由标题文本派生 → **跨 locale 不解析**（中文站复制的链接在英文站只停在页面顶部 = 修复前行为，良性降级）② `/changelog` 与 `/`（overview）**不支持**段锚点 —— 前者尾段已被版本号占用。段落 slug 的**唯一定义** = `playground/docs/navigation.ts` 的 `slugifySectionTitle`，与 F88 视觉闸内联那份必须逐字一致，由 `tests/docs-section-anchor.test.ts` 的漂移闸钉住。**已发到真站并端到端验过**，签核可直接贴形如 `…/playground-dist/#/component/button/button-api` 的链接。）\n27\t>\n28\t> **第四条线（design-sync：Sync A 补齐 + runtime 刷新 + TopBar/MenuList 对齐 Figma，08-13 起 / 08-14 全部收口）**：叙述见 [CHANGELOG](./internal/STATUS-CHANGELOG.md) 顶条，判据 / 取证 / 通道归属 / 验证边界的真源在 [`.design-sync/NOTES.md`](../.design-sync/NOTES.md)。**本线在 STATUS 已无待办**。\n29\t>\n30\t> **本文档是项目状态 SoT**，也是 onboarding 链路的唯一 SoT。在 L-core 里它是 **#1**——**第 0 份是 [`FIGMA_AS_SOURCE_OF_TRUTH.md`](./FIGMA_AS_SOURCE_OF_TRUTH.md)**（见下方 §起手必读链路 的 L-core 表，那张表是次序真源）。本文件早于 PROJECT_GOAL.md 读，因为它直接告诉你\"在哪\"。\n31\t\n32\t> 任何 session wrap up 时**必须更新本文档**（见末尾\"Wrap-up 协议\"）。\n33\t>\n34\t> ⚠️ **排期 SoT 在 [`retrospection/design-spec-canonical-alignment-tracker.md`](./internal/retrospection/design-spec-canonical-alignment-tracker.md)**——本文件 Version Roadmap 段只是镜像。任何 \"v0.X 包含哪些 / 先做哪个\" 决策前先读 tracker 的 \"排期原则\" 自检清单。\n35\t\n36\t---\n37\t\n38\t## 一句话目标\n39\t\n40\t把 Figma 已发布 Library 做成 **AI 与开发可消费的双向 Figma↔Code 桥**（详见 [`PROJECT_GOAL.md`](./PROJECT_GOAL.md)）。\n41\t\n42\t---\n43\t\n44\t## Claude Code Plugin\n45\t\n46\tUX 团队 AI workflow skill 的独立分发轨道（与 npm 包版本独立）。详见 [`docs/PLUGIN.md`](./PLUGIN.md)。\n47\t\n48\t---\n49\t\n50\t## 当前版本：v1.2.0（✅ **published & verified 2026-07-31** —— 四步核验俱全（tag→CI 历史首跑 + registry API 两路 + 真取回 tarball 逐字核 sha1 + owner 人眼核 Packages 页）。**完整取证实录 2026-08-13 已逐字下沉** [STATUS-CHANGELOG](./internal/STATUS-CHANGELOG.md) §「v1.2.0 发布核验实录」——⛔ 别在本行找 run 号 / sha1 / 解包抽验清单。**核验协议真源 = [`RELEASING.md`](./RELEASING.md)**（registry API 两路 + 真取回 tarball + Packages 页人眼亲验；硬纪律，API 绿不免除 —— v0.1.0/v0.1.1 曾 silent fail 1-2 周）。）\n51\t\n52\t| 项 | 值 |\n53\t|---|---|\n54\t| v1.2.0 内容 | **4 minor + 3 patch**（全 additive，无组件 API 移除/改名）：`./web-components` 出口（React / 原生 CE 第一次有 npm 消费路径；⚠️ tarball 2.84 → 4.74 MB，+67%）· Select 触发器补 combobox ARIA · `peerDependencies` 改 `vue: ^3.5.0`（[[INFRA-F85]]）· 浮层层级 token 化（`--z-dropdown` / `--z-tooltip` / `--z-modal` / `--z-select-portal`）·（patch）I18N-01 可见文案 key 真被组件消费 + 防回归闸 · registry 改走 HTTPS 标准端口（原 INFRA-F74，已删档）· UserMenu 面板对齐 Figma `DtZcMkhNy6qh6jbQQnhreQ` node `6423:85`。逐条详情见 [`CHANGELOG.md`](../CHANGELOG.md) |\n55\t| 本次 publish | ⏳ **走 tag→CI**（`.gitea/workflows/publish.yml`，tag `v1.2.0`）。**这条链此前从未执行过一次**（Gitea 1.22.6 没有 `workflow_dispatch`，因此本 host 无干跑能力；恢复干跑的前置 = 升 Gitea ≥1.23）。三个必须逐段读的观察点：① pre-flight 凭据闸（A 读 / B **真写一次 probe** / C 删除并重读列表核实）② changesets-consumed guard ③ `pnpm publish` 本体。401/403 的读码方式写在 workflow 注释与 `RELEASING.md` §Troubleshooting |\n56\t| 包名 | `@ux-team/tvu-design-system`（团队 Gitea registry）。GitHub Packages 上旧包名 `@nancyzeng0210/tvu-design-system` 的 15 个版本（≤1.1.0）**刻意保留不删**（rollback 退路；⚠️ **2026-08-14 订正**：括号里原写的第二条理由「MicroApps/vue-app 仍钉 `^0.6.1`」**已为假** —— 该仓 `111c408`（2026-08-07）已迁到 `^1.2.0`，两个 consumer 都在新 registry 上了。**「别清旧包」这条禁止动作本身仍成立**，靠的是 rollback 退路那条），此后不再有新版本发到那里 |\n57\t| 上一版本 | v1.1.1 —— ✅ published & verified 2026-07-30T02:39:15Z（Gitea registry，**本机 `scripts/publish-to-gitea.sh` 发**，因为 tag→CI 的 secret 当天才修好；三路核验 + owner 人眼确认俱全，叙述归档在 [STATUS-CHANGELOG](./internal/STATUS-CHANGELOG.md)）|\n58\t| 安装 | `pnpm add @ux-team/tvu-design-system` + Gitea `.npmrc`（**HTTPS 标准端口**：`https://product-demo.tvustream.com/gitea/api/packages/ux-team/npm/`）+ **Gitea** token（`read:package`；GitHub PAT 不行，Gitea 在 `authGroup.Verify` 就拒）。步骤见 [`RELEASING.md`](./RELEASING.md) §External consumer setup |\n59\t| Release 流程 | changesets + **tag-triggered 自托管 Gitea CI** + strict audit 链（**条数别写死 —— `prepublishOnly` 是链的 SoT，要数就读它**；此处曾写「32 条」而 2026-08-05 实测 37 步 = 35 条 `audit:*` + `lint-skills` + `lint:ds`）+ Node 20/22 matrix（vitest 仅 Node 22 —— 3 个 audit 脚本靠 Node≥22 原生 TS 类型剥离）+ changesets-consumed guard + **render-gate 前移到切 tag 时在本机强制**（不在 CI：Gitea runner 非特权装不了 chromium 系统库）。GitHub 侧 `gates.yml` = dispatch-only、无发布能力，⚠️ 别给它恢复 tag trigger |\n60\t| 破坏性 (1.2.0) | **无 API 破坏** —— 组件 API / 样式 / token 均无变化。但有一条 consumer 侧硬门槛：**peer 下界升到 `vue ^3.5.0`**，钉 `3.4.x` 的 consumer 装不上。那条「支持 3.4」事实上早已不存在（shipped 代码在用 Vue 3.5 才有的 `useId()`，3.4 上渲染 Tooltip/Select 当场报 `useId is not a function`）——本版删掉的是一句假声明，不是砍掉能用的支持 |\n61\t| 版本详情 | [`CHANGELOG.md`](../CHANGELOG.md) |\n62\t| 注 | ⚠️ 生态：`vue@3.5.36`（曾是 npm latest）官方发布产物损坏（`workspace:*` 未替换），consumer fresh install 需钉 `3.5.35` 或本仓库在用的 `3.5.32`；与本包发布无关 |\n63\t\n64\t---\n65\t\n66\t## 能力 × 成熟度（单一真源表 · INFRA-F58）\n67\t\n68\t> 5 能力定义真源 = [`PROJECT_GOAL.md`](./PROJECT_GOAL.md) §一句话目标；本表只登记**当前成熟度 + 该能力状态的单一真源**，避免\"读了 PROJECT_GOAL 承诺信以为真\"（assessment §5 承诺-vs-实现）。成熟度变化改本表。\n69\t\n70\t| # | 能力 | 成熟度 | 状态单一真源 |\n71\t|---|---|---|---|\n72\t| 1 | 开发 npm install 即用（Vue 组件 / token / 图标 / 样式） | 🟡 **partial** — Vue 全通；**token = CSS 变量 + DTCG JSON + TS 出口**（`./tokens` DTCG · `./tokens/js` resolved TS，INFRA-F55 支柱①）；**React 无 published npm 路径**（经 CE + `react-pilot` 内部 bindings，非 `./react` 导出） | `package.json` exports + PROJECT_GOAL §Token 架构 + assessment §5 |\n73\t| 2 | AI 拿 Figma URL → 定位代码 1:1 还原 | ✅ **done** — manifest 确定性验证 | `figma-data/render-verification-manifest.json`（936）+ FIGMA_AS_SOURCE_OF_TRUTH.md |\n74\t| 3 | AI 拿 代码 → 生成 / 还原 Figma | ⚠️ **DEFERRED（bypass equivalent）** — DS 代码 _可_ 经 manifest + 唯一库 `YbsPRUVmNdsbN40NNwh1Gn` 还原；缺的仅\"全自动 Code Connect publish\"（Pro plan 401）+ 非 DS 反查 + MCP config | PROJECT_GOAL 能力3 + `CAPABILITY_3_BYPASS.md` |\n75\t| 4 | AI 拿 文字/链接/截图/代码 → UX 效果图 + 可运行代码 | 🟡 **gate + AI 辅助合成**（非全自动生成器）；mockup 确定性后验强制化 = F55 缺口 A | PROJECT_GOAL 能力4 + assessment §4 支柱② 设计网 |\n76\t| 5 | 每个 Code 组件可追溯 Figma 来源 | ✅ **done** — canonical `data-figma-*` + manifest N:1 | canonical 组件 `data-figma-*` 属性 + manifest |\n77\t\n78\t---\n79\t\n80\t## Version Roadmap（剩余按版本线分组）\n81\t\n82\t> 本段只留 **open / blocked** 项——已 shipped 版本（v0.2.0–v0.7.0）逐版本 retrospect + 历史完成项在 [`design-spec-canonical-alignment-tracker.md`](./internal/retrospection/design-spec-canonical-alignment-tracker.md) §轨道 A 已完成 / §Release 排期（完成叙述不在 STATUS 累积 — status-keep-only-unfinished）。\n83\t\n84\t### ✅ v1.0.0（稳定承诺 — API 锁定 · **已发布 2026-07-20**）\n85\t\n86\t> **published & verified**：GitHub Packages `1.0.0` created 2026-07-20T10:33:19Z · CI run [29735085984](https://github.com/NancyZeng0210/TVU-Design-System/actions/runs/29735085984)。首个稳定版，公开 API 锁定（[`API_STABILITY.md`](./API_STABILITY.md)）；scope = 组件保真镜像层（36 组件 + token + 图标 + 双向 Figma↔code 桥），产品构建层（Table/Form/layout/pattern）列 v1.x/v2。\n87\t> **触发条件回顾**（全满足）：5 能力交付（能力 3 旁路 ack）· L5 口径 A（tooling ships + MicroApps adopts）· color-contrast owner-accept 收口 · burn-in waived · RC soak（MicroApps Console ≥1 周 0 critical，owner 2026-07-20 sign-off go）。\n88\t\n89\t### 🔵 v1.3.0（**规划中** — 排期层 2026-08-13 重建）\n90\t\n91\t> **排期 SoT 在 [tracker `### v1.3.0`](./internal/retrospection/design-spec-canonical-alignment-tracker.md)，本段只是指针，别在这里找批次内容。**\n92\t> 缘起：原排期图终点是 v1.0.0，2026-07-20 **达成**后没有人画第二张图 ⇒ 排期层空了 4 周，\n93\t> 期间 backlog 涨到 57 条且**无一条有版本归属**（表现 = 一堆 High/Medium 谁也说不上先做哪个）。\n94\t> owner 2026-08-13 拍「先补规划层，别急着往下做条目」。\n95\t> **分拣的主要产出是认定大多数 entry 不该排队**（17 条是「下次碰 X 时」的触发式）。\n96\t> ⚠️ **「57」这个数尚未经核对** —— 当日抽样两次命中 stale（[[INFRA-F119]] 可关一半 · 原 INFRA-F122 存量 2→6（该 entry 2026-08-14 已落地删档）），别把它当工作量。\n97\t\n98\t| 后续 | 版本线 |\n99\t|---|---|\n100\t| ~~批次 A — consumer 面发布正确性~~ → **✅ 2026-08-13 全部 ship（`5844130b`）**：F114 / F117 已删档、F105 只剩 ①③④；顺带闭合 F102。终态判据与留下的已知缺口（`./web-components` 仍无 types）全在 [tracker `### v1.3.0`](./internal/retrospection/design-spec-canonical-alignment-tracker.md)，⛔ 别在这里找 | v1.3.0 |\n101\t| 批次 B 凭据卫生 · 批次 C 让已有的闸真的守住 · 批次 D 大件（Tier 1-C ESLint plugin / F62 / F60，**起不起由 owner 拍**）| v1.3.0 / 待拍 |\n102\t| 产品构建层剩余（layout 原语 / pattern 层）—— APID-02 Form 校验引擎 + APID-01 Table 状态层均已随 **v1.1.0** 发布 | v1.x / v2（backlog INFRA-F68 Batch D/E/G）|\n103\t\n104\t### ⚪ Deferred / Out of scope\n105\t\n106\t| 项 | 状态 | 理由 |\n107\t|---|---|---|\n108\t| **能力 3 (AI code→Figma)** | DEFERRED bypass shipped | Figma Pro plan 限制；[`CAPABILITY_3_BYPASS.md`](./CAPABILITY_3_BYPASS.md) 提供等价方案 |\n109\t| **T1c Extract Pipeline** | PAUSED | plan owner \"元层疑问\"未解 |\n110\t| **Phase 8** 视觉脚本 + Code Connect | DEFERRED | 需 Figma Org plan 升级 |\n111\t\n112\t---\n113\t\n114\t## Active 后续工作\n115\t\n116\t```\n117\tBacklog (active) (32): INFRA- F58·F60·F61·F62·F63·F66·F68·F69·F75·F81·F86·F91·F101·F105·F106·F107·F115·F120·F123·F129·F131·F133·F134·F137·F138·F139 · CANONICAL- F92–F94(打包入口·现只含 F93+F94)·F93·F94·F95·F104 · META-DSYNC-01 —— 计数镜像；状态/待办/⛔ 全在 backlog.md ## Active 各自 entry（C4 机械核）。⛔ 这串别手抄，从活源生成：`grep '^### ' docs/internal/backlog.md`\n118\tdesign-review-queue (4): 设计侧待 designer 动手（off-scale px / multi-select padding outlier / 缺 disabled 变体 / Notification pop confirm 标点）—— 计数镜像，与 §二 9 同口径。⛔ 各条 live 复核日期**别在此抄**（三条不同日），见 design-review-queue.md 各条自带实测行。✅ 2026-08-21 起有闸：`audit:status-consistency` C6（判据 = 真源 `designer-action: yes` 条数，核三处镜像）\n119\tCode-leads divergences (3): msg-bg-tinted-dark / chart-color-palette / pill-component-family — 见 translation/divergences-decisions.json\n120\tDeferred (3): 能力3 bypass · T1c · Phase 8\n121\t```\n122\t\n123\t**真正 next 可推进的**（2026-08-05 复核，**此前三处指路句已 stale 并就地删除**：f73 plan 的「轨道 A 发 1.1.0，卡 owner 建 Gitea PAT」—— 1.1.1/1.2.0 都已发完；`1.1.2` 那条载荷路线 07-31 已作废；`2026-07-30-v1x-next-batch` 的 **10 个 Task 已全部执行完**，Task 10 = 发 v1.2.0）：[[INFRA-F104]]（render-gate 降级判据字段化）**已于 2026-08-07 ship 并从本段删档**（数字/闸细节见上方 Last updated 摘要）——⚠️ **本段已被排期层取代 —— 「下一个做什么」的答案现在在 [tracker `### v1.3.0`](./internal/retrospection/design-spec-canonical-alignment-tracker.md)，别在本段挑**（本段历来是\"零散指路句\"，而 2026-08-13 的分拣证明零散指路正是排期层空缺的症状：57 条 entry 无一条有版本归属）。~~**建议最先** = v1.3.0 批次 A 三条 consumer 面发布正确性~~ → **✅ 2026-08-13 已 ship（`5844130b`）并删档**（F114 / F117 / 顺带 F102；F105 只剩 ①③④）。**不等 owner、不等 designer 的**（~~F98~~ 2026-08-06 已 ship 删档 · ~~F119~~ **2026-08-13 已完全闭合并删档**：步骤①亲验发现 2026-07-31 就已存在于 `release.mjs` step 1c、步骤② 76 张基线已 ship `3cb3e36b`）= ~~[[INFRA-F100]]~~ → **✅ 2026-08-17 整条落地并删档**（三条结构缺口 + 最后那条「37 行豁免按 CE 语义逐行复核」）。**封路理由与诚实边界已全部搬进 `scripts/audit-render-drift-gate-react.mjs` 头注释**（闸每次运行自印），⛔ 别再来 backlog 找这个号 · **Tier 1-C** `@ux-team/eslint-plugin-tvu-design-system`（能力 1 加固，tracker 估 ~2-3 周，自 v0.6.0 挂到现在 —— 「大所以推后」逐字命中 tracker §排期原则反模式表，要继续推后需要一个**不是\"大\"的**新理由，起不起由 owner 拍）。另有 RTL-01 / F68 FID-04 M1 role-map 全量铺开，各自成批。design-review-queue 4 条待设计师（⚠️ 此处 2026-08-21 前一直写 **3**，是本文件里第三处 stale 的同一个量 —— F136 立项时只发现两处；现由 `audit:status-consistency` C6c 吃**所有**出现处）。\n124\t\n125\t**排期决策必读**：[`retrospection/design-spec-canonical-alignment-tracker.md`](./internal/retrospection/design-spec-canonical-alignment-tracker.md) §排期原则 — **不按耗时 / 复杂度 / 成本最低排，按项目目标对齐 + 依赖解锁 + 自动化标准化排**。\n126\t\n127\t---\n128\t\n129\t## 起手必读链路\n130\t\n131\t> **本节是 onboarding 链路的唯一 SoT**（AGENTS.md §必读链路 只登记任务触发表，不再维护并行清单 — 2026-06-10 system-review P1-07/P1-08 重构为两层，消除双链路 drift + 与仓库 lazy-load 原则对齐）。\n132\t>\n133\t> **⛔ Mandatory Gate**：任何 AI session 在第一个项目相关回答 / 推荐 / 任务前，**必须全文读完 L-core 四份**，并读完命中触发条件的 L-ref 最小集。机械执行：用 TodoWrite / TaskList 为 L-core 每项 + 命中的 L-ref 项各建 1 个 todo，逐个 Read 完才能回答。基于 partial L-core 给推荐 = **协议违反**。**唯一的减档 = 下方 [§微改档](#微改档单文件纯文案的减档)**（owner 2026-08-13 裁定新增），判据不满足即回落本档、无第二个例外。\n134\t>\n135\t> **体量口径 —— 本行是唯一真源**（`AGENTS.md` §Onboarding Gate 只指回这里，刻意不复述数字）：**2026-08-04 `wc -c` 实测 65.2 KB** = 三份固定文件 59.8 KB（FIGMA_AS_SOURCE_OF_TRUTH 8.1 + 本文件 37.0 + PROJECT_GOAL 14.7）+ 当前 pickup（本轮那份 5.4）。⚠️ **引用前先自己重跑** `wc -c` 那四份 —— 它们每工作日都在涨，本行也会漂。此前这里与 AGENTS 两处都写着「~40KB ≈ 10-15min」，而 2026-08-03 实测已是 **90.5 KB**、失真 **2.2×**（原 INFRA-F95 已付代价 4 —— **该 entry 三项待做全部闭合、2026-08-13 已删档**；本轮清理让本文件从 63.7 → 37.0 KB，L-core 因此回落到 65.2）。⚠️ **2026-08-13 实测 L-core 四份已回涨到 ~74 KB**（本文件 ~45 KB）—— 正是本行自己说的「本行也会漂」，**别引用这两个数，自己跑 `wc -c`**。**别再写死耗时** —— 那正是下方「历史实证」里 gate 被默读架空的机械成因。\n136\t\n137\t### 微改档（单文件 · 纯文案的减档）\n138\t\n139\t> **owner 2026-08-13 裁定新增。这是本链路唯一的减档，本节是它的唯一 SoT**（`AGENTS.md` §Onboarding Gate 只留一行指针，刻意不复述判据 —— 复述一份就是第二处会漂的副本，[[INFRA-F121]] 已付过这个代价）。\n140\t> 缘起：此前唯一豁免是「用户首条 query 明显非项目相关」，于是「把这句 UI 文案从 A 改成 B」也要先吃 65 KB。gate 设严的原因是 2026-05-13 跳读致首轮推荐漏 4 项硬约束，所以减档不是取消 gate，而是**把省下的风险交给下方升级条件接住**。\n141\t\n142\t**适用判据（四条全中才算，任一不中 → 回落完整 L-core）**：\n143\t\n144\t1. 改动落在**单个文件**内；\n145\t2. 性质是**纯文案 / 措辞**（UI 可见文本、注释、文档行文、错误提示字串）；\n146\t3. **不换组件、不改 token、不加删元素、不动布局**，也不涉及组件选型判断；\n147\t4. 不是 mockup 写操作，也不是推荐 / 排期 / 裁定 / 发版类回答。\n148\t\n149\t**微改档要读的（省下 STATUS 本文件 + PROJECT_GOAL + 当前 pickup 三份）**：\n150\t\n151\t| # | 文件 | 为什么它不能省 |\n152\t|---|---|---|\n153\t| 0 | ⭐ [`FIGMA_AS_SOURCE_OF_TRUTH.md`](./FIGMA_AS_SOURCE_OF_TRUTH.md) 全文 | 文案也可能踩「code 反向要求改 Figma」；本文件是唯一能拦住它的 |\n154\t| — | [`AGENTS.md`](../AGENTS.md) §硬规则表 | 硬规则里的写边界 / commit 纪律与改动大小无关 |\n155\t\n156\t**⛔ 自动升级条件（硬 —— 命中任一即当场停下补读完整 L-core 再继续，不许「就差一点，先改完」）**：\n157\t\n158\t- 发现要动的不只是文案：要**换组件**、要**改 / 新增 token 或写字面量**、要**加删元素或改布局**；\n159\t- 要动**第二个文件**（含\"顺手把生成产物也重跑一下\"）；\n160\t- 触到**组件选型**（该用 A 还是 B）、**Figma 真源判断**、**divergence 登记**；\n161\t- 用户在同一 session 里追加了任何非微改任务，或要求推荐 / 排期 / 裁定；\n162\t- 自己不确定判据 1-4 是否满足 —— **不确定就是不满足**。\n163\t\n164\t**⛔ 本档不放宽的**：mockup 写操作仍走 `AGENTS.md` §Mockup Write Gate 4 步前置 + §必读链路 7-11 整链（不受本档影响）；任何写 Figma 的动作照旧要显式授权。\n165\t\n166\t### L-core — 每 session 全文必读（禁 grep / 跳读 / 摘要替代）\n167\t\n168\t| # | 文件 | 作用 |\n169\t|---|---|---|\n170\t| **0** | ⭐ [`FIGMA_AS_SOURCE_OF_TRUTH.md`](./FIGMA_AS_SOURCE_OF_TRUTH.md) | **最高优先级原则** — Figma 真源 + 唯一合法 divergence + 禁止启发式验证 |\n171\t| 1 | **本文件 STATUS.md** | 知道在哪（状态镜像 + 本链路 SoT） |\n172\t| 2 | [`PROJECT_GOAL.md`](./PROJECT_GOAL.md) | 知道目标（5 个能力 + 受众 + 约束） |\n173\t| 3 | [`_plans/next-session-pickup-*.md`](./internal/_plans/) 最新一份
**⚡ 当前活跃优化程序（固定指针 · 不靠 mtime · 并行 session 再写新 pickup 也不漂移）**：[全生命周期优化](./internal/_plans/next-session-pickup-2026-07-08-full-lifecycle-optimization.md) → 存档 SoT [`full-lifecycle-assessment-2026-07-08`](./internal/full-lifecycle-assessment-2026-07-08.md)（tracked = backlog **INFRA-F55**） | 当前 sprint 操作手册 |\n174\t\n175\t### L-ref — 最小集必读 + 命中触发再深读（各文件顶部有「🤖 AI 读取指引」）\n176\t\n177\t| 文件 | 每 session 最小集 | 升级为全读 / 深读的触发 |\n178\t|---|---|---|\n179\t| [`AGENTS.md`](../AGENTS.md) | §硬规则表（含 Enforcement 层级列）+ §Onboarding Gate | 写 prompt / 审 executor → §工作流 + task-type 矩阵；commit 前 → §Git 工作流；**mockup 任务 → §Mockup Write Gate + §必读链路 7-11 整链升 mandatory** |\n180\t| [`tracker`](./internal/retrospection/design-spec-canonical-alignment-tracker.md) | §排期原则 | 任何\"v0.X 包含哪些 / 先做哪个 / 该不该上 Tier N\"决策 → 全读 |\n181\t| [`backlog.md`](./internal/backlog.md) | — | 当前 sprint task 对应 entry → **全文 Read（不是 grep）**；新增 entry → 先 grep 全部已用 ID |\n182\t| [`meta-rules.md`](./meta-rules.md) | 触发器目录（标题扫一遍） | 写 prompt / 设计机制 / 推荐方案前 → 反模式清单全读 |\n183\t| [`code-conventions.md`](./internal/code-conventions.md) | — | **写 UI 代码的任何任务**（Vue / React / HTML — 含 `playground/docs/*`、`src/components/*`、下游产品 demo 与 PoC）→ 顶部 **§🤖 AI 读取指引 的「起手必读段」**（§R0 Phase 0 元素→组件映射 + §R7 四场景判断 + Task Entry Modes 的唯一活源），单条 R-rule 按该表触发条件 jump。⛔ 禁全量吞（近 90 KB）；⛔ 跳过起手必读段直接进 R-rule = 协议违反。**注**：机械路径 `detect-figma-task.sh` 只在 prompt 含 `figma.com/(design\\|file)/` URL 时触发，**没有 Figma URL 的 code 任务全靠本行**（[[INFRA-F121]] ①） |\n184\t| [`working-principles.md`](./working-principles.md) | 原则 0-8 标题 | 实现决策（命名 / token / API 形态）命中 → 对应原则全读 |\n185\t| [`translation/`](../src/design-system/translation/) 4 文件 | — | Figma↔Code 命名 / divergence / alias 决策时查对应文件 |\n186\t| mockup 链（AGENTS §7-11 + [`figma-component-catalog.md`](./internal/figma-component-catalog.md)） | — | **mockup 任务整链升 mandatory**（Mockup Write Gate 的 4 步前置不变，仍是硬规则） |\n187\t\n188\t> **违反信号（分层版，命中任一 → 停下重读）**：\n189\t> - L-core 没读完就给项目相关回答 / 推荐 → 错（\"我已经知道大概了 / 状态简单跳一步\" 同罪）\n190\t> - L-core 或 backlog 当前 task entry 用 grep / 摘要替代全文 Read → 错\n191\t> - 命中 L-ref 触发条件却只读了标题 / 最小集 → 错（如排期决策没全读 tracker、mockup 任务没读 §7-11）\n192\t> - \"memory 兜底替代 SoT\" → 错（memory 是 AI 缓存，项目契约真源在仓库）\n193\t>\n194\t> **历史实证**：2026-05-13 session 10 跳过 PROJECT_GOAL + AGENTS → 首轮推荐缺 4 项硬约束（canonical SoT / plan owner 边界 / working-principles / meta-rules）→ 用户返工纠偏。2026-06-10 system-review P1-08：旧版\"全量读 ~225KB（mockup +270KB）标 30min\"失真 → gate 被默读架空；两层化让严格性落在读得完的集合上。\n195\t\n196\t---\n197\t\n198\t## Wrap-up 协议\n199\t\n200\t> **session 收尾时读** [`docs/WRAP-UP.md`](./WRAP-UP.md)（每-session STATUS 必改项 + Release wrap-up + Retrospection 触发判断）。\n201\t> 核心一条：顶部 \"Last updated\" 改到今天 + 当日摘要（旧摘要 prepend 进 STATUS-CHANGELOG.md）；SessionEnd hook 自动核验日期。\n202\t\n203\t---\n204\t\n205\t## 文件关系（防混淆）\n206\t\n207\t| 文档 | 用途 | 更新节奏 |\n208\t|---|---|---|\n209\t| **STATUS.md**（本文件） | 全局状态镜像 + 版本线分组 + Active 余量 | **每 session** |\n210\t| `PROJECT_GOAL.md` | 项目目标 + 5 个能力 + 受众 + 约束 | 大方向变才改（罕见） |\n211\t| `_plans/next-session-pickup-*.md` | 当前 sprint 操作手册（prompts / 任务顺序 / dirty 协议） | **每 sprint** |\n212\t| `CHANGELOG.md` | Release-facing（外部 consumer 看）| 每 release |\n213\t| `backlog.md` | 全量 entry 详情（Active only，完成直接删） | 每发现 / 每完成 |\n214\t| `retrospection/design-spec-canonical-alignment-tracker.md` | 设计规范完整计划 + 进度时间线（living doc）| **每 session wrap-up 前同步** |\n215\t| `retrospection/*.md` | 阶段复盘（决策 / 反模式 / 教训） | 每阶段完成 |\n216\t| `internal/STATUS-CHANGELOG.md` | 历史 session changelog 归档（从本文件拆出） | 每 session wrap-up |\n217\t| `WRAP-UP.md` | session 收尾协议（STATUS 必改项 / Release / retrospect 触发） | 罕见 |\n218\t| `PLUGIN.md` | Claude Code plugin 独立分发轨道 | 每 plugin release |\n219\t\n220\t**真源关系**：STATUS.md 是各 SoT 的**镜像/导航**，不是 SoT 本身。具体决策仍在 PROJECT_GOAL / pickup / backlog / CHANGELOG。\n221\t\n222\t### SoT 归属表（哪类事实以谁为准 · INFRA-F58）\n223\t\n224\t> AI 读多份文档遇到冲突时，**以本表指定的真源为准**，其余处一律视为镜像/指针（镜像 stale 时以真源修镜像，不反向）。\n225\t\n226\t| 事实类型 | 唯一真源 | 说明 |\n227\t|---|---|---|\n228\t| **npm 包当前版本号** | STATUS §当前版本（字面版本号只此一处）| README/PLUGIN/GETTING_STARTED/AGENTS 一律\"见 STATUS\"，不写字面版本（de-mirror 闸 `no-version` mode 强制）|\n229\t| **docs 站要不要跟着发版发布** | [`RELEASING.md`](./RELEASING.md) §Step 4 | = **owner 决定，不是 REQUIRED**（owner 裁定 2026-07-31，此前 Step 4 写 REQUIRED / [[INFRA-F84]] 残余① 写 owner 决定，两处各说一套）。测量口 = `pnpm check:docs-site-version`（三态 `0`/`1`/`2`，`2` 当 `0` 用就是假绿），别处只指回 Step 4 |\n230\t| **layout 断点 / 容器宽的数值** | `src/tokens/variables.css` §`── Layout breakpoints ──` + §`── Layout containers ──` | code-first（owner 拍 2026-07-31，登记在 `divergences-decisions.json`）；CSS `@media` 吃不了 `var()` → 引用的可校验形式 = 字面量 ∈ token 值集合，`audit:layout-tokens` 机械核；非 CSS 消费方走 `./tokens` DTCG + `./tokens/js`（同一份文件派生，不存第二份）|\n231\t| **plugin 版本号** | `PLUGIN.md` §版本表 | 与 npm 版本独立；de-mirror 闸 `no-npm-version` mode 放行本文件自身 plugin 版本 |\n232\t| **发版历史 / changelog** | `CHANGELOG.md`（外部）+ `STATUS-CHANGELOG.md`（内部）| — |\n233\t| **排期 / 版本包含哪些** | `retrospection/design-spec-canonical-alignment-tracker.md` §排期原则 | STATUS Version Roadmap 段是镜像 |\n234\t| **Active backlog 全量** | `backlog.md` §Active | STATUS \"Active 后续工作\" 是计数镜像（C4 gate 核）|\n235\t| **5 能力定义** | `PROJECT_GOAL.md` §一句话目标 | 能力**成熟度/状态** → STATUS §能力×成熟度表 |\n236\t| **Figma↔Code 真源原则 + 合法 divergence** | `FIGMA_AS_SOURCE_OF_TRUTH.md` + `translation/divergences-decisions.json` | — |\n237\t| **组件公开 API（props/values）** | 组件 SFC `defineProps`（如 `ButtonBridge.vue`）+ 文档站组件页 | 文档示例必须与 SFC 一致；F58 实证 GETTING_STARTED/README 曾漂移 |\n238\t| **AI 协作硬规则 / 起手链路** | `AGENTS.md` §硬规则 + STATUS §起手必读链路 | 链路 SoT 在 STATUS，AGENTS 只登记任务触发表 |\n239\t| **文档间\"改 X 复查 Y\"依赖** | `docs/internal/doc-sync-map.json` | audit:doc-sync 校 |\n240\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"8d5ff334-2771-499e-832f-f4049853cfa7","timestamp":"2026-08-25T10:16:05.334Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/STATUS.md","content":"# TVU Design System — Status\n\n> **Last updated**: 2026-08-25 —— **落地线第三十轮：mockup conformance 合成单进程引擎 + 给闸的 stdout 定输出契约**（**Active 32 → 32**：新增 [[INFRA-F139]]、删档 INFRA-F132）。执行外部 lab 的两份处方（第 7 / 7b 步），⛔ 不是自选题。
🔴 **本轮最值钱的一条：给 11 条在链闸补一个「分母」字段，当场照出一条 L5 闸的绿三个月来不可解读。** `audit:figma-conformance` 的扫描面 `src/canonical/generated/*.vue` 实测 **0 个文件** ⇒ 每次发版都绿、绿无信息量。修法是 owner 裁定（退役 vs 改指向，两条都改发布链判据强度）⇒ [[INFRA-F139]] + 收割器里具名 shrink-only 豁免（照样每次打印）。**这不是契约引入的缺陷，是契约让一个一直存在的空分母第一次可见。**
**引擎实测**：进程 10 → **1** · 请求 12 → **3** / 大 payload 8 → **1**（请求计数器自证，⛔ 不用耗时代理）· 同一 fileKey 整文件 140s → **27.0s**（且在多跑一条规则的前提下）· 规则 9 → **10**。**规则清单真源从「代码位置」改成「一条命令」**（`--list-rules`）—— 指代码位置本身就是 stale 源。
**契约实测**：11 条在链 `figma-sync` 闸全部上契约，收割器 **11/11 解析出契约块、11/11 读出 findings 计数**（上契约前 10 条在吐 JSON、只有 **4** 条读得出）。选择面**钉 npm key**、⛔ 不钉文件特征。
**B1 = 这一族闸历史上第一个自动执行点**：`.claude/hooks/post-figma-write.sh` 每次 `use_figma` 写后自动后台跑引擎，fileKey **从 prompt 里的 Figma URL 捕获**（不是写死常量）。⚠️ L4，绕过面如实登记。
⚠️ **三条注入证明非空过**，其中一条打的是**接线**（摘掉 `failed` 表达式里一项 → 1 红），纯 import 单测覆盖不到那一半。
⛔ **数别抄，跑**：`pnpm report:gate-output-harvest` · `pnpm audit:mockup-conformance --list-rules`。验收逐条实测 / 两个既有缺陷前后对照 / KNOWN_SILENT 增删行 / 刻意偏离处方的理由 / 处方自身两处数字偏差，全在 [STATUS-CHANGELOG](./internal/STATUS-CHANGELOG.md) 顶条，⛔ 别在本行找。\n> ——\n> **更早各轮（session I–X）摘要已逐字归档**在 [STATUS-CHANGELOG](./internal/STATUS-CHANGELOG.md)；仍需接手人知道的**状态性事实**已各归其唯一真源 —— 主机拓扑 [`DEPLOY.md`](./DEPLOY.md) · docs 站发布口径 [`RELEASING.md`](./RELEASING.md) Step 4 · build 顺序 `scripts/check-dist-wc-freshness.mjs` 头注释 · 各闸的覆盖面与豁免语义在各自脚本头注释且**每次运行自印** · 其余在 [backlog](./internal/backlog.md) 各 entry。⛔ 别再往本段回写完成叙述，闸会拦。\n>\n> ### 一 · 等 owner 拍板（本仓库）\n> 0a. **docs 站 644 张图标预览线上仍坏 —— 源码已修，等一次 docs 站 build + 发布**（`designAssetData.ts` 曾把 dev-server 专用的 `/@fs<绝对路径>` 前缀逐字带进产物）。⛔ 这不是代码待办，是**发布决策**：口径真源 [`RELEASING.md`](./RELEASING.md) §Step 4（= owner 决定，不是 REQUIRED）；测量口 `pnpm check:docs-site-version`（三态，`2` 当 `0` 用就是假绿）。修复经过在 [STATUS-CHANGELOG](./internal/STATUS-CHANGELOG.md) 第二轮那条。**本条 2026-08-18 从顶部摘要区搬来 —— 它是 open 的 owner 项，此前混在「已归档各轮」里容易被读成历史。**\n> 0b. **loading 矩阵免横滚 —— ✅ owner 2026-08-13 已裁定走 ②（把每格 variant 文字 / nodeId 收起），⏳ 待落地**（docs 站视觉改动，走快车道）。裁定理由：② 消除根因（那些文字才是要求 180px 的原因），① 会**失去矩阵对齐** = 牺牲这个页面存在的意义（横向对比 variant）；nodeId 属查证时才用的次要信息，收进 hover / 点击展开即可。⚠️ 落地后仍需 owner 看一眼实际效果。原始两条路：① 把 ≤980 的卡片流降级上提到 ≤1100 / ≤1280（**已否决**）② 见上。背景：2026-08-12 已 ship 的是「够得着」（横滚 + ③ 删掉 ≤1280 反向加宽的列宽覆盖，所需 1260→1040、1280 档横滚量 682→462px）。⛔ 两条**已排除**：拖拽列宽不创造宽度（1280 档 6 列每列只 106px）· 让宽 demo 横跨右侧 CONTENTS 栏不可行（CONTENTS 是 shell 三栏 grid 里的 sticky item，横跨只能负 margin 画到它底下 = F67 (b) 专抓的「被盖住」）。\n> 1. **DG-1 layout 原语 —— token 层 2026-07-31 已 ship，剩下两件事要 owner/designer 的视觉裁定**（owner 当日裁定「根据实际信息来显示即可 + 要有唯一值」→ 不等新表，值取实测现值做成单一定义；八个值逐字取自改动前在用的值、纯命名化零渲染变化，`audit:layout-tokens` L4+L5 上闸）：① ~~3 个存量一次性断点~~ → **✅ 2026-08-12 全部拍完，本子项关闭**：`docs.css` 720 **消除**（owner 拍「拆开归并」并当日 ship）· `progress-demo.css` 900 与 `button-demo.css` 980 **维持豁免不归并**（owner 08-11 / 08-12 分别拍定；判据 = 二者都是 React demo 内部栅格，改它对 DS 消费者零影响，而归并是净损失）。**三条的重开条件已各自写进 [`audit-layout-tokens.mjs`](../scripts/audit-layout-tokens.mjs) 的豁免表**，别在这里找。⚠️ 留一条教训：720 的裁定材料一度**过期**（08-11 那个数字当天就被抽屉导航作废，照它裁 = 按不存在的效果裁）——**「等 owner」条目的实测数字有保质期，隔了一次 ship 要重测再送审**。② ~~容器宽未收口~~ → **✅ owner 2026-08-11 拍定：维持 report-only，不收口**（那批 `max/min-width ≥600px` 是 demo/页面**内容宽**，硬塞进容器档位就是把偶然值当契约。⚠️ **处数别写死，读闸每次运行的自印** —— 这里 2026-08-12 我先把「19 处」改成「22」，**那是错的、当天已订正回来**：22 是闸自己数错的，`extractWidthLiterals`（S5）**不剥 CSS 注释**，把 08-11 抽屉导航那批注释里提到的 3 次 `max-width: 1100px` 当成了真声明。同文件的 `extractMediaWidths`（S3）08-11 修过这个病、S5 那边漏了。已补上同样的注释中和 + 3 条单测（含阴性对照：注释旁的真声明照收），修后实测 **19**，与 07-31 一致 —— **处数从来没漂过，漂的是闸的读数**）。闸的 S5 继续自印剩余处数，**别读成待办**。⚠️ 别读成「布局已收口」；终点仍是 A（Figma 变量），迁移只换真源方向、不改 token 名。详见 [spec §6c](./superpowers/specs/2026-07-30-dg1-layout-primitives-design.md)（§6b「等一张表」那行已就地标注被推翻）。\n> 3. **Gitea registry TLS 化的 owner 残余**（原 INFRA-F74，**2026-08-14 该 entry 已删档 —— 仓库侧全部做完，剩下的只有下面这两件 owner 动作，本行现在是它们的家；⛔ 别再去 backlog 找 F74**）—— ① 人眼看一次新入口 `https://product-demo.tvustream.com/gitea/ux-team/-/packages`（硬纪律，API 绿不免除）· ② 建议轮换主机 `.env`(600) 里那份 `git ls-remote` 仍有效的 `GIT_AUTH`（签发需 owner UI，AI 无此权限）。⛔ **别把 `:3001` 写回 consumer 面 registry 配置** —— 它不是并列的备用入口，是 443 链路上的**中间一跳**，入口拓扑与那次修复的完整真源 = [`GITEA_ENTRYPOINTS.md`](./GITEA_ENTRYPOINTS.md)（⛔ 原先这里指的 `[[INFRA-F89]]` 已删档）。③ 主机上三个 `*.pre-f74*` 回退备份 **暂缓删除**（拿到 SSH 才用得上的唯一回滚源，保留成本为零）—— 三条精确路径已搬进 [`infra/README.md`](../infra/README.md) §主机侧回滚源。\n> 4. **候选回流规则维持候选**（owner 07-29 答「先等等」）—— V4-1827 那批（PRD 措辞锚定产品现状基线 / 交付集与 mockup 同交付区 / 反馈态用文案+状态色、动效交 dev / 删缩元素前先列「谁靠它定位」）+ V4-2333 轮二三条（走查 scope / 偏差要写后果 / wrap-up 步骤有条件）。\n> 5. **[[INFRA-F58]] 残余② 规则三层化 —— 处置待拍（建议整条搁置并重定义）**：2026-08-03 算完三个测量，**器械与目的不匹配** —— 宣称用途是 assessment 支柱① 的「让 claude.ai / Codex 能当 Project Instructions 直接吃」，但那五份文件（`AGENTS.md` + `meta-rules` + `design-process` + `code-conventions` + `mockup-conventions`）**一天涨 54 行、十一天涨 401 行**（08-03 = 7327 → 08-13 = 7674 → **08-14 实测 7728**），而最好可省 150-300 行 —— **可省量追不上分母的增长，比例还在往下走**。⛔ **别读这里的数，自己跑** `wc -l AGENTS.md docs/meta-rules.md docs/internal/{design-process,code-conventions,mockup-conventions}.md`（此处三轮都在漂，本行因此改为只留结论 + 取数命令）。另：原写的 `ds-bundle/reference/` 那组「近逐字搬运」数字（2885→2867 / 1488→1470）**在本仓不可复验** —— `ds-bundle/` 在 `.gitignore` 里、不入库，属外部事实。四块逐块判定 + 六处数字订正 + 两条执行前置见 [backlog F58 entry](./internal/backlog.md)（`e8120010`）。**建议改标「已 scoping、器械与目的不匹配、按需触发」而非留在待做**。⚠️ 若 owner 要真闭合那条 P1 缺口，需要的是**派生式精简产物**（从散文生成紧凑契约、生成而非手维护）—— 那是独立提案、有自己的设计问题（谁是真源 / 怎么防漂），**未立项**。另：任一动它的方案开工前须 owner 显式划清与 2026-06-12 被 reframe 掉的 [`rule-registry`](./internal/rule-registry-design-2026-06-12.md) wholesale reorg 的边界。\n> 6. **DS 系统性评估的两件待办**（评估本身七轴已跑完、finding 已全部立成 [[INFRA-F114]]–[[INFRA-F128]]，叙述见上方摘要与 [评估报告](./internal/_reports/2026-08-13-ds-assessment-axes-abcd.md)）：① **6 份计划仍待起工** —— [闸扩面](./superpowers/plans/2026-08-12-rule-inventory-mirror-gate-extension.md) · [归档](./superpowers/plans/2026-08-12-live-tree-derivative-archive.md) · [场景路由](./superpowers/plans/2026-08-12-scenario-routing-single-source.md) · [PathA增量](./superpowers/plans/2026-08-12-path-a-legacy-host-increment-rule.md) · [判定表](./superpowers/plans/2026-08-12-element-decision-trace-product.md) · [UX场景](./superpowers/plans/2026-08-12-ux-scenario-coverage-expansion.md) ② ~~`AGENTS.md` 快车道「闸的判据」四字等 owner 确认原意~~ → **✅ 2026-08-13 已裁定并落地**（`46234b9f`）：原意 = **`tests/`**，⛔ 不含 `scripts/` 下的闸脚本 ⇒ **改 `scripts/` 的闸脚本不走快车道**。⚠️ **2026-08-13 晚订正本行后半句**（登记为 [[INFRA-F124]] ④）：此前这里与 AGENTS 那段 ⚠️ 注都写「⇒ 照常写 changeset」，而那是**依据 F117 落地前的 §「何时写」**推出来的 —— 同日 F117 已把判据收窄成 `files[]` 白名单。⇒ 正确表述 = **changeset 仍按 §「何时写」的 `files[]` 判据判，不在白名单里的内部 `audit-*.mjs` 属「不写」**。owner 的裁定实质未变，变的只是这半句转述。~~⚠️ 一个联动项：`§228` 把 `scripts/` 整个列为 consumer-facing 必写，F117 落地后要同步改~~ → **✅ 2026-08-13 已随 F117 一并落地（`5844130b`）**：`§228` 改为「`files[]` 白名单内那 20 个 `scripts/`」，并显式声明 **`files[]` 是唯一真源**、不在 AGENTS 里维护第二份会漂的清单。\n>\n> 7. **[[INFRA-F115]] 撤销旧 Figma PAT —— owner 2026-08-13 已同意，⏳ 待 owner 在 Figma UI 执行一步**（Settings → Personal access tokens 撤销那个旧 token）。**AI 侧结构上不可为**（⛔ 禁调 Figma API / 禁重签，见 §三 10），所以「它现在是否仍有效」只能由 owner 在该页确认。**影响面已核（2026-08-13，只看元数据未读任何凭据值）**：本仓所有读 Figma 凭据的脚本都走全仓唯一 parser `scripts/lib/figma-env.mjs` 读 `.env`（当前 PAT）· 旧 PAT 在本机的唯一驻留点就是 `.env.bak.1785390298`（`.env.local` 只有 `GITEA_HOST`、`~/.config/tvu/gitea-token` 是 Gitea 的）· **Gitea 与 GitHub workflow 里零处引用 Figma secret** ⇒ **本仓 / 本机 / CI 三面零影响，新 PAT 完全取代**。⚠️ **唯一核不到的**：`scripts/consumer-postinstall.mjs` 教 consumer 仓库设 GH secret `FIGMA_TOKEN`，MicroApps / NOC 那边那份值是新是旧**看不见**（别的仓库的 secrets）—— 撤销后若某 consumer 的 mockup conformance 报 403，就是它，重配即可。**⚠️ 2026-08-14 影响面重核（零 Figma API 调用、零凭据内容读取，只读元数据）**：那份明文副本当时**仍在**，`find` 全树（含 6 个 worktree）**精确 1 个命中** ⇒「本机唯一驻留点」有判据不只是断言 —— **该副本已于同日删除**（零引用已核、⛔ 未读其内容），但**删本地副本 ≠ 远端失效**，撤销仍只能 owner 在 Figma UI 做；读 Figma 凭据的文件现取 **12 个**（原 11，新增 `scripts/ds-health-scan-mockups.mjs`）、**12/12 全部走唯一 parser**；两 host 5 个 workflow 扫 `FIGMA` **零命中**（配阳性对照 `secrets\\.` 命中 3 行 ⇒ 非空过）。⇒ **三面零影响的结论未变。** 顺带查出一处不属本条的真缺陷（`consumer-postinstall.mjs` 教人配一个所给模板永远不读的 GH secret），已挂 [[INFRA-F115]] entry。\n>\n\n> ### 二 · 等 designer（Figma 侧动手）\n> ⭐ **2026-08-14 新增可交付**：⭐「拿错设计库」的清理清单已机械生成 —— [`_generated/foreign-library-cleanup.md`](./internal/_generated/foreign-library-cleanup.md)，逐个换成当前 DS 库组件。**污染源只有两个 file**（`TVU UX Library` 六文件全中 · `Nancy's Design Assets` 三文件），⛔ 别引用清单里的数（契约 G4：重跑 `pnpm health:mockups` 现算）。它由 `ds-health-scan-mockups.mjs` 全量成功时重写，⛔ **别手改**。\n> 9. **design-review-queue 4 条** —— #4 Notification pop confirm 问句标点不一致（owner 定如实提取、由 designer 在 Figma 统一）+ 3 条 designer-action（off-scale px / multi-select padding outlier / 缺 disabled 变体），全 live 2026-06-11 验证过。详见 [design-review-queue.md](./internal/design-review-queue.md)。**⚠️ 2026-08-03：#3「缺 disabled 变体」多了第 4 个成员 `Tab/Item`**（**条数不变** —— 既有条目长出一个成员，不是新条目）。它把这条从「三个零散控件」变成**需要一次统一裁定**：同族 `select box/filled` / `input box/filled` / `switch` / `radio` **都有** `enable` 轴，缺的这四个不是族惯例、是漏。~~裁定要连数值一起给（0.4 / 0.45 / 第三条路 三选一 + 一个数）~~ → **✅ owner 2026-08-13 已裁定：走 `token desaturation`，且「定一个数」这一问作废**（`--control-disabled-*` / `--text-disabled` / `--icon-disabled` 是 **per-theme 具体色值不是透明度** ⇒ 四分叉 0.4 / 0.45 / ≈0.5 / 0.6 全部作废；依据 = `FIGMA_AS_SOURCE_OF_TRUTH.md:71` 逐字禁止把 opacity-vs-token 当实现策略差 + 实测 token 路线已是多数派 **12 : 8**）。**designer 侧仍待动手** = 在 Figma 给这 4 个成员补 disabled 变体、按 token desaturation 表达 —— ⚠️ **2026-08-14 owner 裁定后它不再是 code 的前置**（Figma 无变体时 code 直接绑既有语义 disabled token 即可，不算发明数值；规则真源 `code-conventions.md` §R9 disabled 行，参照实现 `TabItem.vue`），补变体的目的是补齐设计真源。**code 侧待办** = [[INFRA-F120]]（⚠️ 原并列的 `CANONICAL-F92` 已于 2026-08-14 删档 —— `Tab/Item` 的 code 侧四项实测早在立项前就已 shipped，结论搬进 `design-review-queue.md` §3 那条 🔑，那里另记了一条**待 owner 拍的一致性问题**：Tab 在 Figma 无变体的前提下已绑 token，与 F120 对 `Rating`/`Slider`/`Select` 的「无变体 ⇒ 等 designer」口径互斥）（⚠️ **2026-08-13 订正**：原写「改四个 + `Switch`/`InputNumber` 只需删多余 opacity 行」**已被实测推翻** —— 实为「三改 + 两个转为改 + 一个不动」，且三个改项在 Figma 无 disabled 变体、值仍等本条 designer 产出；观感会变，**必须过 owner 视觉签核**。逐条与证据在 [[INFRA-F120]] entry，另见 §一 7 那条待拍的例外）。\n>\n> ### 三 · 技术项未闭合（详情在 [backlog](./internal/backlog.md) §Active，此处只留最容易被漏的几条；条数别写死 —— 以 `pnpm run audit:status-consistency` 为准）\n> 10. **变量层 ack 2026-10-28 到期即红**（原 INFRA-F79，**2026-08-13 已删档**：⛔ 禁止复现清单已搬进 `audit:variables-freshness` 的 PASS 自印输出 + `variables-staleness-ack.json` 的 `reviewQuestions` 两处真源，别再回写 backlog）。缺口按 **Figma plan = Professional** 的事实已闭合；出路只有 plan 升级（采购）或 Figma plugin 侧导出（未调研）；MCP `get_variable_defs` **只能点验、不能替代 sync**。\n> 11. **[[INFRA-F66]] 残余** —— `tvu-drop-down-list-select` 的 `:host` 尺寸未判定（docs React demo 零渲染实例，且它是 light-DOM CE、`:host` 语义不同不能照搬）。🔴 **2026-08-14 订正触发条件**：原写「触发 = 给它补 React demo 时一并判」并以为硬规则 #8 的闸会推动它 —— **实测那个闸的 in-scope 根本不含它**（无 slot、零 boolean prop），闸绿是空过；React 侧不渲染还是 `Select.tsx` 里一条显式裁定（`F45 OUT`）。⇒ **真触发 = owner 主动把它提为一级 demo 组件**，别等闸。（原 INFRA-F67 已于 2026-08-14 闭合删档 —— 三件残余全部实测已闭；(c-3) 那段「够格独立成 entry」的内容也已全部完成，给已完成的工作立新 entry 违反「完成即删档」。）\n> 12. **尚无人接：只剩 [[INFRA-F75]]，且它的体量 2026-08-14 被推翻** —— 它**不是**「NOC 迁 registry」：实测那份 `upstream-gate` 副本**从来没有** registry/token 配置，与本仓 `templates/upstream-gate-workflow.yml` 逐行比**只差 2 行包名**，且它当前连 `package.json` 都没有、在任何 runner 上都跑不起来。⚠️ 原记的「被 GitHub Actions 额度软阻塞」引的是**7 月**的月度额度，跨月后多半已失效（未实测，待 NOC 侧确认）。致病机制（DS 改 template 包名 → consumer 已复制出去的副本不会跟着改，且无人发现）已搬进 [`MIGRATION_TO_V1.md`](./MIGRATION_TO_V1.md) §3 并把扫描面从 `src` 扩到 `.github/workflows`。（~~INFRA-F90 docs 站 URL 无 section anchor~~ —— **✅ 2026-08-03 已 ship 并从 backlog 删档**，形态 = 路由后多一个尾段 `#/component//`，沿用 `#/changelog/` 的既有先例；**hash 路由只有一个 `#`，不存在第二个 fragment**，所以不可能做成 `#…#anchor`。⚠️ **两条如实登记的边界**：① slug 由标题文本派生 → **跨 locale 不解析**（中文站复制的链接在英文站只停在页面顶部 = 修复前行为，良性降级）② `/changelog` 与 `/`（overview）**不支持**段锚点 —— 前者尾段已被版本号占用。段落 slug 的**唯一定义** = `playground/docs/navigation.ts` 的 `slugifySectionTitle`，与 F88 视觉闸内联那份必须逐字一致，由 `tests/docs-section-anchor.test.ts` 的漂移闸钉住。**已发到真站并端到端验过**，签核可直接贴形如 `…/playground-dist/#/component/button/button-api` 的链接。）\n>\n> **第四条线（design-sync：Sync A 补齐 + runtime 刷新 + TopBar/MenuList 对齐 Figma，08-13 起 / 08-14 全部收口）**：叙述见 [CHANGELOG](./internal/STATUS-CHANGELOG.md) 顶条，判据 / 取证 / 通道归属 / 验证边界的真源在 [`.design-sync/NOTES.md`](../.design-sync/NOTES.md)。**本线在 STATUS 已无待办**。\n>\n> **本文档是项目状态 SoT**，也是 onboarding 链路的唯一 SoT。在 L-core 里它是 **#1**——**第 0 份是 [`FIGMA_AS_SOURCE_OF_TRUTH.md`](./FIGMA_AS_SOURCE_OF_TRUTH.md)**（见下方 §起手必读链路 的 L-core 表，那张表是次序真源）。本文件早于 PROJECT_GOAL.md 读，因为它直接告诉你\"在哪\"。\n\n> 任何 session wrap up 时**必须更新本文档**（见末尾\"Wrap-up 协议\"）。\n>\n> ⚠️ **排期 SoT 在 [`retrospection/design-spec-canonical-alignment-tracker.md`](./internal/retrospection/design-spec-canonical-alignment-tracker.md)**——本文件 Version Roadmap 段只是镜像。任何 \"v0.X 包含哪些 / 先做哪个\" 决策前先读 tracker 的 \"排期原则\" 自检清单。\n\n---\n\n## 一句话目标\n\n把 Figma 已发布 Library 做成 **AI 与开发可消费的双向 Figma↔Code 桥**（详见 [`PROJECT_GOAL.md`](./PROJECT_GOAL.md)）。\n\n---\n\n## Claude Code Plugin\n\nUX 团队 AI workflow skill 的独立分发轨道（与 npm 包版本独立）。详见 [`docs/PLUGIN.md`](./PLUGIN.md)。\n\n---\n\n## 当前版本：v1.2.0（✅ **published & verified 2026-07-31** —— 四步核验俱全（tag→CI 历史首跑 + registry API 两路 + 真取回 tarball 逐字核 sha1 + owner 人眼核 Packages 页）。**完整取证实录 2026-08-13 已逐字下沉** [STATUS-CHANGELOG](./internal/STATUS-CHANGELOG.md) §「v1.2.0 发布核验实录」——⛔ 别在本行找 run 号 / sha1 / 解包抽验清单。**核验协议真源 = [`RELEASING.md`](./RELEASING.md)**（registry API 两路 + 真取回 tarball + Packages 页人眼亲验；硬纪律，API 绿不免除 —— v0.1.0/v0.1.1 曾 silent fail 1-2 周）。）\n\n| 项 | 值 |\n|---|---|\n| v1.2.0 内容 | **4 minor + 3 patch**（全 additive，无组件 API 移除/改名）：`./web-components` 出口（React / 原生 CE 第一次有 npm 消费路径；⚠️ tarball 2.84 → 4.74 MB，+67%）· Select 触发器补 combobox ARIA · `peerDependencies` 改 `vue: ^3.5.0`（[[INFRA-F85]]）· 浮层层级 token 化（`--z-dropdown` / `--z-tooltip` / `--z-modal` / `--z-select-portal`）·（patch）I18N-01 可见文案 key 真被组件消费 + 防回归闸 · registry 改走 HTTPS 标准端口（原 INFRA-F74，已删档）· UserMenu 面板对齐 Figma `DtZcMkhNy6qh6jbQQnhreQ` node `6423:85`。逐条详情见 [`CHANGELOG.md`](../CHANGELOG.md) |\n| 本次 publish | ⏳ **走 tag→CI**（`.gitea/workflows/publish.yml`，tag `v1.2.0`）。**这条链此前从未执行过一次**（Gitea 1.22.6 没有 `workflow_dispatch`，因此本 host 无干跑能力；恢复干跑的前置 = 升 Gitea ≥1.23）。三个必须逐段读的观察点：① pre-flight 凭据闸（A 读 / B **真写一次 probe** / C 删除并重读列表核实）② changesets-consumed guard ③ `pnpm publish` 本体。401/403 的读码方式写在 workflow 注释与 `RELEASING.md` §Troubleshooting |\n| 包名 | `@ux-team/tvu-design-system`（团队 Gitea registry）。GitHub Packages 上旧包名 `@nancyzeng0210/tvu-design-system` 的 15 个版本（≤1.1.0）**刻意保留不删**（rollback 退路；⚠️ **2026-08-14 订正**：括号里原写的第二条理由「MicroApps/vue-app 仍钉 `^0.6.1`」**已为假** —— 该仓 `111c408`（2026-08-07）已迁到 `^1.2.0`，两个 consumer 都在新 registry 上了。**「别清旧包」这条禁止动作本身仍成立**，靠的是 rollback 退路那条），此后不再有新版本发到那里 |\n| 上一版本 | v1.1.1 —— ✅ published & verified 2026-07-30T02:39:15Z（Gitea registry，**本机 `scripts/publish-to-gitea.sh` 发**，因为 tag→CI 的 secret 当天才修好；三路核验 + owner 人眼确认俱全，叙述归档在 [STATUS-CHANGELOG](./internal/STATUS-CHANGELOG.md)）|\n| 安装 | `pnpm add @ux-team/tvu-design-system` + Gitea `.npmrc`（**HTTPS 标准端口**：`https://product-demo.tvustream.com/gitea/api/packages/ux-team/npm/`）+ **Gitea** token（`read:package`；GitHub PAT 不行，Gitea 在 `authGroup.Verify` 就拒）。步骤见 [`RELEASING.md`](./RELEASING.md) §External consumer setup |\n| Release 流程 | changesets + **tag-triggered 自托管 Gitea CI** + strict audit 链（**条数别写死 —— `prepublishOnly` 是链的 SoT，要数就读它**；此处曾写「32 条」而 2026-08-05 实测 37 步 = 35 条 `audit:*` + `lint-skills` + `lint:ds`）+ Node 20/22 matrix（vitest 仅 Node 22 —— 3 个 audit 脚本靠 Node≥22 原生 TS 类型剥离）+ changesets-consumed guard + **render-gate 前移到切 tag 时在本机强制**（不在 CI：Gitea runner 非特权装不了 chromium 系统库）。GitHub 侧 `gates.yml` = dispatch-only、无发布能力，⚠️ 别给它恢复 tag trigger |\n| 破坏性 (1.2.0) | **无 API 破坏** —— 组件 API / 样式 / token 均无变化。但有一条 consumer 侧硬门槛：**peer 下界升到 `vue ^3.5.0`**，钉 `3.4.x` 的 consumer 装不上。那条「支持 3.4」事实上早已不存在（shipped 代码在用 Vue 3.5 才有的 `useId()`，3.4 上渲染 Tooltip/Select 当场报 `useId is not a function`）——本版删掉的是一句假声明，不是砍掉能用的支持 |\n| 版本详情 | [`CHANGELOG.md`](../CHANGELOG.md) |\n| 注 | ⚠️ 生态：`vue@3.5.36`（曾是 npm latest）官方发布产物损坏（`workspace:*` 未替换），consumer fresh install 需钉 `3.5.35` 或本仓库在用的 `3.5.32`；与本包发布无关 |\n\n---\n\n## 能力 × 成熟度（单一真源表 · INFRA-F58）\n\n> 5 能力定义真源 = [`PROJECT_GOAL.md`](./PROJECT_GOAL.md) §一句话目标；本表只登记**当前成熟度 + 该能力状态的单一真源**，避免\"读了 PROJECT_GOAL 承诺信以为真\"（assessment §5 承诺-vs-实现）。成熟度变化改本表。\n\n| # | 能力 | 成熟度 | 状态单一真源 |\n|---|---|---|---|\n| 1 | 开发 npm install 即用（Vue 组件 / token / 图标 / 样式） | 🟡 **partial** — Vue 全通；**token = CSS 变量 + DTCG JSON + TS 出口**（`./tokens` DTCG · `./tokens/js` resolved TS，INFRA-F55 支柱①）；**React 无 published npm 路径**（经 CE + `react-pilot` 内部 bindings，非 `./react` 导出） | `package.json` exports + PROJECT_GOAL §Token 架构 + assessment §5 |\n| 2 | AI 拿 Figma URL → 定位代码 1:1 还原 | ✅ **done** — manifest 确定性验证 | `figma-data/render-verification-manifest.json`（936）+ FIGMA_AS_SOURCE_OF_TRUTH.md |\n| 3 | AI 拿 代码 → 生成 / 还原 Figma | ⚠️ **DEFERRED（bypass equivalent）** — DS 代码 _可_ 经 manifest + 唯一库 `YbsPRUVmNdsbN40NNwh1Gn` 还原；缺的仅\"全自动 Code Connect publish\"（Pro plan 401）+ 非 DS 反查 + MCP config | PROJECT_GOAL 能力3 + `CAPABILITY_3_BYPASS.md` |\n| 4 | AI 拿 文字/链接/截图/代码 → UX 效果图 + 可运行代码 | 🟡 **gate + AI 辅助合成**（非全自动生成器）；mockup 确定性后验强制化 = F55 缺口 A | PROJECT_GOAL 能力4 + assessment §4 支柱② 设计网 |\n| 5 | 每个 Code 组件可追溯 Figma 来源 | ✅ **done** — canonical `data-figma-*` + manifest N:1 | canonical 组件 `data-figma-*` 属性 + manifest |\n\n---\n\n## Version Roadmap（剩余按版本线分组）\n\n> 本段只留 **open / blocked** 项——已 shipped 版本（v0.2.0–v0.7.0）逐版本 retrospect + 历史完成项在 [`design-spec-canonical-alignment-tracker.md`](./internal/retrospection/design-spec-canonical-alignment-tracker.md) §轨道 A 已完成 / §Release 排期（完成叙述不在 STATUS 累积 — status-keep-only-unfinished）。\n\n### ✅ v1.0.0（稳定承诺 — API 锁定 · **已发布 2026-07-20**）\n\n> **published & verified**：GitHub Packages `1.0.0` created 2026-07-20T10:33:19Z · CI run [29735085984](https://github.com/NancyZeng0210/TVU-Design-System/actions/runs/29735085984)。首个稳定版，公开 API 锁定（[`API_STABILITY.md`](./API_STABILITY.md)）；scope = 组件保真镜像层（36 组件 + token + 图标 + 双向 Figma↔code 桥），产品构建层（Table/Form/layout/pattern）列 v1.x/v2。\n> **触发条件回顾**（全满足）：5 能力交付（能力 3 旁路 ack）· L5 口径 A（tooling ships + MicroApps adopts）· color-contrast owner-accept 收口 · burn-in waived · RC soak（MicroApps Console ≥1 周 0 critical，owner 2026-07-20 sign-off go）。\n\n### 🔵 v1.3.0（**规划中** — 排期层 2026-08-13 重建）\n\n> **排期 SoT 在 [tracker `### v1.3.0`](./internal/retrospection/design-spec-canonical-alignment-tracker.md)，本段只是指针，别在这里找批次内容。**\n> 缘起：原排期图终点是 v1.0.0，2026-07-20 **达成**后没有人画第二张图 ⇒ 排期层空了 4 周，\n> 期间 backlog 涨到 57 条且**无一条有版本归属**（表现 = 一堆 High/Medium 谁也说不上先做哪个）。\n> owner 2026-08-13 拍「先补规划层，别急着往下做条目」。\n> **分拣的主要产出是认定大多数 entry 不该排队**（17 条是「下次碰 X 时」的触发式）。\n> ⚠️ **「57」这个数尚未经核对** —— 当日抽样两次命中 stale（[[INFRA-F119]] 可关一半 · 原 INFRA-F122 存量 2→6（该 entry 2026-08-14 已落地删档）），别把它当工作量。\n\n| 后续 | 版本线 |\n|---|---|\n| ~~批次 A — consumer 面发布正确性~~ → **✅ 2026-08-13 全部 ship（`5844130b`）**：F114 / F117 已删档、F105 只剩 ①③④；顺带闭合 F102。终态判据与留下的已知缺口（`./web-components` 仍无 types）全在 [tracker `### v1.3.0`](./internal/retrospection/design-spec-canonical-alignment-tracker.md)，⛔ 别在这里找 | v1.3.0 |\n| 批次 B 凭据卫生 · 批次 C 让已有的闸真的守住 · 批次 D 大件（Tier 1-C ESLint plugin / F62 / F60，**起不起由 owner 拍**）| v1.3.0 / 待拍 |\n| 产品构建层剩余（layout 原语 / pattern 层）—— APID-02 Form 校验引擎 + APID-01 Table 状态层均已随 **v1.1.0** 发布 | v1.x / v2（backlog INFRA-F68 Batch D/E/G）|\n\n### ⚪ Deferred / Out of scope\n\n| 项 | 状态 | 理由 |\n|---|---|---|\n| **能力 3 (AI code→Figma)** | DEFERRED bypass shipped | Figma Pro plan 限制；[`CAPABILITY_3_BYPASS.md`](./CAPABILITY_3_BYPASS.md) 提供等价方案 |\n| **T1c Extract Pipeline** | PAUSED | plan owner \"元层疑问\"未解 |\n| **Phase 8** 视觉脚本 + Code Connect | DEFERRED | 需 Figma Org plan 升级 |\n\n---\n\n## Active 后续工作\n\n```\nBacklog (active) (32): INFRA- F58·F60·F61·F62·F63·F66·F68·F69·F75·F81·F86·F91·F101·F105·F106·F107·F115·F120·F123·F129·F131·F133·F134·F137·F138·F139 · CANONICAL- F92–F94(打包入口·现只含 F93+F94)·F93·F94·F95·F104 · META-DSYNC-01 —— 计数镜像；状态/待办/⛔ 全在 backlog.md ## Active 各自 entry（C4 机械核）。⛔ 这串别手抄，从活源生成：`grep '^### ' docs/internal/backlog.md`\ndesign-review-queue (4): 设计侧待 designer 动手（off-scale px / multi-select padding outlier / 缺 disabled 变体 / Notification pop confirm 标点）—— 计数镜像，与 §二 9 同口径。⛔ 各条 live 复核日期**别在此抄**（三条不同日），见 design-review-queue.md 各条自带实测行。✅ 2026-08-21 起有闸：`audit:status-consistency` C6（判据 = 真源 `designer-action: yes` 条数，核三处镜像）\nCode-leads divergences (3): msg-bg-tinted-dark / chart-color-palette / pill-component-family — 见 translation/divergences-decisions.json\nDeferred (3): 能力3 bypass · T1c · Phase 8\n```\n\n**真正 next 可推进的**（2026-08-05 复核，**此前三处指路句已 stale 并就地删除**：f73 plan 的「轨道 A 发 1.1.0，卡 owner 建 Gitea PAT」—— 1.1.1/1.2.0 都已发完；`1.1.2` 那条载荷路线 07-31 已作废；`2026-07-30-v1x-next-batch` 的 **10 个 Task 已全部执行完**，Task 10 = 发 v1.2.0）：[[INFRA-F104]]（render-gate 降级判据字段化）**已于 2026-08-07 ship 并从本段删档**（数字/闸细节见上方 Last updated 摘要）——⚠️ **本段已被排期层取代 —— 「下一个做什么」的答案现在在 [tracker `### v1.3.0`](./internal/retrospection/design-spec-canonical-alignment-tracker.md)，别在本段挑**（本段历来是\"零散指路句\"，而 2026-08-13 的分拣证明零散指路正是排期层空缺的症状：57 条 entry 无一条有版本归属）。~~**建议最先** = v1.3.0 批次 A 三条 consumer 面发布正确性~~ → **✅ 2026-08-13 已 ship（`5844130b`）并删档**（F114 / F117 / 顺带 F102；F105 只剩 ①③④）。**不等 owner、不等 designer 的**（~~F98~~ 2026-08-06 已 ship 删档 · ~~F119~~ **2026-08-13 已完全闭合并删档**：步骤①亲验发现 2026-07-31 就已存在于 `release.mjs` step 1c、步骤② 76 张基线已 ship `3cb3e36b`）= ~~[[INFRA-F100]]~~ → **✅ 2026-08-17 整条落地并删档**（三条结构缺口 + 最后那条「37 行豁免按 CE 语义逐行复核」）。**封路理由与诚实边界已全部搬进 `scripts/audit-render-drift-gate-react.mjs` 头注释**（闸每次运行自印），⛔ 别再来 backlog 找这个号 · **Tier 1-C** `@ux-team/eslint-plugin-tvu-design-system`（能力 1 加固，tracker 估 ~2-3 周，自 v0.6.0 挂到现在 —— 「大所以推后」逐字命中 tracker §排期原则反模式表，要继续推后需要一个**不是\"大\"的**新理由，起不起由 owner 拍）。另有 RTL-01 / F68 FID-04 M1 role-map 全量铺开，各自成批。design-review-queue 4 条待设计师（⚠️ 此处 2026-08-21 前一直写 **3**，是本文件里第三处 stale 的同一个量 —— F136 立项时只发现两处；现由 `audit:status-consistency` C6c 吃**所有**出现处）。\n\n**排期决策必读**：[`retrospection/design-spec-canonical-alignment-tracker.md`](./internal/retrospection/design-spec-canonical-alignment-tracker.md) §排期原则 — **不按耗时 / 复杂度 / 成本最低排，按项目目标对齐 + 依赖解锁 + 自动化标准化排**。\n\n---\n\n## 起手必读链路\n\n> **本节是 onboarding 链路的唯一 SoT**（AGENTS.md §必读链路 只登记任务触发表，不再维护并行清单 — 2026-06-10 system-review P1-07/P1-08 重构为两层，消除双链路 drift + 与仓库 lazy-load 原则对齐）。\n>\n> **⛔ Mandatory Gate**：任何 AI session 在第一个项目相关回答 / 推荐 / 任务前，**必须全文读完 L-core 四份**，并读完命中触发条件的 L-ref 最小集。机械执行：用 TodoWrite / TaskList 为 L-core 每项 + 命中的 L-ref 项各建 1 个 todo，逐个 Read 完才能回答。基于 partial L-core 给推荐 = **协议违反**。**唯一的减档 = 下方 [§微改档](#微改档单文件纯文案的减档)**（owner 2026-08-13 裁定新增），判据不满足即回落本档、无第二个例外。\n>\n> **体量口径 —— 本行是唯一真源**（`AGENTS.md` §Onboarding Gate 只指回这里，刻意不复述数字）：**2026-08-04 `wc -c` 实测 65.2 KB** = 三份固定文件 59.8 KB（FIGMA_AS_SOURCE_OF_TRUTH 8.1 + 本文件 37.0 + PROJECT_GOAL 14.7）+ 当前 pickup（本轮那份 5.4）。⚠️ **引用前先自己重跑** `wc -c` 那四份 —— 它们每工作日都在涨，本行也会漂。此前这里与 AGENTS 两处都写着「~40KB ≈ 10-15min」，而 2026-08-03 实测已是 **90.5 KB**、失真 **2.2×**（原 INFRA-F95 已付代价 4 —— **该 entry 三项待做全部闭合、2026-08-13 已删档**；本轮清理让本文件从 63.7 → 37.0 KB，L-core 因此回落到 65.2）。⚠️ **2026-08-13 实测 L-core 四份已回涨到 ~74 KB**（本文件 ~45 KB）—— 正是本行自己说的「本行也会漂」，**别引用这两个数，自己跑 `wc -c`**。**别再写死耗时** —— 那正是下方「历史实证」里 gate 被默读架空的机械成因。\n\n### 微改档（单文件 · 纯文案的减档）\n\n> **owner 2026-08-13 裁定新增。这是本链路唯一的减档，本节是它的唯一 SoT**（`AGENTS.md` §Onboarding Gate 只留一行指针，刻意不复述判据 —— 复述一份就是第二处会漂的副本，[[INFRA-F121]] 已付过这个代价）。\n> 缘起：此前唯一豁免是「用户首条 query 明显非项目相关」，于是「把这句 UI 文案从 A 改成 B」也要先吃 65 KB。gate 设严的原因是 2026-05-13 跳读致首轮推荐漏 4 项硬约束，所以减档不是取消 gate，而是**把省下的风险交给下方升级条件接住**。\n\n**适用判据（四条全中才算，任一不中 → 回落完整 L-core）**：\n\n1. 改动落在**单个文件**内；\n2. 性质是**纯文案 / 措辞**（UI 可见文本、注释、文档行文、错误提示字串）；\n3. **不换组件、不改 token、不加删元素、不动布局**，也不涉及组件选型判断；\n4. 不是 mockup 写操作，也不是推荐 / 排期 / 裁定 / 发版类回答。\n\n**微改档要读的（省下 STATUS 本文件 + PROJECT_GOAL + 当前 pickup 三份）**：\n\n| # | 文件 | 为什么它不能省 |\n|---|---|---|\n| 0 | ⭐ [`FIGMA_AS_SOURCE_OF_TRUTH.md`](./FIGMA_AS_SOURCE_OF_TRUTH.md) 全文 | 文案也可能踩「code 反向要求改 Figma」；本文件是唯一能拦住它的 |\n| — | [`AGENTS.md`](../AGENTS.md) §硬规则表 | 硬规则里的写边界 / commit 纪律与改动大小无关 |\n\n**⛔ 自动升级条件（硬 —— 命中任一即当场停下补读完整 L-core 再继续，不许「就差一点，先改完」）**：\n\n- 发现要动的不只是文案：要**换组件**、要**改 / 新增 token 或写字面量**、要**加删元素或改布局**；\n- 要动**第二个文件**（含\"顺手把生成产物也重跑一下\"）；\n- 触到**组件选型**（该用 A 还是 B）、**Figma 真源判断**、**divergence 登记**；\n- 用户在同一 session 里追加了任何非微改任务，或要求推荐 / 排期 / 裁定；\n- 自己不确定判据 1-4 是否满足 —— **不确定就是不满足**。\n\n**⛔ 本档不放宽的**：mockup 写操作仍走 `AGENTS.md` §Mockup Write Gate 4 步前置 + §必读链路 7-11 整链（不受本档影响）；任何写 Figma 的动作照旧要显式授权。\n\n### L-core — 每 session 全文必读（禁 grep / 跳读 / 摘要替代）\n\n| # | 文件 | 作用 |\n|---|---|---|\n| **0** | ⭐ [`FIGMA_AS_SOURCE_OF_TRUTH.md`](./FIGMA_AS_SOURCE_OF_TRUTH.md) | **最高优先级原则** — Figma 真源 + 唯一合法 divergence + 禁止启发式验证 |\n| 1 | **本文件 STATUS.md** | 知道在哪（状态镜像 + 本链路 SoT） |\n| 2 | [`PROJECT_GOAL.md`](./PROJECT_GOAL.md) | 知道目标（5 个能力 + 受众 + 约束） |\n| 3 | [`_plans/next-session-pickup-*.md`](./internal/_plans/) 最新一份
**⚡ 当前活跃优化程序（固定指针 · 不靠 mtime · 并行 session 再写新 pickup 也不漂移）**：[全生命周期优化](./internal/_plans/next-session-pickup-2026-07-08-full-lifecycle-optimization.md) → 存档 SoT [`full-lifecycle-assessment-2026-07-08`](./internal/full-lifecycle-assessment-2026-07-08.md)（tracked = backlog **INFRA-F55**） | 当前 sprint 操作手册 |\n\n### L-ref — 最小集必读 + 命中触发再深读（各文件顶部有「🤖 AI 读取指引」）\n\n| 文件 | 每 session 最小集 | 升级为全读 / 深读的触发 |\n|---|---|---|\n| [`AGENTS.md`](../AGENTS.md) | §硬规则表（含 Enforcement 层级列）+ §Onboarding Gate | 写 prompt / 审 executor → §工作流 + task-type 矩阵；commit 前 → §Git 工作流；**mockup 任务 → §Mockup Write Gate + §必读链路 7-11 整链升 mandatory** |\n| [`tracker`](./internal/retrospection/design-spec-canonical-alignment-tracker.md) | §排期原则 | 任何\"v0.X 包含哪些 / 先做哪个 / 该不该上 Tier N\"决策 → 全读 |\n| [`backlog.md`](./internal/backlog.md) | — | 当前 sprint task 对应 entry → **全文 Read（不是 grep）**；新增 entry → 先 grep 全部已用 ID |\n| [`meta-rules.md`](./meta-rules.md) | 触发器目录（标题扫一遍） | 写 prompt / 设计机制 / 推荐方案前 → 反模式清单全读 |\n| [`code-conventions.md`](./internal/code-conventions.md) | — | **写 UI 代码的任何任务**（Vue / React / HTML — 含 `playground/docs/*`、`src/components/*`、下游产品 demo 与 PoC）→ 顶部 **§🤖 AI 读取指引 的「起手必读段」**（§R0 Phase 0 元素→组件映射 + §R7 四场景判断 + Task Entry Modes 的唯一活源），单条 R-rule 按该表触发条件 jump。⛔ 禁全量吞（近 90 KB）；⛔ 跳过起手必读段直接进 R-rule = 协议违反。**注**：机械路径 `detect-figma-task.sh` 只在 prompt 含 `figma.com/(design\\|file)/` URL 时触发，**没有 Figma URL 的 code 任务全靠本行**（[[INFRA-F121]] ①） |\n| [`working-principles.md`](./working-principles.md) | 原则 0-8 标题 | 实现决策（命名 / token / API 形态）命中 → 对应原则全读 |\n| [`translation/`](../src/design-system/translation/) 4 文件 | — | Figma↔Code 命名 / divergence / alias 决策时查对应文件 |\n| mockup 链（AGENTS §7-11 + [`figma-component-catalog.md`](./internal/figma-component-catalog.md)） | — | **mockup 任务整链升 mandatory**（Mockup Write Gate 的 4 步前置不变，仍是硬规则） |\n\n> **违反信号（分层版，命中任一 → 停下重读）**：\n> - L-core 没读完就给项目相关回答 / 推荐 → 错（\"我已经知道大概了 / 状态简单跳一步\" 同罪）\n> - L-core 或 backlog 当前 task entry 用 grep / 摘要替代全文 Read → 错\n> - 命中 L-ref 触发条件却只读了标题 / 最小集 → 错（如排期决策没全读 tracker、mockup 任务没读 §7-11）\n> - \"memory 兜底替代 SoT\" → 错（memory 是 AI 缓存，项目契约真源在仓库）\n>\n> **历史实证**：2026-05-13 session 10 跳过 PROJECT_GOAL + AGENTS → 首轮推荐缺 4 项硬约束（canonical SoT / plan owner 边界 / working-principles / meta-rules）→ 用户返工纠偏。2026-06-10 system-review P1-08：旧版\"全量读 ~225KB（mockup +270KB）标 30min\"失真 → gate 被默读架空；两层化让严格性落在读得完的集合上。\n\n---\n\n## Wrap-up 协议\n\n> **session 收尾时读** [`docs/WRAP-UP.md`](./WRAP-UP.md)（每-session STATUS 必改项 + Release wrap-up + Retrospection 触发判断）。\n> 核心一条：顶部 \"Last updated\" 改到今天 + 当日摘要（旧摘要 prepend 进 STATUS-CHANGELOG.md）；SessionEnd hook 自动核验日期。\n\n---\n\n## 文件关系（防混淆）\n\n| 文档 | 用途 | 更新节奏 |\n|---|---|---|\n| **STATUS.md**（本文件） | 全局状态镜像 + 版本线分组 + Active 余量 | **每 session** |\n| `PROJECT_GOAL.md` | 项目目标 + 5 个能力 + 受众 + 约束 | 大方向变才改（罕见） |\n| `_plans/next-session-pickup-*.md` | 当前 sprint 操作手册（prompts / 任务顺序 / dirty 协议） | **每 sprint** |\n| `CHANGELOG.md` | Release-facing（外部 consumer 看）| 每 release |\n| `backlog.md` | 全量 entry 详情（Active only，完成直接删） | 每发现 / 每完成 |\n| `retrospection/design-spec-canonical-alignment-tracker.md` | 设计规范完整计划 + 进度时间线（living doc）| **每 session wrap-up 前同步** |\n| `retrospection/*.md` | 阶段复盘（决策 / 反模式 / 教训） | 每阶段完成 |\n| `internal/STATUS-CHANGELOG.md` | 历史 session changelog 归档（从本文件拆出） | 每 session wrap-up |\n| `WRAP-UP.md` | session 收尾协议（STATUS 必改项 / Release / retrospect 触发） | 罕见 |\n| `PLUGIN.md` | Claude Code plugin 独立分发轨道 | 每 plugin release |\n\n**真源关系**：STATUS.md 是各 SoT 的**镜像/导航**，不是 SoT 本身。具体决策仍在 PROJECT_GOAL / pickup / backlog / CHANGELOG。\n\n### SoT 归属表（哪类事实以谁为准 · INFRA-F58）\n\n> AI 读多份文档遇到冲突时，**以本表指定的真源为准**，其余处一律视为镜像/指针（镜像 stale 时以真源修镜像，不反向）。\n\n| 事实类型 | 唯一真源 | 说明 |\n|---|---|---|\n| **npm 包当前版本号** | STATUS §当前版本（字面版本号只此一处）| README/PLUGIN/GETTING_STARTED/AGENTS 一律\"见 STATUS\"，不写字面版本（de-mirror 闸 `no-version` mode 强制）|\n| **docs 站要不要跟着发版发布** | [`RELEASING.md`](./RELEASING.md) §Step 4 | = **owner 决定，不是 REQUIRED**（owner 裁定 2026-07-31，此前 Step 4 写 REQUIRED / [[INFRA-F84]] 残余① 写 owner 决定，两处各说一套）。测量口 = `pnpm check:docs-site-version`（三态 `0`/`1`/`2`，`2` 当 `0` 用就是假绿），别处只指回 Step 4 |\n| **layout 断点 / 容器宽的数值** | `src/tokens/variables.css` §`── Layout breakpoints ──` + §`── Layout containers ──` | code-first（owner 拍 2026-07-31，登记在 `divergences-decisions.json`）；CSS `@media` 吃不了 `var()` → 引用的可校验形式 = 字面量 ∈ token 值集合，`audit:layout-tokens` 机械核；非 CSS 消费方走 `./tokens` DTCG + `./tokens/js`（同一份文件派生，不存第二份）|\n| **plugin 版本号** | `PLUGIN.md` §版本表 | 与 npm 版本独立；de-mirror 闸 `no-npm-version` mode 放行本文件自身 plugin 版本 |\n| **发版历史 / changelog** | `CHANGELOG.md`（外部）+ `STATUS-CHANGELOG.md`（内部）| — |\n| **排期 / 版本包含哪些** | `retrospection/design-spec-canonical-alignment-tracker.md` §排期原则 | STATUS Version Roadmap 段是镜像 |\n| **Active backlog 全量** | `backlog.md` §Active | STATUS \"Active 后续工作\" 是计数镜像（C4 gate 核）|\n| **5 能力定义** | `PROJECT_GOAL.md` §一句话目标 | 能力**成熟度/状态** → STATUS §能力×成熟度表 |\n| **Figma↔Code 真源原则 + 合法 divergence** | `FIGMA_AS_SOURCE_OF_TRUTH.md` + `translation/divergences-decisions.json` | — |\n| **组件公开 API（props/values）** | 组件 SFC `defineProps`（如 `ButtonBridge.vue`）+ 文档站组件页 | 文档示例必须与 SFC 一致；F58 实证 GETTING_STARTED/README 曾漂移 |\n| **AI 协作硬规则 / 起手链路** | `AGENTS.md` §硬规则 + STATUS §起手必读链路 | 链路 SoT 在 STATUS，AGENTS 只登记任务触发表 |\n| **文档间\"改 X 复查 Y\"依赖** | `docs/internal/doc-sync-map.json` | audit:doc-sync 校 |\n","numLines":240,"startLine":1,"totalLines":240}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"87fd6378-88a7-4b7a-b5af-e5819f4f56a9","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":144,"estimated_tokens_delta":94,"uuid":"22f03181-2c4b-40eb-9011-be184a75d749","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHwEqoBqATHWK7mfm56","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAIStgQKpgEIERgCKkACibSwGkMC3Kuh0HiHqR4PqzTpStG1qPazIZe9/iJpp6ILjLaUPWS9ixPKnqBdlUqCSxdLfTy75OFAsoCqt75VMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAerWtdQGsAECEgy43Nme1MtkeB/mt0AaDBWDXi3l41mGqzybECIwRr8es+1VISMuFkx+kz7qmsFOVn1K87ufUKLcr7LYiHVb+sHIA3EugHK+3r+6X0N+KrwCjKHm/5ID/ztBoRFVo3u+b7fMaqmsWSDHpmocszcr4BiiWTO0hnZNeFH71AC7yfvxMWNuFPXO8JaiFzPaSWi9O6uMRE4E+eVGRt8t2XWh9oS7c/DmWzfLdJr49xDQ8NChv2TU9vajqWaIGXK+wjMdOVAaake1ElIeeoY+rQirW3v5MoqzSEYPeJGiKEDWninpH+L1zsvVbFmU6S+tqiSuZOXaLzGp3rSrRIRru9xPKM3X9ULbOT7lI/hiqDnQ5Y6NrMJy6QyonRlIWfStdUQIm1O4AFl44Vwz+HtDkrVuqjmHOfnTRWn+HpELlB5QSGsoWmQ17XSQalsTBN0lxGj05wdgYLe4nplayeBybhdzD2glgO9sIOQF0b4Rx5O2tB1LEnLOMBbuaEfw2XKd9u88sPImbG/X6asG5uRq9RgB"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":22898,"cache_read_input_tokens":72088,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":22898},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"cf249ca1-e676-4218-a6da-68c2c34be8af","timestamp":"2026-08-25T10:16:10.241Z","request_id":"req_011CePHwBF12yt7qLUNoBRmf"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHwEqoBqATHWK7mfm56","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01YLPHXz8F8Yn5dCvhbaGwNy","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/AGENTS.md"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":22898,"cache_read_input_tokens":72088,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":22898},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"afcd5c87-bc04-4f11-ab31-cae82db5c822","timestamp":"2026-08-25T10:16:11.476Z","request_id":"req_011CePHwBF12yt7qLUNoBRmf"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHwEqoBqATHWK7mfm56","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01URHzVT89u12Vv9tASVAyAh","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/_plans/next-session-pickup-2026-07-08-full-lifecycle-optimization.md"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":22898,"cache_read_input_tokens":72088,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":22898},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"30931788-2819-492a-875b-92ab95b3a59c","timestamp":"2026-08-25T10:16:11.938Z","request_id":"req_011CePHwBF12yt7qLUNoBRmf"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01URHzVT89u12Vv9tASVAyAh","type":"tool_result","content":"1\t# Next Session Pickup — 全生命周期流程优化（逐项实现）\n2\t\n3\t> 生成：2026-07-08 分析 session 收尾。本 session 只做了**只读评估 + 存档**，不改任何规范/代码。\n4\t> 起手第一句：`按 docs/internal/_plans/next-session-pickup-2026-07-08-full-lifecycle-optimization.md 推进全生命周期优化`\n5\t\n6\t---\n7\t\n8\t## ⏩ 进度更新 2026-07-09（下个 session 从这里接）\n9\t\n10\t**已完成（都在 master，双 remote push）**：\n11\t- ✅ **主线1 = INFRA-F58 文档一致性 + SoT 单一化**全 7 子项（`21c8c819` + follow-up `2a6eee5e`）。含 broken Button quickstart 修（vitest 实测 static `style=` 坏）、版本单一真源 + de-mirror 闸扩 5 份、code→Figma 边界重述、能力×成熟度表 + SoT 归属表、`doc-sync` 闸、MIGRATION/API_STABILITY 修。拆出 **INFRA-F59**（外观变体 prop 统一，归支柱①）。\n12\t- ✅ **精简/一致性梳理**（owner 追加）：3 subagent 审计 → 删 **222** 个 April-May 死件（`1b6f684d`，stale-anchors 零孤儿）。\n13\t- ✅ **主线2 = 支柱④ 上游理解-分析 gate 设计 spec**（`a043a2c1` + owner 两轮修正 `75daf749`）：spec = [`docs/superpowers/specs/2026-07-09-pillar4-upstream-gate-design.md`](../../superpowers/specs/2026-07-09-pillar4-upstream-gate-design.md)。三决策 = 产出物+schema/chokepoint 校验 · 双层防假闸 · 便携优雅降级。enforcement = **chokepoint-bound**（非 PR 普适；L1 靠会话内人类确认+落点采纳补机校+诚实边界）。采纳骑现有消费 scaffold（不依赖 Gitea）+ git-remote 探测。\n14\t\n15\t**下一步（本 pickup 的续跑入口）**：\n16\t1. **[最高优先] 支柱④ gate → writing-plans**：spec 已过 owner review gate（用户 07-09 已认可两轮修正）。直接 invoke `superpowers:writing-plans` 基于该 spec 出实现 plan（validator + schema + 消费 scaffold 接线 + git-remote 探测 + DS repo CI）。\n17\t2. **遗留精简决策（不阻塞）**：backlog INFRA-F58 §残余 worklist —— conformance-log/long-term-plan/token-strategy 的 delete-vs-move-retrospection policy（owner 拍）；规则三层化重构（M1/S1-S3）归 **F55 支柱①** 专门 plan。\n18\t3. 其余支柱（②代码网/③适配器/元层）按 assessment §8 排期，owner ack 逐步推。\n19\t\n20\t---\n21\t\n22\t## 0. 起手必读\n23\t\n24\t1. 走完 L-core onboarding（FIGMA_SOT / STATUS / PROJECT_GOAL / 本 pickup）。\n25\t2. **全文读评估 SoT**：[`docs/internal/full-lifecycle-assessment-2026-07-08.md`](../full-lifecycle-assessment-2026-07-08.md)——它是本轮所有优化的真源（操作模型 / 架构 / 差距登记 / 承诺-vs-实现 / 排期 / 一手验证事实附录）。\n26\t3. **并行 session 警告**：另有 session 在做 Vue↔React parity 工具 + INFRA-F54（CE `$slots` 失效致具名 slot 在 React 丢；TopBar/ButtonBridge 已修，FormItem/Tooltip/PopupBox 待 CE-safe 检测）。dirty/untracked 文件先假设别 session 在动，不主动消化。见 [[user_parallel-sessions]]。\n27\t\n28\t## 1. 目标架构（要落地的东西 · 全文在评估 SoT §3）\n29\t\n30\t**自触发脊梁 + 四支柱 + 元层**，PR review = owner 统一验收关卡（尽量自动、人只 merge）：\n31\t\n32\t- **自触发脊梁**（工具无关 · 面向人和 AI）：git hook（post-checkout/pre-push）+ `pnpm ds start` 入口 + PR/CI + README「START HERE」。让\"不懂流程的人/任何工具\"被自动导进正确流程。\n33\t- **支柱① 工具无关机器可读契约**：npm 内组件契约（API + 组合规则 + 成熟度 status）+ 精简可移植规则文件 + Figma 库 + claude-design-bundle。不再锁在 skill/6916 行 prose。\n34\t- **支柱② 双质量网**：\n35\t - **代码网（pillar②）**：PR/CI gate，谁产的代码都过。基础已在 Gitea（`.gitea/workflows/pr-checks.yml` 合并前跑 vue-tsc+vitest+prepublishOnly），缺 consumer 冒烟 / API-breaking / 视觉·render 上 PR / **Gitea 分支保护\"必需+禁直推\"** / 风险分诊。\n36\t - **设计网**：Figma/托管产出的\"提交即校验\"（缺口 A：mockup conformance 从 hook 提醒 → 强制自动跑 + 报告防伪，堵 `I1=pass` 粘贴洞）。\n37\t- **支柱③ 每工具薄适配器**：Claude Code→hooks/skills、Codex→file-based prompt、claude.ai→bundle+Project Instructions，全指向支柱①同一契约。\n38\t- **支柱④ 上游理解-分析 gate**：产出 code/mockup **之前**强制——需求复述+理解确认 → 读真源（产品 roadmap/PRD/design-record/product-context）→ 竞品(**实时检索**)/persona/IA → 数据可行性 → MVP → user 校验。\n39\t- **元层**：\n40\t - 学习闭环：工具无关、任何人可触发的\"这里不对/新模式\"回流入口 → 喂回契约。\n41\t - **审核分诊（元层②）**：PR 按风险自动分级（docs→轻检 / src→全检 / API改→必人工），保护单一 PR 审核人。\n42\t - 可观测：gate 通过率/返工率/按工具·按人分布埋点。\n43\t\n44\t## 2. 建议实现顺序（最高杠杆先 · 每步 owner ack）\n45\t\n46\t1. **支柱④ 上游 gate + 支柱① 契约补全**：需求确认关卡 + 竞品接实时检索（LiveU/Dejero/Grabyo/Teradek/QuickLink/Cingularity 已验证可查）+ API 跨组件一致性 + 横向一致性 audit gate + 组合契约/TS token 随包发。\n47\t2. **支柱② 代码网补全 + 分诊**：扩 `.gitea/pr-checks.yml`（consumer 冒烟 + API-surface diff）+ Gitea 开分支保护 + 视觉/render 上 PR（绕 Gitea runner 无 root）+ 风险分级。→ 兑现\"自动审 PR、人只 merge、合并前就知道会不会出问题\"+ post-merge canary 兜底。\n48\t3. **支柱② 设计网（缺口 A）**：mockup 确定性后验强制自动跑 + 报告防伪。\n49\t4. **支柱③ 适配器 + 元层**：claude-design-bundle 补全保鲜、Codex 协议对齐、学习闭环 + 可观测埋点。\n50\t5. **横切/韧性 P1**：bundle vite external echarts bug（实现前复核 vite.config）、组件硬编码英文 i18n、consumer 集成测。\n51\t\n52\t## 3. 待 owner 决策的分叉（实现前先定，评估 SoT §7）\n53\t\n54\t1. 设计产出入口在仓库/命令行 vs Figma → 决定设计网形态（要不要 Figma 侧脊梁）。\n55\t2. owner-direct-master vs PR-for-all → 要\"人只 merge\"需实质改动走 PR + 分支保护，与现默认冲突。\n56\t3. Gitea runner 无 root（装不了 chromium）→ 视觉/render 上 PR 的方案。\n57\t4. 每消费产品是否补\"活的 roadmap + product-context\"（支柱④分析质量的天花板）。\n58\t\n59\t## 4. 纪律（避免重蹈本轮/历史坑）\n60\t\n61\t- **验证跨双 host**：CI 事实要同时看 GitHub `.github/` 和 Gitea `.gitea/`（本轮误报\"单测不进 CI\"就是只看 GitHub）。团队真源在 Gitea。\n62\t- 规则/流程别继续往 L1 prose 加——优先升成机械闸（评估 SoT §2 根因）。\n63\t- 承诺-vs-实现落差（TS token / 双框架 / 能力4 / Use Cases）：要么补实现、要么改 PROJECT_GOAL 措辞对齐，别让后续按错误承诺行动。\n64\t- 竞品分析用**实时检索 + 引用来源**，不脑补。\n65\t- owner 直 commit master + push（现默认）；执行前若改动了这条（转 PR-for-all），先 owner 拍板。\n66\t\n67\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"4292ffb9-5d28-4447-aa14-598226a05755","timestamp":"2026-08-25T10:16:11.947Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/_plans/next-session-pickup-2026-07-08-full-lifecycle-optimization.md","content":"# Next Session Pickup — 全生命周期流程优化（逐项实现）\n\n> 生成：2026-07-08 分析 session 收尾。本 session 只做了**只读评估 + 存档**，不改任何规范/代码。\n> 起手第一句：`按 docs/internal/_plans/next-session-pickup-2026-07-08-full-lifecycle-optimization.md 推进全生命周期优化`\n\n---\n\n## ⏩ 进度更新 2026-07-09（下个 session 从这里接）\n\n**已完成（都在 master，双 remote push）**：\n- ✅ **主线1 = INFRA-F58 文档一致性 + SoT 单一化**全 7 子项（`21c8c819` + follow-up `2a6eee5e`）。含 broken Button quickstart 修（vitest 实测 static `style=` 坏）、版本单一真源 + de-mirror 闸扩 5 份、code→Figma 边界重述、能力×成熟度表 + SoT 归属表、`doc-sync` 闸、MIGRATION/API_STABILITY 修。拆出 **INFRA-F59**（外观变体 prop 统一，归支柱①）。\n- ✅ **精简/一致性梳理**（owner 追加）：3 subagent 审计 → 删 **222** 个 April-May 死件（`1b6f684d`，stale-anchors 零孤儿）。\n- ✅ **主线2 = 支柱④ 上游理解-分析 gate 设计 spec**（`a043a2c1` + owner 两轮修正 `75daf749`）：spec = [`docs/superpowers/specs/2026-07-09-pillar4-upstream-gate-design.md`](../../superpowers/specs/2026-07-09-pillar4-upstream-gate-design.md)。三决策 = 产出物+schema/chokepoint 校验 · 双层防假闸 · 便携优雅降级。enforcement = **chokepoint-bound**（非 PR 普适；L1 靠会话内人类确认+落点采纳补机校+诚实边界）。采纳骑现有消费 scaffold（不依赖 Gitea）+ git-remote 探测。\n\n**下一步（本 pickup 的续跑入口）**：\n1. **[最高优先] 支柱④ gate → writing-plans**：spec 已过 owner review gate（用户 07-09 已认可两轮修正）。直接 invoke `superpowers:writing-plans` 基于该 spec 出实现 plan（validator + schema + 消费 scaffold 接线 + git-remote 探测 + DS repo CI）。\n2. **遗留精简决策（不阻塞）**：backlog INFRA-F58 §残余 worklist —— conformance-log/long-term-plan/token-strategy 的 delete-vs-move-retrospection policy（owner 拍）；规则三层化重构（M1/S1-S3）归 **F55 支柱①** 专门 plan。\n3. 其余支柱（②代码网/③适配器/元层）按 assessment §8 排期，owner ack 逐步推。\n\n---\n\n## 0. 起手必读\n\n1. 走完 L-core onboarding（FIGMA_SOT / STATUS / PROJECT_GOAL / 本 pickup）。\n2. **全文读评估 SoT**：[`docs/internal/full-lifecycle-assessment-2026-07-08.md`](../full-lifecycle-assessment-2026-07-08.md)——它是本轮所有优化的真源（操作模型 / 架构 / 差距登记 / 承诺-vs-实现 / 排期 / 一手验证事实附录）。\n3. **并行 session 警告**：另有 session 在做 Vue↔React parity 工具 + INFRA-F54（CE `$slots` 失效致具名 slot 在 React 丢；TopBar/ButtonBridge 已修，FormItem/Tooltip/PopupBox 待 CE-safe 检测）。dirty/untracked 文件先假设别 session 在动，不主动消化。见 [[user_parallel-sessions]]。\n\n## 1. 目标架构（要落地的东西 · 全文在评估 SoT §3）\n\n**自触发脊梁 + 四支柱 + 元层**，PR review = owner 统一验收关卡（尽量自动、人只 merge）：\n\n- **自触发脊梁**（工具无关 · 面向人和 AI）：git hook（post-checkout/pre-push）+ `pnpm ds start` 入口 + PR/CI + README「START HERE」。让\"不懂流程的人/任何工具\"被自动导进正确流程。\n- **支柱① 工具无关机器可读契约**：npm 内组件契约（API + 组合规则 + 成熟度 status）+ 精简可移植规则文件 + Figma 库 + claude-design-bundle。不再锁在 skill/6916 行 prose。\n- **支柱② 双质量网**：\n - **代码网（pillar②）**：PR/CI gate，谁产的代码都过。基础已在 Gitea（`.gitea/workflows/pr-checks.yml` 合并前跑 vue-tsc+vitest+prepublishOnly），缺 consumer 冒烟 / API-breaking / 视觉·render 上 PR / **Gitea 分支保护\"必需+禁直推\"** / 风险分诊。\n - **设计网**：Figma/托管产出的\"提交即校验\"（缺口 A：mockup conformance 从 hook 提醒 → 强制自动跑 + 报告防伪，堵 `I1=pass` 粘贴洞）。\n- **支柱③ 每工具薄适配器**：Claude Code→hooks/skills、Codex→file-based prompt、claude.ai→bundle+Project Instructions，全指向支柱①同一契约。\n- **支柱④ 上游理解-分析 gate**：产出 code/mockup **之前**强制——需求复述+理解确认 → 读真源（产品 roadmap/PRD/design-record/product-context）→ 竞品(**实时检索**)/persona/IA → 数据可行性 → MVP → user 校验。\n- **元层**：\n - 学习闭环：工具无关、任何人可触发的\"这里不对/新模式\"回流入口 → 喂回契约。\n - **审核分诊（元层②）**：PR 按风险自动分级（docs→轻检 / src→全检 / API改→必人工），保护单一 PR 审核人。\n - 可观测：gate 通过率/返工率/按工具·按人分布埋点。\n\n## 2. 建议实现顺序（最高杠杆先 · 每步 owner ack）\n\n1. **支柱④ 上游 gate + 支柱① 契约补全**：需求确认关卡 + 竞品接实时检索（LiveU/Dejero/Grabyo/Teradek/QuickLink/Cingularity 已验证可查）+ API 跨组件一致性 + 横向一致性 audit gate + 组合契约/TS token 随包发。\n2. **支柱② 代码网补全 + 分诊**：扩 `.gitea/pr-checks.yml`（consumer 冒烟 + API-surface diff）+ Gitea 开分支保护 + 视觉/render 上 PR（绕 Gitea runner 无 root）+ 风险分级。→ 兑现\"自动审 PR、人只 merge、合并前就知道会不会出问题\"+ post-merge canary 兜底。\n3. **支柱② 设计网（缺口 A）**：mockup 确定性后验强制自动跑 + 报告防伪。\n4. **支柱③ 适配器 + 元层**：claude-design-bundle 补全保鲜、Codex 协议对齐、学习闭环 + 可观测埋点。\n5. **横切/韧性 P1**：bundle vite external echarts bug（实现前复核 vite.config）、组件硬编码英文 i18n、consumer 集成测。\n\n## 3. 待 owner 决策的分叉（实现前先定，评估 SoT §7）\n\n1. 设计产出入口在仓库/命令行 vs Figma → 决定设计网形态（要不要 Figma 侧脊梁）。\n2. owner-direct-master vs PR-for-all → 要\"人只 merge\"需实质改动走 PR + 分支保护，与现默认冲突。\n3. Gitea runner 无 root（装不了 chromium）→ 视觉/render 上 PR 的方案。\n4. 每消费产品是否补\"活的 roadmap + product-context\"（支柱④分析质量的天花板）。\n\n## 4. 纪律（避免重蹈本轮/历史坑）\n\n- **验证跨双 host**：CI 事实要同时看 GitHub `.github/` 和 Gitea `.gitea/`（本轮误报\"单测不进 CI\"就是只看 GitHub）。团队真源在 Gitea。\n- 规则/流程别继续往 L1 prose 加——优先升成机械闸（评估 SoT §2 根因）。\n- 承诺-vs-实现落差（TS token / 双框架 / 能力4 / Use Cases）：要么补实现、要么改 PROJECT_GOAL 措辞对齐，别让后续按错误承诺行动。\n- 竞品分析用**实时检索 + 引用来源**，不脑补。\n- owner 直 commit master + push（现默认）；执行前若改动了这条（转 PR-for-all），先 owner 拍板。\n\n","numLines":67,"startLine":1,"totalLines":67}}} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01YLPHXz8F8Yn5dCvhbaGwNy","type":"tool_result","content":"1\t# AI Agents 必读（跨 AI 工具通用）\n2\t\n3\t> 本文件适用于：Codex / Claude Code / Cursor / Cline / GitHub Copilot / 任何在本仓库工作的 AI 工具。\n4\t\n5\t---\n6\t\n7\t## 仓库身份（Owner / 默认作者）\n8\t\n9\t- **Owner**：Nancy ``\n10\t- **默认 UX 交付说明作者**：Nancy（任何 M23 规则卡 / annotation footer 的 \"Author / 作者\" 字段默认填 Nancy，不要写通用 \"UX\" 角色名）\n11\t- **AI 工作时的身份约定**：AI 是 Nancy 的 plan-owner / executor 代理，**不是独立角色**。所有 AI 写出的 commit / PR / annotation 都视为 Nancy 的署名工作\n12\t\n13\t任何 AI 在生成 attribution（commit author / annotation author / handoff doc 作者行 / Jira reporter 等）时**默认填 Nancy**，除非用户在当前 session 明确指定其他人。\n14\t\n15\t---\n16\t\n17\t## ⛔ Mockup Write Gate（TVU 产品 Figma 写操作 mandatory）— 2026-05-27 新增\n18\t\n19\t任何 AI 工具（不限 Claude Code）在对 **TVU 产品 Figma 文件** 做写操作前——包括但不限于：加 mockup / 改 mockup / 加 UX 交付说明 / 加 jira 组件 / 加注释 / 加 page / 加 tooltip / 调样式——**必须**先完成 4 步：\n20\t\n21\t1. **Read [`docs/internal/mockup-conventions.md`](./docs/internal/mockup-conventions.md) — 按文件顶 §🤖 AI 读取指引 scoped 读**（起手必读段 + 触发 jump，禁全量吞；**读哪几条由该文件顶部的 §🤖 AI 读取指引 jump 表按你的任务派**，⛔ 这里不再抄一份「重点规则」清单 —— 抄一份就是一处会漂的副本，2026-08-14 扩 `audit:rule-inventory` 分母时实测这里抄的那份里，有一个 id **活源根本不存在**）\n22\t2. **Read [`docs/internal/design-process.md`](./docs/internal/design-process.md) § Pre-Phase 0（含 § No Open Questions in Deliverables）+ § Stage 0.5 + § Scope Handling + § Delivery Cleanup Gate**（Stage 0.5 含字段长度分布声明，M43 UX-side 镜像；§No Open Questions = 触发器 P 落地：起手扫齐 open questions + 交付物零未决项，禁止贴 Figma）\n23\t3. **Read [`docs/internal/figma-component-catalog.md`](./docs/internal/figma-component-catalog.md) 标题列表**（lazy reference，具体 entry 按需 grep）\n24\t4. **从 [`docs/site-review-manifest.json`](./docs/site-review-manifest.json) 拿 library fileKey**（不要靠扫产品文件 instance 反推）\n25\t\n26\t**⛔ 写操作全程走 §M-LIFECYCLE 三时点闸**（[`mockup-conventions.md` §M-LIFECYCLE](./docs/internal/mockup-conventions.md)）——任何 create / update / delete：\n27\t- **操作前**：create/move 先 probe 目标区防叠加(§I6) · update 先 live 重读做最小 delta(§I5) · delete 先确认目标 + 处理指向它的 connector(§I5/§M23.6)\n28\t- **操作后（每批次，不拖到末尾）**：跑 `pnpm audit:mockup-conformance --file --node <一个 nodeId>`（规则清单 + 条数真源 = **跑一次 `pnpm audit:mockup-conformance --list-rules`**，⛔ 别在这写死条数、也别指某个会搬家的代码位置 —— 2026-08-24 合并后它已从 `AUDITS` 数组挪进 `scripts/mockup-rules/index.mjs`）+ `use_figma` connector centerline probe；违例当场修\n29\t- **走查时**：design-walkthrough 三轴全跑、机械维度贴机检 pass/fail、机检覆盖面 = 全 session 触碰节点 —— ⚠️ **`--node` 只吃一个 id**，覆盖多节点 = 逐节点跑或整文件跑（**用法真源 = [`scripts/audit-mockup-conformance.mjs`](./scripts/audit-mockup-conformance.mjs) 头注释**，本文件不复述）\n30\t\n31\t**触发判定（命中任一即触发）**：\n32\t- 用户给了 Figma URL + 任一动词：\"加 / 改 / 调 / 更新 / 同步 / 推 / 画 / 设计\"\n33\t- 用户说\"加 UX 交付说明 / UX notes / 加 jira 组件 / 走查 / 角色测试 / persona / journey map\"\n34\t- 用户说\"基于昨天的页面修改\" / \"在上一期 mockup 上加 X\" / \"clone 这个 page 改 Y\" → 额外触发 M46 (Library Instance Iteration Discipline)\n35\t- fileKey 命中 TVU 产品文件（典型如 TPC-20220519 `xu7H3ppLyQfa3fOmU8M7iO` / Micro-Apps-20250923 等；非 library 文件均按 TVU 产品文件处理）\n36\t\n37\t**严禁**：\n38\t- 用 claude.ai 通用 `figma-use` / `figma-generate-design` skill 替代 TVU 专属硬规则（M23 等会被整段跳过）\n39\t- 用 memory cache 替代 mockup-conventions.md 真源（memory 是工具私有缓存，规则演化 memory 会过期）\n40\t- \"起手只读 STATUS.md，mockup 规则现场拍\" → mockup 写操作硬规则前置，不允许现场拍\n41\t- 起手用 createFrame 自画 overlay 覆盖既有库 instance → 违 M46 (Library Instance Iteration Discipline)；正路是先 probe instance 可改性\n42\t- M23 UX 交付卡里塞 regex / pseudocode / 长代码块 → 违 M23.10 (Audience-Aware Language)\n43\t- 把 Persona / out-of-scope 声明 / 未来 roadmap 这类 tangential 内容塞进 UX 卡 → 违 M23.11 (Scope Discipline)\n44\t- \"本期不动 R list\" 误读成 \"hide R list\" → 违 design-process.md § Scope Handling\n45\t- Session 收尾前不走 cleanup → 留下被 supersede 的临时 spec / overlay / code 卡 → 违 design-process.md § Delivery Cleanup Gate\n46\t- 调列宽 / 改 cell 内容后只截整表缩略图自检 → 违 M43.2 (Column Width Self-Audit)，必须 zoom-in 每列\n47\t\n48\t**违反信号 → 上一段输出不合格，重做**：\n49\t- UX 交付说明卡用了 cream / 浅底 / 单语 / 非 navy `#2B2D42` → M23 违例\n50\t- 表格新增字段没在 mockup 里给 3 状态（正常 / 截断 / hover tooltip） → M43 违例\n51\t- 自画 RECTANGLE+TEXT 拼 tooltip / button / 注释卡 → M32 Library-First 违例\n52\t- 装饰元素 / NEW badge 浮在 page 层不在 mockup frame 内 → M-INTEGRITY §I4 违例\n53\t- 改了 text 节点 fontName 但没保留 textStyleId → M47 违例（cell 渲染会变灰 / 错位）\n54\t\n55\t**实证**：\n56\t- 2026-05-27 FB-9398（TPC-Service 消费端）：AI 起手只加载 claude.ai 通用 `figma-use` skill，跳过 mockup-conventions.md → UX 交付说明卡用 cream 浅底自由设计 + 单语 → 用户连续两次抓\"没用 TVU 设计系统已有规则\"\n57\t- 2026-05-28 TPC-628（TPC-Service 消费端）：AI 起手 clone FB-9398 后误判 instance 不可改 → 跳到自画 overlay；又把 NEW badge 放 page 层；font fallback 时丢 textStyleId 让 cell 变灰；列宽 rebudget 砍了 Operation 列但没 zoom-in 验证 Edit/Delete/Status 三按钮溢出；收尾时留下 spec 帧 / Display Logic 代码卡 / Persona 卡等冗余 → 用户连续抓 7 次。本次回流加 M46 / M47 / M-INTEGRITY §I4 / M23.10 / M23.11 / M43.2 / Scope Handling / Delivery Cleanup Gate 等规则。\n58\t\n59\t---\n60\t\n61\t## ⛔ Onboarding Gate（第一个项目相关回答前 mandatory）\n62\t\n63\t**任何 AI 在第一个项目相关任务 / 推荐 / 回答前，必须先完成 [`docs/STATUS.md` §起手必读链路](./docs/STATUS.md#起手必读链路) 的两层 onboarding**（该节是链路唯一 SoT，本文件不重复维护清单 — 2026-06-10 P1-07/P1-08 重构）：\n64\t\n65\t- **L-core 全文必读（4 份，禁 grep / 跳读）**：FIGMA_AS_SOURCE_OF_TRUTH → STATUS → PROJECT_GOAL → 当前 pickup。⚠️ **体量 / 耗时预算的唯一真源 = STATUS §起手必读链路**，本文件刻意不复述那个数字 —— 那四份自己每工作日都在涨，复述一份就是又一处会漂的副本（原 INFRA-F95 已付代价 4：两处都写「~40KB」而实测 2.2× —— **该 entry 2026-08-13 已闭合删档**，这条实证的留痕在 `STATUS-CHANGELOG` 与 `audit-doc-shape.mjs` 头注释）\n66\t- **L-ref 最小集必读 + 命中触发深读**：本文件 §硬规则表 + §Onboarding Gate 是每 session 最小集；tracker §排期原则 / backlog 当前 entry 全文 / meta-rules / working-principles / translation/ 按触发表升级 —— 触发表见 STATUS §L-ref\n67\t- **Mockup 任务**：§Mockup Write Gate 4 步前置 + §必读链路 7-11 整链升 mandatory（不受分层影响，仍是硬规则）\n68\t- **唯一减档 = 微改档**（单文件 · 纯文案 · 不换组件不改 token）：判据 / 必读集 / 自动升级条件的**唯一 SoT = [`STATUS.md` §微改档](./docs/STATUS.md#微改档单文件纯文案的减档)**，本文件刻意不复述（owner 2026-08-13 裁定新增；复述一份就是第二处会漂的副本 — [[INFRA-F121]] 已付过这个代价）。⚠️ 上一条 L-core「4 份」在微改档下减为 **#0 + 本文件 §硬规则表**；mockup 写操作**不适用**本减档\n69\t\n70\t**机械执行**：用 TodoWrite / TaskList / 等价机制为 L-core 每项 + 命中的 L-ref 项各建 1 个 todo，逐个 Read 完才能开始回答。**基于 partial L-core 给推荐 = 协议违反**。\n71\t\n72\t**违反信号（分层版）+ 历史实证**：见 [`STATUS.md` §起手必读链路](./docs/STATUS.md#起手必读链路)（该节是链路唯一 SoT，含完整违反信号分层 + 2026-05-13/2026-06-10 P1-08 实证）——本节不再内联镜像，避免两处各改一处忘的 drift（DUP-01；此前 AGENTS 版已漏掉 STATUS 版的 P1-08 教训）。\n73\t\n74\t---\n75\t\n76\t## AI 响应格式规则（决策点 / 推荐型回答 mandatory）\n77\t\n78\tAI 在面对决策点 / 给用户多选项 / 推荐方案时，响应**必须包含 4 块**（缺一不合格）：\n79\t\n80\t1. **总计划 / 总数字**：当前剩余多少问题 / 总任务清单（含已完成 + 待办）\n81\t2. **本次范围**：本轮做了什么 / 影响多少数字\n82\t3. **明确推荐**：选哪个，不要\"A 或 B 都可以\"模糊话；候选 ≥ 2 个时必须排序 + 标默认\n83\t4. **推荐理由**：3 条以内核心理由\n84\t\n85\t**违反信号**（命中任一 → 上一条响应不合格，重写）：\n86\t- 用户问\"推荐哪个\" / \"还剩多少\" / \"总计划呢\" → 重写\n87\t- 用户说\"我自己决定\" / \"你决定\" → 默认仍要给推荐；\"我没意见\"不算合规\n88\t- 列了多选项但没排序 / 没标默认 → 重写\n89\t\n90\t**历史实证**：2026-05-20 session 用户多次因为这 4 块缺失追问 / 重发问题（典型：\"你没告诉我剩下还有多少问题？你推荐解决哪个？为什么\"）。\n91\t\n92\t**规则分层（DUP-05 — 出推荐时三条协同、非重复）**：本节 = **输出契约**（响应长什么样）。配套两条在 [`meta-rules.md`](./docs/meta-rules.md)：**触发器 F**（出推荐**前**的推荐自审 4 问：理由经得起反驳吗 / 有没有把最省事项包装成 #1 / 有没有更稳健选项被压脚注 / 该我拍还是 owner 拍）；**触发器 E**（决策疲劳态下\"只给一个推荐拍 Yes/No\"的 mode override——与本节\"候选 ≥2 排序标默认\"不冲突：E 管疲劳态、本节管常态多选）。三者 = 自审→输出→疲劳降级 的分层，不是三份重复规则。\n93\t\n94\t---\n95\t\n96\t## 项目一句话\n97\t\n98\t把 **Figma 已发布 Library**（组件 / Token / 图标 / Styles）做成 **AI 与开发可消费的双向 Figma↔Code 桥**。\n99\t\n100\t> **5 个能力的完整定义 + 各能力前置约束（T3/T4 schema 设计要点）+ 能力 3 的边界分层，真源 =\n101\t> [`docs/PROJECT_GOAL.md`](./docs/PROJECT_GOAL.md) §一句话目标**。能力**成熟度 / 当前状态** →\n102\t> [`docs/STATUS.md`](./docs/STATUS.md) §能力 × 成熟度表。\n103\t>\n104\t> 2026-08-03 本节从全量镜像收成一句 + 指针（[[INFRA-F58]] D1）。原先这里复述了 5 条能力**并夹带\n105\t> 会变的数字与 key**（`render-verification-manifest 936 条` / `YbsPRUVmNdsbN40NNwh1Gn` / \"待 Pro plan\"），\n106\t> 那是三份现状真源的第四份副本 —— manifest 条数与 plan 状态都在别处随时会动。\n107\t\n108\t---\n109\t\n110\t## 必读链路\n111\t\n112\t> **Onboarding 链路唯一 SoT = [`docs/STATUS.md` §起手必读链路](./docs/STATUS.md#起手必读链路)**（L-core 全读 + L-ref 按触发深读）。本节不再维护并行清单（2026-06-10 P1-07 双链路 drift 治理），只登记 **L-ref 的任务触发表** —— 命中触发即把对应真源升为该任务的 mandatory 深读：\n113\t\n114\t| 触发（做什么） | 深读真源 |\n115\t|---|---|\n116\t| 排期 / 版本决策（\"v0.X 含哪些 / 先做哪个 / 该不该上 Tier N\"） | [`tracker`](./docs/internal/retrospection/design-spec-canonical-alignment-tracker.md) 全读（最小集 = §排期原则） |\n117\t| 写 prompt / 设计机制 / 给推荐方案 | [`docs/meta-rules.md`](./docs/meta-rules.md) 反模式清单 |\n118\t| **写 UI 代码**（Vue / React / HTML — 含本仓库 `playground/docs/*`、`src/components/*`、下游产品 demo 与 PoC） | [`docs/internal/code-conventions.md`](./docs/internal/code-conventions.md) 顶部 **§🤖 AI 读取指引 的「起手必读段」**（含 §R0 Phase 0 元素→组件映射 + §R7 四场景判断 + Task Entry Modes；具体 R-rule 按该表触发条件 jump）。⛔ 按 scoped 读，**禁全量吞**（该文件近 90 KB）；⛔ 跳过起手必读段直接进单条 R-rule = 协议违反（该文件自记「漏 R0 Phase 0 是历史最高频回归源」） |\n119\t| 实现决策：命名 / token / API 形态 / 图标 alias | [`docs/working-principles.md`](./docs/working-principles.md) 9 条原则（0-8）对应条 + [`src/design-system/translation/`](./src/design-system/translation/) 4 文件（`prop-aliases` / `divergences` / `icon-aliases.ts` / `token-aliases.ts`） |\n120\t| 数据来源 / 生成链 / 清理规则 | [`docs/PROJECT_MAP.md`](./docs/PROJECT_MAP.md) |\n121\t| 历史决策回溯 / \"怎么走到这里的\" | [`docs/internal/retrospection/`](./docs/internal/retrospection/)（最新日期） |\n122\t| 接手 sprint task / 立新 entry | [`docs/internal/backlog.md`](./docs/internal/backlog.md)（当前 entry 全文；新 ID 先 grep 全部已用） |\n123\t\n124\t### Mockup 任务额外必读\n125\t\n126\t> 任何 AI 工具收到\"在 TVU 产品 Figma 文件画 UX mockup / 改 mockup / 抽组件入库\"类任务时，**除 L-core + 上表命中项外，下列 7-11 整链升 mandatory —— 各文件按其顶部 §🤖 AI 读取指引 scoped 读**（§Mockup Write Gate 的 4 步前置照旧）：\n127\t>\n128\t> ⚠️ **第 11 项不是「读一份文件」而是「跑一条命令」**（2026-08-14 加入）—— 因此上面那句「按 §🤖 AI 读取指引 scoped 读」对它不适用，它的执行方式与输出怎么读，见该项自己那段。\n129\t>\n130\t> ⚠️ **\"mandatory\" 修饰的是「这条链一份都不能跳」，不是「逐字全量吞」**（[[INFRA-F121]] ② 2026-08-13 统一）。此前本行写「整链升 mandatory **全读**」，与上方 §Mockup Write Gate 第 1 步逐字要求的「按文件顶 §🤖 AI 读取指引 scoped 读（…禁全量吞）」互斥，而两条指的是同一份 `mockup-conventions.md`、又都标 mandatory —— 实测两种读法差 **2.5 倍字节**。⇒ 以 scoped 读为准；某文件没有 §🤖 AI 读取指引块的，才全读。\n131\t>\n132\t> （**此 7-11 链 SoT = 本节**，是 mockup 任务的 scoped 强化清单，有意内联——**不属于 §必读链路开头所指的\"并行清单 drift\"**，无需归并到 STATUS。）\n133\t\n134\t7. **[`docs/internal/design-process.md`](./docs/internal/design-process.md)** — 通用 process 规则（**完整清单见该文件头 `rule-inventory` 块 = 唯一真源**，此处不再枚举）\n135\t8. **[`docs/internal/domain-tvu.md`](./docs/internal/domain-tvu.md)** — TVU 业务规则（**完整清单见该文件头 `rule-inventory` 块**）\n136\t9. **[`docs/internal/mockup-conventions.md`](./docs/internal/mockup-conventions.md)** — Path A 专属（Figma 真源 / 组件取数优先级 / 库归属验证 / M0 / M1 / M10）\n137\t + **[`docs/internal/figma-technical-reference.md`](./docs/internal/figma-technical-reference.md)**（Figma API quirks，实现时查）\n138\t10. **[`docs/internal/figma-component-catalog.md`](./docs/internal/figma-component-catalog.md)** — TVU 已发布库组件目录快速查（mockup 任务起手第一查，避免凭印象造组件）\n139\t11. **跑一次 `pnpm pattern:lookup <本次的 figma URL>`** — 查**本产品自己**已经做过哪些模块（owner 2026-08-14 拍定，走[提案](./docs/superpowers/specs/2026-08-13-product-pattern-index-proposal.md) §7 的 Q2 候选 (a)）\n140\t\n141\t> **第 10 与第 11 是两个不同的问题，⛔ 别合并**：第 10 问「**DS 库**有没有这个原子」（Button / Input / Table，跨产品）；\n142\t> 第 11 问「**这个产品自己**有没有做过这个模块」（设备状态卡 / 告警行 / 参数面板，产品专有、DS 不该收）。\n143\t> owner 的痛点逐字是「用了设计库组件、**没用当前产品已有的组件**」—— 那是第 11 条治的，第 10 条结构上看不见。\n144\t>\n145\t> **⛔⛔ 这一条最容易被用错的方式：把「查不到」读成「没有」。** 工具输出四态，**只有 `✅ covered` 那一态**\n146\t> 能得出「本产品已有 X」；`⬜`（还没采过）的正确结论是「**我查不到**」，⛔ **不是**「没有先例可复用」。\n147\t>\n148\t> **⇒ 命中 ⬜ 的正确动作是「当场采一次再查」，不是「跳过这一步继续画」**：\n149\t> `cd <主工作树> && node scripts/ds-health-scan-mockups.mjs --only `（一步，⛔ 不需要预先登记、\n150\t> 不需要审批；worktree 没有 `.env` ⇒ 必须从主工作树 cwd 跑）。采完重跑第 11 项即可。\n151\t> **⛔ 这里没有、也不该有「先申请纳入采集面」这类白名单** —— 原来的 `patternIndex: true` opt-in\n152\t> 已于 2026-08-14 拆除（owner 逐字：「为什么要把消费级产品一个个拉进来？我要做的是规则，不是实测」）。\n153\t> 任何产品文件都能就地采；已登记为 DIM-U12 测量目标的，全量跑 `pnpm health:mockups` 时顺带就刷新了。\n154\t> ⚠️ 唯一的例外是**采集实在跑不了时**（无 Figma 凭据 / 网络不通）：那时才「照常按本链其余步骤走」，\n155\t> 并在交付里如实写明「本产品 pattern 索引未采到」，⛔ 别写成「无先例可复用」。\n156\t>\n157\t> **为什么这一条是「跑命令」不是「读文档」**：提案 §7 逐字写着，能否定掉整个索引的唯一理由是\n158\t> 「没有任何机制保证有人在画之前查它」。只写一句必读，等于把成败押在每个人每次都记得上 ——\n159\t> 那正是本仓「规则别继续往 L1 prose 加」要治的病。**判据/数据真源与五态语义在\n160\t> [`scripts/pattern-index-lookup.mjs`](./scripts/pattern-index-lookup.mjs) 头注释，⛔ 别在本文件维护第二份。**\n161\t> ⚠️ 它是**查询不是闸**（always exit 0，不拦任何东西）—— 本条的 Enforcement 层级是 **L1**：\n162\t> **没有任何机制能发现「有人跳过了这一步」**。这是如实登记的事实，⛔ 不是待补的 TODO。\n163\t> **「为什么停在 L1 + 什么条件下才该升」的唯一真源** = [`scripts/pattern-index-lookup.mjs`](./scripts/pattern-index-lookup.mjs)\n164\t> 头注释里那个 📌 段（owner 2026-08-14 拍定）。⛔ **别顺手给它加个闸** —— 先读完那三条为什么；\n165\t> 尤其别走「新建组件与已有 pattern 相似度」那条，它是启发式，直接撞 `FIGMA_AS_SOURCE_OF_TRUTH.md` §验证方法。\n166\t\n167\t---\n168\t\n169\t## 硬规则（不可违背）\n170\t\n171\t| # | 规则 | Enforcement 层级 | 违反后果 |\n172\t|---|---|---|---|\n173\t| 1 | **不修改 Figma**——Figma 是设计师真源 | L4-partial：pre-commit 拦 figma-data/ sync-output 镜像写入；**Figma 端写操作本身无机制可拦（L1）** | 任何 Figma 写操作都是 bug |\n174\t| 2 | **不让 AI 按\"行业惯例\"自由发挥** | L1（AI 自律；登记缺失由 #5 的间接链兜底） | 必须读 translation/ 已登记决策；新决策必须先得到用户确认 |\n175\t| 3 | **不创建未登记的 prop / variant / 状态** | L2 间接：无 commit 时拦截，render-verification + published-vs-code 事后抓 drift | 例：Notification 的 `success` 曾是 code 自创 drift；2026-06-12 owner 在 Figma 正式补 `dialog`×`success` 并随发布登记 → 由 drift 转为合法（先 Figma 后 code，符 §\"Figma 库 master 变更→code 原子同步契约\"） |\n176\t| 4 | **颜色硬编码 = bug** | L5：`audit:no-hardcoded-design-tokens`（prepublishOnly + master-push CI） | 必须用 token；token 缺失就新建，不能写 hex |\n177\t| 5 | **任何 Figma↔Code 不一致必须先在 translation/ 登记** | L2 间接：`audit:translation-completeness`（L5）只验**已登记**条目；未登记漂移靠 render-drift-gate 事后抓 | 不登记的不一致 = 漂移 |\n178\t| 6 | **AI 工具从 Figma URL 生成代码必须用 `src/canonical/*` 作为 SoT，不用 `src/components/*`** | L1（DS 仓内）；consumer 侧 L4-partial（eslint `no-base-component-import`） | `src/components/*` 是实现/base 层，`src/canonical/*` 是 Figma-aligned 桥层（npm 经 `src/index.ts` 导出 canonical）。落 base/legacy → 输出 API 错位。详见 [`src/design-system/translation/divergences.md`](./src/design-system/translation/divergences.md) \"Code 端双源\" 段 |\n179\t| 7 | **代码改动必须走 feature 分支 + PR (non-Owner 约束)；Owner 任何改动均可直 commit master**（2026-05-28 broader Owner override 落地，原 docs-only 例外被升级）| L3 平台：Gitea 分支保护（non-Owner）+ Owner override 政策条款 | 见下方「Git 工作流（强制）」段。Owner 例外见 §\"Owner 直 commit master 权限（broader 2026-05-28）\" |\n180\t| 8 | **组件 demo 必演示 Slot + Boolean 属性（Vue playground + React pilot 双框架）**（owner 2026-07-03 拍板）| **L4**：pre-commit 条件 gate + blocking `audit:demo-slot-boolean`（INFRA-F45 shipped 2026-07-06；`scripts/audit-demo-slot-boolean-coverage.mjs` 从 `components.config.ts` 派生 in-scope=28，静态断言双侧 slot 投影 + boolean live 绑定；staged 命中 demo surface/config/audit 时触发）| 凡有 default/named slot 或 boolean prop 的组件，其 docs demo 必须在 **Vue 与 React 两侧**各演示（a）slot 投影真实内容、（b）至少一个 boolean prop 的 live 切换。理由：slot 投影与 boolean 属性是双框架 CE 最易 silent 破的两条链（实证 INFRA-F43 light-DOM slot 不投影恒空 body 数版本未被发现）。首个 exemplar = PopupBox；全量回填后每个 in-scope 组件双侧达标，audit gate 防回归。|\n181\t| 9 | **AI 不得编造 / 虚构工具输出**——随机标识符（commit hash / SHA / 时间戳 / exit code / 测试 passed 数）只能从工具原始输出逐字复制，不准生成 | L1（无机制可拦 AI 幻觉，唯靠纪律 + 用户终端核对） | ① commit hash / SHA / 时间戳 / exit code / passed 数 = 从原始 stdout 逐字复制，绝不自己生成；② 不可逆 / 外部可见操作（commit / push / publish / 删除）的结果以**原始工具输出**或用户终端核对为准，**不得用\"已成功 / 已一致 / 已通过\"概括代替原文**；③ 工具输出超时 / 被省略 / 截断 / 前后矛盾 / 可疑时 → **STOP 交用户在终端核**，不自行接管编造。**归因要准**：病根是 AI 编造，**不是**\"工具不返回\"——多数情况工具正常返回真实数据（2026-07-15 本 session 实证工具输出全真实可核）。真源 memory `no-fabrication-on-uncertain-tool-output` + `local-env-tool-quirks`。实证：上个 session（D2 Task 9 首次尝试）AI 伪造过不存在的 commit hash / push 成功 / 测试通过 / SHA 一致，逼用户起新 session 从真实基线重做 |\n182\t| 10 | **结论必须对\"活源\"验证，不凭摘要 / 镜像 / 记忆下判断**——判断仓库或远端的**当前状态**（某文件是否存在 / 内容为何 / prop-token 名 / 组件是否已同步 / 远端卡片长什么样）前，**必须直接读活源**：本地 `Read` / `grep` 实际文件；远端 DesignSync `get_file` 实际内容。**不得**拿派生镜像 / 摘要 / 记忆缓存 / 面板 UI 当依据下结论。 | L1（无机制可拦，唯靠纪律；由 #9 事后核对间接兜底） ⚠️ 2026-08-20 新增一个此前未登记的形态：**计划文件里的具体值（prop / 导出名）未对活源核** —— 已上机械闸 `pnpm audit:claim-vs-livesource`（pre-commit 条件触发 + pr-checks；INFRA-F133）。⚠️ **该闸对这个形态是 report-only（每次跑、每次印、不阻断）**：落地当天校准实测假阳性率 **86.7%（13/15，35 份指令型文档）**，按 spec §9 退档条件退档；阻断档只保留三条 fail-closed 基础设施判据（活源分母 / 扫描面 / 豁免表 shrink-only）。⚠️ **闸只覆盖这个形态的 prop 名那一半**：barrel 导出名虽然解析了，但只喂活源分母与覆盖面自印，**没有任何判据比对导出名断言**（词法上「导出名断言」与闸选宿主用的形态重合，全比一遍必然是噪声 —— 理由见闸脚本头注释，缺口登记在 backlog `INFRA-F133`）。⛔ 判据、档位与结构化区域定义的真源是[闸脚本头注释](./scripts/audit-claim-vs-livesource.mjs)，**别在本表维护第二份**。⇒ 仍靠纪律的是：**结构化区域里的断言（S2 只印不红）**、散文里的断言（S5 只印不红）、**导出名断言（不在覆盖面）**、对话里的口头结论、以及**文档断言 × 另一份文档的当前版本**（本闸只核代码活源）。 | 二手源会 drift，信了就\"读错\"：① 导出 bundle 的 `01–14` ≠ repo 真源——**改规则去 `docs/` / `docs/internal/`，别去 bundle 找**（[`PROJECT_MAP.md` §9](./docs/PROJECT_MAP.md)）；② 现有远端卡的 prop ≠ canonical——**照抄现有卡 = 复制 drift**，prop 名一律以 `src/canonical/*.vue` 为准；③ DesignSync 面板 `updatedAt` / 卡片对**非视觉写入不刷新**——别拿 UI 当同步凭据，写完逐文件 `get_file` 亲验（memory `designsync-nonvisual-writes-no-ui-bump`）；④ memory / handoff / 摘要文档是工具私有缓存或时点快照，规则演化后会过期，**只作导航，不作真源**（形态 ①④ 2026-08-20 已评估：无可靠词法解 —— 实测 71 处引用中 48 处报红且多数假阳性，\"当依据\"与\"当对象\"是语义区分 ⇒ 维持 L1，不上闸）。**病根 = \"AI 读错\"：信了会漂移的二手源。** 实证：Sync A 6 卡审计中 5 卡有 prop drift（Badge/Button 的 `tag`/`variant` → 应 `fill`、UserMenu `items[]` → 应 `actions[]` 等），正是历史上照抄现有卡、未回 `canonical` 活源验证的结果。
⚠️ **2026-08-11 补一个被漏掉的形态（PR #9 实证）：多分支协作下，你自己的本地工作树也是一种会过期的镜像。** 那次撞号的一方读的是**本地实际文件**（不是摘要、不是 memory、不是面板 UI —— 完全符合本条），只是那份文件已经 62 天没同步，于是把 master 上早已占用的规则编号又用了一遍。⇒ 判断**全局命名空间的当前状态**（规则编号 / backlog entry ID / token 名 / 已用过的 key）时，活源是 **`origin/master`**（先 `git fetch`），不是本地文件。已上机械闸：`pnpm audit:rule-number-collision`（pre-commit 条件触发 + `pr-checks.yml` 带 `--require-remote`）+ 分配器 `pnpm rule:next <系列>` / `pnpm new-backlog <前缀>`。⚠️ **2026-08-20 订正**：此处原写「该闸只覆盖三份规则真源的编号，**看不到 backlog entry ID**，那一条仍靠本纪律」—— 原 [[INFRA-F109]] 已落地，`docs/internal/backlog.md` 的 **entry ID 现已在覆盖面内**（含 `####` 层级、无 `F` 中缀、带连字符前缀、umbrella 范围标题四种形态；⛔ 覆盖面与仍看不到的三样，真源是[闸脚本头注释](./scripts/audit-rule-number-collision.mjs)，**别在本表维护第二份**）。⇒ 本条仍需靠纪律的只剩「**已删档号被重新占用**」（完成即删档 ⇒ 被删 ID 在 master 文本里已不存在，闸看不见）—— 取号一律走 `pnpm new-backlog`，它扫三份 SoT 全文、含历史提及 |\n183\t\n184\t> **Enforcement 层级图例**（对齐 [`meta-rules.md`](./docs/meta-rules.md) 触发器 K 的 L1→L5 谱系；列加于 2026-06-10 system-review P2-04）：**L1** = 文本规则靠 AI/人自律 · **L2** = 无直接拦截但有事后 audit 可抓 · **L3** = 平台/流程机制 · **L4** = 本地 pre-commit hook（可 `--no-verify` 绕过）· **L5** = prepublishOnly / CI strict gate。**各条规则强度本不相同**——没有这列时\"同等强\"是错觉；声称\"有 gate 兜底\"前先对照此列。\n185\t\n186\t---\n187\t\n188\t## Git 工作流（强制）\n189\t\n190\t`master` 受分支保护，**non-Owner 的任何代码改动必须走 PR**。AI 在本仓库工作时遵循以下决策树：\n191\t\n192\t> **⚠️ Owner 例外**：默认操作者 Owner（Nancy）**可直 commit master、不建分支**——见下方 §\"Owner 直 commit master 权限（broader 2026-05-28）\"（硬规则 #7 已编码）。本节决策树主要约束 non-Owner，及 Owner 在当前 session 明示\"走 PR / 建分支\"的情形。\n193\t\n194\t### 分支决策（non-Owner 贡献者适用）\n195\t\n196\t> **本仓实际默认 = Owner（Nancy）直 commit master、不建分支**（硬规则 #7，见下方 §Owner override）。下面仅约束 non-Owner 贡献者，或 Owner 在当前 session 明示\"走 PR / 建分支\"时。\n197\t\n198\t1. **在 master 起手** → `git checkout -b /`（type ∈ feat/fix/docs/chore/refactor/test）。\n199\t2. **已在 feature 分支** → **强默认复用同一分支**。边界按**主题**（非文件/组件）：同会话持续指令、无\"切任务\"信号 = 同主题，累积 commit 最后一个 PR。拆多分支/多 PR = 反模式（增 review 摩擦、破坏语义聚合）。\n200\t3. **只在三种情况换分支**：用户明说\"另一个任务/新分支\"、当前 PR 已合并（master 已含该分支）、主题完全跨域（最后一种先问 owner）。**不主动问\"是否换分支\"**。\n201\t\n202\t### Commit + Push\n203\t\n204\t- Commit message 用 Conventional Commits：`type(scope): description`（如 `feat(button): add loading state`）\n205\t- 一个分支可以多个 commit，PR 合并时会汇总\n206\t- Push 后把 Gitea 自动返回的 PR 创建链接给用户：\n207\t ```\n208\t https://product-demo.tvustream.com/gitea/ux-team/tvu-design-system/compare/master...<分支名>\n209\t ```\n210\t\n211\t### 并行 session 下的 git 纪律（本仓库常态：多 session 同时写）\n212\t\n213\t**本节是这两条纪律的唯一真源**（2026-08-04 从 `docs/STATUS.md` 顶部搬来——它们是规则不是状态）。\n214\t\n215\t1. **接手前先 `git status`；遇到 dirty / untracked 先判「隔夜遗留」还是「别人正在写」** —— 这两种情况的正确动作**相反**，而判据**不是**「dirty 就是别人的」，是 **mtime + `git log` 有无同任务 commit**。两次实证都在 2026-07-30/31 的多 session 并行里：起手时靠它判出 `UserMenu.vue` 正被并行写（mtime 与本 session 起手同分钟）从而没去碰；收尾时又靠它把一批「看着像隔夜残留」的 untracked 判成**正在进行**（mtime 在当下几分钟内），几分钟后那条线自己提交了。\n216\t2. **`git commit` 必须带内联显式路径**：`git commit -F -- …`（`-F` 在 `--` 之前），**且提交后紧跟 `git reset -- `**。不带 pathspec 会把别人 staged 的文件卷进自己的 commit；不 reset 则留下幻影 staged 状态、会被别人下一次裸 commit 提交掉。⚠️ 并行写同一仓库时 `.git/index.lock` 会让 commit 直接 `exit 128` —— **那不是故障、是对方正在提交**，等一下重来即可（改动完好留在工作树）。\n217\t\n218\t### 建 PR 时如何填模板（PR body）\n219\t\n220\t建 PR 时按 [`.gitea/PULL_REQUEST_TEMPLATE.md`](./.gitea/PULL_REQUEST_TEMPLATE.md) 逐段填正文，分两类纪律：\n221\t\n222\t**必须自动填好**（从 diff / 对话可推导，不让 Owner 自己猜）：\n223\t- **改动内容**：读本次 diff，逐条列出实际改了什么文件、什么行为\n224\t- **改动原因**：从对话上下文 / 关联需求写清楚，关联 Issue 写 `#编号`\n225\t- **改动类型**：按改动性质勾选（可多选）\n226\t- **备注**：reviewer 需知的点、后续 TODO、未执行项说明\n227\t\n228\t**禁止假填**（只能反映真实结果，否则误导 Owner review）：\n229\t- **测试情况 checkbox**：只勾**本次真实跑过并通过**的命令；没跑的留空，并在「备注」写明\"未执行：xxx\"。绝不能凭\"应该会过\"就打勾——Owner 见勾即视为已验证。\n230\t- **截图 / 录屏**：仅 UI 改动且**真实跑过 app / playground 截取**才贴；纯 docs / 逻辑改动写\"不涉及 UI\"。不得生成或捏造截图。\n231\t- **检查清单**：只勾确实核对过的项。\n232\t\n233\t**Why**：模板的价值是让 Owner 一眼判断该不该合。勾选若不可信 → 比留空更糟（制造虚假安全感）。AI 应把\"哪些已验证 / 哪些没验证\"如实写出，判断权留给 Owner。\n234\t\n235\t### 直 commit master 时：commit message 写结构化 body\n236\t\n237\t直 commit master 没有 PR 描述兜记录，**commit message 的 body 就是\"改了什么 + 测了什么\"的唯一载体**——按 [PR 模板](./.gitea/PULL_REQUEST_TEMPLATE.md) 字段精简对齐，让 `git log` / Gitea 提交页一眼可读，与同事走 PR 看到的信息一致、互不冲突。\n238\t\n239\t格式：\n240\t\n241\t```\n242\t(): <一句话 subject> # subject 仍遵循 Conventional Commits\n243\t\n244\t改动内容：\n245\t- <逐条列出实际改了什么文件 / 行为，从 diff 来>\n246\t改动类型：feat / fix / docs / refactor / chore …（可多类）\n247\t测试：<只写本次真实跑过的，如 pnpm test ✅ 219 passed；没跑的写\"未跑：lint/typecheck\">\n248\t```\n249\t\n250\t**纪律（与 PR 模板同源）**：\n251\t- 改动内容 / 类型从 diff 与对话自动填好，别让 Owner 自己猜。\n252\t- 测试只写**真实执行**的结果；没跑的如实标\"未跑：xxx\"，绝不能凭\"应该会过\"写 ✅——Owner 看 commit 即视为已验证。\n253\t- UI 改动有截图就把路径 / 链接放进 body；纯逻辑改动注明\"不涉及 UI\"。\n254\t\n255\t**Why**：同事 PR 的\"改动 + 测试\"在 PR 描述里，Owner 直 commit 的在 commit body 里，两条路径记录同一套字段、各自独立——Owner 在 PR 列表和 git log 里都能一眼看出改了什么、测没测，统一可见且不冲突。\n256\t\n257\t### 直 commit master 时：写 changeset（版本日志）\n258\t\n259\t走 PR 有 PR 模板兜结构化记录；**直 commit master（Owner override）没有 PR**，靠 changeset 留每个版本的改动记录。仓库已配 [Changesets](./.changeset/config.json)（`baseBranch: master`），`CHANGELOG.md` 由它按版本自动生成——这就是\"按版本知道改了什么\"的真源。\n260\t\n261\t**何时写**：本次 commit **影响 npm 发布产物 / consumer 行为**时——`src/**` 组件、API/props、`src/tokens/**`、导出（`index.ts`）、`eslint-plugin/**`、`templates/**`，以及 **`files[]` 白名单内那 20 个 `scripts/`**（不是整个 `scripts/`）等 consumer-facing 资产。\n262\t\n263\t> ⚠️ **本行 2026-08-13 随 [[INFRA-F117]] 落地订正**：原文写的是裸 `scripts/`，而当时 `files[]` 也确实是裸 `\"scripts\"`（107 个内部脚本全进包）。F117 把它收窄成具名白名单后，**`scripts/` 不再整体是 consumer-facing** —— 判据改为「该文件在不在 `package.json` 的 `files[]` 里」，`files[]` 是唯一真源，别在这里维护第二份清单（要看当前白名单跑 `npm pack --dry-run`）。改一个只在本仓库跑的 `scripts/audit-*.mjs` 属**不写** changeset 的内部改动。\n264\t\n265\t\n266\t\n267\t**何时不写**（写了反而污染版本日志）：纯 `docs/**`、`tests/**`、`playground/**`、`react-pilot/**`（owner 2026-08-12 明确补入 —— 它的 `src/demos/*.css` 是 docs 站两侧共用的 demo 样式，不进 `dist`）、`figma-sync/**`、CI / 内部重构等不改变发布产物的改动。\n268\t\n269\t**怎么写**：和实质改动放在**同一个 commit** 里，新增 `.changeset/.md`：\n270\t\n271\t```md\n272\t---\n273\t\"@ux-team/tvu-design-system\": patch\n274\t---\n275\t\n276\t<面向 consumer 的一句话：改了什么 + 影响。Breaking 要写迁移说明。>\n277\t```\n278\t\n279\t**bump 级别（= 改动类型）**：\n280\t- `major` — 破坏性改动（API / prop 重命名或删除、行为不兼容）\n281\t- `minor` — 新功能 / 新组件 / 新 prop（向后兼容）\n282\t- `patch` — bug 修复 / 视觉对齐 / 小调整\n283\t\n284\t**纪律**：bump 级别和描述据实写，不夸大不缩小——`changeset version` 据此 bump 版本号并汇总进 CHANGELOG，Owner 与 consumer 都按它判断升级影响。发布时 `pnpm changeset:version` 汇总、`pnpm changeset:status` 查待发布项。\n285\t\n286\t### docs 站内部 demo / 页面样式改动的快车道（owner 2026-08-12 裁定）\n287\t\n288\t**适用面（严格 AND）**：本次改动集 ⊆ `playground/**` + `react-pilot/**` + `docs/**` + `tests/**`，**且不碰 `src/**`** ⇒ 不进 npm 产物、consumer 不可见。典型 = docs 站 demo CSS、页面布局、响应式断点、**闸的判据（指 `tests/**` 里的断言，⛔ 不含 `scripts/` 下的闸脚本本身）**。\n289\t\n290\t> ⚠️ **「闸的判据」四字的限定是 owner 2026-08-13 补的**（[[INFRA-F128]] 系列评估发现互斥）：原文只写「闸的判据」，而闸脚本住在 `scripts/`，于是它把 `scripts/` 隐含划进了快车道面 —— 但同段的「严格 AND」谓词**根本不含 `scripts/`**（只有 `playground`/`react-pilot`/`docs`/`tests`）。owner 确认原意是 **`tests/`**（2026-08-12 那批快车道改动实际动的就是 `tests/docs-overflow/*.spec.ts` 的 `VIEWPORTS` 与判据，且它满足谓词）。⇒ **改 `scripts/` 下的闸脚本不走快车道**（谓词不含它）；**changeset 则仍按上一节 §「何时写」的 `files[]` 判据判 —— 不在 `files[]` 白名单里的内部 `audit-*.mjs` 属「不写」。**\n291\t>\n292\t> > 🔴 **2026-08-13 晚就地订正本段自己的一处 stale 转述（登记为原 INFRA-F124 ④ —— **该 entry 2026-08-14 四个子项全部落地后已删档**，判据留痕在 tracker §待核可关）**：上面原写「上一节 §「何时写」又把 `scripts/` 列为 consumer-facing **必写**，三方互斥」并据此推出「⇒ …**照常写 changeset**」—— **那句描述的是 [[INFRA-F117]] 落地前的措辞**。同一天的 §「何时写」（见上一节）已把判据订正为「该文件在不在 `package.json` 的 `files[]` 里，**`files[]` 是唯一真源**」，并逐字点名「改一个只在本仓库跑的 `scripts/audit-*.mjs` 属**不写** changeset 的内部改动」。⇒ 这**不是两条对等规则打架**，是本段的前提 stale ⇒ 它推出的那半句结论失效（互斥也从「三方」降为「两方」，第三方已自行消失）。**owner 的裁定实质一个字没动** —— 快车道谓词仍不含 `scripts/`；变的只是 changeset 那一半，从「照常写」改为回指 `files[]` 判据。⚠️ 这条留痕本身是「**同一份文件内部**的规则真源冲突」的实例，与 原 INFRA-F124 的三项（跨文件冲突）同类不同形态。\n293\t\n294\t**立规缘由**：这类改动的产品体量很小（常是几行 CSS），但此前按满配纪律走 —— 逐文件问视觉批准 + 为每条缺陷配新闸 + 故障注入证明 + STATUS/CHANGELOG/backlog/tracker 四处同步 —— 仪式成本是改动本身的数倍。owner 2026-08-12 拍板给三条豁免：\n295\t\n296\t1. **免 changeset** —— 见上一节「何时不写」（本裁定把 `react-pilot/**` 补进那张清单）。\n297\t2. **视觉批准合批** —— `VISUAL_COMMIT_APPROVED` 一次批准覆盖**同一批**（同 session 内连续、owner 已看过效果的那一组）视觉改动，不必逐文件 / 逐 commit 各问一次。⚠️ **AI 仍然不自设这个变量**：合批只减少「问几次」，不改变「必须由 owner 说出口」。\n298\t3. **免为它新建闸 / 免故障注入证明 / 免四处文档同步** —— 只更新 backlog 对应 entry（真源）+ STATUS 一行；不写复盘文档、不为单条缺陷新建 audit 脚本。\n299\t\n300\t⚠️ **「免机械闸」我按最窄读法执行，owner 可推翻**：读成「免**新建**闸」，**现成的 `audit:docs-overflow` / `audit:layout-tokens` / `vue-tsc` / `pnpm test` 仍然跑**。三条理由：① 前两条恰好是自动发现「内容被裁且够不着」的唯一手段，而 [[INFRA-F112]] 正是从 `docs-overflow` 的判据漏洞逃掉的 —— 关掉它等于把发现同类缺陷的能力一起关掉 ② 成本不在这里：四条合计 ~7min 且无人值守，同一条修复里真正吃时间的是重写判据、故障注入、四处文档 ③ 它们是**已存在**的闸，跑一次的边际成本近零。**重开条件**：owner 明说「连现成的也别跑」，或实测这几条闸的耗时占到一次 docs 修复总时长的 1/3 以上。\n301\t\n302\t### 禁止 AI 做的事\n303\t\n304\t- ❌ 不要自己点合并（PR 必须由人审批后合并）\n305\t- ❌ **non-Owner** 不要试图 push 到 master（会被分支保护拒绝）；**Owner 直 commit master 是默认**，见 §\"Owner 直 commit master 权限（broader 2026-05-28）\"\n306\t- ❌ 不要为同一个逻辑改动拆多个分支\n307\t- ❌ 不要在没确认主题完成的情况下擅自切回 master\n308\t\n309\t### Owner 直 commit master 权限（broader 2026-05-28）\n310\t\n311\t**2026-05-28 Owner override 升级**：原 docs-only 例外扩到 **任何改动**（含 code / config / schema / scripts / SoT 等）。Owner Nancy 默认 commit 到 master，**不建 feature 分支**，除非用户在当前 session 明示\"开分支\"。\n312\t\n313\t**触发条件（严格 AND）**：\n314\t1. 当前 session 操作者 = Owner (默认 Nancy；见 §\"仓库身份\")\n315\t2. Owner 未在当前 session 明示\"建分支\" / \"走 PR\" / \"feature branch\" 等措辞\n316\t\n317\t**AI 决策树**（在仓库 cwd 改任何文件时）：\n318\t\n319\t```\n320\t当前 session 是 Owner 操作？\n321\t └─ YES → Owner 明示要建分支 / PR？\n322\t └─ YES → 走 §\"Git 工作流（强制）\" feature branch\n323\t └─ NO → 当前在 master：直 commit；当前在 feature：问 Owner \"本次并入当前分支还是切 master 直 commit？\"\n324\t └─ NO → 走常规 feature branch + PR 流程\n325\t```\n326\t\n327\t**Why**：\n328\t- 单人 owner 项目 + AI plan-owner/executor 代理模式下，feature branch 仅是仪式 (no second reviewer except Owner themselves)\n329\t- Owner 已对每个 commit 实质 review (plan owner 审 executor diff + Owner ack)\n330\t- 分支保护可为 Owner 设豁免规则 (Gitea 支持)；未设豁免时 Owner 用管理员权限绕过\n331\t- 减少 branch / PR / merge 切换 cycle 摩擦\n332\t\n333\t**反例（仍走 feature branch）**：\n334\t- 非 Owner 用户改任何文件 → 常规流程保留 review trail\n335\t- Owner 明示\"这个开分支跑\" / \"走 PR\" → 按 Owner 指令开分支\n336\t- AI 在 Owner 没明示授权直 commit 时... 实际不存在此 case（Owner override 是 default，AI 不需要明示授权也直 commit）\n337\t\n338\t**实证**：2026-05-28 BRIDGE-MOCKUP-008 Phase C session — Codex 按旧 docs-only 例外建 `chore/bridge-mockup-008-phase-c-merge` 分支，Owner 反问 \"为什么它会弄到分支里面？没道理不知道提交到 master\"。本条款升级。\n339\t\n340\t### Docs-only 改动：见上方 broader Owner override（legacy 2026-05-26，已被涵盖）\n341\t\n342\t**本节原 docs-only 例外（2026-05-26 立）已被上方 §\"Owner 直 commit master 权限（broader 2026-05-28）\" 完全涵盖**——docs-only 只是\"任何改动\"的子集，规则一律以 §276 broader override 为准，本节不再单独维护触发条件 / 决策树（避免两处改一处忘的 drift）。\n343\t\n344\t**实证（保留）**：2026-05-26 TPC bulk import session，Owner 改 mockup-conventions.md M23 stroke 3→4px 时被 AI 建议走 feature 分支，多绕一层；催生原 docs-only 例外，2026-05-28 被 broader override 吸收。\n345\t\n346\t---\n347\t\n348\t## 元规则：真源单一 + 双层导入（不绑工具 / 不绑模型）\n349\t\n350\t> 本元规则适用于**任何 AI 工具**（Claude Code / Codex / Cursor / Cline / Copilot / 其它）、**任何角色**（plan owner / executor / reviewer）。\n351\t> 角色与工具的绑定可变化——当前 Claude Code = plan owner、Codex = executor，但可互换或被替代——**本规则不变**。\n352\t\n353\t详细规则、反模式清单、角色互换条款、Audit/数据产出类 prompt 子规则，统一登记在：\n354\t\n355\t→ **[`docs/meta-rules.md`](./docs/meta-rules.md)**（元规则真源）\n356\t\n357\t任何角色在写 prompt / 设计机制 / 推荐方案前，**必须先过 meta-rules.md 的反模式清单**。命中任一条 → 停下重新设计。\n358\t\n359\t---\n360\t\n361\t## 工作流（约定）\n362\t\n363\t> **角色驱动，工具可换。** 本段使用角色名（`plan owner` / `executor`）而非工具名。\n364\t> **本仓实际默认（2026-07-17 对齐实际）**：solo DS 工作 = **Claude Code 同时任 plan owner + executor（直做 + 自动 subagent/Workflow 并行）**——不走 file-based 往返委派。下面的\"标准闭环 / executor STOP / file-based prompt\"是**委派协议**，仅在 **① 多工具协作（另一 AI 当 executor）或 ② 同事委派 / 大型可并行任务** 时启用。（owner 2026-07-16 确立\"默认自主 + 自动多 Agent 并行\"实践，详见 §标准闭环 头注。）\n365\t> **委派时的默认绑定**：`plan owner = Claude Code`、`executor = Codex`。\n366\t> **切换方式**：用户在对话里说\"把 `<角色>` 换成 ``\"，新工具读 `AGENTS.md` + `docs/meta-rules.md` 即可承担该角色。\n367\t> **切换不需要改本文件 / `meta-rules.md` / 任何 prompt 模板**——它们都是角色无关的。如果发现哪条规则绑了具体工具名，应该改成角色名（违反 meta-rules 反模式 #1）。\n368\t\n369\t### 角色定义\n370\t\n371\t| 角色 | 职责 |\n372\t|---|---|\n373\t| **plan owner** | 写 plan / 设计 prompt / 审 executor 的 diff / 复审是否进入下一阶段 |\n374\t| **executor** | 按 plan owner 写的 prompt 严格执行任务 / 跑脚本 / 报告改动与未解决项 |\n375\t| **reviewer** | 用户最终拍板（部分情况下 plan owner 兼任审计） |\n376\t\n377\t> 上表是默认骨架。**具体职责按下面 task-type 矩阵微调**——不是 one-size-fits-all。\n378\t\n379\t### Task-type 分工矩阵（mandatory，prompt §Mode 头段必声明）\n380\t\n381\t> 实证来源：P15.1 / P15.2 / P15.2-extend / P16 discovery 四次实跑。Plan owner 凭记忆喂 baseline 数字 = bug 源（P15 §0 算错 38 → reroute / pickup §3 \"~48\" 歧义被 Codex 抓出）；executor 在 apply 阶段额外 verify spec = 冗余 round trip。\n382\t>\n383\t> **每个 prompt 必须在 §Mode 段明示 task type**（如 `Mode: Discovery only` / `Mode: Apply deterministic spec` / `Mode: Design options + STOP`）。executor 按对应行执行，plan owner 按对应行 review。\n384\t\n385\t| 任务类型 | Baseline 数字 | 决策 / 分类 | 设计选项 | 代码改动 | 典型实证 |\n386\t|---|---|---|---|---|---|\n387\t| **Discovery / 调研** | Executor grep 实证 | Executor 按 plan owner 写的机械规则分类 | Executor 列偏差 + STOP | ❌ 不动 | P15.1 / P16 discovery |\n388\t| **Apply / 实施**（spec 已定） | Plan owner 写死 | Plan owner 已拍板 | ❌ 不发挥 | Executor 按 spec 改 | P15.2 / P15.2-extend |\n389\t| **Design / 设计选项**（多解） | Plan owner 给约束 | — | Executor 列 2-3 选项 + 推荐默认 + STOP | ❌ 不动 | P16b verifier topology |\n390\t| **Refactor / API 改造** | Plan owner 实证（写死）| Plan owner 拍板 API 形态 | Plan owner 拍板 | Executor 按 API spec 改 + 跑 vitest | Phase 6.6 dual-form / Phase 6.8 Button canonical |\n391\t| **Infrastructure / 工具**（小 CLI / hook）| — | Plan owner 拍板 spec | Plan owner | **Plan owner 可 direct**（path B）| Tier 2-D/E/F / new-backlog.mjs |\n392\t| **Audit / 数据扫描产出** | Executor grep | Executor 按 plan owner schema 输出 | — | ❌ 不动 | future audit-mockup-conformance discovery |\n393\t\n394\t### 跨 task-type 不变约束（所有类型都必须遵守）\n395\t\n396\t1. **Executor 永不 commit / push** — prompt 不得含 commit/push 指令，executor verify 后只报 diff + stdout，由 plan owner + 用户 ack 后才 commit\n397\t2. **Plan owner 必独立 verify executor 报告**——按 task type 差异化（见下）：\n398\t - Discovery 类：sample 1-2 cluster 重 grep 验分类；不能只 verify 数字加总\n399\t - Apply 类：diff 全审 + git status / git diff --stat 独立 check\n400\t - Design 类：每个 option 独立查可行性，不 rubber-stamp executor 推荐\n401\t3. **Plan owner 不直接动 source code / tokens / JSON 数据 / component**——例外仅 Infrastructure 类小工具 + 协作文档 + prompt 文件 + 审计报告 + 复盘文档\n402\t4. **决定哪类 task type** 由 plan owner 在 prompt §Mode 段明示；executor 起手第一步是 confirm task type，与 prompt §Mode 不符必 STOP 反馈\n403\t\n404\t### 标准闭环（委派协议 — plan owner ≠ executor 时按顺序）\n405\t\n406\t> **适用范围**：下面 7 步是 **plan owner 与 executor 分属不同工具/人** 时的委派协议。**本仓 solo DS 工作（Claude 直做）默认不走此环**——坍缩为：`Claude 实现（+subagent/Workflow 并行）→ 自 verify 拿真实 gate stdout → owner ack → commit`（不可逆操作前的 owner ack 与自 verify 是保留的核心闸，见跨 task-type 不变约束 #1/#2）。\n407\t\n408\t1. plan owner 读项目规则 + audit\n409\t2. plan owner 生成 `docs/internal/_prompts/.prompt.md`\n410\t3. 用户把 prompt 交给 executor\n411\t4. executor 按 prompt 改代码 / 产出文件\n412\t5. executor STOP，列出改动和未验证项\n413\t6. plan owner 复审 executor diff\n414\t7. 用户决定是否进入下一阶段\n415\t\n416\t### 单一决策源模式（当前默认）\n417\t\n418\t为避免 plan owner 与 executor 在对话中互相\"补充框架\"、反复扩展路线，后续协作默认采用以下边界：\n419\t\n420\t- **plan owner 负责产出一版路线图 / prompt**，并把结构性决策固化到仓库文档\n421\t- **executor 不做\"加料式评论\"**：不在 plan owner 路线图基础上继续发明新轨道、新阶段或新框架\n422\t- **executor 只做三件事**：\n423\t 1. 检查 prompt 是否有明显 blocker（会误删 / 误 commit / 改 Figma / 范围不可验证 / 与仓库规则冲突）\n424\t 2. 执行 prompt 指定任务\n425\t 3. 报告改动、验证结果、未解决项\n426\t- 如果 executor 不同意 prompt，只指出**会导致失败的 blocker**，不扩展替代路线\n427\t- 一旦 `docs/internal/long-term-plan-v2-*.md` 或同等路线图落仓库并经用户确认，本阶段以该文档为准；不要在对话里反复发明新框架\n428\t\n429\t### executor 角色行为约束\n430\t\n431\t- 用户通过 file-based prompt 触发任务：`请按 docs/internal/_prompts/.prompt.md 执行`\n432\t- **起手第一步：confirm prompt §Mode 段声明的 task type**，按 task-type 矩阵对应行执行；prompt 缺 §Mode 段 → STOP 反馈让 plan owner 补\n433\t- 每个 prompt 末尾会有 \"完成后 STOP，等用户审\"——**严格遵守 STOP**，不要自行进入下一步\n434\t- 关键参数（如 token 值、变体枚举）**先列出来给用户确认**，不要自行决定\n435\t- 在单一决策源模式下，执行前只做 blocker 检查；无 blocker 就执行，不再提出额外路线规划\n436\t- **不\"加料式评论\"、不发明新轨道 / 阶段 / 框架**——只做三件事：① 检查 prompt 有无明显 blocker ② 执行 prompt 任务 ③ 报告改动、验证结果、未解决项\n437\t- **永不自行 commit / push**（见跨 task-type 不变约束 #1）\n438\t\n439\t### plan owner 角色行为约束\n440\t\n441\t- 直接读项目文件审 executor 产出\n442\t- 设计 prompt 前**强制过 `docs/meta-rules.md` 反模式清单**——命中任一条 → 重新设计，不 fire\n443\t- **每个 prompt §Mode 段必明示 task type**（Discovery / Apply / Design / Refactor / Infrastructure / Audit）——见 task-type 矩阵\n444\t- **Discovery / Audit 类 prompt 不写死 baseline 数字**——让 executor grep 实证；plan owner 凭记忆喂数字 = bug 源（P15 §0 算错 38 实证）\n445\t- **Apply 类 prompt 必写死 spec**（token 名 / CSS 行 / API 形态）——不让 executor 重复 verify\n446\t- 任何重大决策（破坏性 API 改造、跨阶段路径选择）必须 propose 给用户拍板\n447\t- 默认**不直接修改代码 / 脚本 / tokens / JSON 数据 / 组件文件**——涉及这些改动时，应先生成 executor prompt，除非用户明确授权（Infrastructure 类小工具 path B 例外）\n448\t- 可以直接修改协作规则文档、prompt 文件、审计报告和复盘文档；完成后必须 STOP，等用户确认\n449\t- **审 executor 产出必独立 verify**——Discovery 类 sample 1-2 重 grep 验分类（不只 verify 数字加总）；Apply 类全 diff 审 + git status 实证；Design 类每 option 独立查可行性\n450\t\n451\t### 共同规则\n452\t\n453\t- 决策必须固化到文档（不能只在对话里口头提）\n454\t- 阶段完成后追加复盘到 `docs/internal/retrospection/{date}.md`"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"05e0392f-9f97-4d69-9349-da68c860001a","timestamp":"2026-08-25T10:16:12.694Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/AGENTS.md","content":"# AI Agents 必读（跨 AI 工具通用）\n\n> 本文件适用于：Codex / Claude Code / Cursor / Cline / GitHub Copilot / 任何在本仓库工作的 AI 工具。\n\n---\n\n## 仓库身份（Owner / 默认作者）\n\n- **Owner**：Nancy ``\n- **默认 UX 交付说明作者**：Nancy（任何 M23 规则卡 / annotation footer 的 \"Author / 作者\" 字段默认填 Nancy，不要写通用 \"UX\" 角色名）\n- **AI 工作时的身份约定**：AI 是 Nancy 的 plan-owner / executor 代理，**不是独立角色**。所有 AI 写出的 commit / PR / annotation 都视为 Nancy 的署名工作\n\n任何 AI 在生成 attribution（commit author / annotation author / handoff doc 作者行 / Jira reporter 等）时**默认填 Nancy**，除非用户在当前 session 明确指定其他人。\n\n---\n\n## ⛔ Mockup Write Gate（TVU 产品 Figma 写操作 mandatory）— 2026-05-27 新增\n\n任何 AI 工具（不限 Claude Code）在对 **TVU 产品 Figma 文件** 做写操作前——包括但不限于：加 mockup / 改 mockup / 加 UX 交付说明 / 加 jira 组件 / 加注释 / 加 page / 加 tooltip / 调样式——**必须**先完成 4 步：\n\n1. **Read [`docs/internal/mockup-conventions.md`](./docs/internal/mockup-conventions.md) — 按文件顶 §🤖 AI 读取指引 scoped 读**（起手必读段 + 触发 jump，禁全量吞；**读哪几条由该文件顶部的 §🤖 AI 读取指引 jump 表按你的任务派**，⛔ 这里不再抄一份「重点规则」清单 —— 抄一份就是一处会漂的副本，2026-08-14 扩 `audit:rule-inventory` 分母时实测这里抄的那份里，有一个 id **活源根本不存在**）\n2. **Read [`docs/internal/design-process.md`](./docs/internal/design-process.md) § Pre-Phase 0（含 § No Open Questions in Deliverables）+ § Stage 0.5 + § Scope Handling + § Delivery Cleanup Gate**（Stage 0.5 含字段长度分布声明，M43 UX-side 镜像；§No Open Questions = 触发器 P 落地：起手扫齐 open questions + 交付物零未决项，禁止贴 Figma）\n3. **Read [`docs/internal/figma-component-catalog.md`](./docs/internal/figma-component-catalog.md) 标题列表**（lazy reference，具体 entry 按需 grep）\n4. **从 [`docs/site-review-manifest.json`](./docs/site-review-manifest.json) 拿 library fileKey**（不要靠扫产品文件 instance 反推）\n\n**⛔ 写操作全程走 §M-LIFECYCLE 三时点闸**（[`mockup-conventions.md` §M-LIFECYCLE](./docs/internal/mockup-conventions.md)）——任何 create / update / delete：\n- **操作前**：create/move 先 probe 目标区防叠加(§I6) · update 先 live 重读做最小 delta(§I5) · delete 先确认目标 + 处理指向它的 connector(§I5/§M23.6)\n- **操作后（每批次，不拖到末尾）**：跑 `pnpm audit:mockup-conformance --file --node <一个 nodeId>`（规则清单 + 条数真源 = **跑一次 `pnpm audit:mockup-conformance --list-rules`**，⛔ 别在这写死条数、也别指某个会搬家的代码位置 —— 2026-08-24 合并后它已从 `AUDITS` 数组挪进 `scripts/mockup-rules/index.mjs`）+ `use_figma` connector centerline probe；违例当场修\n- **走查时**：design-walkthrough 三轴全跑、机械维度贴机检 pass/fail、机检覆盖面 = 全 session 触碰节点 —— ⚠️ **`--node` 只吃一个 id**，覆盖多节点 = 逐节点跑或整文件跑（**用法真源 = [`scripts/audit-mockup-conformance.mjs`](./scripts/audit-mockup-conformance.mjs) 头注释**，本文件不复述）\n\n**触发判定（命中任一即触发）**：\n- 用户给了 Figma URL + 任一动词：\"加 / 改 / 调 / 更新 / 同步 / 推 / 画 / 设计\"\n- 用户说\"加 UX 交付说明 / UX notes / 加 jira 组件 / 走查 / 角色测试 / persona / journey map\"\n- 用户说\"基于昨天的页面修改\" / \"在上一期 mockup 上加 X\" / \"clone 这个 page 改 Y\" → 额外触发 M46 (Library Instance Iteration Discipline)\n- fileKey 命中 TVU 产品文件（典型如 TPC-20220519 `xu7H3ppLyQfa3fOmU8M7iO` / Micro-Apps-20250923 等；非 library 文件均按 TVU 产品文件处理）\n\n**严禁**：\n- 用 claude.ai 通用 `figma-use` / `figma-generate-design` skill 替代 TVU 专属硬规则（M23 等会被整段跳过）\n- 用 memory cache 替代 mockup-conventions.md 真源（memory 是工具私有缓存，规则演化 memory 会过期）\n- \"起手只读 STATUS.md，mockup 规则现场拍\" → mockup 写操作硬规则前置，不允许现场拍\n- 起手用 createFrame 自画 overlay 覆盖既有库 instance → 违 M46 (Library Instance Iteration Discipline)；正路是先 probe instance 可改性\n- M23 UX 交付卡里塞 regex / pseudocode / 长代码块 → 违 M23.10 (Audience-Aware Language)\n- 把 Persona / out-of-scope 声明 / 未来 roadmap 这类 tangential 内容塞进 UX 卡 → 违 M23.11 (Scope Discipline)\n- \"本期不动 R list\" 误读成 \"hide R list\" → 违 design-process.md § Scope Handling\n- Session 收尾前不走 cleanup → 留下被 supersede 的临时 spec / overlay / code 卡 → 违 design-process.md § Delivery Cleanup Gate\n- 调列宽 / 改 cell 内容后只截整表缩略图自检 → 违 M43.2 (Column Width Self-Audit)，必须 zoom-in 每列\n\n**违反信号 → 上一段输出不合格，重做**：\n- UX 交付说明卡用了 cream / 浅底 / 单语 / 非 navy `#2B2D42` → M23 违例\n- 表格新增字段没在 mockup 里给 3 状态（正常 / 截断 / hover tooltip） → M43 违例\n- 自画 RECTANGLE+TEXT 拼 tooltip / button / 注释卡 → M32 Library-First 违例\n- 装饰元素 / NEW badge 浮在 page 层不在 mockup frame 内 → M-INTEGRITY §I4 违例\n- 改了 text 节点 fontName 但没保留 textStyleId → M47 违例（cell 渲染会变灰 / 错位）\n\n**实证**：\n- 2026-05-27 FB-9398（TPC-Service 消费端）：AI 起手只加载 claude.ai 通用 `figma-use` skill，跳过 mockup-conventions.md → UX 交付说明卡用 cream 浅底自由设计 + 单语 → 用户连续两次抓\"没用 TVU 设计系统已有规则\"\n- 2026-05-28 TPC-628（TPC-Service 消费端）：AI 起手 clone FB-9398 后误判 instance 不可改 → 跳到自画 overlay；又把 NEW badge 放 page 层；font fallback 时丢 textStyleId 让 cell 变灰；列宽 rebudget 砍了 Operation 列但没 zoom-in 验证 Edit/Delete/Status 三按钮溢出；收尾时留下 spec 帧 / Display Logic 代码卡 / Persona 卡等冗余 → 用户连续抓 7 次。本次回流加 M46 / M47 / M-INTEGRITY §I4 / M23.10 / M23.11 / M43.2 / Scope Handling / Delivery Cleanup Gate 等规则。\n\n---\n\n## ⛔ Onboarding Gate（第一个项目相关回答前 mandatory）\n\n**任何 AI 在第一个项目相关任务 / 推荐 / 回答前，必须先完成 [`docs/STATUS.md` §起手必读链路](./docs/STATUS.md#起手必读链路) 的两层 onboarding**（该节是链路唯一 SoT，本文件不重复维护清单 — 2026-06-10 P1-07/P1-08 重构）：\n\n- **L-core 全文必读（4 份，禁 grep / 跳读）**：FIGMA_AS_SOURCE_OF_TRUTH → STATUS → PROJECT_GOAL → 当前 pickup。⚠️ **体量 / 耗时预算的唯一真源 = STATUS §起手必读链路**，本文件刻意不复述那个数字 —— 那四份自己每工作日都在涨，复述一份就是又一处会漂的副本（原 INFRA-F95 已付代价 4：两处都写「~40KB」而实测 2.2× —— **该 entry 2026-08-13 已闭合删档**，这条实证的留痕在 `STATUS-CHANGELOG` 与 `audit-doc-shape.mjs` 头注释）\n- **L-ref 最小集必读 + 命中触发深读**：本文件 §硬规则表 + §Onboarding Gate 是每 session 最小集；tracker §排期原则 / backlog 当前 entry 全文 / meta-rules / working-principles / translation/ 按触发表升级 —— 触发表见 STATUS §L-ref\n- **Mockup 任务**：§Mockup Write Gate 4 步前置 + §必读链路 7-11 整链升 mandatory（不受分层影响，仍是硬规则）\n- **唯一减档 = 微改档**（单文件 · 纯文案 · 不换组件不改 token）：判据 / 必读集 / 自动升级条件的**唯一 SoT = [`STATUS.md` §微改档](./docs/STATUS.md#微改档单文件纯文案的减档)**，本文件刻意不复述（owner 2026-08-13 裁定新增；复述一份就是第二处会漂的副本 — [[INFRA-F121]] 已付过这个代价）。⚠️ 上一条 L-core「4 份」在微改档下减为 **#0 + 本文件 §硬规则表**；mockup 写操作**不适用**本减档\n\n**机械执行**：用 TodoWrite / TaskList / 等价机制为 L-core 每项 + 命中的 L-ref 项各建 1 个 todo，逐个 Read 完才能开始回答。**基于 partial L-core 给推荐 = 协议违反**。\n\n**违反信号（分层版）+ 历史实证**：见 [`STATUS.md` §起手必读链路](./docs/STATUS.md#起手必读链路)（该节是链路唯一 SoT，含完整违反信号分层 + 2026-05-13/2026-06-10 P1-08 实证）——本节不再内联镜像，避免两处各改一处忘的 drift（DUP-01；此前 AGENTS 版已漏掉 STATUS 版的 P1-08 教训）。\n\n---\n\n## AI 响应格式规则（决策点 / 推荐型回答 mandatory）\n\nAI 在面对决策点 / 给用户多选项 / 推荐方案时，响应**必须包含 4 块**（缺一不合格）：\n\n1. **总计划 / 总数字**：当前剩余多少问题 / 总任务清单（含已完成 + 待办）\n2. **本次范围**：本轮做了什么 / 影响多少数字\n3. **明确推荐**：选哪个，不要\"A 或 B 都可以\"模糊话；候选 ≥ 2 个时必须排序 + 标默认\n4. **推荐理由**：3 条以内核心理由\n\n**违反信号**（命中任一 → 上一条响应不合格，重写）：\n- 用户问\"推荐哪个\" / \"还剩多少\" / \"总计划呢\" → 重写\n- 用户说\"我自己决定\" / \"你决定\" → 默认仍要给推荐；\"我没意见\"不算合规\n- 列了多选项但没排序 / 没标默认 → 重写\n\n**历史实证**：2026-05-20 session 用户多次因为这 4 块缺失追问 / 重发问题（典型：\"你没告诉我剩下还有多少问题？你推荐解决哪个？为什么\"）。\n\n**规则分层（DUP-05 — 出推荐时三条协同、非重复）**：本节 = **输出契约**（响应长什么样）。配套两条在 [`meta-rules.md`](./docs/meta-rules.md)：**触发器 F**（出推荐**前**的推荐自审 4 问：理由经得起反驳吗 / 有没有把最省事项包装成 #1 / 有没有更稳健选项被压脚注 / 该我拍还是 owner 拍）；**触发器 E**（决策疲劳态下\"只给一个推荐拍 Yes/No\"的 mode override——与本节\"候选 ≥2 排序标默认\"不冲突：E 管疲劳态、本节管常态多选）。三者 = 自审→输出→疲劳降级 的分层，不是三份重复规则。\n\n---\n\n## 项目一句话\n\n把 **Figma 已发布 Library**（组件 / Token / 图标 / Styles）做成 **AI 与开发可消费的双向 Figma↔Code 桥**。\n\n> **5 个能力的完整定义 + 各能力前置约束（T3/T4 schema 设计要点）+ 能力 3 的边界分层，真源 =\n> [`docs/PROJECT_GOAL.md`](./docs/PROJECT_GOAL.md) §一句话目标**。能力**成熟度 / 当前状态** →\n> [`docs/STATUS.md`](./docs/STATUS.md) §能力 × 成熟度表。\n>\n> 2026-08-03 本节从全量镜像收成一句 + 指针（[[INFRA-F58]] D1）。原先这里复述了 5 条能力**并夹带\n> 会变的数字与 key**（`render-verification-manifest 936 条` / `YbsPRUVmNdsbN40NNwh1Gn` / \"待 Pro plan\"），\n> 那是三份现状真源的第四份副本 —— manifest 条数与 plan 状态都在别处随时会动。\n\n---\n\n## 必读链路\n\n> **Onboarding 链路唯一 SoT = [`docs/STATUS.md` §起手必读链路](./docs/STATUS.md#起手必读链路)**（L-core 全读 + L-ref 按触发深读）。本节不再维护并行清单（2026-06-10 P1-07 双链路 drift 治理），只登记 **L-ref 的任务触发表** —— 命中触发即把对应真源升为该任务的 mandatory 深读：\n\n| 触发（做什么） | 深读真源 |\n|---|---|\n| 排期 / 版本决策（\"v0.X 含哪些 / 先做哪个 / 该不该上 Tier N\"） | [`tracker`](./docs/internal/retrospection/design-spec-canonical-alignment-tracker.md) 全读（最小集 = §排期原则） |\n| 写 prompt / 设计机制 / 给推荐方案 | [`docs/meta-rules.md`](./docs/meta-rules.md) 反模式清单 |\n| **写 UI 代码**（Vue / React / HTML — 含本仓库 `playground/docs/*`、`src/components/*`、下游产品 demo 与 PoC） | [`docs/internal/code-conventions.md`](./docs/internal/code-conventions.md) 顶部 **§🤖 AI 读取指引 的「起手必读段」**（含 §R0 Phase 0 元素→组件映射 + §R7 四场景判断 + Task Entry Modes；具体 R-rule 按该表触发条件 jump）。⛔ 按 scoped 读，**禁全量吞**（该文件近 90 KB）；⛔ 跳过起手必读段直接进单条 R-rule = 协议违反（该文件自记「漏 R0 Phase 0 是历史最高频回归源」） |\n| 实现决策：命名 / token / API 形态 / 图标 alias | [`docs/working-principles.md`](./docs/working-principles.md) 9 条原则（0-8）对应条 + [`src/design-system/translation/`](./src/design-system/translation/) 4 文件（`prop-aliases` / `divergences` / `icon-aliases.ts` / `token-aliases.ts`） |\n| 数据来源 / 生成链 / 清理规则 | [`docs/PROJECT_MAP.md`](./docs/PROJECT_MAP.md) |\n| 历史决策回溯 / \"怎么走到这里的\" | [`docs/internal/retrospection/`](./docs/internal/retrospection/)（最新日期） |\n| 接手 sprint task / 立新 entry | [`docs/internal/backlog.md`](./docs/internal/backlog.md)（当前 entry 全文；新 ID 先 grep 全部已用） |\n\n### Mockup 任务额外必读\n\n> 任何 AI 工具收到\"在 TVU 产品 Figma 文件画 UX mockup / 改 mockup / 抽组件入库\"类任务时，**除 L-core + 上表命中项外，下列 7-11 整链升 mandatory —— 各文件按其顶部 §🤖 AI 读取指引 scoped 读**（§Mockup Write Gate 的 4 步前置照旧）：\n>\n> ⚠️ **第 11 项不是「读一份文件」而是「跑一条命令」**（2026-08-14 加入）—— 因此上面那句「按 §🤖 AI 读取指引 scoped 读」对它不适用，它的执行方式与输出怎么读，见该项自己那段。\n>\n> ⚠️ **\"mandatory\" 修饰的是「这条链一份都不能跳」，不是「逐字全量吞」**（[[INFRA-F121]] ② 2026-08-13 统一）。此前本行写「整链升 mandatory **全读**」，与上方 §Mockup Write Gate 第 1 步逐字要求的「按文件顶 §🤖 AI 读取指引 scoped 读（…禁全量吞）」互斥，而两条指的是同一份 `mockup-conventions.md`、又都标 mandatory —— 实测两种读法差 **2.5 倍字节**。⇒ 以 scoped 读为准；某文件没有 §🤖 AI 读取指引块的，才全读。\n>\n> （**此 7-11 链 SoT = 本节**，是 mockup 任务的 scoped 强化清单，有意内联——**不属于 §必读链路开头所指的\"并行清单 drift\"**，无需归并到 STATUS。）\n\n7. **[`docs/internal/design-process.md`](./docs/internal/design-process.md)** — 通用 process 规则（**完整清单见该文件头 `rule-inventory` 块 = 唯一真源**，此处不再枚举）\n8. **[`docs/internal/domain-tvu.md`](./docs/internal/domain-tvu.md)** — TVU 业务规则（**完整清单见该文件头 `rule-inventory` 块**）\n9. **[`docs/internal/mockup-conventions.md`](./docs/internal/mockup-conventions.md)** — Path A 专属（Figma 真源 / 组件取数优先级 / 库归属验证 / M0 / M1 / M10）\n + **[`docs/internal/figma-technical-reference.md`](./docs/internal/figma-technical-reference.md)**（Figma API quirks，实现时查）\n10. **[`docs/internal/figma-component-catalog.md`](./docs/internal/figma-component-catalog.md)** — TVU 已发布库组件目录快速查（mockup 任务起手第一查，避免凭印象造组件）\n11. **跑一次 `pnpm pattern:lookup <本次的 figma URL>`** — 查**本产品自己**已经做过哪些模块（owner 2026-08-14 拍定，走[提案](./docs/superpowers/specs/2026-08-13-product-pattern-index-proposal.md) §7 的 Q2 候选 (a)）\n\n> **第 10 与第 11 是两个不同的问题，⛔ 别合并**：第 10 问「**DS 库**有没有这个原子」（Button / Input / Table，跨产品）；\n> 第 11 问「**这个产品自己**有没有做过这个模块」（设备状态卡 / 告警行 / 参数面板，产品专有、DS 不该收）。\n> owner 的痛点逐字是「用了设计库组件、**没用当前产品已有的组件**」—— 那是第 11 条治的，第 10 条结构上看不见。\n>\n> **⛔⛔ 这一条最容易被用错的方式：把「查不到」读成「没有」。** 工具输出四态，**只有 `✅ covered` 那一态**\n> 能得出「本产品已有 X」；`⬜`（还没采过）的正确结论是「**我查不到**」，⛔ **不是**「没有先例可复用」。\n>\n> **⇒ 命中 ⬜ 的正确动作是「当场采一次再查」，不是「跳过这一步继续画」**：\n> `cd <主工作树> && node scripts/ds-health-scan-mockups.mjs --only `（一步，⛔ 不需要预先登记、\n> 不需要审批；worktree 没有 `.env` ⇒ 必须从主工作树 cwd 跑）。采完重跑第 11 项即可。\n> **⛔ 这里没有、也不该有「先申请纳入采集面」这类白名单** —— 原来的 `patternIndex: true` opt-in\n> 已于 2026-08-14 拆除（owner 逐字：「为什么要把消费级产品一个个拉进来？我要做的是规则，不是实测」）。\n> 任何产品文件都能就地采；已登记为 DIM-U12 测量目标的，全量跑 `pnpm health:mockups` 时顺带就刷新了。\n> ⚠️ 唯一的例外是**采集实在跑不了时**（无 Figma 凭据 / 网络不通）：那时才「照常按本链其余步骤走」，\n> 并在交付里如实写明「本产品 pattern 索引未采到」，⛔ 别写成「无先例可复用」。\n>\n> **为什么这一条是「跑命令」不是「读文档」**：提案 §7 逐字写着，能否定掉整个索引的唯一理由是\n> 「没有任何机制保证有人在画之前查它」。只写一句必读，等于把成败押在每个人每次都记得上 ——\n> 那正是本仓「规则别继续往 L1 prose 加」要治的病。**判据/数据真源与五态语义在\n> [`scripts/pattern-index-lookup.mjs`](./scripts/pattern-index-lookup.mjs) 头注释，⛔ 别在本文件维护第二份。**\n> ⚠️ 它是**查询不是闸**（always exit 0，不拦任何东西）—— 本条的 Enforcement 层级是 **L1**：\n> **没有任何机制能发现「有人跳过了这一步」**。这是如实登记的事实，⛔ 不是待补的 TODO。\n> **「为什么停在 L1 + 什么条件下才该升」的唯一真源** = [`scripts/pattern-index-lookup.mjs`](./scripts/pattern-index-lookup.mjs)\n> 头注释里那个 📌 段（owner 2026-08-14 拍定）。⛔ **别顺手给它加个闸** —— 先读完那三条为什么；\n> 尤其别走「新建组件与已有 pattern 相似度」那条，它是启发式，直接撞 `FIGMA_AS_SOURCE_OF_TRUTH.md` §验证方法。\n\n---\n\n## 硬规则（不可违背）\n\n| # | 规则 | Enforcement 层级 | 违反后果 |\n|---|---|---|---|\n| 1 | **不修改 Figma**——Figma 是设计师真源 | L4-partial：pre-commit 拦 figma-data/ sync-output 镜像写入；**Figma 端写操作本身无机制可拦（L1）** | 任何 Figma 写操作都是 bug |\n| 2 | **不让 AI 按\"行业惯例\"自由发挥** | L1（AI 自律；登记缺失由 #5 的间接链兜底） | 必须读 translation/ 已登记决策；新决策必须先得到用户确认 |\n| 3 | **不创建未登记的 prop / variant / 状态** | L2 间接：无 commit 时拦截，render-verification + published-vs-code 事后抓 drift | 例：Notification 的 `success` 曾是 code 自创 drift；2026-06-12 owner 在 Figma 正式补 `dialog`×`success` 并随发布登记 → 由 drift 转为合法（先 Figma 后 code，符 §\"Figma 库 master 变更→code 原子同步契约\"） |\n| 4 | **颜色硬编码 = bug** | L5：`audit:no-hardcoded-design-tokens`（prepublishOnly + master-push CI） | 必须用 token；token 缺失就新建，不能写 hex |\n| 5 | **任何 Figma↔Code 不一致必须先在 translation/ 登记** | L2 间接：`audit:translation-completeness`（L5）只验**已登记**条目；未登记漂移靠 render-drift-gate 事后抓 | 不登记的不一致 = 漂移 |\n| 6 | **AI 工具从 Figma URL 生成代码必须用 `src/canonical/*` 作为 SoT，不用 `src/components/*`** | L1（DS 仓内）；consumer 侧 L4-partial（eslint `no-base-component-import`） | `src/components/*` 是实现/base 层，`src/canonical/*` 是 Figma-aligned 桥层（npm 经 `src/index.ts` 导出 canonical）。落 base/legacy → 输出 API 错位。详见 [`src/design-system/translation/divergences.md`](./src/design-system/translation/divergences.md) \"Code 端双源\" 段 |\n| 7 | **代码改动必须走 feature 分支 + PR (non-Owner 约束)；Owner 任何改动均可直 commit master**（2026-05-28 broader Owner override 落地，原 docs-only 例外被升级）| L3 平台：Gitea 分支保护（non-Owner）+ Owner override 政策条款 | 见下方「Git 工作流（强制）」段。Owner 例外见 §\"Owner 直 commit master 权限（broader 2026-05-28）\" |\n| 8 | **组件 demo 必演示 Slot + Boolean 属性（Vue playground + React pilot 双框架）**（owner 2026-07-03 拍板）| **L4**：pre-commit 条件 gate + blocking `audit:demo-slot-boolean`（INFRA-F45 shipped 2026-07-06；`scripts/audit-demo-slot-boolean-coverage.mjs` 从 `components.config.ts` 派生 in-scope=28，静态断言双侧 slot 投影 + boolean live 绑定；staged 命中 demo surface/config/audit 时触发）| 凡有 default/named slot 或 boolean prop 的组件，其 docs demo 必须在 **Vue 与 React 两侧**各演示（a）slot 投影真实内容、（b）至少一个 boolean prop 的 live 切换。理由：slot 投影与 boolean 属性是双框架 CE 最易 silent 破的两条链（实证 INFRA-F43 light-DOM slot 不投影恒空 body 数版本未被发现）。首个 exemplar = PopupBox；全量回填后每个 in-scope 组件双侧达标，audit gate 防回归。|\n| 9 | **AI 不得编造 / 虚构工具输出**——随机标识符（commit hash / SHA / 时间戳 / exit code / 测试 passed 数）只能从工具原始输出逐字复制，不准生成 | L1（无机制可拦 AI 幻觉，唯靠纪律 + 用户终端核对） | ① commit hash / SHA / 时间戳 / exit code / passed 数 = 从原始 stdout 逐字复制，绝不自己生成；② 不可逆 / 外部可见操作（commit / push / publish / 删除）的结果以**原始工具输出**或用户终端核对为准，**不得用\"已成功 / 已一致 / 已通过\"概括代替原文**；③ 工具输出超时 / 被省略 / 截断 / 前后矛盾 / 可疑时 → **STOP 交用户在终端核**，不自行接管编造。**归因要准**：病根是 AI 编造，**不是**\"工具不返回\"——多数情况工具正常返回真实数据（2026-07-15 本 session 实证工具输出全真实可核）。真源 memory `no-fabrication-on-uncertain-tool-output` + `local-env-tool-quirks`。实证：上个 session（D2 Task 9 首次尝试）AI 伪造过不存在的 commit hash / push 成功 / 测试通过 / SHA 一致，逼用户起新 session 从真实基线重做 |\n| 10 | **结论必须对\"活源\"验证，不凭摘要 / 镜像 / 记忆下判断**——判断仓库或远端的**当前状态**（某文件是否存在 / 内容为何 / prop-token 名 / 组件是否已同步 / 远端卡片长什么样）前，**必须直接读活源**：本地 `Read` / `grep` 实际文件；远端 DesignSync `get_file` 实际内容。**不得**拿派生镜像 / 摘要 / 记忆缓存 / 面板 UI 当依据下结论。 | L1（无机制可拦，唯靠纪律；由 #9 事后核对间接兜底） ⚠️ 2026-08-20 新增一个此前未登记的形态：**计划文件里的具体值（prop / 导出名）未对活源核** —— 已上机械闸 `pnpm audit:claim-vs-livesource`（pre-commit 条件触发 + pr-checks；INFRA-F133）。⚠️ **该闸对这个形态是 report-only（每次跑、每次印、不阻断）**：落地当天校准实测假阳性率 **86.7%（13/15，35 份指令型文档）**，按 spec §9 退档条件退档；阻断档只保留三条 fail-closed 基础设施判据（活源分母 / 扫描面 / 豁免表 shrink-only）。⚠️ **闸只覆盖这个形态的 prop 名那一半**：barrel 导出名虽然解析了，但只喂活源分母与覆盖面自印，**没有任何判据比对导出名断言**（词法上「导出名断言」与闸选宿主用的形态重合，全比一遍必然是噪声 —— 理由见闸脚本头注释，缺口登记在 backlog `INFRA-F133`）。⛔ 判据、档位与结构化区域定义的真源是[闸脚本头注释](./scripts/audit-claim-vs-livesource.mjs)，**别在本表维护第二份**。⇒ 仍靠纪律的是：**结构化区域里的断言（S2 只印不红）**、散文里的断言（S5 只印不红）、**导出名断言（不在覆盖面）**、对话里的口头结论、以及**文档断言 × 另一份文档的当前版本**（本闸只核代码活源）。 | 二手源会 drift，信了就\"读错\"：① 导出 bundle 的 `01–14` ≠ repo 真源——**改规则去 `docs/` / `docs/internal/`，别去 bundle 找**（[`PROJECT_MAP.md` §9](./docs/PROJECT_MAP.md)）；② 现有远端卡的 prop ≠ canonical——**照抄现有卡 = 复制 drift**，prop 名一律以 `src/canonical/*.vue` 为准；③ DesignSync 面板 `updatedAt` / 卡片对**非视觉写入不刷新**——别拿 UI 当同步凭据，写完逐文件 `get_file` 亲验（memory `designsync-nonvisual-writes-no-ui-bump`）；④ memory / handoff / 摘要文档是工具私有缓存或时点快照，规则演化后会过期，**只作导航，不作真源**（形态 ①④ 2026-08-20 已评估：无可靠词法解 —— 实测 71 处引用中 48 处报红且多数假阳性，\"当依据\"与\"当对象\"是语义区分 ⇒ 维持 L1，不上闸）。**病根 = \"AI 读错\"：信了会漂移的二手源。** 实证：Sync A 6 卡审计中 5 卡有 prop drift（Badge/Button 的 `tag`/`variant` → 应 `fill`、UserMenu `items[]` → 应 `actions[]` 等），正是历史上照抄现有卡、未回 `canonical` 活源验证的结果。
⚠️ **2026-08-11 补一个被漏掉的形态（PR #9 实证）：多分支协作下，你自己的本地工作树也是一种会过期的镜像。** 那次撞号的一方读的是**本地实际文件**（不是摘要、不是 memory、不是面板 UI —— 完全符合本条），只是那份文件已经 62 天没同步，于是把 master 上早已占用的规则编号又用了一遍。⇒ 判断**全局命名空间的当前状态**（规则编号 / backlog entry ID / token 名 / 已用过的 key）时，活源是 **`origin/master`**（先 `git fetch`），不是本地文件。已上机械闸：`pnpm audit:rule-number-collision`（pre-commit 条件触发 + `pr-checks.yml` 带 `--require-remote`）+ 分配器 `pnpm rule:next <系列>` / `pnpm new-backlog <前缀>`。⚠️ **2026-08-20 订正**：此处原写「该闸只覆盖三份规则真源的编号，**看不到 backlog entry ID**，那一条仍靠本纪律」—— 原 [[INFRA-F109]] 已落地，`docs/internal/backlog.md` 的 **entry ID 现已在覆盖面内**（含 `####` 层级、无 `F` 中缀、带连字符前缀、umbrella 范围标题四种形态；⛔ 覆盖面与仍看不到的三样，真源是[闸脚本头注释](./scripts/audit-rule-number-collision.mjs)，**别在本表维护第二份**）。⇒ 本条仍需靠纪律的只剩「**已删档号被重新占用**」（完成即删档 ⇒ 被删 ID 在 master 文本里已不存在，闸看不见）—— 取号一律走 `pnpm new-backlog`，它扫三份 SoT 全文、含历史提及 |\n\n> **Enforcement 层级图例**（对齐 [`meta-rules.md`](./docs/meta-rules.md) 触发器 K 的 L1→L5 谱系；列加于 2026-06-10 system-review P2-04）：**L1** = 文本规则靠 AI/人自律 · **L2** = 无直接拦截但有事后 audit 可抓 · **L3** = 平台/流程机制 · **L4** = 本地 pre-commit hook（可 `--no-verify` 绕过）· **L5** = prepublishOnly / CI strict gate。**各条规则强度本不相同**——没有这列时\"同等强\"是错觉；声称\"有 gate 兜底\"前先对照此列。\n\n---\n\n## Git 工作流（强制）\n\n`master` 受分支保护，**non-Owner 的任何代码改动必须走 PR**。AI 在本仓库工作时遵循以下决策树：\n\n> **⚠️ Owner 例外**：默认操作者 Owner（Nancy）**可直 commit master、不建分支**——见下方 §\"Owner 直 commit master 权限（broader 2026-05-28）\"（硬规则 #7 已编码）。本节决策树主要约束 non-Owner，及 Owner 在当前 session 明示\"走 PR / 建分支\"的情形。\n\n### 分支决策（non-Owner 贡献者适用）\n\n> **本仓实际默认 = Owner（Nancy）直 commit master、不建分支**（硬规则 #7，见下方 §Owner override）。下面仅约束 non-Owner 贡献者，或 Owner 在当前 session 明示\"走 PR / 建分支\"时。\n\n1. **在 master 起手** → `git checkout -b /`（type ∈ feat/fix/docs/chore/refactor/test）。\n2. **已在 feature 分支** → **强默认复用同一分支**。边界按**主题**（非文件/组件）：同会话持续指令、无\"切任务\"信号 = 同主题，累积 commit 最后一个 PR。拆多分支/多 PR = 反模式（增 review 摩擦、破坏语义聚合）。\n3. **只在三种情况换分支**：用户明说\"另一个任务/新分支\"、当前 PR 已合并（master 已含该分支）、主题完全跨域（最后一种先问 owner）。**不主动问\"是否换分支\"**。\n\n### Commit + Push\n\n- Commit message 用 Conventional Commits：`type(scope): description`（如 `feat(button): add loading state`）\n- 一个分支可以多个 commit，PR 合并时会汇总\n- Push 后把 Gitea 自动返回的 PR 创建链接给用户：\n ```\n https://product-demo.tvustream.com/gitea/ux-team/tvu-design-system/compare/master...<分支名>\n ```\n\n### 并行 session 下的 git 纪律（本仓库常态：多 session 同时写）\n\n**本节是这两条纪律的唯一真源**（2026-08-04 从 `docs/STATUS.md` 顶部搬来——它们是规则不是状态）。\n\n1. **接手前先 `git status`；遇到 dirty / untracked 先判「隔夜遗留」还是「别人正在写」** —— 这两种情况的正确动作**相反**，而判据**不是**「dirty 就是别人的」，是 **mtime + `git log` 有无同任务 commit**。两次实证都在 2026-07-30/31 的多 session 并行里：起手时靠它判出 `UserMenu.vue` 正被并行写（mtime 与本 session 起手同分钟）从而没去碰；收尾时又靠它把一批「看着像隔夜残留」的 untracked 判成**正在进行**（mtime 在当下几分钟内），几分钟后那条线自己提交了。\n2. **`git commit` 必须带内联显式路径**：`git commit -F -- …`（`-F` 在 `--` 之前），**且提交后紧跟 `git reset -- `**。不带 pathspec 会把别人 staged 的文件卷进自己的 commit；不 reset 则留下幻影 staged 状态、会被别人下一次裸 commit 提交掉。⚠️ 并行写同一仓库时 `.git/index.lock` 会让 commit 直接 `exit 128` —— **那不是故障、是对方正在提交**，等一下重来即可（改动完好留在工作树）。\n\n### 建 PR 时如何填模板（PR body）\n\n建 PR 时按 [`.gitea/PULL_REQUEST_TEMPLATE.md`](./.gitea/PULL_REQUEST_TEMPLATE.md) 逐段填正文，分两类纪律：\n\n**必须自动填好**（从 diff / 对话可推导，不让 Owner 自己猜）：\n- **改动内容**：读本次 diff，逐条列出实际改了什么文件、什么行为\n- **改动原因**：从对话上下文 / 关联需求写清楚，关联 Issue 写 `#编号`\n- **改动类型**：按改动性质勾选（可多选）\n- **备注**：reviewer 需知的点、后续 TODO、未执行项说明\n\n**禁止假填**（只能反映真实结果，否则误导 Owner review）：\n- **测试情况 checkbox**：只勾**本次真实跑过并通过**的命令；没跑的留空，并在「备注」写明\"未执行：xxx\"。绝不能凭\"应该会过\"就打勾——Owner 见勾即视为已验证。\n- **截图 / 录屏**：仅 UI 改动且**真实跑过 app / playground 截取**才贴；纯 docs / 逻辑改动写\"不涉及 UI\"。不得生成或捏造截图。\n- **检查清单**：只勾确实核对过的项。\n\n**Why**：模板的价值是让 Owner 一眼判断该不该合。勾选若不可信 → 比留空更糟（制造虚假安全感）。AI 应把\"哪些已验证 / 哪些没验证\"如实写出，判断权留给 Owner。\n\n### 直 commit master 时：commit message 写结构化 body\n\n直 commit master 没有 PR 描述兜记录，**commit message 的 body 就是\"改了什么 + 测了什么\"的唯一载体**——按 [PR 模板](./.gitea/PULL_REQUEST_TEMPLATE.md) 字段精简对齐，让 `git log` / Gitea 提交页一眼可读，与同事走 PR 看到的信息一致、互不冲突。\n\n格式：\n\n```\n(): <一句话 subject> # subject 仍遵循 Conventional Commits\n\n改动内容：\n- <逐条列出实际改了什么文件 / 行为，从 diff 来>\n改动类型：feat / fix / docs / refactor / chore …（可多类）\n测试：<只写本次真实跑过的，如 pnpm test ✅ 219 passed；没跑的写\"未跑：lint/typecheck\">\n```\n\n**纪律（与 PR 模板同源）**：\n- 改动内容 / 类型从 diff 与对话自动填好，别让 Owner 自己猜。\n- 测试只写**真实执行**的结果；没跑的如实标\"未跑：xxx\"，绝不能凭\"应该会过\"写 ✅——Owner 看 commit 即视为已验证。\n- UI 改动有截图就把路径 / 链接放进 body；纯逻辑改动注明\"不涉及 UI\"。\n\n**Why**：同事 PR 的\"改动 + 测试\"在 PR 描述里，Owner 直 commit 的在 commit body 里，两条路径记录同一套字段、各自独立——Owner 在 PR 列表和 git log 里都能一眼看出改了什么、测没测，统一可见且不冲突。\n\n### 直 commit master 时：写 changeset（版本日志）\n\n走 PR 有 PR 模板兜结构化记录；**直 commit master（Owner override）没有 PR**，靠 changeset 留每个版本的改动记录。仓库已配 [Changesets](./.changeset/config.json)（`baseBranch: master`），`CHANGELOG.md` 由它按版本自动生成——这就是\"按版本知道改了什么\"的真源。\n\n**何时写**：本次 commit **影响 npm 发布产物 / consumer 行为**时——`src/**` 组件、API/props、`src/tokens/**`、导出（`index.ts`）、`eslint-plugin/**`、`templates/**`，以及 **`files[]` 白名单内那 20 个 `scripts/`**（不是整个 `scripts/`）等 consumer-facing 资产。\n\n> ⚠️ **本行 2026-08-13 随 [[INFRA-F117]] 落地订正**：原文写的是裸 `scripts/`，而当时 `files[]` 也确实是裸 `\"scripts\"`（107 个内部脚本全进包）。F117 把它收窄成具名白名单后，**`scripts/` 不再整体是 consumer-facing** —— 判据改为「该文件在不在 `package.json` 的 `files[]` 里」，`files[]` 是唯一真源，别在这里维护第二份清单（要看当前白名单跑 `npm pack --dry-run`）。改一个只在本仓库跑的 `scripts/audit-*.mjs` 属**不写** changeset 的内部改动。\n\n\n\n**何时不写**（写了反而污染版本日志）：纯 `docs/**`、`tests/**`、`playground/**`、`react-pilot/**`（owner 2026-08-12 明确补入 —— 它的 `src/demos/*.css` 是 docs 站两侧共用的 demo 样式，不进 `dist`）、`figma-sync/**`、CI / 内部重构等不改变发布产物的改动。\n\n**怎么写**：和实质改动放在**同一个 commit** 里，新增 `.changeset/.md`：\n\n```md\n---\n\"@ux-team/tvu-design-system\": patch\n---\n\n<面向 consumer 的一句话：改了什么 + 影响。Breaking 要写迁移说明。>\n```\n\n**bump 级别（= 改动类型）**：\n- `major` — 破坏性改动（API / prop 重命名或删除、行为不兼容）\n- `minor` — 新功能 / 新组件 / 新 prop（向后兼容）\n- `patch` — bug 修复 / 视觉对齐 / 小调整\n\n**纪律**：bump 级别和描述据实写，不夸大不缩小——`changeset version` 据此 bump 版本号并汇总进 CHANGELOG，Owner 与 consumer 都按它判断升级影响。发布时 `pnpm changeset:version` 汇总、`pnpm changeset:status` 查待发布项。\n\n### docs 站内部 demo / 页面样式改动的快车道（owner 2026-08-12 裁定）\n\n**适用面（严格 AND）**：本次改动集 ⊆ `playground/**` + `react-pilot/**` + `docs/**` + `tests/**`，**且不碰 `src/**`** ⇒ 不进 npm 产物、consumer 不可见。典型 = docs 站 demo CSS、页面布局、响应式断点、**闸的判据（指 `tests/**` 里的断言，⛔ 不含 `scripts/` 下的闸脚本本身）**。\n\n> ⚠️ **「闸的判据」四字的限定是 owner 2026-08-13 补的**（[[INFRA-F128]] 系列评估发现互斥）：原文只写「闸的判据」，而闸脚本住在 `scripts/`，于是它把 `scripts/` 隐含划进了快车道面 —— 但同段的「严格 AND」谓词**根本不含 `scripts/`**（只有 `playground`/`react-pilot`/`docs`/`tests`）。owner 确认原意是 **`tests/`**（2026-08-12 那批快车道改动实际动的就是 `tests/docs-overflow/*.spec.ts` 的 `VIEWPORTS` 与判据，且它满足谓词）。⇒ **改 `scripts/` 下的闸脚本不走快车道**（谓词不含它）；**changeset 则仍按上一节 §「何时写」的 `files[]` 判据判 —— 不在 `files[]` 白名单里的内部 `audit-*.mjs` 属「不写」。**\n>\n> > 🔴 **2026-08-13 晚就地订正本段自己的一处 stale 转述（登记为原 INFRA-F124 ④ —— **该 entry 2026-08-14 四个子项全部落地后已删档**，判据留痕在 tracker §待核可关）**：上面原写「上一节 §「何时写」又把 `scripts/` 列为 consumer-facing **必写**，三方互斥」并据此推出「⇒ …**照常写 changeset**」—— **那句描述的是 [[INFRA-F117]] 落地前的措辞**。同一天的 §「何时写」（见上一节）已把判据订正为「该文件在不在 `package.json` 的 `files[]` 里，**`files[]` 是唯一真源**」，并逐字点名「改一个只在本仓库跑的 `scripts/audit-*.mjs` 属**不写** changeset 的内部改动」。⇒ 这**不是两条对等规则打架**，是本段的前提 stale ⇒ 它推出的那半句结论失效（互斥也从「三方」降为「两方」，第三方已自行消失）。**owner 的裁定实质一个字没动** —— 快车道谓词仍不含 `scripts/`；变的只是 changeset 那一半，从「照常写」改为回指 `files[]` 判据。⚠️ 这条留痕本身是「**同一份文件内部**的规则真源冲突」的实例，与 原 INFRA-F124 的三项（跨文件冲突）同类不同形态。\n\n**立规缘由**：这类改动的产品体量很小（常是几行 CSS），但此前按满配纪律走 —— 逐文件问视觉批准 + 为每条缺陷配新闸 + 故障注入证明 + STATUS/CHANGELOG/backlog/tracker 四处同步 —— 仪式成本是改动本身的数倍。owner 2026-08-12 拍板给三条豁免：\n\n1. **免 changeset** —— 见上一节「何时不写」（本裁定把 `react-pilot/**` 补进那张清单）。\n2. **视觉批准合批** —— `VISUAL_COMMIT_APPROVED` 一次批准覆盖**同一批**（同 session 内连续、owner 已看过效果的那一组）视觉改动，不必逐文件 / 逐 commit 各问一次。⚠️ **AI 仍然不自设这个变量**：合批只减少「问几次」，不改变「必须由 owner 说出口」。\n3. **免为它新建闸 / 免故障注入证明 / 免四处文档同步** —— 只更新 backlog 对应 entry（真源）+ STATUS 一行；不写复盘文档、不为单条缺陷新建 audit 脚本。\n\n⚠️ **「免机械闸」我按最窄读法执行，owner 可推翻**：读成「免**新建**闸」，**现成的 `audit:docs-overflow` / `audit:layout-tokens` / `vue-tsc` / `pnpm test` 仍然跑**。三条理由：① 前两条恰好是自动发现「内容被裁且够不着」的唯一手段，而 [[INFRA-F112]] 正是从 `docs-overflow` 的判据漏洞逃掉的 —— 关掉它等于把发现同类缺陷的能力一起关掉 ② 成本不在这里：四条合计 ~7min 且无人值守，同一条修复里真正吃时间的是重写判据、故障注入、四处文档 ③ 它们是**已存在**的闸，跑一次的边际成本近零。**重开条件**：owner 明说「连现成的也别跑」，或实测这几条闸的耗时占到一次 docs 修复总时长的 1/3 以上。\n\n### 禁止 AI 做的事\n\n- ❌ 不要自己点合并（PR 必须由人审批后合并）\n- ❌ **non-Owner** 不要试图 push 到 master（会被分支保护拒绝）；**Owner 直 commit master 是默认**，见 §\"Owner 直 commit master 权限（broader 2026-05-28）\"\n- ❌ 不要为同一个逻辑改动拆多个分支\n- ❌ 不要在没确认主题完成的情况下擅自切回 master\n\n### Owner 直 commit master 权限（broader 2026-05-28）\n\n**2026-05-28 Owner override 升级**：原 docs-only 例外扩到 **任何改动**（含 code / config / schema / scripts / SoT 等）。Owner Nancy 默认 commit 到 master，**不建 feature 分支**，除非用户在当前 session 明示\"开分支\"。\n\n**触发条件（严格 AND）**：\n1. 当前 session 操作者 = Owner (默认 Nancy；见 §\"仓库身份\")\n2. Owner 未在当前 session 明示\"建分支\" / \"走 PR\" / \"feature branch\" 等措辞\n\n**AI 决策树**（在仓库 cwd 改任何文件时）：\n\n```\n当前 session 是 Owner 操作？\n └─ YES → Owner 明示要建分支 / PR？\n └─ YES → 走 §\"Git 工作流（强制）\" feature branch\n └─ NO → 当前在 master：直 commit；当前在 feature：问 Owner \"本次并入当前分支还是切 master 直 commit？\"\n └─ NO → 走常规 feature branch + PR 流程\n```\n\n**Why**：\n- 单人 owner 项目 + AI plan-owner/executor 代理模式下，feature branch 仅是仪式 (no second reviewer except Owner themselves)\n- Owner 已对每个 commit 实质 review (plan owner 审 executor diff + Owner ack)\n- 分支保护可为 Owner 设豁免规则 (Gitea 支持)；未设豁免时 Owner 用管理员权限绕过\n- 减少 branch / PR / merge 切换 cycle 摩擦\n\n**反例（仍走 feature branch）**：\n- 非 Owner 用户改任何文件 → 常规流程保留 review trail\n- Owner 明示\"这个开分支跑\" / \"走 PR\" → 按 Owner 指令开分支\n- AI 在 Owner 没明示授权直 commit 时... 实际不存在此 case（Owner override 是 default，AI 不需要明示授权也直 commit）\n\n**实证**：2026-05-28 BRIDGE-MOCKUP-008 Phase C session — Codex 按旧 docs-only 例外建 `chore/bridge-mockup-008-phase-c-merge` 分支，Owner 反问 \"为什么它会弄到分支里面？没道理不知道提交到 master\"。本条款升级。\n\n### Docs-only 改动：见上方 broader Owner override（legacy 2026-05-26，已被涵盖）\n\n**本节原 docs-only 例外（2026-05-26 立）已被上方 §\"Owner 直 commit master 权限（broader 2026-05-28）\" 完全涵盖**——docs-only 只是\"任何改动\"的子集，规则一律以 §276 broader override 为准，本节不再单独维护触发条件 / 决策树（避免两处改一处忘的 drift）。\n\n**实证（保留）**：2026-05-26 TPC bulk import session，Owner 改 mockup-conventions.md M23 stroke 3→4px 时被 AI 建议走 feature 分支，多绕一层；催生原 docs-only 例外，2026-05-28 被 broader override 吸收。\n\n---\n\n## 元规则：真源单一 + 双层导入（不绑工具 / 不绑模型）\n\n> 本元规则适用于**任何 AI 工具**（Claude Code / Codex / Cursor / Cline / Copilot / 其它）、**任何角色**（plan owner / executor / reviewer）。\n> 角色与工具的绑定可变化——当前 Claude Code = plan owner、Codex = executor，但可互换或被替代——**本规则不变**。\n\n详细规则、反模式清单、角色互换条款、Audit/数据产出类 prompt 子规则，统一登记在：\n\n→ **[`docs/meta-rules.md`](./docs/meta-rules.md)**（元规则真源）\n\n任何角色在写 prompt / 设计机制 / 推荐方案前，**必须先过 meta-rules.md 的反模式清单**。命中任一条 → 停下重新设计。\n\n---\n\n## 工作流（约定）\n\n> **角色驱动，工具可换。** 本段使用角色名（`plan owner` / `executor`）而非工具名。\n> **本仓实际默认（2026-07-17 对齐实际）**：solo DS 工作 = **Claude Code 同时任 plan owner + executor（直做 + 自动 subagent/Workflow 并行）**——不走 file-based 往返委派。下面的\"标准闭环 / executor STOP / file-based prompt\"是**委派协议**，仅在 **① 多工具协作（另一 AI 当 executor）或 ② 同事委派 / 大型可并行任务** 时启用。（owner 2026-07-16 确立\"默认自主 + 自动多 Agent 并行\"实践，详见 §标准闭环 头注。）\n> **委派时的默认绑定**：`plan owner = Claude Code`、`executor = Codex`。\n> **切换方式**：用户在对话里说\"把 `<角色>` 换成 ``\"，新工具读 `AGENTS.md` + `docs/meta-rules.md` 即可承担该角色。\n> **切换不需要改本文件 / `meta-rules.md` / 任何 prompt 模板**——它们都是角色无关的。如果发现哪条规则绑了具体工具名，应该改成角色名（违反 meta-rules 反模式 #1）。\n\n### 角色定义\n\n| 角色 | 职责 |\n|---|---|\n| **plan owner** | 写 plan / 设计 prompt / 审 executor 的 diff / 复审是否进入下一阶段 |\n| **executor** | 按 plan owner 写的 prompt 严格执行任务 / 跑脚本 / 报告改动与未解决项 |\n| **reviewer** | 用户最终拍板（部分情况下 plan owner 兼任审计） |\n\n> 上表是默认骨架。**具体职责按下面 task-type 矩阵微调**——不是 one-size-fits-all。\n\n### Task-type 分工矩阵（mandatory，prompt §Mode 头段必声明）\n\n> 实证来源：P15.1 / P15.2 / P15.2-extend / P16 discovery 四次实跑。Plan owner 凭记忆喂 baseline 数字 = bug 源（P15 §0 算错 38 → reroute / pickup §3 \"~48\" 歧义被 Codex 抓出）；executor 在 apply 阶段额外 verify spec = 冗余 round trip。\n>\n> **每个 prompt 必须在 §Mode 段明示 task type**（如 `Mode: Discovery only` / `Mode: Apply deterministic spec` / `Mode: Design options + STOP`）。executor 按对应行执行，plan owner 按对应行 review。\n\n| 任务类型 | Baseline 数字 | 决策 / 分类 | 设计选项 | 代码改动 | 典型实证 |\n|---|---|---|---|---|---|\n| **Discovery / 调研** | Executor grep 实证 | Executor 按 plan owner 写的机械规则分类 | Executor 列偏差 + STOP | ❌ 不动 | P15.1 / P16 discovery |\n| **Apply / 实施**（spec 已定） | Plan owner 写死 | Plan owner 已拍板 | ❌ 不发挥 | Executor 按 spec 改 | P15.2 / P15.2-extend |\n| **Design / 设计选项**（多解） | Plan owner 给约束 | — | Executor 列 2-3 选项 + 推荐默认 + STOP | ❌ 不动 | P16b verifier topology |\n| **Refactor / API 改造** | Plan owner 实证（写死）| Plan owner 拍板 API 形态 | Plan owner 拍板 | Executor 按 API spec 改 + 跑 vitest | Phase 6.6 dual-form / Phase 6.8 Button canonical |\n| **Infrastructure / 工具**（小 CLI / hook）| — | Plan owner 拍板 spec | Plan owner | **Plan owner 可 direct**（path B）| Tier 2-D/E/F / new-backlog.mjs |\n| **Audit / 数据扫描产出** | Executor grep | Executor 按 plan owner schema 输出 | — | ❌ 不动 | future audit-mockup-conformance discovery |\n\n### 跨 task-type 不变约束（所有类型都必须遵守）\n\n1. **Executor 永不 commit / push** — prompt 不得含 commit/push 指令，executor verify 后只报 diff + stdout，由 plan owner + 用户 ack 后才 commit\n2. **Plan owner 必独立 verify executor 报告**——按 task type 差异化（见下）：\n - Discovery 类：sample 1-2 cluster 重 grep 验分类；不能只 verify 数字加总\n - Apply 类：diff 全审 + git status / git diff --stat 独立 check\n - Design 类：每个 option 独立查可行性，不 rubber-stamp executor 推荐\n3. **Plan owner 不直接动 source code / tokens / JSON 数据 / component**——例外仅 Infrastructure 类小工具 + 协作文档 + prompt 文件 + 审计报告 + 复盘文档\n4. **决定哪类 task type** 由 plan owner 在 prompt §Mode 段明示；executor 起手第一步是 confirm task type，与 prompt §Mode 不符必 STOP 反馈\n\n### 标准闭环（委派协议 — plan owner ≠ executor 时按顺序）\n\n> **适用范围**：下面 7 步是 **plan owner 与 executor 分属不同工具/人** 时的委派协议。**本仓 solo DS 工作（Claude 直做）默认不走此环**——坍缩为：`Claude 实现（+subagent/Workflow 并行）→ 自 verify 拿真实 gate stdout → owner ack → commit`（不可逆操作前的 owner ack 与自 verify 是保留的核心闸，见跨 task-type 不变约束 #1/#2）。\n\n1. plan owner 读项目规则 + audit\n2. plan owner 生成 `docs/internal/_prompts/.prompt.md`\n3. 用户把 prompt 交给 executor\n4. executor 按 prompt 改代码 / 产出文件\n5. executor STOP，列出改动和未验证项\n6. plan owner 复审 executor diff\n7. 用户决定是否进入下一阶段\n\n### 单一决策源模式（当前默认）\n\n为避免 plan owner 与 executor 在对话中互相\"补充框架\"、反复扩展路线，后续协作默认采用以下边界：\n\n- **plan owner 负责产出一版路线图 / prompt**，并把结构性决策固化到仓库文档\n- **executor 不做\"加料式评论\"**：不在 plan owner 路线图基础上继续发明新轨道、新阶段或新框架\n- **executor 只做三件事**：\n 1. 检查 prompt 是否有明显 blocker（会误删 / 误 commit / 改 Figma / 范围不可验证 / 与仓库规则冲突）\n 2. 执行 prompt 指定任务\n 3. 报告改动、验证结果、未解决项\n- 如果 executor 不同意 prompt，只指出**会导致失败的 blocker**，不扩展替代路线\n- 一旦 `docs/internal/long-term-plan-v2-*.md` 或同等路线图落仓库并经用户确认，本阶段以该文档为准；不要在对话里反复发明新框架\n\n### executor 角色行为约束\n\n- 用户通过 file-based prompt 触发任务：`请按 docs/internal/_prompts/.prompt.md 执行`\n- **起手第一步：confirm prompt §Mode 段声明的 task type**，按 task-type 矩阵对应行执行；prompt 缺 §Mode 段 → STOP 反馈让 plan owner 补\n- 每个 prompt 末尾会有 \"完成后 STOP，等用户审\"——**严格遵守 STOP**，不要自行进入下一步\n- 关键参数（如 token 值、变体枚举）**先列出来给用户确认**，不要自行决定\n- 在单一决策源模式下，执行前只做 blocker 检查；无 blocker 就执行，不再提出额外路线规划\n- **不\"加料式评论\"、不发明新轨道 / 阶段 / 框架**——只做三件事：① 检查 prompt 有无明显 blocker ② 执行 prompt 任务 ③ 报告改动、验证结果、未解决项\n- **永不自行 commit / push**（见跨 task-type 不变约束 #1）\n\n### plan owner 角色行为约束\n\n- 直接读项目文件审 executor 产出\n- 设计 prompt 前**强制过 `docs/meta-rules.md` 反模式清单**——命中任一条 → 重新设计，不 fire\n- **每个 prompt §Mode 段必明示 task type**（Discovery / Apply / Design / Refactor / Infrastructure / Audit）——见 task-type 矩阵\n- **Discovery / Audit 类 prompt 不写死 baseline 数字**——让 executor grep 实证；plan owner 凭记忆喂数字 = bug 源（P15 §0 算错 38 实证）\n- **Apply 类 prompt 必写死 spec**（token 名 / CSS 行 / API 形态）——不让 executor 重复 verify\n- 任何重大决策（破坏性 API 改造、跨阶段路径选择）必须 propose 给用户拍板\n- 默认**不直接修改代码 / 脚本 / tokens / JSON 数据 / 组件文件**——涉及这些改动时，应先生成 executor prompt，除非用户明确授权（Infrastructure 类小工具 path B 例外）\n- 可以直接修改协作规则文档、prompt 文件、审计报告和复盘文档；完成后必须 STOP，等用户确认\n- **审 executor 产出必独立 verify**——Discovery 类 sample 1-2 重 grep 验分类（不只 verify 数字加总）；Apply 类全 diff 审 + git status 实证；Design 类每 option 独立查可行性\n\n### 共同规则\n\n- 决策必须固化到文档（不能只在对话里口头提）\n- 阶段完成后追加复盘到 `docs/internal/retrospection/{date}.md`","numLines":454,"startLine":1,"totalLines":781,"truncatedByTokenCap":true}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"190b18c9-649d-408e-879a-e31d90dd1746","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":100,"estimated_tokens_delta":50,"uuid":"0fdb347b-6767-476d-9d3c-c51018439ea5","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":200,"estimated_tokens_delta":100,"uuid":"afb81ac3-e9ad-49e7-b9d3-ef419ef594ac","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":300,"estimated_tokens_delta":100,"uuid":"14ad4c78-8c2a-40e6-b9b8-074c2b008f55","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":400,"estimated_tokens_delta":100,"uuid":"2d9d2c85-eab0-43e9-bd56-e9d23dfcfe79","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":500,"estimated_tokens_delta":100,"uuid":"85efa9a0-2a96-4dda-ac8d-554705997c66","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHwny5iGtqjSosrGDFQ","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"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"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":28167,"cache_read_input_tokens":94986,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":28167},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"e1edd011-afbb-4287-8853-b62111dc9a16","timestamp":"2026-08-25T10:16:24.667Z","request_id":"req_011CePHwisX8spWVjsXxUM6B"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHwny5iGtqjSosrGDFQ","type":"message","role":"assistant","content":[{"type":"text","text":"L-core 四份读完。这个任务是「写 HTML UI 代码（下游产品 PoC）」，命中 `code-conventions.md` 触发，我按它顶部的 scoped 指引读起手必读段。"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":28167,"cache_read_input_tokens":94986,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":28167},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"128f95dc-25d8-47de-91c8-9a890089608d","timestamp":"2026-08-25T10:16:26.041Z","request_id":"req_011CePHwisX8spWVjsXxUM6B"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHwny5iGtqjSosrGDFQ","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01A12hDVGjMH9kosATL2hBQt","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","limit":200},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":28167,"cache_read_input_tokens":94986,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":28167},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"f2415085-2d12-4e0e-a09d-883fd633d478","timestamp":"2026-08-25T10:16:26.512Z","request_id":"req_011CePHwisX8spWVjsXxUM6B"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01A12hDVGjMH9kosATL2hBQt","type":"tool_result","content":"1\t# Code Implementation Conventions（Path B — Code）\n2\t\n3\t> 任何 AI 工具**在消费 TVU UX Design System 写代码**时必须遵循的硬约束。\n4\t> 项目级真源；不要在对话或工具私有 memory 里复刻规则。\n5\t>\n6\t> **作用域**：写**前端代码**（HTML / Vue / React / 其它）消费 TVU library 的任何场景——本仓库的 `playground/docs/*` / `src/components/*` / 下游产品 demo（如 `MicroApps Console`）/ 任何 PoC。\n7\t> **不**作用于：Figma mockup（→ 见 [`mockup-conventions.md`](./mockup-conventions.md)）；非 UI 代码（generators / build scripts）。\n8\t>\n9\t> **Enforcement 层级声明（system-review-2026-06-10 INFO-05）**：R-rules 本体是 **L1 AI 行为规则**（写码时自律遵守）；机制强制在 **consumer 侧**——`audit:consumer-code` CLI + eslint-plugin（场景感知接线见 `ds-enforcement-scenarios-spec.md`），DS 仓内对 R-rules **无 commit-time gate（by design**，meta-rules 触发器 K 承认 L1 可接受；DS 自身 .vue 由 audit:design-system / canonical-compliance / lint:ds dogfood 覆盖等价面）。个别 rule 文内出现的 \"L3\" 指其 consumer 侧 CLI/eslint 镜像的层级，不是 DS 仓内层级。\n10\t\n11\t\n12\t> **本文件规则清单 —— 唯一真源**（机械核 `pnpm audit:rule-inventory`；scoped 与 lazy 加载按本清单挑，别处一律只放指针）\n13\t>\n14\t> R0 / R1 / R2 / R3 / R4 / R5 / R6 / R7 / R8 / R9 / R10 / R12 / R14 / R15 / R16 / R13 / R17 / R18 / R19 / R23 / R-DISCIPLINE\n15\t\n16\t\n17\t> ⚠️ **本清单从活源 rule heading 机械派生**（`scripts/lib/rule-ids.mjs`，与 `audit:rule-load-map` / `rule:next` 同源），**按文档物理顺序、非编号顺序** —— `R16` 在 `R13` 之前、`R23` 在 `R19` 之后就是活源里的样子。⛔ 别手抄、别顺手排序。**不含** `R2.1`（H3 子条，折进 `R2`）；本文件另有十余个非规则 H2（§🤖 AI 读取指引 / §Convention Priority Hierarchy 等）不在清单内 —— 清单的语义是「规则」，不是「章节」。\n18\t\n19\t---\n20\t\n21\t## 🤖 AI 读取指引（按需加载，避免全量吞）\n22\t\n23\t本文件很长（现算：`wc -l docs/internal/code-conventions.md`），**不要起手就全量 Read**。按下表只读起手必读段，具体 R-rule jump to 时再读：\n24\t\n25\t> ⛔ **本表刻意不写死行号**（2026-08-17 订正）。此前这里标着 `§R0 … (163–200)`，而活源里 §R0 的标题实测在 **209 行**、漂了 ~46 行 —— 照标注 offset 读会读到 §Lazy Reference Discipline 的尾巴，**静默拿不到 R0**，而本文件自己下面第一条红线逐字写着「漏 R0 Phase 0 是历史最高频回归源」。同句原写的「~1100 行」当时实测 **1512 行**。⇒ 定位一律**现算**：`grep -n '^## ' docs/internal/code-conventions.md` 拿真实行号再按段 Read。\n26\t\n27\t| 起手必读（任务前先吃这些） | 定位（`grep -n '^## '` 现算） |\n28\t|---|---|\n29\t| 本文件顶部 intro + §作用域 + §必读链路 + §与 mockup-conventions 的边界 + §真源关系 | 文件开头到 §Convention Priority Hierarchy 之前 |\n30\t| §Convention Priority Hierarchy（冲突解决总则） | 同名 H2 |\n31\t| §Task Entry Modes + §Pre-Phase 0 + §Lazy Reference Discipline | 三个同名 H2 |\n32\t| §R0 Phase 0 Element-to-Component Mapping（**所有任务前置**） | `## R0 —` 那个 H2 |\n33\t| **§R-DISCIPLINE Rule Execution（起手协议后必跑，所有任务）** — TodoWrite 把「读到的规则」物化成 checklist，防\"读了不执行\" | §R-DISCIPLINE |\n34\t\n35\t| 触发后再读（按场景 jump，不预读） | 触发条件 |\n36\t|---|---|\n37\t| **加新规则前先要号：`pnpm rule:next R`** —— 号从 `origin/master` 算，**别看本地文件的最大号**（本地工作树是会过期的镜像；2026-08-11 PR #9 实证）。撞号由 `audit:rule-number-collision` 在 pre-commit/CI 拦。 | **要往本文件新增带编号的 §R 条目**时 |\n38\t| §R1 / §R15 library-first | 要画 / 写新 UI 元素时 |\n39\t| §R2 token discipline | 要写颜色 / 间距值时 |\n40\t| §R3 mirror canonical | 要做复合组件时 |\n41\t| §R7 4 大场景判断 + §规则适用速查表 | 任务意图未明 / 多场景候选时 |\n42\t| §R8 视觉还原自检 + §R9 静态→交互 + §R10 vector 导出 | R7 场景 1 / 3 / 4 命中后 |\n43\t| §R12 annotation 过滤 + §R16 字符串边界 | 任务涉及 designer 标注 / i18n key 时 |\n44\t| §R13 affordance 搜索 | 要找 chevron / sort / close 等\"基本语义元素\"前 |\n45\t| §R14 layout primitive | 要决定 flex / grid / absolute 时 |\n46\t| §R5 session handoff + §R6 增量复用 + §R4 process | 跨 session 接力 / 改既有产品时 |\n47\t| §R17 | 同一 module 跨页重复 → 抽复用组件提案时 |\n48\t| §R18 | 有参考图 / 截图输入时 |\n49\t| §R19 | 做 selected / active 指示样式时 |\n50\t| §R23 | 做受限容器 / cell 内容溢出处理时 |\n51\t\n52\t**红线**：跳过\"起手必读段\"直接进 R-rule = 协议违反（漏 R0 Phase 0 是历史最高频回归源）。\n53\t\n54\t---\n55\t\n56\t## 必读链路（起手按顺序读）\n57\t\n58\t| 文件 | 内容 | 必读时机 |\n59\t|---|---|---|\n60\t| [`design-process.md`](./design-process.md) | 通用 process 规则 —— **清单见该文件头 `rule-inventory` 块（唯一真源）**，此处不枚举 | **所有任务** |\n61\t| [`domain-tvu.md`](./domain-tvu.md) | TVU 业务规则 —— **清单见该文件头 `rule-inventory` 块** | **所有任务** |\n62\t| 本文件 | Path B 专属：TVU code source 真源关系 / R0 / R1 / R2 / R3 / R4 / R5 / R6 | **所有 Path B 任务** |\n63\t\n64\t---\n65\t\n66\t## 与 mockup-conventions 的边界\n67\t\n68\t| 维度 | mockup-conventions (M1-M20) | code-conventions (R1-R4，本文件) |\n69\t|---|---|---|\n70\t| 操作对象 | Figma 文件 | 前端代码（HTML/Vue/React/...） |\n71\t| 库实证目标 | Figma published library components / icons | `tvu-design-system/dist/icons/svg/` + `src/canonical/` + `src/tokens/variables.css` |\n72\t| 输出 | mockup frame | UI 代码 |\n73\t| 共享原则 | \"Library 优先 + 实证搜索 discipline\" — 两边都是同一原则的不同实例 | 同左 |\n74\t\n75\t**M2**（Figma mockup 不许凭直觉自画组件）和 **R1**（code 不许凭直觉自画 icon）是同源原则在不同 scope 的镜像规则。**它们不能互相替代**——做 mockup 用 M2，写 code 用 R1-R4。\n76\t\n77\t---\n78\t\n79\t## 真源关系（必读 — 影响所有下游判断）\n80\t\n81\t| 层级 | 是什么 | 完整度 |\n82\t|---|---|---|\n83\t| Figma `TVU UX Design System` library（key `lk-057f6ba0...`）| **视觉真源** | 100%（即时反映新设计） |\n84\t| `dist/icons/svg/` + `src/canonical/` + `src/tokens/variables.css` | 该真源的**代码集成** | ~60% 持续 sync |\n85\t\n86\t**关键判断**：代码端 gap **不构成自画许可证**。遇 gap 的正确路径：\n87\t\n88\t1. 当 code 路径（priority 1）miss → fallback MCP `get_design_context` 取 Figma 真源（priority 2）→ 内联使用\n89\t2. 同步登记 [`backlog.md`](./backlog.md) 的 BRIDGE-CODE-ICONS / BRIDGE-CODE-CANONICAL 段作 sync 候选\n90\t3. **Figma library 也 miss 时**才走 R1 / R3 的自画例外条款\n91\t\n92\t> \"code lib 没 sync 故自画\" 是 60% 现实下最高频的反模式。`dist/icons/svg/` 和 `src/canonical/` 不是 truth source，是 truth 的 sync target。\n93\t\n94\t---\n95\t\n96\t## Convention Priority Hierarchy（冲突解决优先级）\n97\t\n98\tTVU 设计规范当前约 60% sync 进度，仍在持续整理。AI 遇规则冲突或 TVU 规范未覆盖的判断时，按此优先级处理：\n99\t\n100\t| 级别 | 来源 | 何时引用 |\n101\t|---|---|---|\n102\t| **P0 最高** | TVU 项目级硬规则 ([`AGENTS.md`](../../AGENTS.md) 硬规则 #1-#N) | 任意 TVU 相关任务 |\n103\t| **P1** | TVU consumption conventions (**本文件全部 R 规则** / [`mockup-conventions.md`](./mockup-conventions.md) **全部 M 规则**) | 消费 TVU 库时 |\n104\t| **P2** | `role-ux` skill UX guidance | Pre-Phase 0 / UX 判断 |\n105\t| **P3 兜底** | 通用 UX heuristics (Nielsen / WCAG / 平台惯例) + AI 训练知识 | TVU 未覆盖的判断 |\n106\t\n107\t### 冲突解决规则\n108\t\n109\t1. **高优先级胜出**：P0 > P1 > P2 > P3\n110\t2. **显式 override 需用户拍板**：AI 不能自作主张用 P3 推翻 P1\n111\t3. **TVU 未规定 → P3 兜底**：例如响应式断点 / 表单 validation 时机 / toast 显示时长 等 TVU 没明说的，AI 用通用 UX 规范，**不停下追问**\n112\t\n113\t### 示例\n114\t\n115\t- **M3 红=Live (P1) vs 通用 UX 红=危险 (P3)** → M3 胜出（broadcasting 行业惯例）\n116\t- **R1 库实证 (P1) vs \"这个图标我快速画一个就行\" (无来源)** → R1 胜出，必须查库\n117\t- **role-ux 说 \"按钮焦点态加 outline\" (P2) vs P3 无强约束** → P2 胜出\n118\t- **R16 / M33 产品 UI 层单语 (P1) vs role-ux \"涉及文案提供中英双语版本\" (P2)** → R16 / M33 胜出：双语只作用于注释 / 交付说明层，产品 UI（dialog title·body / button label / tooltip / menu item）走设备语言单语。⚠️ 上表 P1 行 2026-08-14 前写的是一段**编号区间**，而两边的编号早已长到区间之外（本文件现有 21 条 R 规则，跑 `grep -c '^## R' docs/internal/code-conventions.md` 现取），**R16 ↔ M33 这对镜像恰好落在区间外** —— 于是这条 P1 规则看起来没有级别、与 P2 像是平级冲突（原 INFRA-F124 ③，2026-08-14 落地后删档）。⛔ 别在此处重列编号清单，会再漂一次；真源就是那两份文件本身\n119\t- **TVU 没规定 toast 显示时长** → P3 兜底（成功 2-3s / 错误 5s+ / 永久错误 dismissable）\n120\t\n121\t### Why\n122\t\n123\tTVU 规范持续整理中，**hierarchy 让 AI 在规范不完整时仍能输出合规结果**——TVU 没覆盖的不停下追问按通用 UX 兜底；TVU 已覆盖的不被通用 UX 反推。\n124\t\n125\t---\n126\t\n127\t## Task Entry Modes\n128\t\n129\tAI 接到任务后**先 classify** 再决定走哪条路径：\n130\t\n131\t| ID | 用户表达 | 流程 |\n132\t|---|---|---|\n133\t| **US-1** Greenfield 产品 | \"基于 TVU 设计一个 X 产品，功能大概 ABC...\" | Pre-Phase 0 → R0 → build |\n134\t| **US-2** Greenfield 单页 | \"基于 TVU 给 X 产品画 dashboard 页\" | Pre-Phase 0 (单页 micro 版，可合并 Gate 1+2) → R0 → build |\n135\t| **US-3** Existing product 增 / 改 / 删 | \"MicroApps Console 加/改/删任意页或功能\" | Read handoff → Pre-Phase 0 (仅变化部分) → R0 → build (仅变化部分) |\n136\t| **US-4a** Figma → code visual-fidelity mirror | \"客户/第三方 Figma 按原样还原\" / \"验证 TVU 库够不够\" / \"按这张截图实现\" | R7 场景 1 → 跳过 Pre-Phase 0 → R0 with visual-fidelity priority → build（Figma 视觉为准） |\n137\t| **US-4b** Figma → code TVU-normalize translation | \"用 TVU 实现 Figma X frame\" / \"TVU library Figma 1:1 还原\" / \"用 TVU 规范化这个设计\" | R7 场景 3 → 跳过 Pre-Phase 0 → 从 Figma metadata 反推 element → R0 → build |\n138\t| **US-5** 小调整 (1-2 element) | \"登录按钮换个位置\" | 跳过 Pre-Phase 0 + R0 (R0 trivial 跳过条款) → 直接做 |\n139\t| **US-6** Review / Audit | \"帮我审 X 代码是否符合 TVU 规范\" / \"找出 X 违反的规则\" | 跳过 Pre-Phase 0 + R0 → 对照**本文件全部 R 规则** + Convention Priority 逐条审 → 产 audit report |\n140\t\n141\tClassification 不确定时 → AI **主动问用户**哪种入口，不要默默走错。**特别：US-4 必须 ask 是 4a 还是 4b**（R7 disambiguation 是高频翻车点，详见 R7）。\n142\t\n143\t---\n144\t\n145\t## Pre-Phase 0：Product Definition（前置硬规则）\n146\t\n147\t**触发条件**：用户给的是高层产品 / 页面 brief（如 \"基于 TVU 设计一个 X 产品/页面，功能大概 ABC\"），element 未列出。\n148\t\n149\t**进入时同步 load `role-ux` skill 作为 UX guidance layer** —— Pre-Phase 0 内的功能假设 / UX flow 提案带上 role-ux 的 UX 判断、直播行业惯例、a11y、中英双语文案 discipline。\n150\t\n151\t**不触发**：用户已给完整 element 清单 / 已有 handoff 定义了产品 scope（US-3 沿用现有定义） / Figma frame → code mirror（US-4）。\n152\t\n153\t### 5 步流程（两个用户 gate）\n154\t\n155\t#### Step 1 — AI 提功能假设清单\n156\t- **条数**：由 AI 按产品复杂度自决（简单 3-5 / 中等 6-10 / 复杂 10+），不设硬上限\n157\t- **分层**：核心 (MVP) + 增值 两层\n158\t- **市场参考**：用户没指明则**不主动引**；用户说\"参考市场\"才按同类产品对照（vMix / TriCaster / OBS / LiveU / 行业内同类）\n159\t\n160\t#### ⏸ Gate 1：用户校功能假设\n161\t- 用户可：删 / 改 / 增 / 重排核心 vs 增值\n162\t- 用户确认 MVP scope 后才进 Step 3\n163\t\n164\t#### Step 3 — AI 提 UX flow 草稿\n165\t- **默认格式**：文字 bullet list\n166\t - 用户角色：...\n167\t - 主任务：...\n168\t - 信息架构 / page list：每页一句话核心任务\n169\t - 关键 page-to-page 跳转\n170\t- **复杂产品升级**（≥ 5 页 或 多角色）：ASCII flow diagram 或 Mermaid（用户能渲染时）\n171\t\n172\t#### ⏸ Gate 2：用户校 UX flow\n173\t- 用户可：调整 flow / 增删 page / 调整跳转\n174\t- 用户确认骨架后才进 Step 5\n175\t\n176\t#### Step 5 — AI 按 page list 逐页拆 element → Pre-Phase 0 完成\n177\t- 此时手里：MVP 功能清单 + UX flow + page list + per-page element list\n178\t- 进入 Phase 0 mapping（R0）\n179\t\n180\t### Why\n181\t\n182\t高层 brief 跳过 Pre-Phase 0 直接走 R0 会得到\"基于 TVU 组件凑出来但产品逻辑空洞\"的结果——element 都对，但 flow 没思考 / 角色不清晰 / page 间割裂。Pre-Phase 0 强制 2 个用户 gate 把产品决策权显式还给用户，AI 只做\"基于 brief 做合理提案\"的辅助，**不做\"代用户决定产品做什么\"的越权**。\n183\t\n184\t### 与 role-ux skill 的分工\n185\t\n186\t- `role-ux` skill：独立 UX 咨询角色（用户问\"这个交互怎么设计\"）\n187\t- Pre-Phase 0：workflow 内嵌产品定义阶段，目标输出 element list 喂给 R0\n188\t\n189\t两者**不互相 chain**——用户主动唤 role-ux 时只用 role-ux；用户走 `tvu-design-code` 时 Pre-Phase 0 内嵌做。\n190\t\n191\t---\n192\t\n193\t## Lazy Reference Discipline（按需加载 / 不预加载全量）\n194\t\n195\tTVU library 体积大（647 icons / 49 components / N tokens / canonical 桥层）。**不预加载全量**——按 \"先索引后细节\" 三阶段：\n196\t\n197\t| 阶段 | 加载什么 | 命令示例 |\n198\t|---|---|---|\n199\t| **起手** | conventions 真源（必）+ catalog headers + namespace 目录 | `Read AGENTS.md + code-conventions.md`
`head -60 figma-component-catalog.md`（只看 ### 标题列表）
`ls dist/icons/svg/`（28 个分类目录，已是轻索引） |\n200\t| **Phase 0** | 每 element 按需 grep 具体细节 | `ls dist/icons/svg//` + grep
`grep -A 5 \"^### \" figma-component-catalog.md`
`grep \"\" src/tokens/variables.css` |"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"b1e9a3d6-96df-4494-8b6e-792164797df9","timestamp":"2026-08-25T10:16:26.525Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","content":"# Code Implementation Conventions（Path B — Code）\n\n> 任何 AI 工具**在消费 TVU UX Design System 写代码**时必须遵循的硬约束。\n> 项目级真源；不要在对话或工具私有 memory 里复刻规则。\n>\n> **作用域**：写**前端代码**（HTML / Vue / React / 其它）消费 TVU library 的任何场景——本仓库的 `playground/docs/*` / `src/components/*` / 下游产品 demo（如 `MicroApps Console`）/ 任何 PoC。\n> **不**作用于：Figma mockup（→ 见 [`mockup-conventions.md`](./mockup-conventions.md)）；非 UI 代码（generators / build scripts）。\n>\n> **Enforcement 层级声明（system-review-2026-06-10 INFO-05）**：R-rules 本体是 **L1 AI 行为规则**（写码时自律遵守）；机制强制在 **consumer 侧**——`audit:consumer-code` CLI + eslint-plugin（场景感知接线见 `ds-enforcement-scenarios-spec.md`），DS 仓内对 R-rules **无 commit-time gate（by design**，meta-rules 触发器 K 承认 L1 可接受；DS 自身 .vue 由 audit:design-system / canonical-compliance / lint:ds dogfood 覆盖等价面）。个别 rule 文内出现的 \"L3\" 指其 consumer 侧 CLI/eslint 镜像的层级，不是 DS 仓内层级。\n\n\n> **本文件规则清单 —— 唯一真源**（机械核 `pnpm audit:rule-inventory`；scoped 与 lazy 加载按本清单挑，别处一律只放指针）\n>\n> R0 / R1 / R2 / R3 / R4 / R5 / R6 / R7 / R8 / R9 / R10 / R12 / R14 / R15 / R16 / R13 / R17 / R18 / R19 / R23 / R-DISCIPLINE\n\n\n> ⚠️ **本清单从活源 rule heading 机械派生**（`scripts/lib/rule-ids.mjs`，与 `audit:rule-load-map` / `rule:next` 同源），**按文档物理顺序、非编号顺序** —— `R16` 在 `R13` 之前、`R23` 在 `R19` 之后就是活源里的样子。⛔ 别手抄、别顺手排序。**不含** `R2.1`（H3 子条，折进 `R2`）；本文件另有十余个非规则 H2（§🤖 AI 读取指引 / §Convention Priority Hierarchy 等）不在清单内 —— 清单的语义是「规则」，不是「章节」。\n\n---\n\n## 🤖 AI 读取指引（按需加载，避免全量吞）\n\n本文件很长（现算：`wc -l docs/internal/code-conventions.md`），**不要起手就全量 Read**。按下表只读起手必读段，具体 R-rule jump to 时再读：\n\n> ⛔ **本表刻意不写死行号**（2026-08-17 订正）。此前这里标着 `§R0 … (163–200)`，而活源里 §R0 的标题实测在 **209 行**、漂了 ~46 行 —— 照标注 offset 读会读到 §Lazy Reference Discipline 的尾巴，**静默拿不到 R0**，而本文件自己下面第一条红线逐字写着「漏 R0 Phase 0 是历史最高频回归源」。同句原写的「~1100 行」当时实测 **1512 行**。⇒ 定位一律**现算**：`grep -n '^## ' docs/internal/code-conventions.md` 拿真实行号再按段 Read。\n\n| 起手必读（任务前先吃这些） | 定位（`grep -n '^## '` 现算） |\n|---|---|\n| 本文件顶部 intro + §作用域 + §必读链路 + §与 mockup-conventions 的边界 + §真源关系 | 文件开头到 §Convention Priority Hierarchy 之前 |\n| §Convention Priority Hierarchy（冲突解决总则） | 同名 H2 |\n| §Task Entry Modes + §Pre-Phase 0 + §Lazy Reference Discipline | 三个同名 H2 |\n| §R0 Phase 0 Element-to-Component Mapping（**所有任务前置**） | `## R0 —` 那个 H2 |\n| **§R-DISCIPLINE Rule Execution（起手协议后必跑，所有任务）** — TodoWrite 把「读到的规则」物化成 checklist，防\"读了不执行\" | §R-DISCIPLINE |\n\n| 触发后再读（按场景 jump，不预读） | 触发条件 |\n|---|---|\n| **加新规则前先要号：`pnpm rule:next R`** —— 号从 `origin/master` 算，**别看本地文件的最大号**（本地工作树是会过期的镜像；2026-08-11 PR #9 实证）。撞号由 `audit:rule-number-collision` 在 pre-commit/CI 拦。 | **要往本文件新增带编号的 §R 条目**时 |\n| §R1 / §R15 library-first | 要画 / 写新 UI 元素时 |\n| §R2 token discipline | 要写颜色 / 间距值时 |\n| §R3 mirror canonical | 要做复合组件时 |\n| §R7 4 大场景判断 + §规则适用速查表 | 任务意图未明 / 多场景候选时 |\n| §R8 视觉还原自检 + §R9 静态→交互 + §R10 vector 导出 | R7 场景 1 / 3 / 4 命中后 |\n| §R12 annotation 过滤 + §R16 字符串边界 | 任务涉及 designer 标注 / i18n key 时 |\n| §R13 affordance 搜索 | 要找 chevron / sort / close 等\"基本语义元素\"前 |\n| §R14 layout primitive | 要决定 flex / grid / absolute 时 |\n| §R5 session handoff + §R6 增量复用 + §R4 process | 跨 session 接力 / 改既有产品时 |\n| §R17 | 同一 module 跨页重复 → 抽复用组件提案时 |\n| §R18 | 有参考图 / 截图输入时 |\n| §R19 | 做 selected / active 指示样式时 |\n| §R23 | 做受限容器 / cell 内容溢出处理时 |\n\n**红线**：跳过\"起手必读段\"直接进 R-rule = 协议违反（漏 R0 Phase 0 是历史最高频回归源）。\n\n---\n\n## 必读链路（起手按顺序读）\n\n| 文件 | 内容 | 必读时机 |\n|---|---|---|\n| [`design-process.md`](./design-process.md) | 通用 process 规则 —— **清单见该文件头 `rule-inventory` 块（唯一真源）**，此处不枚举 | **所有任务** |\n| [`domain-tvu.md`](./domain-tvu.md) | TVU 业务规则 —— **清单见该文件头 `rule-inventory` 块** | **所有任务** |\n| 本文件 | Path B 专属：TVU code source 真源关系 / R0 / R1 / R2 / R3 / R4 / R5 / R6 | **所有 Path B 任务** |\n\n---\n\n## 与 mockup-conventions 的边界\n\n| 维度 | mockup-conventions (M1-M20) | code-conventions (R1-R4，本文件) |\n|---|---|---|\n| 操作对象 | Figma 文件 | 前端代码（HTML/Vue/React/...） |\n| 库实证目标 | Figma published library components / icons | `tvu-design-system/dist/icons/svg/` + `src/canonical/` + `src/tokens/variables.css` |\n| 输出 | mockup frame | UI 代码 |\n| 共享原则 | \"Library 优先 + 实证搜索 discipline\" — 两边都是同一原则的不同实例 | 同左 |\n\n**M2**（Figma mockup 不许凭直觉自画组件）和 **R1**（code 不许凭直觉自画 icon）是同源原则在不同 scope 的镜像规则。**它们不能互相替代**——做 mockup 用 M2，写 code 用 R1-R4。\n\n---\n\n## 真源关系（必读 — 影响所有下游判断）\n\n| 层级 | 是什么 | 完整度 |\n|---|---|---|\n| Figma `TVU UX Design System` library（key `lk-057f6ba0...`）| **视觉真源** | 100%（即时反映新设计） |\n| `dist/icons/svg/` + `src/canonical/` + `src/tokens/variables.css` | 该真源的**代码集成** | ~60% 持续 sync |\n\n**关键判断**：代码端 gap **不构成自画许可证**。遇 gap 的正确路径：\n\n1. 当 code 路径（priority 1）miss → fallback MCP `get_design_context` 取 Figma 真源（priority 2）→ 内联使用\n2. 同步登记 [`backlog.md`](./backlog.md) 的 BRIDGE-CODE-ICONS / BRIDGE-CODE-CANONICAL 段作 sync 候选\n3. **Figma library 也 miss 时**才走 R1 / R3 的自画例外条款\n\n> \"code lib 没 sync 故自画\" 是 60% 现实下最高频的反模式。`dist/icons/svg/` 和 `src/canonical/` 不是 truth source，是 truth 的 sync target。\n\n---\n\n## Convention Priority Hierarchy（冲突解决优先级）\n\nTVU 设计规范当前约 60% sync 进度，仍在持续整理。AI 遇规则冲突或 TVU 规范未覆盖的判断时，按此优先级处理：\n\n| 级别 | 来源 | 何时引用 |\n|---|---|---|\n| **P0 最高** | TVU 项目级硬规则 ([`AGENTS.md`](../../AGENTS.md) 硬规则 #1-#N) | 任意 TVU 相关任务 |\n| **P1** | TVU consumption conventions (**本文件全部 R 规则** / [`mockup-conventions.md`](./mockup-conventions.md) **全部 M 规则**) | 消费 TVU 库时 |\n| **P2** | `role-ux` skill UX guidance | Pre-Phase 0 / UX 判断 |\n| **P3 兜底** | 通用 UX heuristics (Nielsen / WCAG / 平台惯例) + AI 训练知识 | TVU 未覆盖的判断 |\n\n### 冲突解决规则\n\n1. **高优先级胜出**：P0 > P1 > P2 > P3\n2. **显式 override 需用户拍板**：AI 不能自作主张用 P3 推翻 P1\n3. **TVU 未规定 → P3 兜底**：例如响应式断点 / 表单 validation 时机 / toast 显示时长 等 TVU 没明说的，AI 用通用 UX 规范，**不停下追问**\n\n### 示例\n\n- **M3 红=Live (P1) vs 通用 UX 红=危险 (P3)** → M3 胜出（broadcasting 行业惯例）\n- **R1 库实证 (P1) vs \"这个图标我快速画一个就行\" (无来源)** → R1 胜出，必须查库\n- **role-ux 说 \"按钮焦点态加 outline\" (P2) vs P3 无强约束** → P2 胜出\n- **R16 / M33 产品 UI 层单语 (P1) vs role-ux \"涉及文案提供中英双语版本\" (P2)** → R16 / M33 胜出：双语只作用于注释 / 交付说明层，产品 UI（dialog title·body / button label / tooltip / menu item）走设备语言单语。⚠️ 上表 P1 行 2026-08-14 前写的是一段**编号区间**，而两边的编号早已长到区间之外（本文件现有 21 条 R 规则，跑 `grep -c '^## R' docs/internal/code-conventions.md` 现取），**R16 ↔ M33 这对镜像恰好落在区间外** —— 于是这条 P1 规则看起来没有级别、与 P2 像是平级冲突（原 INFRA-F124 ③，2026-08-14 落地后删档）。⛔ 别在此处重列编号清单，会再漂一次；真源就是那两份文件本身\n- **TVU 没规定 toast 显示时长** → P3 兜底（成功 2-3s / 错误 5s+ / 永久错误 dismissable）\n\n### Why\n\nTVU 规范持续整理中，**hierarchy 让 AI 在规范不完整时仍能输出合规结果**——TVU 没覆盖的不停下追问按通用 UX 兜底；TVU 已覆盖的不被通用 UX 反推。\n\n---\n\n## Task Entry Modes\n\nAI 接到任务后**先 classify** 再决定走哪条路径：\n\n| ID | 用户表达 | 流程 |\n|---|---|---|\n| **US-1** Greenfield 产品 | \"基于 TVU 设计一个 X 产品，功能大概 ABC...\" | Pre-Phase 0 → R0 → build |\n| **US-2** Greenfield 单页 | \"基于 TVU 给 X 产品画 dashboard 页\" | Pre-Phase 0 (单页 micro 版，可合并 Gate 1+2) → R0 → build |\n| **US-3** Existing product 增 / 改 / 删 | \"MicroApps Console 加/改/删任意页或功能\" | Read handoff → Pre-Phase 0 (仅变化部分) → R0 → build (仅变化部分) |\n| **US-4a** Figma → code visual-fidelity mirror | \"客户/第三方 Figma 按原样还原\" / \"验证 TVU 库够不够\" / \"按这张截图实现\" | R7 场景 1 → 跳过 Pre-Phase 0 → R0 with visual-fidelity priority → build（Figma 视觉为准） |\n| **US-4b** Figma → code TVU-normalize translation | \"用 TVU 实现 Figma X frame\" / \"TVU library Figma 1:1 还原\" / \"用 TVU 规范化这个设计\" | R7 场景 3 → 跳过 Pre-Phase 0 → 从 Figma metadata 反推 element → R0 → build |\n| **US-5** 小调整 (1-2 element) | \"登录按钮换个位置\" | 跳过 Pre-Phase 0 + R0 (R0 trivial 跳过条款) → 直接做 |\n| **US-6** Review / Audit | \"帮我审 X 代码是否符合 TVU 规范\" / \"找出 X 违反的规则\" | 跳过 Pre-Phase 0 + R0 → 对照**本文件全部 R 规则** + Convention Priority 逐条审 → 产 audit report |\n\nClassification 不确定时 → AI **主动问用户**哪种入口，不要默默走错。**特别：US-4 必须 ask 是 4a 还是 4b**（R7 disambiguation 是高频翻车点，详见 R7）。\n\n---\n\n## Pre-Phase 0：Product Definition（前置硬规则）\n\n**触发条件**：用户给的是高层产品 / 页面 brief（如 \"基于 TVU 设计一个 X 产品/页面，功能大概 ABC\"），element 未列出。\n\n**进入时同步 load `role-ux` skill 作为 UX guidance layer** —— Pre-Phase 0 内的功能假设 / UX flow 提案带上 role-ux 的 UX 判断、直播行业惯例、a11y、中英双语文案 discipline。\n\n**不触发**：用户已给完整 element 清单 / 已有 handoff 定义了产品 scope（US-3 沿用现有定义） / Figma frame → code mirror（US-4）。\n\n### 5 步流程（两个用户 gate）\n\n#### Step 1 — AI 提功能假设清单\n- **条数**：由 AI 按产品复杂度自决（简单 3-5 / 中等 6-10 / 复杂 10+），不设硬上限\n- **分层**：核心 (MVP) + 增值 两层\n- **市场参考**：用户没指明则**不主动引**；用户说\"参考市场\"才按同类产品对照（vMix / TriCaster / OBS / LiveU / 行业内同类）\n\n#### ⏸ Gate 1：用户校功能假设\n- 用户可：删 / 改 / 增 / 重排核心 vs 增值\n- 用户确认 MVP scope 后才进 Step 3\n\n#### Step 3 — AI 提 UX flow 草稿\n- **默认格式**：文字 bullet list\n - 用户角色：...\n - 主任务：...\n - 信息架构 / page list：每页一句话核心任务\n - 关键 page-to-page 跳转\n- **复杂产品升级**（≥ 5 页 或 多角色）：ASCII flow diagram 或 Mermaid（用户能渲染时）\n\n#### ⏸ Gate 2：用户校 UX flow\n- 用户可：调整 flow / 增删 page / 调整跳转\n- 用户确认骨架后才进 Step 5\n\n#### Step 5 — AI 按 page list 逐页拆 element → Pre-Phase 0 完成\n- 此时手里：MVP 功能清单 + UX flow + page list + per-page element list\n- 进入 Phase 0 mapping（R0）\n\n### Why\n\n高层 brief 跳过 Pre-Phase 0 直接走 R0 会得到\"基于 TVU 组件凑出来但产品逻辑空洞\"的结果——element 都对，但 flow 没思考 / 角色不清晰 / page 间割裂。Pre-Phase 0 强制 2 个用户 gate 把产品决策权显式还给用户，AI 只做\"基于 brief 做合理提案\"的辅助，**不做\"代用户决定产品做什么\"的越权**。\n\n### 与 role-ux skill 的分工\n\n- `role-ux` skill：独立 UX 咨询角色（用户问\"这个交互怎么设计\"）\n- Pre-Phase 0：workflow 内嵌产品定义阶段，目标输出 element list 喂给 R0\n\n两者**不互相 chain**——用户主动唤 role-ux 时只用 role-ux；用户走 `tvu-design-code` 时 Pre-Phase 0 内嵌做。\n\n---\n\n## Lazy Reference Discipline（按需加载 / 不预加载全量）\n\nTVU library 体积大（647 icons / 49 components / N tokens / canonical 桥层）。**不预加载全量**——按 \"先索引后细节\" 三阶段：\n\n| 阶段 | 加载什么 | 命令示例 |\n|---|---|---|\n| **起手** | conventions 真源（必）+ catalog headers + namespace 目录 | `Read AGENTS.md + code-conventions.md`
`head -60 figma-component-catalog.md`（只看 ### 标题列表）
`ls dist/icons/svg/`（28 个分类目录，已是轻索引） |\n| **Phase 0** | 每 element 按需 grep 具体细节 | `ls dist/icons/svg//` + grep
`grep -A 5 \"^### \" figma-component-catalog.md`
`grep \"\" src/tokens/variables.css` |","numLines":200,"startLine":1,"totalLines":1528}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":100,"estimated_tokens_delta":100,"uuid":"605bf784-c905-44a7-aac5-e48d9a29cd0f","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":50,"uuid":"0484a7fd-c7db-4bc3-8a33-40dbd14351d0","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":300,"estimated_tokens_delta":150,"uuid":"540175dd-8400-4b94-b79b-3a6d6df59ff2","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":400,"estimated_tokens_delta":100,"uuid":"de517217-1c82-4c6e-a029-5e62349c71cf","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHxow9oFAbKamCyDaQ8","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAIS5goKpgEIERgCKkCyNE2StoGxIK/Fwxp6RbHjS6mRuLgEBp3IrDwpjT1T4Zlnpwse2wwkcYbLa9iyoCArG2X9nru7m1XX+qBDF00hMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAYTXtdQGsAECEgyssi7iLKzbxtWtaOwaDAQcpFeMls03JyrQMiIwxr0/WzbwD28fcX9+qq/js0SSUnhG8PUQhZDlR3vgymRwLHm67plHciypVbUed6JFKuwIu8dyniMmlRfvSMy4okcN+QA8FJHutru6MIoNHJY0z7t6B5GQT6KZ+vh+MIm1YhGh1V56p5lQVzWbfTGmccLj0dSf+Q4wexhY9lc4Yc8MPsZg/p5W4BHDUG1W8uC4shQlsR0kGpUthJRmM2BGs94ehQfYXWiux/KUjtfcPdOjQuFjziKzKbYXHPtFxKG0vE9JsKMYYewOgVYdwYhhpFvtTx9tI1Y7h+omsrOvmkkCRpqaR1KIFyKVCK/az/hhl5PGMWpyDKo9XeT78Zy8MTcijN0TxUJKEpCSrK1dTEoCXRDEJpDq3G6141Sma53oqLlmLkS/WcMqwlecanGa36EANKYyUW9ESVNQAQu2BiAS6zh7RwHkfwLylypJbPFbP9T1kZ8iJU1Cdp4R3lYctXIgpNwAO2GyRjE7SZ/pTvF2ZdmAZrzrc1VCHhrhfx0sqxWHGpgcr4GKSFZZZ/XKgLU6fs0dH09hlKe5NkEcixDk5aB71zG7mL5VoaxgyKPcsQzHvTWVtPCz2QOAIfyA7+pRgpmBG1ZyTsfJfXd/1buWPiof43MlWcj6/KU2ZBZUfd8FJefuxpguZ7xVY6+RBKtUpoU8vrgHs/j+ccJ/7DQYKV+I21GnfSNFSyqUy77W8LUCFcMFg0H4OKF6CVlc3eQNTjrrRN5k1gVb55VJFu4++ybz5TdVUNNCHK6BdFCpRi/YTwGGAKPI3jyBaIQchF6mtGv1z3AZj/TmNdDsfipNVqc5Za19X61uh7GXct+xGm51GcaelcGHsUB79l6ABDJNejA6d0J9/8grUwThjY5gNEPhE7Ag3RUAh/mE7Xd++ZIjA97mx55yvu2pAPuP527gucr0O3P3mjsuBjOM0ZO4eTuRy7FSjBmrBT3TOtljySPhuDkgEQ7bJXPHXzvg7E+9Z5YMFOpSpmbfUJf78RNLnKaunF7bQldw51FAOfi9+zoo1K+vT2q5ihkOFsB1RggiFwaw4qdUcyswl6KrsfZsUYbaiPZSQuxs5BDCv1PUfMoeV28/NL9pR4EWZBOrvN4JoJu+hiuwlSEwJeEffSshR41BIUeTjXhc98hWcCIiiBdHfyl0AJjtCdcmudqMdDhtt7qsf0uNi+9W6P/P/aTYuYWbk31p4bAvFyXEbdQqNrYBSc39PG6KYAfz6KZBhRFStWAvPB+/HuR8j5sCPNKiPkhffdmhokHrXb5MfmDVOhOWL0tzUZQFARYgV/yj4lnIyMMEfUfXJqd6wQsbgNVArkEDBFsdniRzJ5WrFCt1pM0BZc6HAYwtBhlzIJgkUZrX0HbXL7LRtEuTe2aShdVXn5nYK1fPSmwTn77WtKgZR+XQJ7HIU3gjenVwAcfzZfv76Kr2NfZBRkTWHTqwJ4MDefptnSMX/ACO8vTFZ0yh3v10Hut8WSoDJHrY6UviowAW7L6KAcseHI/benhHmxyXTWkIWLXxHH9QsN5MgTNvxECCJHNB3jqHxDUibHm6C4EDSFQSg90NGtzLZNfN2RgB"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":8023,"cache_read_input_tokens":123153,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":8023},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"af56449a-2534-4c3b-8701-695343291191","timestamp":"2026-08-25T10:16:36.610Z","request_id":"req_011CePHxjspkn8BjBNzRUYVW"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHxow9oFAbKamCyDaQ8","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_017uJug2fWKpF2SDJnVQXMHq","name":"Grep","input":{"pattern":"^## ","path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","output_mode":"content","-n":true},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":8023,"cache_read_input_tokens":123153,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":8023},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"5148b9cc-3913-4e13-9e97-dd44850815da","timestamp":"2026-08-25T10:16:38.484Z","request_id":"req_011CePHxjspkn8BjBNzRUYVW"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_017uJug2fWKpF2SDJnVQXMHq","type":"tool_result","content":"21:## 🤖 AI 读取指引（按需加载，避免全量吞）\n56:## 必读链路（起手按顺序读）\n66:## 与 mockup-conventions 的边界\n79:## 真源关系（必读 — 影响所有下游判断）\n96:## Convention Priority Hierarchy（冲突解决优先级）\n127:## Task Entry Modes\n145:## Pre-Phase 0：Product Definition（前置硬规则）\n193:## Lazy Reference Discipline（按需加载 / 不预加载全量）\n211:## R0 — Phase 0：Element-to-Component Mapping（前置硬规则）\n249:## R1 — 图标必须从 TVU library 取（不准内联自画 SVG）\n259:## R2 — 颜色必须用 TVU token，不写 hex literal\n294:## R3 — 复合组件优先 mirror TVU canonical\n304:## R4 — 不\"先实现，再问要不要换库\"\n317:## Acceptance criteria（build 自审）\n329:## R5 — Session Handoff Convention（跨 session 任务接力）\n338:## 1. Context\n341:## 2. 必读 onboarding 顺序\n348:## 3. Current State\n358:## 4. 已知 gap（按严重度排序）\n361:## 5. 下一步优先级\n364:## 6. Quick-start prompt（可直接 copy 到新 session）\n371:## 7. Phase 0 ledger entry（Wrap-up checklist）\n399:## R6 — 已建立产品的增量优先复用 local\n448:## R7 — 任务意图 disambiguate：4 大场景判断（起手必判）\n597:## 规则适用速查表（按 R7 场景查 R7-R10 + meta + 工具）\n648:## R8 — 视觉还原任务自检 protocol（场景 1 / 3 / 4 强制；enforcement L3）\n741:## R9 — Static-to-Interactive Augmentation Protocol（场景 1 / 3 强制；enforcement L1，v2 待升 L3）\n871:## R10 — Vector 元素导出策略决策（场景 1 / 3 / 4 强制；enforcement L1，v2 待升 L3）\n953:## R12 — Designer Annotation 过滤（场景 1 / 3 / 4 强制；enforcement L3）\n995:## R14 — Layout Primitive Selection（code-side mirror of M31）\n1030:## R15 — Library-First for All Product UI Elements（code-side mirror of M32；R1 + R3 扩展）\n1082:## R16 — Annotation vs Product UI String Boundary（code-side mirror of M33）\n1146:## R13 — Affordance-Category Search Discipline（code-side mirror of M35）\n1254:## 关联文档\n1263:## R17 — Multi-page module reuse → file-local component → library promotion audit（code-side mirror of M36）\n1284:## R18 — Reference-image probe before implementation（code-side mirror of M37）\n1315:## R19 — Selected indicator CSS spec（code-side mirror of M38）\n1358:## R23 — Constrained-Cell Text Overflow（code-side mirror of M43）— 2026-05-27 新增\n1467:## R-DISCIPLINE — Rule Execution Discipline（code-side mirror of M-DISCIPLINE）— 2026-06-01 新增\n1523:## AI 工具集成"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"e480a7c8-7366-4cf1-bcd8-f980609e4011","timestamp":"2026-08-25T10:16:38.511Z","tool_use_result":{"mode":"content","numFiles":0,"filenames":[],"content":"21:## 🤖 AI 读取指引（按需加载，避免全量吞）\n56:## 必读链路（起手按顺序读）\n66:## 与 mockup-conventions 的边界\n79:## 真源关系（必读 — 影响所有下游判断）\n96:## Convention Priority Hierarchy（冲突解决优先级）\n127:## Task Entry Modes\n145:## Pre-Phase 0：Product Definition（前置硬规则）\n193:## Lazy Reference Discipline（按需加载 / 不预加载全量）\n211:## R0 — Phase 0：Element-to-Component Mapping（前置硬规则）\n249:## R1 — 图标必须从 TVU library 取（不准内联自画 SVG）\n259:## R2 — 颜色必须用 TVU token，不写 hex literal\n294:## R3 — 复合组件优先 mirror TVU canonical\n304:## R4 — 不\"先实现，再问要不要换库\"\n317:## Acceptance criteria（build 自审）\n329:## R5 — Session Handoff Convention（跨 session 任务接力）\n338:## 1. Context\n341:## 2. 必读 onboarding 顺序\n348:## 3. Current State\n358:## 4. 已知 gap（按严重度排序）\n361:## 5. 下一步优先级\n364:## 6. Quick-start prompt（可直接 copy 到新 session）\n371:## 7. Phase 0 ledger entry（Wrap-up checklist）\n399:## R6 — 已建立产品的增量优先复用 local\n448:## R7 — 任务意图 disambiguate：4 大场景判断（起手必判）\n597:## 规则适用速查表（按 R7 场景查 R7-R10 + meta + 工具）\n648:## R8 — 视觉还原任务自检 protocol（场景 1 / 3 / 4 强制；enforcement L3）\n741:## R9 — Static-to-Interactive Augmentation Protocol（场景 1 / 3 强制；enforcement L1，v2 待升 L3）\n871:## R10 — Vector 元素导出策略决策（场景 1 / 3 / 4 强制；enforcement L1，v2 待升 L3）\n953:## R12 — Designer Annotation 过滤（场景 1 / 3 / 4 强制；enforcement L3）\n995:## R14 — Layout Primitive Selection（code-side mirror of M31）\n1030:## R15 — Library-First for All Product UI Elements（code-side mirror of M32；R1 + R3 扩展）\n1082:## R16 — Annotation vs Product UI String Boundary（code-side mirror of M33）\n1146:## R13 — Affordance-Category Search Discipline（code-side mirror of M35）\n1254:## 关联文档\n1263:## R17 — Multi-page module reuse → file-local component → library promotion audit（code-side mirror of M36）\n1284:## R18 — Reference-image probe before implementation（code-side mirror of M37）\n1315:## R19 — Selected indicator CSS spec（code-side mirror of M38）\n1358:## R23 — Constrained-Cell Text Overflow（code-side mirror of M43）— 2026-05-27 新增\n1467:## R-DISCIPLINE — Rule Execution Discipline（code-side mirror of M-DISCIPLINE）— 2026-06-01 新增\n1523:## AI 工具集成","numLines":40,"totalLines":40}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"c4b9ece8-64b2-4475-863c-376e6f165243","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"b620fbdb-2478-43a9-98bc-caf4dcd0ea27","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":181,"estimated_tokens_delta":31,"uuid":"f40d4049-81ef-4c39-b4bc-e4aeb40144c9","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHyiQ3hMuwM3SCUnu5R","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISywUKpgEIERgCKkC3d89n0HgCBUcrIwzh6uYnwePMjsmebA9MiglLMlSUvF8Lv9otXplBUElCtdq8iXMePNZ/2/P+veeoZpRN0RceMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAY7XtdQGsAECEgyxmlnKAHWWTztqwDgaDMzuMhNcLYu6nu0ZBiIwBFVdpqLg8JxqyXtTRsmBUyqPOA6k3m0Imkum+AO12fnZnFRD7TQLYy3L760Z4E1PKtEDOczwQgzYoYd+i3sy85INlDEygcj/R5ZFceEnMGtG0W5ako0MH+02kot7EisINsP/J7/LCE+OCf8Y86wJ+GoySDOgyahSe5zrGAIr9dsQeAeP4DknOFCdIYAIIDqU6nGJHtWeeO2SiyGl3e7Mja6HcxTtI8DZ6mZj++wGdYzQbWvtfxb3x4POe05pBFtKUVqwyyHseJ6oVqblZJMjlhLxG1qlOFPUdXDH16x30zzeGQIfGWlCt34vaBqo70dXmhHI2cve5luTYLB0Pn7eBzIUjIwncC8HU8R13Cs7pSWyMuWvUlX47XTzSie/wM3x8jZ85bjHhxexHv5Ozd/x0ANGQBxL514bVPLR0j0hzWsBTTCWPjbtpvehvGKgb1ZdMipHyhnnyx8v9ANCWoQDpmNrYp14nQzPlw4XDy9o3vXTtUvoFl2XDGIXlIcIS0QsitVrIU+FUxfibGYeH8UfKW0pIr7ejzFrikzfohISj5ZaUeMdgROSin1gDjDGjyQziaPQo4P9/wVo6eHPjSC14x38BuyID2JVoMQNOrFEGoKuVmoCYLmR9LjZHRxqJb4weqSBtMtkEbRXd/Zz0cuiijtCEFKvULORSUm1ce7yE+Lrtqs1GAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1806,"cache_read_input_tokens":131176,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1806},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"340af29f-749a-42da-b076-8cacbe869514","timestamp":"2026-08-25T10:16:46.373Z","request_id":"req_011CePHycxNxkZuEQb4gVXYi"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHyiQ3hMuwM3SCUnu5R","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01KiJCED8Pn2McZf1vh3dduA","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","offset":211,"limit":120},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1806,"cache_read_input_tokens":131176,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1806},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"8b8c17b3-9f6c-4d52-94c8-1967c20502e5","timestamp":"2026-08-25T10:16:47.776Z","request_id":"req_011CePHycxNxkZuEQb4gVXYi"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01KiJCED8Pn2McZf1vh3dduA","type":"tool_result","content":"211\t## R0 — Phase 0：Element-to-Component Mapping（前置硬规则）\n212\t\n213\t任务涉及 **≥ 3 个 element** 时**必须**在写代码前先产出 mapping table。trivial 1–2 element 任务可省。\n214\t\n215\t### 输入\n216\t\n217\t用户的需求清单 / 元素列表（用户给或 AI 从需求拆解）。\n218\t\n219\t### Lookup 序列（按序）\n220\t\n221\t1. **grep [`figma-component-catalog.md`](./figma-component-catalog.md)** — 拿 Figma component_set key + variants + Primary use / Extension / Don't use；每个 element 至少 2-3 个同义词 / casing 变体试\n222\t2. **grep [`figma-data/figma-to-code-mapping.json`](../../figma-data/figma-to-code-mapping.json)** — Figma name → code name + status\n223\t3. **grep `src/canonical/`** — canonical 桥层是否存在\n224\t4. **grep `dist/icons/svg/`** — icon SVG 是否已 sync\n225\t5. **catalog miss 时** → MCP `search_design_system` + `get_design_context`（priority 2 fallback）\n226\t\n227\t### 输出格式（mandatory 4 列 table）\n228\t\n229\t| Element | Figma component_set (key + variants) | Code path | 状态 |\n230\t|---|---|---|---|\n231\t| top bar | `Top bar` (`918b928e...`, Tag=AfterLogin/BeforeLogin) | `src/canonical/TopBar.vue` | ✅ sync |\n232\t| status badge | `Badge` (`4db5246d...`, Type/Color/Tag) | canonical 缺 → Figma fallback | 🟡 sync gap → BRIDGE-CODE-CANONICAL |\n233\t| live icon | `indicator/live-1` | `dist/icons/svg/indicator/live-1__1133_22954.svg` | ✅ sync |\n234\t| (假想真无) | catalog + MCP search 全 miss | n/a | ⚠️ 真 gap → 用户拍板自画 + BRIDGE-CODE-ICONS |\n235\t\n236\t### 处理流程\n237\t\n238\t1. AI 产出整张 table\n239\t2. 把 table 发给用户校验（用户纠正误读 / 补充遗漏 / 一次性决策 gap 处理）\n240\t3. 用户确认后才开始写代码\n241\t4. build 过程中若发现新 element 没在 table 里 → **回到 Phase 0** 补一行，**禁止**现场判断\"library 缺件\"\n242\t\n243\t### Why\n244\t\n245\t反应式（边写边查）模式下，gap 分散在过程里 → 用户无法预审 → 容易现场误判走自画（R1 / M2 反模式同根）。前置 mapping 让所有 gap 一次暴露，用户一次决策（接受 Figma fallback / 暂停补 sync / 拍板自画），同时把 `figma-component-catalog.md` 系统性 exercise（🟡 skeleton 顺手回填升级 ✅ verified）。\n246\t\n247\t---\n248\t\n249\t## R1 — 图标必须从 TVU library 取（不准内联自画 SVG）\n250\t\n251\t> **⚠️ Merged into [R15](#r15--library-first-for-all-product-ui-elementscode-side-mirror-of-m32r1--r3-扩展)** as the icon sub-clause (R15 §icons). R15 is the umbrella for all product UI elements (icons + buttons + inputs + modals + ...); R1 was the icon-specific subset and is now absorbed.\n252\t>\n253\t> The 12-row anti-pattern table (2026-05-11 MicroApps Console retrospective) + R1 例外条款（自画唯一允许场景）+ Affordance synonym expansion are preserved in R15 §icons + carried by R13 (Affordance-Category Search) which generalizes synonym expansion.\n254\t>\n255\t> This anchor is preserved for legacy reference.\n256\t\n257\t---\n258\t\n259\t## R2 — 颜色必须用 TVU token，不写 hex literal\n260\t\n261\t- 取数路径：`tvu-design-system/src/tokens/variables.css` 全部 `--*` 变量\n262\t- 写代码时：CSS 用 `var(--brand)` / `var(--bg-layer1)` 等；不写 `#2fb54e` / `#141414`\n263\t- Token 缺失场景：先确认是 Figma 真源缺还是 sync 缺；如果是真源缺 → 用户拍板新建 + 同步 figma-data。**绝不直接 hardcode hex**\n264\t\n265\t同 [`AGENTS.md`](../../AGENTS.md) 硬规则 #4 (\"颜色硬编码 = bug\")。\n266\t\n267\t### R2.1 — 对外分享的独立页面同样受 R2 约束，且要整体像 TVU（owner 立规 2026-08-11）\n268\t\n269\t「分享类文档」= 会发给团队之外或不进仓库的人看的独立页面（当前实例：随文档站发布、免登录可读的\n270\t`playground/public/onboarding.html`）。**它们不是 R2 的例外，反而是最该守的一档** —— 它是别人看到\n271\t这套设计系统的第一眼，而且不经过组件层兜底，写歪了没人替它兜。\n272\t\n273\t不只是颜色，整体观感要落在设计系统里：\n274\t\n275\t| 维度 | 怎么取 |\n276\t|---|---|\n277\t| 颜色 / 层次 | `--bg-layer1` 页面底 · `--bg-layer2/3` 抬升面 · `--line-light` 描边 · `--brand` 强调（跟随 `playground/docs/docs.css` 已确立的用法，别自创一套） |\n278\t| 间距 / 圆角 | `--sp-*` / `--r-*`，不写裸 px |\n279\t| 字阶 | `--font-size-*` + `--line-height-*` 配对使用 |\n280\t| 主题 | **深色是设计系统默认**；浅色走 ``，不要自己写 `prefers-color-scheme` 配色表 |\n281\t| 断点 / 容器宽 | `--bp-*` / `--container-*`（否则会被 `audit:layout-tokens` 判为 off-scale） |\n282\t\n283\t**token 怎么进到一个自包含页面**：不要手抄色值。构建时由 `vite.playground.config.ts` 的\n284\t`copyDesignTokensPlugin` 把 `src/tokens/variables.css` 原样拷成 `playground-dist/tvu-tokens.css`，\n285\t页面 `` 它即可 —— 真源只有一份，token 一改页面跟着变。\n286\t\n287\t**Enforcement**：`audit:no-hardcoded-design-tokens` 的扫描面已含 `playground/public/**/*.html`\n288\t（2026-08-11 扩面）。裸 hex 命中 token 值 → **阻塞**；无对应 token 的字面量 → report-only。\n289\t⚠️ 设计系统**没有等宽字体 token**（只有 base/en/zh/clock），页面局部定义 mono 字体栈是允许的，\n290\t但仅限字体族，不得借此夹带颜色。\n291\t\n292\t---\n293\t\n294\t## R3 — 复合组件优先 mirror TVU canonical\n295\t\n296\t- 取数路径：`tvu-design-system/src/canonical/*.vue`（Vue + canonical 桥层）\n297\t- 能直接消费（npm install） → 直接用\n298\t- 不能消费（如单 HTML demo，无构建链）→ **手写 1:1 mirror canonical 的 props / events / slots / 视觉**；不要按自己理解重新设计 API\n299\t- 决策来源必须可追溯到 canonical spec（API / 视觉）\n300\t- **canonical 还没桥但 Figma library 有** → 用 Figma MCP `get_design_context` 拿 spec → mirror Figma 输出的 React+Tailwind reference（按目标项目栈适配）→ 同步登记 [`backlog.md`](./backlog.md) \"BRIDGE-CODE-CANONICAL\" 段（暂不存在则新建）作 sync 候选；**不**视为 \"library 缺件\" → **不**走自画路径\n301\t\n302\t---\n303\t\n304\t## R4 — 不\"先实现，再问要不要换库\"\n305\t\n306\t库实证是 implementation 的**前置**，不是 nice-to-have：\n307\t\n308\t- 起步第一动作：`ls /Users/nancy/Documents/AICoding/VS_Code/tvu-design-system/dist/icons/svg/` 拿到全库 SVG catalog\n309\t- 每写一个 icon → 先 grep 这个目录\n310\t- 每写一个颜色 → 先 grep `src/tokens/variables.css`\n311\t- 每写一个复合组件 → 先 grep `src/canonical/`\n312\t\n313\t**Why:** \"先按印象实现，让用户审\" 这种 anti-pattern 把 review burden 推给用户，违反 [`docs/meta-rules.md`](../meta-rules.md) 反模式清单。\n314\t\n315\t---\n316\t\n317\t## Acceptance criteria（build 自审）\n318\t\n319\t任何 implementation PR 完工前，作者必须答得出：\n320\t\n321\t- 自画 SVG icon 数量？每个有库实证证据吗（搜索词 + 结果）？\n322\t- 用了多少 hex literal？token 化了吗？\n323\t- 复合组件 mirror 自哪个 canonical？API 差异有登记吗（如 prop name 不同应进 `src/design-system/translation/`）？\n324\t\n325\t任一条答不出 → 不可宣布\"完成\"，必须返工。\n326\t\n327\t---\n328\t\n329\t## R5 — Session Handoff Convention（跨 session 任务接力）\n330\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"d5c51851-6152-4020-9aa3-ff24c11bdae0","timestamp":"2026-08-25T10:16:47.783Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","content":"## R0 — Phase 0：Element-to-Component Mapping（前置硬规则）\n\n任务涉及 **≥ 3 个 element** 时**必须**在写代码前先产出 mapping table。trivial 1–2 element 任务可省。\n\n### 输入\n\n用户的需求清单 / 元素列表（用户给或 AI 从需求拆解）。\n\n### Lookup 序列（按序）\n\n1. **grep [`figma-component-catalog.md`](./figma-component-catalog.md)** — 拿 Figma component_set key + variants + Primary use / Extension / Don't use；每个 element 至少 2-3 个同义词 / casing 变体试\n2. **grep [`figma-data/figma-to-code-mapping.json`](../../figma-data/figma-to-code-mapping.json)** — Figma name → code name + status\n3. **grep `src/canonical/`** — canonical 桥层是否存在\n4. **grep `dist/icons/svg/`** — icon SVG 是否已 sync\n5. **catalog miss 时** → MCP `search_design_system` + `get_design_context`（priority 2 fallback）\n\n### 输出格式（mandatory 4 列 table）\n\n| Element | Figma component_set (key + variants) | Code path | 状态 |\n|---|---|---|---|\n| top bar | `Top bar` (`918b928e...`, Tag=AfterLogin/BeforeLogin) | `src/canonical/TopBar.vue` | ✅ sync |\n| status badge | `Badge` (`4db5246d...`, Type/Color/Tag) | canonical 缺 → Figma fallback | 🟡 sync gap → BRIDGE-CODE-CANONICAL |\n| live icon | `indicator/live-1` | `dist/icons/svg/indicator/live-1__1133_22954.svg` | ✅ sync |\n| (假想真无) | catalog + MCP search 全 miss | n/a | ⚠️ 真 gap → 用户拍板自画 + BRIDGE-CODE-ICONS |\n\n### 处理流程\n\n1. AI 产出整张 table\n2. 把 table 发给用户校验（用户纠正误读 / 补充遗漏 / 一次性决策 gap 处理）\n3. 用户确认后才开始写代码\n4. build 过程中若发现新 element 没在 table 里 → **回到 Phase 0** 补一行，**禁止**现场判断\"library 缺件\"\n\n### Why\n\n反应式（边写边查）模式下，gap 分散在过程里 → 用户无法预审 → 容易现场误判走自画（R1 / M2 反模式同根）。前置 mapping 让所有 gap 一次暴露，用户一次决策（接受 Figma fallback / 暂停补 sync / 拍板自画），同时把 `figma-component-catalog.md` 系统性 exercise（🟡 skeleton 顺手回填升级 ✅ verified）。\n\n---\n\n## R1 — 图标必须从 TVU library 取（不准内联自画 SVG）\n\n> **⚠️ Merged into [R15](#r15--library-first-for-all-product-ui-elementscode-side-mirror-of-m32r1--r3-扩展)** as the icon sub-clause (R15 §icons). R15 is the umbrella for all product UI elements (icons + buttons + inputs + modals + ...); R1 was the icon-specific subset and is now absorbed.\n>\n> The 12-row anti-pattern table (2026-05-11 MicroApps Console retrospective) + R1 例外条款（自画唯一允许场景）+ Affordance synonym expansion are preserved in R15 §icons + carried by R13 (Affordance-Category Search) which generalizes synonym expansion.\n>\n> This anchor is preserved for legacy reference.\n\n---\n\n## R2 — 颜色必须用 TVU token，不写 hex literal\n\n- 取数路径：`tvu-design-system/src/tokens/variables.css` 全部 `--*` 变量\n- 写代码时：CSS 用 `var(--brand)` / `var(--bg-layer1)` 等；不写 `#2fb54e` / `#141414`\n- Token 缺失场景：先确认是 Figma 真源缺还是 sync 缺；如果是真源缺 → 用户拍板新建 + 同步 figma-data。**绝不直接 hardcode hex**\n\n同 [`AGENTS.md`](../../AGENTS.md) 硬规则 #4 (\"颜色硬编码 = bug\")。\n\n### R2.1 — 对外分享的独立页面同样受 R2 约束，且要整体像 TVU（owner 立规 2026-08-11）\n\n「分享类文档」= 会发给团队之外或不进仓库的人看的独立页面（当前实例：随文档站发布、免登录可读的\n`playground/public/onboarding.html`）。**它们不是 R2 的例外，反而是最该守的一档** —— 它是别人看到\n这套设计系统的第一眼，而且不经过组件层兜底，写歪了没人替它兜。\n\n不只是颜色，整体观感要落在设计系统里：\n\n| 维度 | 怎么取 |\n|---|---|\n| 颜色 / 层次 | `--bg-layer1` 页面底 · `--bg-layer2/3` 抬升面 · `--line-light` 描边 · `--brand` 强调（跟随 `playground/docs/docs.css` 已确立的用法，别自创一套） |\n| 间距 / 圆角 | `--sp-*` / `--r-*`，不写裸 px |\n| 字阶 | `--font-size-*` + `--line-height-*` 配对使用 |\n| 主题 | **深色是设计系统默认**；浅色走 ``，不要自己写 `prefers-color-scheme` 配色表 |\n| 断点 / 容器宽 | `--bp-*` / `--container-*`（否则会被 `audit:layout-tokens` 判为 off-scale） |\n\n**token 怎么进到一个自包含页面**：不要手抄色值。构建时由 `vite.playground.config.ts` 的\n`copyDesignTokensPlugin` 把 `src/tokens/variables.css` 原样拷成 `playground-dist/tvu-tokens.css`，\n页面 `` 它即可 —— 真源只有一份，token 一改页面跟着变。\n\n**Enforcement**：`audit:no-hardcoded-design-tokens` 的扫描面已含 `playground/public/**/*.html`\n（2026-08-11 扩面）。裸 hex 命中 token 值 → **阻塞**；无对应 token 的字面量 → report-only。\n⚠️ 设计系统**没有等宽字体 token**（只有 base/en/zh/clock），页面局部定义 mono 字体栈是允许的，\n但仅限字体族，不得借此夹带颜色。\n\n---\n\n## R3 — 复合组件优先 mirror TVU canonical\n\n- 取数路径：`tvu-design-system/src/canonical/*.vue`（Vue + canonical 桥层）\n- 能直接消费（npm install） → 直接用\n- 不能消费（如单 HTML demo，无构建链）→ **手写 1:1 mirror canonical 的 props / events / slots / 视觉**；不要按自己理解重新设计 API\n- 决策来源必须可追溯到 canonical spec（API / 视觉）\n- **canonical 还没桥但 Figma library 有** → 用 Figma MCP `get_design_context` 拿 spec → mirror Figma 输出的 React+Tailwind reference（按目标项目栈适配）→ 同步登记 [`backlog.md`](./backlog.md) \"BRIDGE-CODE-CANONICAL\" 段（暂不存在则新建）作 sync 候选；**不**视为 \"library 缺件\" → **不**走自画路径\n\n---\n\n## R4 — 不\"先实现，再问要不要换库\"\n\n库实证是 implementation 的**前置**，不是 nice-to-have：\n\n- 起步第一动作：`ls /Users/nancy/Documents/AICoding/VS_Code/tvu-design-system/dist/icons/svg/` 拿到全库 SVG catalog\n- 每写一个 icon → 先 grep 这个目录\n- 每写一个颜色 → 先 grep `src/tokens/variables.css`\n- 每写一个复合组件 → 先 grep `src/canonical/`\n\n**Why:** \"先按印象实现，让用户审\" 这种 anti-pattern 把 review burden 推给用户，违反 [`docs/meta-rules.md`](../meta-rules.md) 反模式清单。\n\n---\n\n## Acceptance criteria（build 自审）\n\n任何 implementation PR 完工前，作者必须答得出：\n\n- 自画 SVG icon 数量？每个有库实证证据吗（搜索词 + 结果）？\n- 用了多少 hex literal？token 化了吗？\n- 复合组件 mirror 自哪个 canonical？API 差异有登记吗（如 prop name 不同应进 `src/design-system/translation/`）？\n\n任一条答不出 → 不可宣布\"完成\"，必须返工。\n\n---\n\n## R5 — Session Handoff Convention（跨 session 任务接力）\n","numLines":120,"startLine":211,"totalLines":1528}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHyiQ3hMuwM3SCUnu5R","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01FUqwzBEhrKXugJDhjPePrb","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","offset":448,"limit":200},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1806,"cache_read_input_tokens":131176,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1806},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"cf809258-2912-4c54-9e82-3da3ac8390e5","timestamp":"2026-08-25T10:16:48.010Z","request_id":"req_011CePHycxNxkZuEQb4gVXYi"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01FUqwzBEhrKXugJDhjPePrb","type":"tool_result","content":"448\t## R7 — 任务意图 disambiguate：4 大场景判断（起手必判）\n449\t\n450\t### 触发背景\n451\t\n452\tTVU library 60% sync 现实下，消费侧任务的**视觉真源未必是 TVU library**：\n453\t\n454\t- Figma 效果图可能是 pre-design-system 时代 / 第三方 / 客户提供，不符合 TVU 规范\n455\t- 用户拿 Figma 来\"验证 TVU 库覆盖度\"而**不**想做 TVU 化重构\n456\t- Existing product 本地已有非 TVU 组件，新增量不应越界做 silent compliance fix\n457\t\n458\tAI 默认走 \"Figma → TVU mapping → 用 TVU 替换\" 会在用户只想 1:1 还原时**过度规范化**——把原本应保留的视觉强行变成 TVU 版本。\n459\t\n460\t### 4 大场景 + 判断维度\n461\t\n462\t任务起手时（在 R0 Phase 0 mapping 之前），AI 必须**显式 disambiguate 用户意图**，归到 4 大场景之一：\n463\t\n464\t| 场景 | 名字 | 视觉真源 | 产品状态 | 任务性质 | TVU 库角色 | 路径要点 |\n465\t|---|---|---|---|---|---|---|\n466\t| **场景 1** | 非 TVU 视觉还原 | Figma / 截图 / 草图 本身 | 任意 | 新建（按视觉还原）| 软建议，命中即用，**不**强推替换 | R0 mapping 每行标 \"visual-fidelity priority\"；缺件按 Figma 原样实现（hex / 自画 SVG / 非 canonical 组件允许）；标 sync 候选；**不**走 R1/R2 例外授权流程 |\n467\t| **场景 2** | 已有产品增量 | 已有产品视觉惯例（含已 sync 的 TVU + local + 已用 token） | 已有产品 | 增量 / 迭代 | element 级决策：local 有用 local，local 没用 TVU | R6 决策树：local > TVU > 自写；**不**借机修 pre-design-system 合规债 |\n468\t| **场景 3** | 全新产品 TVU 构建 | TVU library | greenfield | 新建 | 强约束（priority 1） | R0 + R1/R2/R3 全套；gap 走 fallback 链（code → MCP Figma → 自画例外） |\n469\t| **场景 4** | TVU 规范校正 | TVU library | 任意（多数已有产品）| 重构 / 校正 | 强约束（priority 1） | 独立 refactor 任务，需用户**显式发起**，不混在增量任务里 |\n470\t\n471\t### 场景 2 视觉真源细化（element-level + 成熟度光谱）\n472\t\n473\t场景 2 不是\"禁用 TVU\"——而是**逐 element 判断**，TVU 库经常会用、且应该用：\n474\t\n475\t| element 状况 | 决策 |\n476\t|---|---|\n477\t| ✅ local 有 + ✅ TVU 也有 | **优先 local**（避免跨页面割裂） |\n478\t| ❌ local 没 + ✅ TVU 有 | **用 TVU** ← 完全合法且鼓励 |\n479\t| ❌ local 没 + ❌ TVU 没 | **自写候选**（走 R0 / R1 例外，需用户授权 + 登记 backlog） |\n480\t| ⚠️ local 有但旧/不规范 + ✅ TVU 有新版 | **仍用 local**（除非用户显式说\"用 TVU 替换\"）— pre-design-system 不视为 bug |\n481\t\n482\t产品 TVU 化成熟度光谱（不改变规则，仅影响新增 element 多数走哪）：\n483\t\n484\t| 产品 TVU 化程度 | 新增 element 多数走 |\n485\t|---|---|\n486\t| 高（80% TVU + 20% local） | 多数走 TVU，少数复用 local |\n487\t| 中（50/50） | 严格 R6 决策树逐 element 判断 |\n488\t| 低（20% TVU + 80% local） | 多数复用 local，少数走 TVU |\n489\t\n490\t规则统一——**不**因 TVU 化程度而变。\n491\t\n492\t### 常见子场景（20 个）+ 触发关键词\n493\t\n494\t#### 场景 1（非 TVU 视觉还原）\n495\t\n496\t| 子场景 | 典型表达 | 触发关键词 |\n497\t|---|---|---|\n498\t| **1.1** 客户 / 第三方 Figma 设计 | \"客户给了这个 Figma，按原样还原\" | 客户 Figma / 第三方设计 + 还原 |\n499\t| **1.2** Pre-design-system 时代旧 Figma | \"这是 TVU 规范前的旧设计图，照实现\" | 旧设计 / legacy / pre-design-system + 实现 |\n500\t| **1.3** 截图 / 草图 / 手稿（非 Figma 文件） | \"按这张截图 1:1 实现\" | 截图 / 草图 / 手稿 + 1:1 / 实现 |\n501\t| **1.4** 验证 TVU 库覆盖度（diagnostic） | \"看 TVU 库够不够撑这个 Figma\" / \"找出 Figma 里哪些 TVU 库没有\" | 验证库 / 覆盖度 / 撑得起 / 找 gap |\n502\t| **1.5** 临时 PoC / demo / 草稿（不进生产） | \"做个 demo 试试效果\" | PoC / demo / 临时 / 试试 |\n503\t\n504\t#### 场景 2（已有产品增量）\n505\t\n506\t| 子场景 | 典型表达 | 触发关键词 |\n507\t|---|---|---|\n508\t| **2.1** 已有产品加全新页面 | \"MicroApps Console 加 dashboard 页\" | 已有产品名 + 加 + 页 |\n509\t| **2.2** 已有页面加新 feature / element | \"在 setting 页加一个 X 选项\" | 已有页面名 + 加 + 元素 |\n510\t| **2.3** 修改已有元素行为（不动视觉） | \"登录失败提示改一下文案\" | 已有元素 + 改 / 调整 + 行为/文案词 |\n511\t| **2.4** 补一个 local 没有但 TVU 有的组件 | \"需要个 progress bar，TVU 有现成的\" | local 没 + TVU 有 + 直接用 |\n512\t| **2.5** 基于已有 layout / composable 拓展 | \"用现有的 SettingsField 加一行\" | 复用 + 已有 composable 名 |\n513\t\n514\t#### 场景 3（全新产品 TVU 构建）\n515\t\n516\t| 子场景 | 典型表达 | 触发关键词 |\n517\t|---|---|---|\n518\t| **3.1** Greenfield 产品（从 brief 起步） | \"基于 TVU 设计一个 X 产品，功能 ABC\" | 基于 TVU + 设计 / 建 + 新产品 |\n519\t| **3.2** Greenfield 单页 / dashboard | \"用 TVU 给 X 产品画 dashboard 页\" | greenfield + 单页 + 用 TVU |\n520\t| **3.3** TVU library 画的 Figma → 翻译代码 | \"把这个 TVU Figma frame 翻译成代码\" / \"拿这个 TVU URL 1:1 还原\" | TVU Figma / TVU URL + 翻译 / 还原 |\n521\t| **3.4** 客户 Figma 但要求用 TVU 重新实现 | \"客户给了 Figma，**用 TVU** 实现\" | 客户 Figma + **用 TVU** + 实现（视觉真源被显式覆写为 TVU） |\n522\t| **3.5** 从 PRD / 文字 brief 起步（无 Figma 输入） | \"按 PRD 用 TVU 实现 X feature\" | PRD / spec + 用 TVU + 实现 |\n523\t\n524\t#### 场景 4（TVU 规范校正）\n525\t\n526\t| 子场景 | 典型表达 | 触发关键词 |\n527\t|---|---|---|\n528\t| **4.1** 整体迁移到 TVU 规范 | \"把这个产品 / 页面整体迁移到 TVU 规范\" | 迁移 / 整体规范化 |\n529\t| **4.2** 替换 hex literal 为 TVU token | \"把 hex 全换成 token\" | 替换 + hex / hardcode + token |\n530\t| **4.3** 替换自画 SVG 为 TVU library icon | \"把自画图标全换成 TVU 库的\" | 替换 + 自画 / inline SVG + TVU icon |\n531\t| **4.4** 替换 local 组件为 TVU canonical | \"把这个 Button 换成 TVU 新版\" | 替换 + local 组件名 + TVU 新版 |\n532\t| **4.5** 审计代码符合度（仅产报告，不改） | \"审 X 代码是否符合 TVU 规范\" / \"找出违反规则的地方\" | 审 / audit / 找违规 + TVU |\n533\t\n534\t> **破坏性 / 大迁移走专项流程**：场景 4.1（整体迁移）/ 4.4（替换 local 组件为 TVU canonical）若**破坏 consumer 已用 API** 或**跨多组件/多 consumer**,起手读 [`migration-protocol.md`](./migration-protocol.md)（四阶段：基线快照 → 方案+owner ack → 实现 → 验证+consumer soak）。小破坏走其轻档,大迁移四阶段全走。\n535\t\n536\t### Hybrid 边界 case（AI 必须 ask 用户裁定，不强行归类）\n537\t\n538\t下列 hybrid 表达**不直接归类**，AI 必须先 ask 用户裁定视觉真源：\n539\t\n540\t| Hybrid 案例 | AI 应 ask 的问题 |\n541\t|---|---|\n542\t| 在已有产品里按客户 Figma 还原新页面 | \"新页面视觉按客户 Figma 1:1 还是按已有产品惯例校正？\" → 答 1:1 = 场景 2 scope + 场景 1 视觉；答校正 = 场景 2 |\n543\t| 已有产品里某具体页面整页迁移 TVU | \"这是顺手提到还是显式发起独立 refactor？\" → 显式发起 = 场景 4；顺手 = 不动（场景 2） |\n544\t| Greenfield 但已有部分 PoC 代码可参考 | \"PoC 是 throwaway 还是要保留？\" → throwaway = 场景 3；要保留 = 场景 2 |\n545\t| 拿一个 Figma 同时验证库覆盖度 + 还原 | 双目的（1.4 + 1.1）可合并执行：1:1 还原同时产 gap 清单（无需 ask） |\n546\t\n547\t### 起手 disambiguation 协议\n548\t\n549\t1. 用户表达包含子场景表的\"触发关键词\"任一组合 → AI 可直接归类\n550\t2. 关键词不明确 / 关键词冲突（如同时含\"已有产品\" + \"用 TVU\"）→ AI 必须 ask\n551\t3. 命中 Hybrid 边界 case → AI 必须 ask 视觉真源\n552\t4. **默认偏向不 TVU 化**——歧义时优先归场景 1 或场景 2（保留原貌），不默认场景 3 / 4（这是最容易\"过度规范化\"的方向）\n553\t\n554\t### 与 Task Entry Modes (US-1..6) 的关系\n555\t\n556\tR7 是**正交维度**——US 维度判断\"任务类型\"，R7 维度判断\"视觉真源 / 意图\"。两者配合：\n557\t\n558\t| US 类型 | 常见对应场景 |\n559\t|---|---|\n560\t| US-1 / US-2 Greenfield | 默认场景 3 |\n561\t| US-3 Existing increment | 默认场景 2 |\n562\t| **US-4a** Figma visual-fidelity mirror | 场景 1（显式） |\n563\t| **US-4b** Figma TVU-normalize translation | 场景 3（显式） |\n564\t| US-5 trivial 调整 | 按 product 现状（场景 2 子集） |\n565\t| US-6 Audit | 场景 4.5（审计子情况） |\n566\t\n567\t### Acceptance criteria（build 自审）\n568\t\n569\t- 任务开始前，AI 显式声明 **\"intent classified as 场景 X.Y（子场景）\"** 一行？\n570\t- 场景 1 任务中保留的非 TVU 视觉（hex / 自画 SVG / 非 canonical 组件）有标 ``？\n571\t- 场景 2 任务中是否**抑制**了对 pre-design-system 合规债的\"顺手修复\"冲动？\n572\t- 场景 1 / 场景 2 暴露的 gap 是否登记到 [`backlog.md`](./backlog.md) 对应 BRIDGE / sync 候选段（暴露不修复，但记录）？\n573\t- 命中 Hybrid 边界 case 时，是否先 ask 了用户而非自作主张？\n574\t\n575\t### Why\n576\t\n577\t60% sync 现实下，AI 默认 \"Figma → TVU mapping → 替换\" 会污染用户的真实意图——尤其当用户只是想验证库覆盖度或 1:1 临摹既有视觉时。强制起手 disambiguation 把\"视觉真源\"决策权显式还给用户，AI 不替用户做\"该不该 TVU 化\"的越权判断。\n578\t\n579\t同根原则：R6 在 product code 层覆盖了同问题（已建立产品的增量不要 silent refactor）；R7 把同原则提升到 **task intent 维度**，覆盖更广（含 Figma 输入维度 + 用户验证意图 + element-level 决策）。\n580\t\n581\t### 反模式记录\n582\t\n583\t- 用户说\"帮我把这个 Figma 翻译成代码\"（未指明场景 1 / 3），AI 默认走场景 3 → 把客户自由设计的颜色全替换成 TVU token → 视觉走样 → 用户返工说\"我只是要还原而已\"。\n584\t- 用户说\"在 MicroApps Console 加 X 页\"（场景 2），AI 顺手把已有页面的 hex literal 全替换成 token + 加 changeset → 越权 + 制造未审批破坏性变更（同 R6 既有反例）。\n585\t- 用户说\"看 TVU 库够不够撑住这个 Figma\"（场景 1.4），AI 走场景 3 把所有缺件强行用 TVU 近似品替换 → 失去了\"验证库覆盖度\"的诊断价值，用户拿不到 gap 列表。\n586\t- 用户说\"在已有产品加一个新页面\"（场景 2.1），AI 误读为\"已有产品 = 禁用 TVU\"，强行只用 local 组件甚至自写 → 错过 TVU 库可用项（场景 2 是 element-level 决策，不是禁用 TVU）。\n587\t- 用户历史用语\"1:1 还原\"（项目语境多指场景 3.3 — TVU library Figma 还原），AI 误归场景 1 → 不走 R1/R2 强约束 → 输出与 TVU 库脱钩。**纠偏**：单独的\"1:1 还原\"不构成场景 1 trigger；必须同时出现\"客户 / 第三方 / 截图 / 草图 / 旧设计\"等非 TVU 来源关键词。\n588\t\n589\t### 与既有规则关系\n590\t\n591\t- R1（icon）/ R2（token）/ R3（canonical）在 **场景 3 / 4** 路径下强约束；在 **场景 1** 路径下退为软建议（命中即用）\n592\t- R6 是 **场景 2** 的 product code 层实现细节；R7 是上游 intent 判断\n593\t- 与 mockup-conventions 的 M2 / M21 同根（同源原则在 mockup scope 的镜像）\n594\t\n595\t---\n596\t\n597\t## 规则适用速查表（按 R7 场景查 R7-R10 + meta + 工具）\n598\t\n599\tR7 classify 之后，用此表快速判断该 fire 哪些规则。读者不用 grep 各规则段拼矩阵。\n600\t\n601\t### 适用矩阵\n602\t\n603\t| 规则 / 工具 | 场景 1
非 TVU 视觉还原 | 场景 2
已有产品增量 | 场景 3
全新 TVU 构建 | 场景 4
TVU 规范校正 |\n604\t|---|---|---|---|---|\n605\t| **R7** 意图 disambiguate（起手必判） | ✅ 必判 | ✅ 必判 | ✅ 必判 | ✅ 必判 |\n606\t| **R8** 视觉 self-check（L3 visual-diff.py） | ✅ 强制 | ⚠️ 小增量（R6 子集 ≤2 elem）可豁免 | ✅ 强制 | ✅ 强制 |\n607\t| **R8** 矢量源 → 矢量输出 | ✅ | ✅ | ✅ | ✅ |\n608\t| **R8** 禁止 approximate 重画 vector | ✅ | ✅ | ✅ | ✅ |\n609\t| **R9** Hover / focus / disabled 补全 | ✅ 强制 | ⚠️ 按已有产品惯例 | ✅ 强制 | ❌ 不主动补新交互 |\n610\t| **R10** Vector 导出策略决策 | ✅ 强制 | ⚠️ 仅涉及新 vector 时 | ✅ 强制 | ✅ 强制（组件替换时） |\n611\t| **R12** Designer annotation 过滤 | ✅ 强制 | ✅ 强制 | ✅ 强制 | ✅ 强制 |\n612\t| **Meta-K** enforcement 层级声明 | ✅ 写规则时 | ✅ | ✅ | ✅ |\n613\t| **Meta-L** AI 不确定必 ask | ✅ **全场景 + 不限 Figma 任务** | ✅ | ✅ | ✅ |\n614\t| **A** pre-commit hook（[`.husky/pre-commit`](../../.husky/pre-commit)） | ✅ 任何视觉 commit | ✅ | ✅ | ✅ |\n615\t| **B'** [`figma-asset-fetch.py`](../../scripts/figma-asset-fetch.py) | ✅ 任何取 asset 操作 | ✅ | ✅ | ✅ |\n616\t| [`visual-diff.py`](../../scripts/visual-diff.py) | ✅ R8 配套 | ⚠️ 按 R8 例外 | ✅ R8 配套 | ✅ R8 配套 |\n617\t\n618\t### 全场景永远适用（无豁免）\n619\t\n620\t| 规则 / 工具 | 为什么 |\n621\t|---|---|\n622\t| **R7 起手 classify** | 跳起手 = 跳基础协议 |\n623\t| **R8 矢量源 → 矢量输出** + **禁止 approximate** | 物理原则（矢量降级是损失），不是 scope 问题 |\n624\t| **Meta-L** AI 不确定必 ask | 元规则，超越 Figma scope，任何任务都适用 |\n625\t| **A** pre-commit hook | 物理拦截，hook 不分场景 |\n626\t| **B'** / visual-diff.py | 工具，谁用都受益 |\n627\t| **R12** annotation 过滤 | 设计师批注永远不该渲染为 UI |\n628\t\n629\t### 起手 5 步 checklist（任何 Figma → Code 任务）\n630\t\n631\t1. **R7 classify**：判场景 1/2/3/4 + 子场景 X.Y → 显式声明 `\"intent classified as 场景 X.Y\"`\n632\t2. **查上表**：知道这次 fire 哪些规则\n633\t3. **Meta-L 兜底**：任何不确定 → ask user，**不**自作主张\n634\t4. **执行**：按选定规则跑（如 R8 自检 close-loop / R9 hover 推断 / R10 vector strategy 声明）\n635\t5. **commit 前**：触发 pre-commit hook（视觉文件 staged 时需 `VISUAL_COMMIT_APPROVED=1`）\n636\t\n637\t### 易混淆边界（场景 2 vs 场景 4）\n638\t\n639\t| 行为 | 场景归属 | 处理 |\n640\t|---|---|---|\n641\t| 加**新**元素，local 没有 → 用 TVU vector | 场景 2.4（合法增量） | R10 适用，按 case A/B 取 TVU canonical |\n642\t| 替换**已有** local 组件为 TVU canonical | 场景 4.4（compliance refactor） | 需用户显式发起独立 refactor 任务 |\n643\t\n644\t边界：增量是 OK 的，**借机替换已有元素**就越界进场景 4，必须用户显式授权。\n645\t\n646\t---\n647\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"14621efe-2a7a-48e9-847a-08af469e24dc","timestamp":"2026-08-25T10:16:48.022Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","content":"## R7 — 任务意图 disambiguate：4 大场景判断（起手必判）\n\n### 触发背景\n\nTVU library 60% sync 现实下，消费侧任务的**视觉真源未必是 TVU library**：\n\n- Figma 效果图可能是 pre-design-system 时代 / 第三方 / 客户提供，不符合 TVU 规范\n- 用户拿 Figma 来\"验证 TVU 库覆盖度\"而**不**想做 TVU 化重构\n- Existing product 本地已有非 TVU 组件，新增量不应越界做 silent compliance fix\n\nAI 默认走 \"Figma → TVU mapping → 用 TVU 替换\" 会在用户只想 1:1 还原时**过度规范化**——把原本应保留的视觉强行变成 TVU 版本。\n\n### 4 大场景 + 判断维度\n\n任务起手时（在 R0 Phase 0 mapping 之前），AI 必须**显式 disambiguate 用户意图**，归到 4 大场景之一：\n\n| 场景 | 名字 | 视觉真源 | 产品状态 | 任务性质 | TVU 库角色 | 路径要点 |\n|---|---|---|---|---|---|---|\n| **场景 1** | 非 TVU 视觉还原 | Figma / 截图 / 草图 本身 | 任意 | 新建（按视觉还原）| 软建议，命中即用，**不**强推替换 | R0 mapping 每行标 \"visual-fidelity priority\"；缺件按 Figma 原样实现（hex / 自画 SVG / 非 canonical 组件允许）；标 sync 候选；**不**走 R1/R2 例外授权流程 |\n| **场景 2** | 已有产品增量 | 已有产品视觉惯例（含已 sync 的 TVU + local + 已用 token） | 已有产品 | 增量 / 迭代 | element 级决策：local 有用 local，local 没用 TVU | R6 决策树：local > TVU > 自写；**不**借机修 pre-design-system 合规债 |\n| **场景 3** | 全新产品 TVU 构建 | TVU library | greenfield | 新建 | 强约束（priority 1） | R0 + R1/R2/R3 全套；gap 走 fallback 链（code → MCP Figma → 自画例外） |\n| **场景 4** | TVU 规范校正 | TVU library | 任意（多数已有产品）| 重构 / 校正 | 强约束（priority 1） | 独立 refactor 任务，需用户**显式发起**，不混在增量任务里 |\n\n### 场景 2 视觉真源细化（element-level + 成熟度光谱）\n\n场景 2 不是\"禁用 TVU\"——而是**逐 element 判断**，TVU 库经常会用、且应该用：\n\n| element 状况 | 决策 |\n|---|---|\n| ✅ local 有 + ✅ TVU 也有 | **优先 local**（避免跨页面割裂） |\n| ❌ local 没 + ✅ TVU 有 | **用 TVU** ← 完全合法且鼓励 |\n| ❌ local 没 + ❌ TVU 没 | **自写候选**（走 R0 / R1 例外，需用户授权 + 登记 backlog） |\n| ⚠️ local 有但旧/不规范 + ✅ TVU 有新版 | **仍用 local**（除非用户显式说\"用 TVU 替换\"）— pre-design-system 不视为 bug |\n\n产品 TVU 化成熟度光谱（不改变规则，仅影响新增 element 多数走哪）：\n\n| 产品 TVU 化程度 | 新增 element 多数走 |\n|---|---|\n| 高（80% TVU + 20% local） | 多数走 TVU，少数复用 local |\n| 中（50/50） | 严格 R6 决策树逐 element 判断 |\n| 低（20% TVU + 80% local） | 多数复用 local，少数走 TVU |\n\n规则统一——**不**因 TVU 化程度而变。\n\n### 常见子场景（20 个）+ 触发关键词\n\n#### 场景 1（非 TVU 视觉还原）\n\n| 子场景 | 典型表达 | 触发关键词 |\n|---|---|---|\n| **1.1** 客户 / 第三方 Figma 设计 | \"客户给了这个 Figma，按原样还原\" | 客户 Figma / 第三方设计 + 还原 |\n| **1.2** Pre-design-system 时代旧 Figma | \"这是 TVU 规范前的旧设计图，照实现\" | 旧设计 / legacy / pre-design-system + 实现 |\n| **1.3** 截图 / 草图 / 手稿（非 Figma 文件） | \"按这张截图 1:1 实现\" | 截图 / 草图 / 手稿 + 1:1 / 实现 |\n| **1.4** 验证 TVU 库覆盖度（diagnostic） | \"看 TVU 库够不够撑这个 Figma\" / \"找出 Figma 里哪些 TVU 库没有\" | 验证库 / 覆盖度 / 撑得起 / 找 gap |\n| **1.5** 临时 PoC / demo / 草稿（不进生产） | \"做个 demo 试试效果\" | PoC / demo / 临时 / 试试 |\n\n#### 场景 2（已有产品增量）\n\n| 子场景 | 典型表达 | 触发关键词 |\n|---|---|---|\n| **2.1** 已有产品加全新页面 | \"MicroApps Console 加 dashboard 页\" | 已有产品名 + 加 + 页 |\n| **2.2** 已有页面加新 feature / element | \"在 setting 页加一个 X 选项\" | 已有页面名 + 加 + 元素 |\n| **2.3** 修改已有元素行为（不动视觉） | \"登录失败提示改一下文案\" | 已有元素 + 改 / 调整 + 行为/文案词 |\n| **2.4** 补一个 local 没有但 TVU 有的组件 | \"需要个 progress bar，TVU 有现成的\" | local 没 + TVU 有 + 直接用 |\n| **2.5** 基于已有 layout / composable 拓展 | \"用现有的 SettingsField 加一行\" | 复用 + 已有 composable 名 |\n\n#### 场景 3（全新产品 TVU 构建）\n\n| 子场景 | 典型表达 | 触发关键词 |\n|---|---|---|\n| **3.1** Greenfield 产品（从 brief 起步） | \"基于 TVU 设计一个 X 产品，功能 ABC\" | 基于 TVU + 设计 / 建 + 新产品 |\n| **3.2** Greenfield 单页 / dashboard | \"用 TVU 给 X 产品画 dashboard 页\" | greenfield + 单页 + 用 TVU |\n| **3.3** TVU library 画的 Figma → 翻译代码 | \"把这个 TVU Figma frame 翻译成代码\" / \"拿这个 TVU URL 1:1 还原\" | TVU Figma / TVU URL + 翻译 / 还原 |\n| **3.4** 客户 Figma 但要求用 TVU 重新实现 | \"客户给了 Figma，**用 TVU** 实现\" | 客户 Figma + **用 TVU** + 实现（视觉真源被显式覆写为 TVU） |\n| **3.5** 从 PRD / 文字 brief 起步（无 Figma 输入） | \"按 PRD 用 TVU 实现 X feature\" | PRD / spec + 用 TVU + 实现 |\n\n#### 场景 4（TVU 规范校正）\n\n| 子场景 | 典型表达 | 触发关键词 |\n|---|---|---|\n| **4.1** 整体迁移到 TVU 规范 | \"把这个产品 / 页面整体迁移到 TVU 规范\" | 迁移 / 整体规范化 |\n| **4.2** 替换 hex literal 为 TVU token | \"把 hex 全换成 token\" | 替换 + hex / hardcode + token |\n| **4.3** 替换自画 SVG 为 TVU library icon | \"把自画图标全换成 TVU 库的\" | 替换 + 自画 / inline SVG + TVU icon |\n| **4.4** 替换 local 组件为 TVU canonical | \"把这个 Button 换成 TVU 新版\" | 替换 + local 组件名 + TVU 新版 |\n| **4.5** 审计代码符合度（仅产报告，不改） | \"审 X 代码是否符合 TVU 规范\" / \"找出违反规则的地方\" | 审 / audit / 找违规 + TVU |\n\n> **破坏性 / 大迁移走专项流程**：场景 4.1（整体迁移）/ 4.4（替换 local 组件为 TVU canonical）若**破坏 consumer 已用 API** 或**跨多组件/多 consumer**,起手读 [`migration-protocol.md`](./migration-protocol.md)（四阶段：基线快照 → 方案+owner ack → 实现 → 验证+consumer soak）。小破坏走其轻档,大迁移四阶段全走。\n\n### Hybrid 边界 case（AI 必须 ask 用户裁定，不强行归类）\n\n下列 hybrid 表达**不直接归类**，AI 必须先 ask 用户裁定视觉真源：\n\n| Hybrid 案例 | AI 应 ask 的问题 |\n|---|---|\n| 在已有产品里按客户 Figma 还原新页面 | \"新页面视觉按客户 Figma 1:1 还是按已有产品惯例校正？\" → 答 1:1 = 场景 2 scope + 场景 1 视觉；答校正 = 场景 2 |\n| 已有产品里某具体页面整页迁移 TVU | \"这是顺手提到还是显式发起独立 refactor？\" → 显式发起 = 场景 4；顺手 = 不动（场景 2） |\n| Greenfield 但已有部分 PoC 代码可参考 | \"PoC 是 throwaway 还是要保留？\" → throwaway = 场景 3；要保留 = 场景 2 |\n| 拿一个 Figma 同时验证库覆盖度 + 还原 | 双目的（1.4 + 1.1）可合并执行：1:1 还原同时产 gap 清单（无需 ask） |\n\n### 起手 disambiguation 协议\n\n1. 用户表达包含子场景表的\"触发关键词\"任一组合 → AI 可直接归类\n2. 关键词不明确 / 关键词冲突（如同时含\"已有产品\" + \"用 TVU\"）→ AI 必须 ask\n3. 命中 Hybrid 边界 case → AI 必须 ask 视觉真源\n4. **默认偏向不 TVU 化**——歧义时优先归场景 1 或场景 2（保留原貌），不默认场景 3 / 4（这是最容易\"过度规范化\"的方向）\n\n### 与 Task Entry Modes (US-1..6) 的关系\n\nR7 是**正交维度**——US 维度判断\"任务类型\"，R7 维度判断\"视觉真源 / 意图\"。两者配合：\n\n| US 类型 | 常见对应场景 |\n|---|---|\n| US-1 / US-2 Greenfield | 默认场景 3 |\n| US-3 Existing increment | 默认场景 2 |\n| **US-4a** Figma visual-fidelity mirror | 场景 1（显式） |\n| **US-4b** Figma TVU-normalize translation | 场景 3（显式） |\n| US-5 trivial 调整 | 按 product 现状（场景 2 子集） |\n| US-6 Audit | 场景 4.5（审计子情况） |\n\n### Acceptance criteria（build 自审）\n\n- 任务开始前，AI 显式声明 **\"intent classified as 场景 X.Y（子场景）\"** 一行？\n- 场景 1 任务中保留的非 TVU 视觉（hex / 自画 SVG / 非 canonical 组件）有标 ``？\n- 场景 2 任务中是否**抑制**了对 pre-design-system 合规债的\"顺手修复\"冲动？\n- 场景 1 / 场景 2 暴露的 gap 是否登记到 [`backlog.md`](./backlog.md) 对应 BRIDGE / sync 候选段（暴露不修复，但记录）？\n- 命中 Hybrid 边界 case 时，是否先 ask 了用户而非自作主张？\n\n### Why\n\n60% sync 现实下，AI 默认 \"Figma → TVU mapping → 替换\" 会污染用户的真实意图——尤其当用户只是想验证库覆盖度或 1:1 临摹既有视觉时。强制起手 disambiguation 把\"视觉真源\"决策权显式还给用户，AI 不替用户做\"该不该 TVU 化\"的越权判断。\n\n同根原则：R6 在 product code 层覆盖了同问题（已建立产品的增量不要 silent refactor）；R7 把同原则提升到 **task intent 维度**，覆盖更广（含 Figma 输入维度 + 用户验证意图 + element-level 决策）。\n\n### 反模式记录\n\n- 用户说\"帮我把这个 Figma 翻译成代码\"（未指明场景 1 / 3），AI 默认走场景 3 → 把客户自由设计的颜色全替换成 TVU token → 视觉走样 → 用户返工说\"我只是要还原而已\"。\n- 用户说\"在 MicroApps Console 加 X 页\"（场景 2），AI 顺手把已有页面的 hex literal 全替换成 token + 加 changeset → 越权 + 制造未审批破坏性变更（同 R6 既有反例）。\n- 用户说\"看 TVU 库够不够撑住这个 Figma\"（场景 1.4），AI 走场景 3 把所有缺件强行用 TVU 近似品替换 → 失去了\"验证库覆盖度\"的诊断价值，用户拿不到 gap 列表。\n- 用户说\"在已有产品加一个新页面\"（场景 2.1），AI 误读为\"已有产品 = 禁用 TVU\"，强行只用 local 组件甚至自写 → 错过 TVU 库可用项（场景 2 是 element-level 决策，不是禁用 TVU）。\n- 用户历史用语\"1:1 还原\"（项目语境多指场景 3.3 — TVU library Figma 还原），AI 误归场景 1 → 不走 R1/R2 强约束 → 输出与 TVU 库脱钩。**纠偏**：单独的\"1:1 还原\"不构成场景 1 trigger；必须同时出现\"客户 / 第三方 / 截图 / 草图 / 旧设计\"等非 TVU 来源关键词。\n\n### 与既有规则关系\n\n- R1（icon）/ R2（token）/ R3（canonical）在 **场景 3 / 4** 路径下强约束；在 **场景 1** 路径下退为软建议（命中即用）\n- R6 是 **场景 2** 的 product code 层实现细节；R7 是上游 intent 判断\n- 与 mockup-conventions 的 M2 / M21 同根（同源原则在 mockup scope 的镜像）\n\n---\n\n## 规则适用速查表（按 R7 场景查 R7-R10 + meta + 工具）\n\nR7 classify 之后，用此表快速判断该 fire 哪些规则。读者不用 grep 各规则段拼矩阵。\n\n### 适用矩阵\n\n| 规则 / 工具 | 场景 1
非 TVU 视觉还原 | 场景 2
已有产品增量 | 场景 3
全新 TVU 构建 | 场景 4
TVU 规范校正 |\n|---|---|---|---|---|\n| **R7** 意图 disambiguate（起手必判） | ✅ 必判 | ✅ 必判 | ✅ 必判 | ✅ 必判 |\n| **R8** 视觉 self-check（L3 visual-diff.py） | ✅ 强制 | ⚠️ 小增量（R6 子集 ≤2 elem）可豁免 | ✅ 强制 | ✅ 强制 |\n| **R8** 矢量源 → 矢量输出 | ✅ | ✅ | ✅ | ✅ |\n| **R8** 禁止 approximate 重画 vector | ✅ | ✅ | ✅ | ✅ |\n| **R9** Hover / focus / disabled 补全 | ✅ 强制 | ⚠️ 按已有产品惯例 | ✅ 强制 | ❌ 不主动补新交互 |\n| **R10** Vector 导出策略决策 | ✅ 强制 | ⚠️ 仅涉及新 vector 时 | ✅ 强制 | ✅ 强制（组件替换时） |\n| **R12** Designer annotation 过滤 | ✅ 强制 | ✅ 强制 | ✅ 强制 | ✅ 强制 |\n| **Meta-K** enforcement 层级声明 | ✅ 写规则时 | ✅ | ✅ | ✅ |\n| **Meta-L** AI 不确定必 ask | ✅ **全场景 + 不限 Figma 任务** | ✅ | ✅ | ✅ |\n| **A** pre-commit hook（[`.husky/pre-commit`](../../.husky/pre-commit)） | ✅ 任何视觉 commit | ✅ | ✅ | ✅ |\n| **B'** [`figma-asset-fetch.py`](../../scripts/figma-asset-fetch.py) | ✅ 任何取 asset 操作 | ✅ | ✅ | ✅ |\n| [`visual-diff.py`](../../scripts/visual-diff.py) | ✅ R8 配套 | ⚠️ 按 R8 例外 | ✅ R8 配套 | ✅ R8 配套 |\n\n### 全场景永远适用（无豁免）\n\n| 规则 / 工具 | 为什么 |\n|---|---|\n| **R7 起手 classify** | 跳起手 = 跳基础协议 |\n| **R8 矢量源 → 矢量输出** + **禁止 approximate** | 物理原则（矢量降级是损失），不是 scope 问题 |\n| **Meta-L** AI 不确定必 ask | 元规则，超越 Figma scope，任何任务都适用 |\n| **A** pre-commit hook | 物理拦截，hook 不分场景 |\n| **B'** / visual-diff.py | 工具，谁用都受益 |\n| **R12** annotation 过滤 | 设计师批注永远不该渲染为 UI |\n\n### 起手 5 步 checklist（任何 Figma → Code 任务）\n\n1. **R7 classify**：判场景 1/2/3/4 + 子场景 X.Y → 显式声明 `\"intent classified as 场景 X.Y\"`\n2. **查上表**：知道这次 fire 哪些规则\n3. **Meta-L 兜底**：任何不确定 → ask user，**不**自作主张\n4. **执行**：按选定规则跑（如 R8 自检 close-loop / R9 hover 推断 / R10 vector strategy 声明）\n5. **commit 前**：触发 pre-commit hook（视觉文件 staged 时需 `VISUAL_COMMIT_APPROVED=1`）\n\n### 易混淆边界（场景 2 vs 场景 4）\n\n| 行为 | 场景归属 | 处理 |\n|---|---|---|\n| 加**新**元素，local 没有 → 用 TVU vector | 场景 2.4（合法增量） | R10 适用，按 case A/B 取 TVU canonical |\n| 替换**已有** local 组件为 TVU canonical | 场景 4.4（compliance refactor） | 需用户显式发起独立 refactor 任务 |\n\n边界：增量是 OK 的，**借机替换已有元素**就越界进场景 4，必须用户显式授权。\n\n---\n","numLines":200,"startLine":448,"totalLines":1528}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":100,"estimated_tokens_delta":100,"uuid":"fd9db096-79b7-49c2-8059-a9562a88547b","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":50,"uuid":"daac2dbf-e096-4aaf-8331-ac69101b441a","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":300,"estimated_tokens_delta":150,"uuid":"c01e7235-c06a-4c97-8497-a85e03736d68","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":400,"estimated_tokens_delta":100,"uuid":"64b20a7f-9a5d-4c9f-b58d-202ab0514d89","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":500,"estimated_tokens_delta":100,"uuid":"bd76c179-1f10-43bf-bafd-a8ed16f35c5e","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":600,"estimated_tokens_delta":100,"uuid":"69a7823b-6a19-4ff9-9dc9-6a8bbcc00e2b","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":700,"estimated_tokens_delta":100,"uuid":"b1bc3002-dc68-41bd-82bc-ba47d3a11837","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":800,"estimated_tokens_delta":100,"uuid":"3873057f-4a99-4fca-9a11-031d64ff608f","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":900,"estimated_tokens_delta":100,"uuid":"cfec32f0-323b-48a8-8841-9b8678581492","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1000,"estimated_tokens_delta":100,"uuid":"9f961785-b781-4b3a-8c23-d9ca218ffdbd","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1150,"estimated_tokens_delta":150,"uuid":"6b86aa8d-b520-48fa-a101-519e5f89e42b","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1250,"estimated_tokens_delta":100,"uuid":"64b6a18c-48e1-4c98-9de8-2c4fe1174754","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1400,"estimated_tokens_delta":150,"uuid":"eda6f0e0-5864-4386-92cb-e64575501c65","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1500,"estimated_tokens_delta":100,"uuid":"104f1fbe-3f44-4237-90cf-3063933223aa","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1600,"estimated_tokens_delta":100,"uuid":"3855119b-1e21-4785-bf47-b33adb14afba","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHzPo8oasHiuoFdboCK","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"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"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":11378,"cache_read_input_tokens":132982,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":11378},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"689c4575-5b4c-4af9-8044-283831470135","timestamp":"2026-08-25T10:17:15.057Z","request_id":"req_011CePHzKkJi6XR8NJSMfXwQ"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHzPo8oasHiuoFdboCK","type":"message","role":"assistant","content":[{"type":"text","text":"Intent 分类前先做 R0 的 lookup 序列（catalog / mapping / canonical / icons / tokens）。"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":11378,"cache_read_input_tokens":132982,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":11378},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"f91ea38c-0f4b-4099-925c-64a96f5b368a","timestamp":"2026-08-25T10:17:15.725Z","request_id":"req_011CePHzKkJi6XR8NJSMfXwQ"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHzPo8oasHiuoFdboCK","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01GP5DqG9fKgGe8pK4e9Z12w","name":"Grep","input":{"pattern":"^### ","path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/figma-component-catalog.md","output_mode":"content","-n":true},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":11378,"cache_read_input_tokens":132982,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":11378},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"a0ed12e0-5c17-4c9c-97ba-ce0f3cd7b248","timestamp":"2026-08-25T10:17:17.149Z","request_id":"req_011CePHzKkJi6XR8NJSMfXwQ"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01GP5DqG9fKgGe8pK4e9Z12w","type":"tool_result","content":"60:### Badge\n88:### Button/dark M\n117:### Tab/Item\n146:### Tab List\n160:### Top bar\n183:### Notification ⟨confirm dialog / prompt / popconfirm / 确认弹窗 / 警告 / toast / alert / 信息条⟩\n220:### Message ⟨prompt / 提示消息 / status line / 顶部瞬时消息⟩\n241:### input box/filled\n262:### Tooltips\n277:### APP Icons ⚠️ (file-local)\n306:### User Menu ⚠️ (file-local) ⟨账号菜单 / avatar dropdown / account popup / 头像下拉⟩\n333:### Table\n355:### Pagination\n375:### Form Item\n409:### check box\n431:### radio\n452:### switch\n473:### InputNumber\n494:### select box/filled\n516:### Drop down List/Select\n537:### Chart\n558:### Progress\n658:### 已知具体 icon (用过实证 key)\n699:### Status colors (broadcast convention M3)\n714:### Surface (dark theme)\n720:### Text\n726:### Border / divider\n733:### Spacing / Radius\n741:### Variant-leak 问题\n744:### 每个 entry 的演化路径\n752:### Bootstrap 重生成"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"5e51f73f-0345-46d4-9ce9-e06df5487095","timestamp":"2026-08-25T10:17:17.170Z","tool_use_result":{"mode":"content","numFiles":0,"filenames":[],"content":"60:### Badge\n88:### Button/dark M\n117:### Tab/Item\n146:### Tab List\n160:### Top bar\n183:### Notification ⟨confirm dialog / prompt / popconfirm / 确认弹窗 / 警告 / toast / alert / 信息条⟩\n220:### Message ⟨prompt / 提示消息 / status line / 顶部瞬时消息⟩\n241:### input box/filled\n262:### Tooltips\n277:### APP Icons ⚠️ (file-local)\n306:### User Menu ⚠️ (file-local) ⟨账号菜单 / avatar dropdown / account popup / 头像下拉⟩\n333:### Table\n355:### Pagination\n375:### Form Item\n409:### check box\n431:### radio\n452:### switch\n473:### InputNumber\n494:### select box/filled\n516:### Drop down List/Select\n537:### Chart\n558:### Progress\n658:### 已知具体 icon (用过实证 key)\n699:### Status colors (broadcast convention M3)\n714:### Surface (dark theme)\n720:### Text\n726:### Border / divider\n733:### Spacing / Radius\n741:### Variant-leak 问题\n744:### 每个 entry 的演化路径\n752:### Bootstrap 重生成","numLines":31,"totalLines":31}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHzPo8oasHiuoFdboCK","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01F2KwsVN8EYua85T4ssDiei","name":"Glob","input":{"pattern":"src/canonical/*.vue"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":11378,"cache_read_input_tokens":132982,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":11378},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"3b75f67c-b9b3-494b-920d-108bc0388a07","timestamp":"2026-08-25T10:17:17.771Z","request_id":"req_011CePHzKkJi6XR8NJSMfXwQ"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePHzPo8oasHiuoFdboCK","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01Ki64Qfr6gjr29rNcQ6CUxa","name":"Glob","input":{"pattern":"dist/icons/svg/*"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":11378,"cache_read_input_tokens":132982,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":11378},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"969696ae-ee4c-4d99-99b4-c75a6edf1954","timestamp":"2026-08-25T10:17:17.778Z","request_id":"req_011CePHzKkJi6XR8NJSMfXwQ"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01Ki64Qfr6gjr29rNcQ6CUxa","type":"tool_result","content":"No files found"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"f160088e-31cd-4fa9-aa48-e8c0afe0c294","timestamp":"2026-08-25T10:17:17.868Z","tool_use_result":{"filenames":[],"durationMs":88,"numFiles":0,"truncated":false,"totalMatches":0,"countIsComplete":true}} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01F2KwsVN8EYua85T4ssDiei","type":"tool_result","content":"src/canonical/Badge.vue\nsrc/canonical/Breadcrumb.vue\nsrc/canonical/BreadcrumbItem.vue\nsrc/canonical/ButtonBridge.vue\nsrc/canonical/Chart.vue\nsrc/canonical/CheckBox.vue\nsrc/canonical/DropDownListSelect.vue\nsrc/canonical/Form.vue\nsrc/canonical/FormItem.vue\nsrc/canonical/Icon.vue\nsrc/canonical/InputBoxBase.vue\nsrc/canonical/InputBoxFilled.vue\nsrc/canonical/InputBoxLine.vue\nsrc/canonical/InputNumber.vue\nsrc/canonical/Logo.vue\nsrc/canonical/MenuList.vue\nsrc/canonical/Message.vue\nsrc/canonical/Notification.vue\nsrc/canonical/Pagination.vue\nsrc/canonical/PillCounter.vue\nsrc/canonical/PillStatus.vue\nsrc/canonical/PopupBox.vue\nsrc/canonical/Progress.vue\nsrc/canonical/Radio.vue\nsrc/canonical/Rating.vue\nsrc/canonical/SelectBoxBase.vue\nsrc/canonical/SelectBoxFilled.vue\nsrc/canonical/SelectBoxLine.vue\nsrc/canonical/Slider.vue\nsrc/canonical/StepItem.vue\nsrc/canonical/Steps.vue\nsrc/canonical/Switch.vue\nsrc/canonical/Tab.vue\nsrc/canonical/TabItem.vue\nsrc/canonical/TabList.vue\nsrc/canonical/Table.vue\nsrc/canonical/Tooltip.vue\nsrc/canonical/TopBar.vue\nsrc/canonical/UserMenu.vue"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"3fe195f2-bdf0-4643-b647-0f9dee0f7bfb","timestamp":"2026-08-25T10:17:17.869Z","tool_use_result":{"filenames":["src/canonical/Badge.vue","src/canonical/Breadcrumb.vue","src/canonical/BreadcrumbItem.vue","src/canonical/ButtonBridge.vue","src/canonical/Chart.vue","src/canonical/CheckBox.vue","src/canonical/DropDownListSelect.vue","src/canonical/Form.vue","src/canonical/FormItem.vue","src/canonical/Icon.vue","src/canonical/InputBoxBase.vue","src/canonical/InputBoxFilled.vue","src/canonical/InputBoxLine.vue","src/canonical/InputNumber.vue","src/canonical/Logo.vue","src/canonical/MenuList.vue","src/canonical/Message.vue","src/canonical/Notification.vue","src/canonical/Pagination.vue","src/canonical/PillCounter.vue","src/canonical/PillStatus.vue","src/canonical/PopupBox.vue","src/canonical/Progress.vue","src/canonical/Radio.vue","src/canonical/Rating.vue","src/canonical/SelectBoxBase.vue","src/canonical/SelectBoxFilled.vue","src/canonical/SelectBoxLine.vue","src/canonical/Slider.vue","src/canonical/StepItem.vue","src/canonical/Steps.vue","src/canonical/Switch.vue","src/canonical/Tab.vue","src/canonical/TabItem.vue","src/canonical/TabList.vue","src/canonical/Table.vue","src/canonical/Tooltip.vue","src/canonical/TopBar.vue","src/canonical/UserMenu.vue"],"durationMs":93,"numFiles":39,"truncated":false,"totalMatches":39,"countIsComplete":true}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":100,"estimated_tokens_delta":100,"uuid":"91efb102-4d53-467c-ab7c-982766d4e397","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":146,"estimated_tokens_delta":46,"uuid":"9911a42d-f02b-4542-8805-25c596ab5e1f","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ2bDHQTKu4mJGqoEjW","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISvwQKpgEIERgCKkCXOZFG+8ndWrKf6+qrltpG/I+OIGNE/Ihf+r+QfDKsk5QMOAEbSrSLS0kTJK4mpB1SbFJHzdlMAUyXVtZjO/zTMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAbPXtdQGsAECEgy1ug6aCTfuqZBKt7oaDA2vAUQifHOOwY4TvyIwIOP7RkPczC7fo+hf0++FWR0NDw755s+3LE31tKdw5kv7omuBJ2Krdo56u/jiAc3sKsUCsiOp3ypxYk4PHdQF33TVQ2h4boI4E6fYnXeB4ovmN7OqKzNPqkLch4GDGN49Xsytfa/fC2qEKdx7TXrRdZD++FiSWnzux2wkkdL+yZn0nroHABk+Fwp7Aj03sNgXsQdaEAWt1oUXiM2hZBSCDj+HneR/vLwFlIhsEF2vC8hMgf+QtyjFrVshe9DmkTuKGnISh7S19E5ntHi3VNA6Zlb2m6cjX9nJ0HpAXhOJ7FCF9jzWNHPMn36vECYW4jY3jsAPzYgcS9oLhKHltoE9Jt6TR7DCcN25tjzpsVDp1DcABcpWKghA5fF8budBIS2uGrqTSRjw5GxWcNgs+vGMMnRlZutpV4r9JzwhsywJLsgFwRYmrltJBudY8ttHbel8sgyi7zygH2ZChgtMwoGszxfNE13MTk06Z6d3hqItCGSzlknW3FBZdhgB"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3043,"cache_read_input_tokens":144360,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3043},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"08886005-0c61-40fd-a9c5-7300ca6174bd","timestamp":"2026-08-25T10:17:23.381Z","request_id":"req_011CePJ2XCvyvJ9DoGrdzUcS"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ2bDHQTKu4mJGqoEjW","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_012UKAeXLoomzeq6NeTkw3Vy","name":"Glob","input":{"pattern":"src/icons/**"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3043,"cache_read_input_tokens":144360,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3043},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"eac37a51-4fe4-40a7-b5d2-4a3dcf0b5e50","timestamp":"2026-08-25T10:17:24.067Z","request_id":"req_011CePJ2XCvyvJ9DoGrdzUcS"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_012UKAeXLoomzeq6NeTkw3Vy","type":"tool_result","content":"src/icons/catalog/runtime.ts\nsrc/icons/generated/action.ts\nsrc/icons/generated/brand.ts\nsrc/icons/generated/communication.ts\nsrc/icons/generated/feature.ts\nsrc/icons/generated/file.ts\nsrc/icons/generated/indicator.ts\nsrc/icons/generated/input.ts\nsrc/icons/generated/media.ts\nsrc/icons/generated/navigation.ts\nsrc/icons/generated/network.ts\nsrc/icons/generated/others.ts\nsrc/icons/generated/output.ts\nsrc/icons/generated/rating.ts\nsrc/icons/generated/setting.ts\nsrc/icons/generated/status.ts\nsrc/icons/generated/theme.ts\nsrc/icons/generated/time.ts\nsrc/icons/generated/user.ts\nsrc/icons/index.ts\nsrc/icons/manifest.ts\nsrc/icons/raw.ts\nsrc/icons/registry.ts\nsrc/icons/types.ts\nsrc/icons/catalog/generated/arrow.ts\nsrc/icons/catalog/generated/audio.ts\nsrc/icons/catalog/generated/cut.ts\nsrc/icons/catalog/generated/edit.ts\nsrc/icons/catalog/generated/feature.ts\nsrc/icons/catalog/generated/file.ts\nsrc/icons/catalog/generated/filter.ts\nsrc/icons/catalog/generated/indicator.ts\nsrc/icons/catalog/generated/input.ts\nsrc/icons/catalog/generated/load.ts\nsrc/icons/catalog/generated/location.ts\nsrc/icons/catalog/generated/logo.ts\nsrc/icons/catalog/generated/mark.ts\nsrc/icons/catalog/generated/meeting.ts\nsrc/icons/catalog/generated/menu.ts\nsrc/icons/catalog/generated/message.ts\nsrc/icons/catalog/generated/network.ts\nsrc/icons/catalog/generated/others.ts\nsrc/icons/catalog/generated/output.ts\nsrc/icons/catalog/generated/pay.ts\nsrc/icons/catalog/generated/picture.ts\nsrc/icons/catalog/generated/preview.ts\nsrc/icons/catalog/generated/search.ts\nsrc/icons/catalog/generated/setting.ts\nsrc/icons/catalog/generated/share.ts\nsrc/icons/catalog/generated/time.ts\nsrc/icons/catalog/generated/user.ts\nsrc/icons/catalog/generated/video.ts\nsrc/icons/catalog/manifest.ts\nsrc/icons/catalog/index.ts\nsrc/icons/catalog/loaders.ts"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"993a200d-a710-4d34-9c3f-9ac14ff9d8cb","timestamp":"2026-08-25T10:17:24.124Z","tool_use_result":{"filenames":["src/icons/catalog/runtime.ts","src/icons/generated/action.ts","src/icons/generated/brand.ts","src/icons/generated/communication.ts","src/icons/generated/feature.ts","src/icons/generated/file.ts","src/icons/generated/indicator.ts","src/icons/generated/input.ts","src/icons/generated/media.ts","src/icons/generated/navigation.ts","src/icons/generated/network.ts","src/icons/generated/others.ts","src/icons/generated/output.ts","src/icons/generated/rating.ts","src/icons/generated/setting.ts","src/icons/generated/status.ts","src/icons/generated/theme.ts","src/icons/generated/time.ts","src/icons/generated/user.ts","src/icons/index.ts","src/icons/manifest.ts","src/icons/raw.ts","src/icons/registry.ts","src/icons/types.ts","src/icons/catalog/generated/arrow.ts","src/icons/catalog/generated/audio.ts","src/icons/catalog/generated/cut.ts","src/icons/catalog/generated/edit.ts","src/icons/catalog/generated/feature.ts","src/icons/catalog/generated/file.ts","src/icons/catalog/generated/filter.ts","src/icons/catalog/generated/indicator.ts","src/icons/catalog/generated/input.ts","src/icons/catalog/generated/load.ts","src/icons/catalog/generated/location.ts","src/icons/catalog/generated/logo.ts","src/icons/catalog/generated/mark.ts","src/icons/catalog/generated/meeting.ts","src/icons/catalog/generated/menu.ts","src/icons/catalog/generated/message.ts","src/icons/catalog/generated/network.ts","src/icons/catalog/generated/others.ts","src/icons/catalog/generated/output.ts","src/icons/catalog/generated/pay.ts","src/icons/catalog/generated/picture.ts","src/icons/catalog/generated/preview.ts","src/icons/catalog/generated/search.ts","src/icons/catalog/generated/setting.ts","src/icons/catalog/generated/share.ts","src/icons/catalog/generated/time.ts","src/icons/catalog/generated/user.ts","src/icons/catalog/generated/video.ts","src/icons/catalog/manifest.ts","src/icons/catalog/index.ts","src/icons/catalog/loaders.ts"],"durationMs":55,"numFiles":55,"truncated":false,"totalMatches":55,"countIsComplete":true}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ2bDHQTKu4mJGqoEjW","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01FuAFBg62Q9PiC827b9BxYJ","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/figma-component-catalog.md","offset":537,"limit":130},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3043,"cache_read_input_tokens":144360,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3043},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"89b369b7-1251-4f38-9dcf-c3f08d0f4190","timestamp":"2026-08-25T10:17:24.357Z","request_id":"req_011CePJ2XCvyvJ9DoGrdzUcS"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01FuAFBg62Q9PiC827b9BxYJ","type":"tool_result","content":"537\t### Chart\n538\t- **Library key**: `TBD — import on next use`\n539\t- **Axes**: `type` (pie / donut / line / bar / bar-horizontal / line-bar)\n540\t- **Variants**: 6\n541\t- **Code mapping**: `Chart` (status: approved)\n542\t\n543\t#### Primary use\n544\t数据可视化组件——ECharts 封装，按 `type` 渲染 6 种图，`datasets` 驱动 + 内置 12 色调色板与主题感知图例。展示统计数据时用，**禁止直接引 ECharts 或自画 SVG**。\n545\t\n546\t#### Extension scenarios\n547\t- **饼图 / 环形图**：`type=pie` / `type=donut` —— 占比/构成可视化\n548\t- **折线图**：`type=line` —— 趋势/时间序列（多系列）\n549\t- **柱状图 / 横向柱状图**：`type=bar` / `type=bar-horizontal` —— 分类对比，`bar-horizontal` 走 `indexAxis: 'y'`\n550\t- **折柱混合**：`type=line-bar` —— 同图叠加柱与线，每 dataset 用 `dataset.type='bar'|'line'` 指定\n551\t\n552\t#### Don't use for\n553\t- 单一百分比进度 —— 用 `Progress`，不要为一个值开 Chart\n554\t- 别直接引 ECharts 或自画 svg 图表 —— 用 `Chart`，类型走 `type`、数据走 `datasets`\n555\t\n556\t---\n557\t\n558\t### Progress\n559\t- **Library key**: `TBD — import on next use`\n560\t- **Axes**: `theme` (dark / light) × `status` (default / success / error / warning) × `size` (M / S)\n561\t- **Variants**: 16\n562\t- **Code mapping**: `Progress` (status: approved)\n563\t\n564\t#### Primary use\n565\t只读进度条——百分比值（`value` 0–100）+ 状态填充色 + 可选百分比标签（`showLabel` 默认 true）。展示任务完成度时用；可拖动选值用 `Slider`。\n566\t\n567\t#### Extension scenarios\n568\t- **任务完成度（中性）**：`status=default`（或 `success`）—— 填充色 `--brand`（绿）\n569\t- **失败 / 错误进度**：`status=error` —— 填充色 `--red`\n570\t- **告警进度**：`status=warning` —— 填充色 `--orange`\n571\t- **紧凑布局**：`size=S` —— 更细轨道，用于行内/卡片内空间紧张处；默认 `M`\n572\t\n573\t#### Don't use for\n574\t- 可交互取值 / 滑动设值 —— 用 `Slider`（Progress 是只读 indicator）\n575\t- 多值/趋势可视化 —— 用 `Chart`\n576\t- 别用嵌套 div + width% 自画进度条 —— 用 `Progress`，值走 `value`、标签走 `showLabel`\n577\t\n578\t> ⚠️ `status`（default/success/error/warning）是通用进度语义（错=红、警=橙、成功/默认=brand 绿），**不是** domain-tvu M3 的 broadcast Live/Preview 映射——复用同组 token 但语义轴不同。\n579\t\n580\t---\n581\t\n582\t## 🟡 Skeleton — Other Library Components\n583\t\n584\t> **2026-06-15 批量回填**：11 个常用件（Table / Pagination / Form Item / check box / radio / switch / InputNumber / select box/filled / Drop down List/Select / Chart / Progress）已从本表升 ✅ Verified（见上）—— 变体/轴对**已同步库真源**（`components.manifest.json` / `docs-figma-members/*`，drift=0）核实，使用语义 grounded in 组件代码 + docs page + `component-affordances.json` + domain 规则。**Library key 按本节约定标 `TBD — import on next use`**（首次 mockup import 时回填；Claude Design 消费用指导+token、不依赖 key）。\n585\t\n586\t下表列出其余尚未 verify 的 component_sets，按字母排序。**Library keys 留空**（用时 import 一次填回；优先 grep 这个表确认是否存在再 import）。其中 leak / 非组件 / 旧库残留（`After selecting R wi` / `auto recover` / `Home` / `Brand color` / `Neutral Color` / `Icon Guides 16*16` / `Dark·Light/*-btn` 系列）应 prune 或标 deprecated，不升 Verified。\n587\t\n588\t| Component | Axes | Variants | Status | Notes |\n589\t|---|---|---|---|---|\n590\t| `After selecting R wi` | — | 1 | 🟡 | 名字像 file-internal 标记，可能是 leak，需验（prune 候选）|\n591\t| `auto recover` | — | 1 | 🟡 | 同上（prune 候选）|\n592\t| `Brand color` | — | 1 | 🟡 | 色板示例，**非组件**（prune 候选）|\n593\t| `Breadcrumb/Item` | state | 4 | 🟡 | navigation breadcrumb 单项 |\n594\t| `Button/dark L` | icon×style×color×status×radius×fixedWidth | 400 | 🟡 | Button/dark M（✅）的 large 版本 (40px)，用法同 M |\n595\t| `Button/dark S` | 同上 | 400 | 🟡 | small 版本 (28px)，用法同 Button/dark M（✅）|\n596\t| `Button/dark XS` | 同上 | 400 | 🟡 | ⚠️ operator console **不要用** (M7) |\n597\t| `Button/light L` | 同上 | 400 | 🟡 | light theme |\n598\t| `Button/light M` | 同上 | 400 | 🟡 | light theme |\n599\t| `Button/light S` | 同上 | 400 | 🟡 | light theme |\n600\t| `Button/light XS` | 同上 | 400 | 🟡 | light theme |\n601\t| `Button/url link` | dark theme×status | 4 | 🟡 | 链接样式按钮 |\n602\t| `Dark/filled btn` | Property 1 | 3 | 🟡 | **旧库残留**，优先用 `Button/dark M`（✅）（deprecate 候选）|\n603\t| `Dark/outlined btn` | Property 1 | 3 | 🟡 | 同上（deprecate 候选）|\n604\t| `Dark/text btn` | Property 1 | 3 | 🟡 | 同上（deprecate 候选）|\n605\t| `Drop down List/Cascading` | Dark Theme×Type | 4 | 🟡 | 级联下拉 |\n606\t| `Drop down List/Item` | Theme×Type×IsParent×Checked×Active×Disabled×Hover | 41 | 🟡 | 下拉单项（通常经 `Drop down List/Select`（✅）消费）|\n607\t| `Home` | — | 1 | 🟡 | 名字异常，可能 leak（prune 候选）|\n608\t| `Icon Guides 16*16` | — | 1 | 🟡 | 设计指引**非组件**（prune 候选）|\n609\t| `input box/line` | 同 input box/filled | 112 | 🟡 | line 风格（input box/filled 已 ✅）|\n610\t| `Light/filled btn` | Property 1 | 3 | 🟡 | **旧库残留**（deprecate 候选）|\n611\t| `Light/outlined btn` | Property 1 | 3 | 🟡 | 旧库残留（deprecate 候选）|\n612\t| `Light/text btn` | Property 1 | 3 | 🟡 | 旧库残留（deprecate 候选）|\n613\t| `Neutral Color` | — | 1 | 🟡 | 色板示例，**非组件**（prune 候选）|\n614\t| `Notification` | theme×status | 14 | 🟡 | inline message banner —— ⚠️ 疑为旧模型残留（Notification 已 ✅ form/type/closable 新模型），需 dedup-verify |\n615\t| `Popup Box` | Theme | 2 | 🟡 | **大型自定义内容模态壳**（非确认框、非 Message 替代 —— 原写「modal 替代 Message? 需对比验证」的问句 2026-08-13 作废，判据见本文件 §Notification Compare-with + `CLAUDE_DESIGN_RULES.md` §3）|\n616\t| `Rating` | theme×value | 10 | 🟡 | 评分 |\n617\t| `select box/line` | 同 select box/filled | 144 | 🟡 | line 版本（select box/filled 已 ✅）|\n618\t| `Slider` | theme×size | 4 | 🟡 | 滑块 |\n619\t| `Step/Item` | direction×style×state | 9 | 🟡 | 步骤条单项 |\n620\t\n621\t---\n622\t\n623\t## Icons (644 total · 28 namespaces)\n624\t\n625\t**直接用，不要用 Unicode glyph 替代。** 命名清晰：`icon/Action/Concept`。\n626\t\n627\t| Namespace | Count | 主要 icon | Notes |\n628\t|---|---|---|---|\n629\t| `icon/output` | 81 | — | 输出/视频/流 类 |\n630\t| `icon/Video` | 57 | `Video/go to` (跳转/外链) | broadcast 视频操作 |\n631\t| `icon/indicator` | 51 | — | 状态指示 dot/glow 等 |\n632\t| `icon/input` | 41 | `input/SRT` | 输入信号源类型 |\n633\t| `icon/file` | 40 | `file/log` | 文件操作 |\n634\t| `icon/Meeting` | 38 | — | 会议/通讯 |\n635\t| `icon/Edit` | 37 | `Edit/Add 1`, `Edit/Delete` (X 关闭/移除), `Edit/Edit`, `Edit/Copy` | 编辑/CRUD |\n636\t| `icon/Preview` | 31 | `Preview/Hide` | preview/眼睛切换 |\n637\t| `icon/user` | 29 | `user/ID` | 用户标识 |\n638\t| `icon/Picture` | 24 | — | 图片操作 |\n639\t| `icon/mark` | 23 | — | 标记/书签 |\n640\t| `icon/others` | 21 | `others/global control` | 杂项 |\n641\t| `icon/audio` | 17 | — | 音频操作 |\n642\t| `icon/Message` | 17 | `Message/Notification 2` | 消息提示 |\n643\t| `icon/Arrow` | 16 | `Arrow/Double up` (展开↑), `Arrow/Double down` (折叠↓), `Arrow/Dropdown`, `Arrow/Sorting` | 方向/箭头 |\n644\t| `icon/network` | 16 | — | 网络/连接 |\n645\t| `icon/Filter` | 15 | `MMA/filter` (待验证 namespace) | 过滤 |\n646\t| `icon/Setting` | 14 | `Setting/Setting 1`, `Setting/Switch` | 设置 |\n647\t| `icon/Time` | 13 | — | 时间/时钟 |\n648\t| `icon/Feature` | 11 | — | 功能特性标记 |\n649\t| `icon/share` | 11 | — | 分享/外发 |\n650\t| `icon/Cut` | 10 | `Cut/Hard cut`, `Cut/Dissolve` | 视频剪辑过渡 |\n651\t| `icon/Menu` | 9 | `menu/3` | 菜单触发 |\n652\t| `icon/pay` | 9 | — | 计费 |\n653\t| `icon/Search` | 5 | `MMA/search` | 搜索 |\n654\t| `icon/location` | 5 | — | 地理位置 |\n655\t| `icon/load` | 4 | — | loading 状态 |\n656\t| `icon/logo` | 2 | `logo/TVU` | 品牌 logo |\n657\t\n658\t### 已知具体 icon (用过实证 key)\n659\t\n660\t| Icon name | Key | 语义 |\n661\t|---|---|---|\n662\t| `icon/Arrow/Double up` | `2be13b82bf5bb8e32142e82d06bc20a14cfb79c2` | card 展开（点击折叠） |\n663\t| `icon/Arrow/Double down` | `9b7938b81ceba8cb1a55661a9fbbfaa5980a6493` | card 折叠（点击展开） |\n664\t| `icon/Arrow/Dropdown` | `eba15c0b438d16e88b86ffebe86423aabef212e9` | dropdown trigger |\n665\t| `icon/PP/play` | `260bf857862c7294aaaf3b8883efbc7a7d757e9f` | \"Start\" action（Start In / Start Out） |\n666\t| `icon/Edit/Delete` | `6379e02068f1cad59776d408d63cb9f4b416a594` | \"Remove\" / X close |"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"8f5581b2-1aac-42aa-b660-6dc8468bfba9","timestamp":"2026-08-25T10:17:24.369Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/figma-component-catalog.md","content":"### Chart\n- **Library key**: `TBD — import on next use`\n- **Axes**: `type` (pie / donut / line / bar / bar-horizontal / line-bar)\n- **Variants**: 6\n- **Code mapping**: `Chart` (status: approved)\n\n#### Primary use\n数据可视化组件——ECharts 封装，按 `type` 渲染 6 种图，`datasets` 驱动 + 内置 12 色调色板与主题感知图例。展示统计数据时用，**禁止直接引 ECharts 或自画 SVG**。\n\n#### Extension scenarios\n- **饼图 / 环形图**：`type=pie` / `type=donut` —— 占比/构成可视化\n- **折线图**：`type=line` —— 趋势/时间序列（多系列）\n- **柱状图 / 横向柱状图**：`type=bar` / `type=bar-horizontal` —— 分类对比，`bar-horizontal` 走 `indexAxis: 'y'`\n- **折柱混合**：`type=line-bar` —— 同图叠加柱与线，每 dataset 用 `dataset.type='bar'|'line'` 指定\n\n#### Don't use for\n- 单一百分比进度 —— 用 `Progress`，不要为一个值开 Chart\n- 别直接引 ECharts 或自画 svg 图表 —— 用 `Chart`，类型走 `type`、数据走 `datasets`\n\n---\n\n### Progress\n- **Library key**: `TBD — import on next use`\n- **Axes**: `theme` (dark / light) × `status` (default / success / error / warning) × `size` (M / S)\n- **Variants**: 16\n- **Code mapping**: `Progress` (status: approved)\n\n#### Primary use\n只读进度条——百分比值（`value` 0–100）+ 状态填充色 + 可选百分比标签（`showLabel` 默认 true）。展示任务完成度时用；可拖动选值用 `Slider`。\n\n#### Extension scenarios\n- **任务完成度（中性）**：`status=default`（或 `success`）—— 填充色 `--brand`（绿）\n- **失败 / 错误进度**：`status=error` —— 填充色 `--red`\n- **告警进度**：`status=warning` —— 填充色 `--orange`\n- **紧凑布局**：`size=S` —— 更细轨道，用于行内/卡片内空间紧张处；默认 `M`\n\n#### Don't use for\n- 可交互取值 / 滑动设值 —— 用 `Slider`（Progress 是只读 indicator）\n- 多值/趋势可视化 —— 用 `Chart`\n- 别用嵌套 div + width% 自画进度条 —— 用 `Progress`，值走 `value`、标签走 `showLabel`\n\n> ⚠️ `status`（default/success/error/warning）是通用进度语义（错=红、警=橙、成功/默认=brand 绿），**不是** domain-tvu M3 的 broadcast Live/Preview 映射——复用同组 token 但语义轴不同。\n\n---\n\n## 🟡 Skeleton — Other Library Components\n\n> **2026-06-15 批量回填**：11 个常用件（Table / Pagination / Form Item / check box / radio / switch / InputNumber / select box/filled / Drop down List/Select / Chart / Progress）已从本表升 ✅ Verified（见上）—— 变体/轴对**已同步库真源**（`components.manifest.json` / `docs-figma-members/*`，drift=0）核实，使用语义 grounded in 组件代码 + docs page + `component-affordances.json` + domain 规则。**Library key 按本节约定标 `TBD — import on next use`**（首次 mockup import 时回填；Claude Design 消费用指导+token、不依赖 key）。\n\n下表列出其余尚未 verify 的 component_sets，按字母排序。**Library keys 留空**（用时 import 一次填回；优先 grep 这个表确认是否存在再 import）。其中 leak / 非组件 / 旧库残留（`After selecting R wi` / `auto recover` / `Home` / `Brand color` / `Neutral Color` / `Icon Guides 16*16` / `Dark·Light/*-btn` 系列）应 prune 或标 deprecated，不升 Verified。\n\n| Component | Axes | Variants | Status | Notes |\n|---|---|---|---|---|\n| `After selecting R wi` | — | 1 | 🟡 | 名字像 file-internal 标记，可能是 leak，需验（prune 候选）|\n| `auto recover` | — | 1 | 🟡 | 同上（prune 候选）|\n| `Brand color` | — | 1 | 🟡 | 色板示例，**非组件**（prune 候选）|\n| `Breadcrumb/Item` | state | 4 | 🟡 | navigation breadcrumb 单项 |\n| `Button/dark L` | icon×style×color×status×radius×fixedWidth | 400 | 🟡 | Button/dark M（✅）的 large 版本 (40px)，用法同 M |\n| `Button/dark S` | 同上 | 400 | 🟡 | small 版本 (28px)，用法同 Button/dark M（✅）|\n| `Button/dark XS` | 同上 | 400 | 🟡 | ⚠️ operator console **不要用** (M7) |\n| `Button/light L` | 同上 | 400 | 🟡 | light theme |\n| `Button/light M` | 同上 | 400 | 🟡 | light theme |\n| `Button/light S` | 同上 | 400 | 🟡 | light theme |\n| `Button/light XS` | 同上 | 400 | 🟡 | light theme |\n| `Button/url link` | dark theme×status | 4 | 🟡 | 链接样式按钮 |\n| `Dark/filled btn` | Property 1 | 3 | 🟡 | **旧库残留**，优先用 `Button/dark M`（✅）（deprecate 候选）|\n| `Dark/outlined btn` | Property 1 | 3 | 🟡 | 同上（deprecate 候选）|\n| `Dark/text btn` | Property 1 | 3 | 🟡 | 同上（deprecate 候选）|\n| `Drop down List/Cascading` | Dark Theme×Type | 4 | 🟡 | 级联下拉 |\n| `Drop down List/Item` | Theme×Type×IsParent×Checked×Active×Disabled×Hover | 41 | 🟡 | 下拉单项（通常经 `Drop down List/Select`（✅）消费）|\n| `Home` | — | 1 | 🟡 | 名字异常，可能 leak（prune 候选）|\n| `Icon Guides 16*16` | — | 1 | 🟡 | 设计指引**非组件**（prune 候选）|\n| `input box/line` | 同 input box/filled | 112 | 🟡 | line 风格（input box/filled 已 ✅）|\n| `Light/filled btn` | Property 1 | 3 | 🟡 | **旧库残留**（deprecate 候选）|\n| `Light/outlined btn` | Property 1 | 3 | 🟡 | 旧库残留（deprecate 候选）|\n| `Light/text btn` | Property 1 | 3 | 🟡 | 旧库残留（deprecate 候选）|\n| `Neutral Color` | — | 1 | 🟡 | 色板示例，**非组件**（prune 候选）|\n| `Notification` | theme×status | 14 | 🟡 | inline message banner —— ⚠️ 疑为旧模型残留（Notification 已 ✅ form/type/closable 新模型），需 dedup-verify |\n| `Popup Box` | Theme | 2 | 🟡 | **大型自定义内容模态壳**（非确认框、非 Message 替代 —— 原写「modal 替代 Message? 需对比验证」的问句 2026-08-13 作废，判据见本文件 §Notification Compare-with + `CLAUDE_DESIGN_RULES.md` §3）|\n| `Rating` | theme×value | 10 | 🟡 | 评分 |\n| `select box/line` | 同 select box/filled | 144 | 🟡 | line 版本（select box/filled 已 ✅）|\n| `Slider` | theme×size | 4 | 🟡 | 滑块 |\n| `Step/Item` | direction×style×state | 9 | 🟡 | 步骤条单项 |\n\n---\n\n## Icons (644 total · 28 namespaces)\n\n**直接用，不要用 Unicode glyph 替代。** 命名清晰：`icon/Action/Concept`。\n\n| Namespace | Count | 主要 icon | Notes |\n|---|---|---|---|\n| `icon/output` | 81 | — | 输出/视频/流 类 |\n| `icon/Video` | 57 | `Video/go to` (跳转/外链) | broadcast 视频操作 |\n| `icon/indicator` | 51 | — | 状态指示 dot/glow 等 |\n| `icon/input` | 41 | `input/SRT` | 输入信号源类型 |\n| `icon/file` | 40 | `file/log` | 文件操作 |\n| `icon/Meeting` | 38 | — | 会议/通讯 |\n| `icon/Edit` | 37 | `Edit/Add 1`, `Edit/Delete` (X 关闭/移除), `Edit/Edit`, `Edit/Copy` | 编辑/CRUD |\n| `icon/Preview` | 31 | `Preview/Hide` | preview/眼睛切换 |\n| `icon/user` | 29 | `user/ID` | 用户标识 |\n| `icon/Picture` | 24 | — | 图片操作 |\n| `icon/mark` | 23 | — | 标记/书签 |\n| `icon/others` | 21 | `others/global control` | 杂项 |\n| `icon/audio` | 17 | — | 音频操作 |\n| `icon/Message` | 17 | `Message/Notification 2` | 消息提示 |\n| `icon/Arrow` | 16 | `Arrow/Double up` (展开↑), `Arrow/Double down` (折叠↓), `Arrow/Dropdown`, `Arrow/Sorting` | 方向/箭头 |\n| `icon/network` | 16 | — | 网络/连接 |\n| `icon/Filter` | 15 | `MMA/filter` (待验证 namespace) | 过滤 |\n| `icon/Setting` | 14 | `Setting/Setting 1`, `Setting/Switch` | 设置 |\n| `icon/Time` | 13 | — | 时间/时钟 |\n| `icon/Feature` | 11 | — | 功能特性标记 |\n| `icon/share` | 11 | — | 分享/外发 |\n| `icon/Cut` | 10 | `Cut/Hard cut`, `Cut/Dissolve` | 视频剪辑过渡 |\n| `icon/Menu` | 9 | `menu/3` | 菜单触发 |\n| `icon/pay` | 9 | — | 计费 |\n| `icon/Search` | 5 | `MMA/search` | 搜索 |\n| `icon/location` | 5 | — | 地理位置 |\n| `icon/load` | 4 | — | loading 状态 |\n| `icon/logo` | 2 | `logo/TVU` | 品牌 logo |\n\n### 已知具体 icon (用过实证 key)\n\n| Icon name | Key | 语义 |\n|---|---|---|\n| `icon/Arrow/Double up` | `2be13b82bf5bb8e32142e82d06bc20a14cfb79c2` | card 展开（点击折叠） |\n| `icon/Arrow/Double down` | `9b7938b81ceba8cb1a55661a9fbbfaa5980a6493` | card 折叠（点击展开） |\n| `icon/Arrow/Dropdown` | `eba15c0b438d16e88b86ffebe86423aabef212e9` | dropdown trigger |\n| `icon/PP/play` | `260bf857862c7294aaaf3b8883efbc7a7d757e9f` | \"Start\" action（Start In / Start Out） |\n| `icon/Edit/Delete` | `6379e02068f1cad59776d408d63cb9f4b416a594` | \"Remove\" / X close |","numLines":130,"startLine":537,"totalLines":763}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"f69067d4-a8c2-4ec1-98a5-e838e590e8eb","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":100,"estimated_tokens_delta":50,"uuid":"3f89531a-8353-42f6-ac90-93d90fc94c52","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":200,"estimated_tokens_delta":100,"uuid":"3430b085-986f-446a-9f0a-5aa17798eb08","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":350,"estimated_tokens_delta":150,"uuid":"42a48ddc-1dec-4e07-8b6d-71ccd7d1f414","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":450,"estimated_tokens_delta":100,"uuid":"c7fe6b4d-4b25-447d-baf1-21b870079662","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":600,"estimated_tokens_delta":150,"uuid":"4b780f4a-fdc5-4e75-b6e9-668421a5a7a3","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":700,"estimated_tokens_delta":100,"uuid":"77d9cc22-c111-4d06-9fbb-198cd53235d8","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":800,"estimated_tokens_delta":100,"uuid":"80912791-ae6c-466a-b1ef-91bebfe7159e","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":950,"estimated_tokens_delta":150,"uuid":"d3ce6568-0d0b-480b-8a52-168648a6a30b","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1050,"estimated_tokens_delta":100,"uuid":"f8cad9a0-0222-4313-a6e5-0bbb73d59125","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1150,"estimated_tokens_delta":100,"uuid":"4042ba3c-8ceb-499a-84e5-a7d987fe2340","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ35LDdRts6yG5fRWQ5","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"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"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":5756,"cache_read_input_tokens":147403,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":5756},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"2695bb0a-7380-46f1-8e86-4d965f1ffd52","timestamp":"2026-08-25T10:17:44.571Z","request_id":"req_011CePJ319CmGm5cXxbqbuTv"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ35LDdRts6yG5fRWQ5","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01Rhr3sV9fkCkHC5biKb2yaD","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/canonical/Chart.vue"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":5756,"cache_read_input_tokens":147403,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":5756},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"56ba5061-d6a8-4bcd-ac9f-5c2bc573551e","timestamp":"2026-08-25T10:17:45.374Z","request_id":"req_011CePJ319CmGm5cXxbqbuTv"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01Rhr3sV9fkCkHC5biKb2yaD","type":"tool_result","content":"1\t\n27\t\n28\t\n38\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"78a537cd-f1c8-4ed0-b073-1523a16e33c4","timestamp":"2026-08-25T10:17:45.380Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/canonical/Chart.vue","content":"\n\n\n","numLines":38,"startLine":1,"totalLines":38}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"2c183487-b441-43fd-a376-8e077bf0b656","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":87,"estimated_tokens_delta":37,"uuid":"51e29bed-1312-4dfe-9165-8c65145460f9","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ4dyXiNXpqPs1T7pUh","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAIS1QIKpgEIERgCKkC/XU14SQxnyt+toWkYWXW+avMaCQmaTBmiigE8CHtCt2+lRihXmnl4BQgdiy+r+3k8znzOBGgzv1frdGaiHtFnMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAc7XtdQGsAECEgxkC2IcdgeaXvNFnUgaDIyMY/RkuwA8XNClMSIwwbwnZcDUtlgYVAS9NyXEtA43xNhIwiyOqf9I3sp670L3IazWWHeF2WzXsYnCzuFZKlxTwdyvx4NtF3Dq+1/LO3l9gsknhK+UAdLfPrBGoAaHw1qiskL/WXe63aBkOQav5h/kWIxNgsMgbVbjJ1yfT8PsEWT7sozwiKOMbt3OAohzmV/F55AFxCDpQ9NIERgB"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1744,"cache_read_input_tokens":153159,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1744},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"ceae759b-4b39-4bdc-943e-430083be16c4","timestamp":"2026-08-25T10:17:50.039Z","request_id":"req_011CePJ4Z1dfiyX1FyXadz6H"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ4dyXiNXpqPs1T7pUh","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01LHqrzndrE9aZT83iz66X4B","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Chart/Chart.vue"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1744,"cache_read_input_tokens":153159,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1744},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"6b476b80-8f0d-4443-a990-ef36ae0ea2c7","timestamp":"2026-08-25T10:17:50.461Z","request_id":"req_011CePJ4Z1dfiyX1FyXadz6H"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01LHqrzndrE9aZT83iz66X4B","type":"tool_result","content":"1\t\n76\t\n77\t\n86\t\n87\t\n100\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"af5b19d9-3a07-43e7-a59e-297a139c8822","timestamp":"2026-08-25T10:17:50.473Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Chart/Chart.vue","content":"\n\n\n\n\n","numLines":100,"startLine":1,"totalLines":100}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ51kiWPdYMeH844foN","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_015bmr51jVfP9tjBykvsubBD","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Chart/use-chart-tokens.ts"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1560,"cache_read_input_tokens":154903,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1560},"output_tokens":17,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"f6b26ee9-b7e3-4d55-a16d-a98408ac4c3a","timestamp":"2026-08-25T10:17:55.625Z","request_id":"req_011CePJ4vsHKLTXMekrsaygc"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_015bmr51jVfP9tjBykvsubBD","type":"tool_result","content":"1\t/**\n2\t * Resolve --chart-color-1..12 from document.documentElement at runtime.\n3\t * Returns hex array. Re-call on theme switch to get current theme values.\n4\t */\n5\texport function resolveChartPalette(): string[] {\n6\t if (typeof document === 'undefined') {\n7\t // SSR-safe fallback (default dark theme hex values)\n8\t return [\n9\t '#2fb54e', '#ea4233', '#3892f3', '#f68512', '#2dceae', '#d8c537',\n10\t '#9a4ee5', '#e54eb4', '#4e6ee5', '#e57a4e', '#c47de8', '#a3d837',\n11\t ]\n12\t }\n13\t const style = getComputedStyle(document.documentElement)\n14\t return Array.from({ length: 12 }, (_, i) =>\n15\t style.getPropertyValue(`--chart-color-${i + 1}`).trim() || '#000000'\n16\t )\n17\t}\n18\t\n19\t/**\n20\t * Resolve a single CSS custom property from document.documentElement at runtime.\n21\t * Re-call on theme switch to pick up the current theme value.\n22\t */\n23\texport function resolveCssVar(name: string, fallback: string): string {\n24\t if (typeof document === 'undefined') return fallback\n25\t return getComputedStyle(document.documentElement).getPropertyValue(name).trim() || fallback\n26\t}\n27\t\n28\t/**\n29\t * Legend text colour — Figma `Color Type/text/text_2` (--text-2: #cccccc dark /\n30\t * #434343 light). The ECharts option takes resolved colour strings, so the no-DOM\n31\t * fallback hex lives here in the resolution layer (same pattern as\n32\t * resolveChartPalette), keeping component .vue files literal-hex-free\n33\t * (AGENTS.md hard rule #4 / audit:design-system).\n34\t */\n35\texport function resolveLegendColor(): string {\n36\t return resolveCssVar('--text-2', '#cccccc')\n37\t}\n38\t\n39\t/**\n40\t * Axis / grid divider colour — Figma-aligned semantic token --line-divider-light\n41\t * (= var(--line-light): #434343 dark / #cccccc light). Drives chart axis lines,\n42\t * ticks and grid split lines. Like resolveLegendColor, the no-DOM fallback hex\n43\t * lives here in the resolution layer so component .vue files stay literal-hex-free\n44\t * (AGENTS.md hard rule #4 / audit:design-system / eslint no-hardcoded-color).\n45\t */\n46\texport function resolveAxisLineColor(): string {\n47\t return resolveCssVar('--line-divider-light', '#434343')\n48\t}\n49\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"848404bc-4698-4340-98ea-d767c674438a","timestamp":"2026-08-25T10:17:55.631Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Chart/use-chart-tokens.ts","content":"/**\n * Resolve --chart-color-1..12 from document.documentElement at runtime.\n * Returns hex array. Re-call on theme switch to get current theme values.\n */\nexport function resolveChartPalette(): string[] {\n if (typeof document === 'undefined') {\n // SSR-safe fallback (default dark theme hex values)\n return [\n '#2fb54e', '#ea4233', '#3892f3', '#f68512', '#2dceae', '#d8c537',\n '#9a4ee5', '#e54eb4', '#4e6ee5', '#e57a4e', '#c47de8', '#a3d837',\n ]\n }\n const style = getComputedStyle(document.documentElement)\n return Array.from({ length: 12 }, (_, i) =>\n style.getPropertyValue(`--chart-color-${i + 1}`).trim() || '#000000'\n )\n}\n\n/**\n * Resolve a single CSS custom property from document.documentElement at runtime.\n * Re-call on theme switch to pick up the current theme value.\n */\nexport function resolveCssVar(name: string, fallback: string): string {\n if (typeof document === 'undefined') return fallback\n return getComputedStyle(document.documentElement).getPropertyValue(name).trim() || fallback\n}\n\n/**\n * Legend text colour — Figma `Color Type/text/text_2` (--text-2: #cccccc dark /\n * #434343 light). The ECharts option takes resolved colour strings, so the no-DOM\n * fallback hex lives here in the resolution layer (same pattern as\n * resolveChartPalette), keeping component .vue files literal-hex-free\n * (AGENTS.md hard rule #4 / audit:design-system).\n */\nexport function resolveLegendColor(): string {\n return resolveCssVar('--text-2', '#cccccc')\n}\n\n/**\n * Axis / grid divider colour — Figma-aligned semantic token --line-divider-light\n * (= var(--line-light): #434343 dark / #cccccc light). Drives chart axis lines,\n * ticks and grid split lines. Like resolveLegendColor, the no-DOM fallback hex\n * lives here in the resolution layer so component .vue files stay literal-hex-free\n * (AGENTS.md hard rule #4 / audit:design-system / eslint no-hardcoded-color).\n */\nexport function resolveAxisLineColor(): string {\n return resolveCssVar('--line-divider-light', '#434343')\n}\n","numLines":49,"startLine":1,"totalLines":49}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ51kiWPdYMeH844foN","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01SdzNTUbTf7QpbJRV6H4YKL","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Chart/build-chart-option.ts"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1560,"cache_read_input_tokens":154903,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1560},"output_tokens":17,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"1c9ac352-e526-4162-a80d-9b1fd87a9540","timestamp":"2026-08-25T10:17:56.265Z","request_id":"req_011CePJ4vsHKLTXMekrsaygc"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01SdzNTUbTf7QpbJRV6H4YKL","type":"tool_result","content":"1\t// props → ECharts option 的纯函数。抽成纯函数是为了可单测（Chart.vue 只留 init /\n2\t// resize / theme 那部分 shadow-DOM 副作用）。\n3\t// 设计见 docs/superpowers/specs/2026-07-01-echarts-migration-and-dual-framework-demo-design.md\n4\t//（§3.2 按需注册清单 = tree-shaking 承重前提，禁 `import * from 'echarts'` ·\n5\t// §3.3 六种 type 的映射表 · §3.4 为什么是 SVGRenderer 而非 Canvas（render-gate 要能读节点））\n6\texport type ChartType = 'pie' | 'donut' | 'line' | 'bar' | 'bar-horizontal' | 'line-bar'\n7\t\n8\texport interface ChartDatasetInput {\n9\t label: string\n10\t data: number[]\n11\t type?: 'line' | 'bar'\n12\t color?: string\n13\t}\n14\t\n15\texport interface BuildOptionCtx {\n16\t palette: string[]\n17\t legendColor: string\n18\t fontFamily: string\n19\t /** Resolved divider colour for axis lines, ticks and grid split lines (theme-aware). */\n20\t axisLineColor: string\n21\t}\n22\t\n23\tinterface BuildProps {\n24\t type: ChartType\n25\t datasets: ChartDatasetInput[]\n26\t labels: string[]\n27\t}\n28\t\n29\texport function buildChartOption(props: BuildProps, ctx: BuildOptionCtx): Record {\n30\t const legend = {\n31\t bottom: 0,\n32\t icon: 'circle',\n33\t itemWidth: 8,\n34\t itemHeight: 8,\n35\t textStyle: { color: ctx.legendColor, fontFamily: ctx.fontFamily, fontSize: 12 },\n36\t }\n37\t\n38\t if (props.type === 'pie' || props.type === 'donut') {\n39\t const first = props.datasets[0]\n40\t return {\n41\t color: ctx.palette,\n42\t legend,\n43\t tooltip: { trigger: 'item' },\n44\t series: [{\n45\t type: 'pie',\n46\t radius: props.type === 'donut' ? ['40%', '70%'] : '70%',\n47\t // Slice labels off: the bottom legend already identifies every slice, and\n48\t // ECharts' default outside labels + leader lines clutter / clip in the\n49\t // design system's narrow chart cards.\n50\t label: { show: false },\n51\t data: (first?.data ?? []).map((value, i) => ({ value, name: props.labels[i] ?? String(i) })),\n52\t }],\n53\t }\n54\t }\n55\t\n56\t const isHorizontal = props.type === 'bar-horizontal'\n57\t // Axis lines / ticks / grid split lines all use the theme-aware divider colour\n58\t // (resolved from --line-divider-light); tick labels reuse the legend text colour.\n59\t // Without these ECharts falls back to a built-in light grey that reads as white\n60\t // in the dark theme.\n61\t const axisLabel = { color: ctx.legendColor }\n62\t const axisLine = { lineStyle: { color: ctx.axisLineColor } }\n63\t const axisTick = { lineStyle: { color: ctx.axisLineColor } }\n64\t const splitLine = { lineStyle: { color: ctx.axisLineColor } }\n65\t const categoryAxis = { type: 'category', data: props.labels, axisLine, axisTick, axisLabel }\n66\t const valueAxis = { type: 'value', axisLine, axisTick, axisLabel, splitLine }\n67\t\n68\t const series = props.datasets.map((d) => {\n69\t const seriesType =\n70\t props.type === 'line' ? 'line'\n71\t : props.type === 'bar' || props.type === 'bar-horizontal' ? 'bar'\n72\t : (d.type ?? 'bar')\n73\t return {\n74\t name: d.label,\n75\t type: seriesType,\n76\t data: d.data,\n77\t ...(d.color ? { itemStyle: { color: d.color } } : {}),\n78\t }\n79\t })\n80\t\n81\t return {\n82\t color: ctx.palette,\n83\t legend,\n84\t tooltip: { trigger: 'axis' },\n85\t // containLabel lets the grid auto-reserve room for axis category labels, so\n86\t // long labels (e.g. bar-horizontal's Y-axis categories) are never clipped by\n87\t // the narrow chart card's left edge.\n88\t grid: { containLabel: true },\n89\t xAxis: isHorizontal ? valueAxis : categoryAxis,\n90\t yAxis: isHorizontal ? categoryAxis : valueAxis,\n91\t series,\n92\t }\n93\t}\n94\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"836ebc34-ac3b-48bd-bea0-0fba2828c934","timestamp":"2026-08-25T10:17:56.274Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Chart/build-chart-option.ts","content":"// props → ECharts option 的纯函数。抽成纯函数是为了可单测（Chart.vue 只留 init /\n// resize / theme 那部分 shadow-DOM 副作用）。\n// 设计见 docs/superpowers/specs/2026-07-01-echarts-migration-and-dual-framework-demo-design.md\n//（§3.2 按需注册清单 = tree-shaking 承重前提，禁 `import * from 'echarts'` ·\n// §3.3 六种 type 的映射表 · §3.4 为什么是 SVGRenderer 而非 Canvas（render-gate 要能读节点））\nexport type ChartType = 'pie' | 'donut' | 'line' | 'bar' | 'bar-horizontal' | 'line-bar'\n\nexport interface ChartDatasetInput {\n label: string\n data: number[]\n type?: 'line' | 'bar'\n color?: string\n}\n\nexport interface BuildOptionCtx {\n palette: string[]\n legendColor: string\n fontFamily: string\n /** Resolved divider colour for axis lines, ticks and grid split lines (theme-aware). */\n axisLineColor: string\n}\n\ninterface BuildProps {\n type: ChartType\n datasets: ChartDatasetInput[]\n labels: string[]\n}\n\nexport function buildChartOption(props: BuildProps, ctx: BuildOptionCtx): Record {\n const legend = {\n bottom: 0,\n icon: 'circle',\n itemWidth: 8,\n itemHeight: 8,\n textStyle: { color: ctx.legendColor, fontFamily: ctx.fontFamily, fontSize: 12 },\n }\n\n if (props.type === 'pie' || props.type === 'donut') {\n const first = props.datasets[0]\n return {\n color: ctx.palette,\n legend,\n tooltip: { trigger: 'item' },\n series: [{\n type: 'pie',\n radius: props.type === 'donut' ? ['40%', '70%'] : '70%',\n // Slice labels off: the bottom legend already identifies every slice, and\n // ECharts' default outside labels + leader lines clutter / clip in the\n // design system's narrow chart cards.\n label: { show: false },\n data: (first?.data ?? []).map((value, i) => ({ value, name: props.labels[i] ?? String(i) })),\n }],\n }\n }\n\n const isHorizontal = props.type === 'bar-horizontal'\n // Axis lines / ticks / grid split lines all use the theme-aware divider colour\n // (resolved from --line-divider-light); tick labels reuse the legend text colour.\n // Without these ECharts falls back to a built-in light grey that reads as white\n // in the dark theme.\n const axisLabel = { color: ctx.legendColor }\n const axisLine = { lineStyle: { color: ctx.axisLineColor } }\n const axisTick = { lineStyle: { color: ctx.axisLineColor } }\n const splitLine = { lineStyle: { color: ctx.axisLineColor } }\n const categoryAxis = { type: 'category', data: props.labels, axisLine, axisTick, axisLabel }\n const valueAxis = { type: 'value', axisLine, axisTick, axisLabel, splitLine }\n\n const series = props.datasets.map((d) => {\n const seriesType =\n props.type === 'line' ? 'line'\n : props.type === 'bar' || props.type === 'bar-horizontal' ? 'bar'\n : (d.type ?? 'bar')\n return {\n name: d.label,\n type: seriesType,\n data: d.data,\n ...(d.color ? { itemStyle: { color: d.color } } : {}),\n }\n })\n\n return {\n color: ctx.palette,\n legend,\n tooltip: { trigger: 'axis' },\n // containLabel lets the grid auto-reserve room for axis category labels, so\n // long labels (e.g. bar-horizontal's Y-axis categories) are never clipped by\n // the narrow chart card's left edge.\n grid: { containLabel: true },\n xAxis: isHorizontal ? valueAxis : categoryAxis,\n yAxis: isHorizontal ? categoryAxis : valueAxis,\n series,\n }\n}\n","numLines":94,"startLine":1,"totalLines":94}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":100,"estimated_tokens_delta":100,"uuid":"df97383a-bd16-4820-a433-6c1c69f4e4d6","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":200,"estimated_tokens_delta":100,"uuid":"15a2cc36-9b52-4d41-8e59-9cd3f142ee7e","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ5SB9V4kyx2KeQ1vje","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISrQUKpgEIERgCKkA7YXploJ7VeKwFuKuEE0qtElSQfFs4udp6W2f0FjqIAYCSxNLwRwWlR4g4aD8vjC/BXDbEr5w+AR7B4CUKbq1MMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAdrXtdQGsAECEgz+hS5/Mv6ZM+V1YsIaDBYhptglUVM1l+HFTiIwFI2TWPFISC2coKtbty9u7e8g0cuDPRWgqscv3GIchQHzi/dNCGdYdi0A76WpDm21KrMDq1rnwBEsGbaO1te6rHqO/6a40M7pelB3huioPl5tR06jsprwonIN5SB0aJlb5XnFV4zabE3oHTCLor7O3xFXjPWmheE5c9qlBj7t2U+pWql8BFsA3sGv8rSc8uCkU0pjBvgqAfHKFlmqLMGM2V0cieUtYKGpvxoI2KfqD8XlOCiJPCrXKzizbcRDHvi1c2+HKM2JB2Hb3MYM/0UMCakDbCoLGYl9tviFmtAh8O82jEYZvPmhqVzthTqJwtbcZ5nKHiGJONY/g6IyajGGukIjuqfHhY4aolJymD8G8+IRotoL0jkmTjBnP8oMCQdYUgToHqtwBpiFZKxwJ9x6ReVuGSonvGSWg8lOFjUNaFNWkiglJai84d7vDZ+Qh+2f7eYAzVoUk2+6cxSeyjDFxsdzFKRRMuyf1D+ujgNkkLoVneyEsOOQ5Ayn3QtO5LPQsDGPmPeSeeX0bqzSnAsItjBmnQzm9ym7/OESDc+4wo2wOiTQisTYWFEJYkR2C03Xracxc9gebXRvt7gOHL5FYib+lZaacLfQko82dF9i20561LhXp3E9FEuurV/umkC6jlzp0L5PGAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":2901,"cache_read_input_tokens":156463,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2901},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"2499bcfd-456c-4fec-b81c-40913d389435","timestamp":"2026-08-25T10:18:02.165Z","request_id":"req_011CePJ5MtgG7tE5jY81W9fJ"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ5SB9V4kyx2KeQ1vje","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01CKeJZeXftF83zFzynASKy1","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/tokens/variables.css"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":2901,"cache_read_input_tokens":156463,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2901},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"6086e191-6b59-40eb-8398-a14c2e61f994","timestamp":"2026-08-25T10:18:02.888Z","request_id":"req_011CePJ5MtgG7tE5jY81W9fJ"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01CKeJZeXftF83zFzynASKy1","type":"tool_result","content":"1\t/* AUTO-GENERATED — Figma-synced tokens refreshed; code-authored tokens PRESERVED.\n2\t *\n3\t * SYNCED FROM FIGMA by `pnpm generate` (source figma-data/normalized/variables.json) —\n4\t * all 54 Figma Variables, matched BY NAME. NOT just the raw palette (--color-grey-*,\n5\t * --brand, --red, --orange, --blue): it INCLUDES the semantic color layer (Figma\n6\t * \"Color Type/*\" → --text-*, --icon-*, --bg-*, --line-*). Gated by `pnpm audit:token-contract`.\n7\t * Do NOT hand-edit their values — edit Figma + re-sync. (The semantic color ones ARE\n8\t * Figma-sourced even though they look \"authored\"; hand-editing them fails the gate.)\n9\t * CODE-AUTHORED (no Figma Variable; PRESERVED verbatim) — spacing (--sp-*), control sizing,\n10\t * effect/text-style composites, component-variant (--notification-* / --progress-* / --slider-*),\n11\t * derived aliases. Values hand-aligned to Figma Styles/nodes; NOT gated.\n12\t *\n13\t * Dark/Light theme: apply [data-theme=\"light\"] to to switch to light mode.\n14\t */\n15\t\n16\t/* ── Dark mode (default) ── */\n17\t:root {\n18\t /* ===== Neutrals (grey scale, light → dark) ===== */\n19\t --color-white: #ffffff;\n20\t --color-grey-2: #f8f8f8;\n21\t --color-grey-3: #f0f0f0;\n22\t --color-grey-4: #dbdbdb;\n23\t --color-grey-5: #cccccc;\n24\t --color-grey-6: #9e9e9e;\n25\t --color-grey-7: #7b7b7b;\n26\t --color-grey-8: #595959;\n27\t --color-grey-9: #434343;\n28\t --color-grey-10: #353535;\n29\t --color-grey-11: #262626;\n30\t --color-grey-12: #1f1f1f;\n31\t --color-grey-13: #141414;\n32\t --color-grey-14: #000000;\n33\t\n34\t /* ===== Brand & status ===== */\n35\t --brand: #2fb54e;\n36\t --brand-hover: #41c760;\n37\t --brand-match: #0b2b13;\n38\t --brand-disable: #1a652c;\n39\t --red: #ea4233;\n40\t --red-hover: #ed5b4e;\n41\t --red-bg: #fff1f0;\n42\t --orange: #f68512;\n43\t --orange-hover: #f89c3e;\n44\t --orange-bg: #fff3db;\n45\t --orange-tz: #d39f39;\n46\t --blue: #3892f3;\n47\t --blue-hover: #62a9f6;\n48\t --blue-bg: #e1eefd;\n49\t\n50\t /* ===== Message soft backgrounds =====\n51\t BRIDGE-MOCKUP-001: dark-mode 软背景 (tinted ~18% over bg). 见 divergences-decisions.json `msg-bg-tinted-dark-set-2026-05-19`. Figma sync pending. */\n52\t --msg-bg-red: #3b1c1a;\n53\t --msg-bg-brand: #19311e;\n54\t --msg-bg-blue: #1a2b3c;\n55\t --msg-bg-grey: #353535;\n56\t\n57\t /* ===== Text ===== */\n58\t --text-heading: #ffffff;\n59\t --text-body: #f8f8f8;\n60\t --text-2: #cccccc;\n61\t --text-tips: #9e9e9e;\n62\t --text-placeholder: #7b7b7b;\n63\t --text-disabled: #595959;\n64\t --text-grey-en: #cccccc;\n65\t --text-grey-dis: #7b7b7b;\n66\t --text-grey-hv: #cccccc;\n67\t --text-primary-btn: #f8f8f8;\n68\t\n69\t /* ===== Icon ===== */\n70\t --icon-active: #f8f8f8;\n71\t --icon-default: #9e9e9e;\n72\t --icon-disabled: #595959;\n73\t --icon-placeholder: #7b7b7b;\n74\t --icon-grey-dis: #7b7b7b;\n75\t\n76\t /* ===== Surface / background ===== */\n77\t --bg-layer1: #141414;\n78\t --bg-layer2: #1f1f1f;\n79\t --bg-layer3: #262626;\n80\t --bg-layer4: #353535;\n81\t --bg-topbar: #000000;\n82\t --bg-grey-btn-hv: #595959;\n83\t --bg-grey-btn-en: #434343;\n84\t --bg-grey-btn-dis: #434343;\n85\t\n86\t /* ===== Line / border ===== */\n87\t --line-border: #595959;\n88\t --line-deep: #353535;\n89\t --line-light: #434343;\n90\t\n91\t /* ===== Input / select border aliases ===== */\n92\t --input-line-border: var(--color-grey-8);\n93\t --input-disabled-border: var(--color-grey-8);\n94\t --select-line-border: var(--color-grey-8);\n95\t --select-disabled-border: var(--color-grey-8);\n96\t --select-multi-line-border: var(--color-grey-8);\n97\t --select-chip-border: var(--color-grey-9);\n98\t --select-chip-filled-bg: var(--color-grey-13);\n99\t\n100\t /* ===== Chart categorical palette (12 colors) — CANONICAL-011 D1 =====\n101\t 4 reuse existing base hues; 8 new derived by HSL hue rotation\n102\t maintaining S 65-78% / L 50-60% to match brand-level visual weight.\n103\t Order matches Option C warm/cool alternating (1=cool brand → 12=warm). */\n104\t --chart-color-1: var(--brand); /* 134° 绿 (brand) */\n105\t --chart-color-2: var(--red); /* 6° 红 */\n106\t --chart-color-3: var(--blue); /* 211° 蓝 */\n107\t --chart-color-4: var(--orange); /* 31° 橙 */\n108\t --chart-color-5: #2dceae; /* 169° 青绿 */\n109\t --chart-color-6: #d8c537; /* 52° 黄 */\n110\t --chart-color-7: #9a4ee5; /* 265° 紫 */\n111\t --chart-color-8: #e54eb4; /* 320° 洋红 */\n112\t --chart-color-9: #4e6ee5; /* 228° 靛蓝 */\n113\t --chart-color-10: #e57a4e; /* 17° 珊瑚 */\n114\t --chart-color-11: #c47de8; /* 293° lavender */\n115\t --chart-color-12: #a3d837; /* 90° chartreuse */\n116\t}\n117\t\n118\t/* ── Spacing ── */\n119\t:root {\n120\t --sp-xxs: 4px;\n121\t --sp-xs: 8px;\n122\t --sp-s: 12px;\n123\t --sp-m: 16px;\n124\t --sp-l: 24px;\n125\t --sp-xl: 32px;\n126\t --sp-xxl: 40px;\n127\t --sp-xxxl: 56px;\n128\t}\n129\t\n130\t/* ── Radius ── */\n131\t:root {\n132\t --r-xs: 2px;\n133\t --r-s: 4px;\n134\t --r-m: 8px;\n135\t --r-l: 12px;\n136\t --r-xl: 16px;\n137\t --r-xxl: 20px; /* mirror Figma Radius/XXL=20 (was 100px — false alias to radius/xxl, drift 修复 2026-06-12). Switch track(h=20) 仍 pill：border-radius clamp 到 height/2=10 */\n138\t}\n139\t\n140\t/* ── Z-Index / Elevation ──\n141\t code-authored（无 Figma Variable 上游，同 --sp-* 性质 → 不受 audit:token-contract 管，\n142\t 但受 audit:sort-tokens I1/I2 管）。TKN-02：此前 4 个浮层各自写死魔法数字，消费方想把\n143\t 自己的浮层插进这套层级只能猜。\n144\t ⚠️ 每个值都**等于替换前的实测现值**，本组纯命名化、不改任何层叠顺序 —— 刻意不规整成\n145\t 100/200/300，那会改变层叠关系 = 视觉回归。若要整齐标度，另立一项并单独过视觉门。\n146\t 只登记有真实消费者且有实测值的层；`--z-toast` 一类当前无消费者、无实测值，不凭空造。 */\n147\t:root {\n148\t --z-dropdown: 1000; /* UserMenu 面板 */\n149\t --z-tooltip: 1000; /* Tooltip */\n150\t --z-modal: 1000; /* PopupBox */\n151\t --z-select-portal: 1100; /* Select 的 teleport 下拉 —— 高于 modal 是因为 modal 内也放 select */\n152\t}\n153\t\n154\t/* ── Layout breakpoints ──\n155\t code-authored（无 Figma Variable 上游，同 --sp-* / --z-* 性质 → 不受 audit:token-contract 管，\n156\t 受 audit:sort-tokens I1/I2 + audit:layout-tokens 管）。INFRA-F68 DG-1，owner 2026-07-31 拍\n157\t 路线 B（code-first token）；登记在 translation/divergences-decisions.json。\n158\t ⚠️ 四个值**逐字取自替换前仓库里真实在用的 @media 值**（1100/960/640 各出现 2 处，1280 = docs\n159\t 站与视觉闸的 viewport 宽），本组纯命名化、不改任何断点行为 —— 刻意不规整成 600/900/1200/1500，\n160\t 那会改窄屏布局 = 视觉回归，且属 owner/designer 的视觉裁定。\n161\t ⚠️ CSS `@media` 语法吃不了 `var()`，所以\"引用\"的可校验形式 = 字面量必须 ∈ 本组值集合，由\n162\t `pnpm audit:layout-tokens` 机械核（另有 3 条存量一次性值走该闸的具名带日期 shrink-only 豁免）。\n163\t 非 CSS 消费方（AI / 非 web 工具 / consumer JS）走 `./tokens` DTCG + `./tokens/js` 出口，\n164\t 由 generate-token-exports 从本文件派生 —— 值只有这一处定义。 */\n165\t:root {\n166\t --bp-sm: 640px; /* 现用于 docs.css 手机档 / react-pilot chart demo */\n167\t --bp-md: 960px; /* 现用于 ColorPage / react-pilot button demo */\n168\t --bp-lg: 1100px; /* 现用于 docs.css 主栏塌陷 / CanonicalShowcase */\n169\t --bp-xl: 1280px; /* = docs 站与 test:visual 的 viewport 宽 */\n170\t}\n171\t\n172\t/* ── Layout containers ──\n173\t 同上：值逐字取自替换前实测现值，纯命名化。与 --bp-* 的区别 = 容器宽可以直接\n174\t `max-width: var(--container-*)` 引用（CSS 允许），故这几处已改成真引用、不再有字面量副本。\n175\t ⚠️ 仓库里还有一批**内容宽**字面量（600/760/860/900/980/1200 等，各 1-3 处）刻意未纳入：\n176\t 它们是 demo/页面内容宽而非布局容器，硬塞进容器档位就是\"把偶然值当契约\"。audit:layout-tokens\n177\t 会 report-only 逐条印出它们 + 计数，drift 可见但不阻塞。 */\n178\t:root {\n179\t --container-narrow: 720px; /* 正文窄栏 .intro（docs 站 + CanonicalShowcase 两处） */\n180\t --container-prose: 840px; /* 段落摘要 .docs-section__summary */\n181\t --container-page: 1600px; /* CanonicalShowcase 页宽 */\n182\t --container-wide: 1800px; /* docs 站外壳最大宽 */\n183\t}\n184\t\n185\t/* ── Typography ── */\n186\t\n187\t/* TopBar timezone clock face — the SAME font Figma uses.\n188\t Figma 真源 (node 4771:7194) 用 \"Digital Numbers\" by Stephan Ahlf\n189\t (github.com/s-a/digital-numbers-font, SIL OFL 1.1). Figma 按字体名引用，\n190\t 我们 self-host 原版 OFL 文件做到 1:1 一致（非替代字体）。\n191\t 字体文件 + 许可证: src/tokens/fonts/DigitalNumbers-Regular.{woff,ttf} + DigitalNumbers-OFL.txt。 */\n192\t@font-face {\n193\t font-family: 'Digital Numbers';\n194\t src: url('./fonts/DigitalNumbers-Regular.woff') format('woff'),\n195\t url('./fonts/DigitalNumbers-Regular.ttf') format('truetype');\n196\t font-weight: 400;\n197\t font-style: normal;\n198\t font-display: swap;\n199\t}\n200\t\n201\t:root {\n202\t --font-family-en: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, 'Fira Sans',\n203\t 'Droid Sans', 'Helvetica Neue', sans-serif;\n204\t --font-family-zh: 'PingFang SC', 'Microsoft YaHei', Helvetica, Arial, sans-serif;\n205\t --font-family-base: var(--font-family-en), var(--font-family-zh);\n206\t /* TopBar timezone CLOCK FACE ONLY — Figma \"Digital Numbers\" 7-segment LED display\n207\t (self-hosted original, OFL 1.1). Reserved for the clock readout in the top bar,\n208\t paired with --orange-tz (amber). Everything else — UI text AND data (IP / MAC /\n209\t serial / dBm / byte counts) — uses --font-family-base (the normal EN/ZH stack);\n210\t for column-aligned digits add `font-variant-numeric: tabular-nums`. There is\n211\t deliberately NO separate monospace font in this system. */\n212\t --font-family-clock: 'Digital Numbers', 'Courier New', monospace;\n213\t}\n214\t\n215\t/* ── Domain-specific component-variant tokens (theme-stable) ──\n216\t 2026-05-07: 组件内部有 theme variant prop (e.g. Notification theme='light'/'dark')\n217\t 不应使用 site-theme-aware tokens (--bg-layer*)。这里定义 variant-specific 固定值，\n218\t theme-stable (两 site theme 都同值)，对齐 figma 真源 */\n219\t:root {\n220\t /* Notification component variant bg (figma 真源: dark=#353535 grey-10, light=#f8f8f8 grey-2)\n221\t 2026-05-07 D1 correction: light 不是 #ffffff（之前误设），figma 真源是 #f8f8f8 */\n222\t --notification-bg-dark: var(--color-grey-10);\n223\t --notification-bg-light: var(--color-grey-2);\n224\t\n225\t /* === Component-variant theme-stable tokens (D2/D4 — 同 Notification 模式) === */\n226\t /* Tooltip / Progress / Switch / Radio / CheckBox 都有 own theme axis */\n227\t /* Tooltip variant tokens */\n228\t --tooltip-bg-dark: var(--color-grey-10); /* #353535 */\n229\t --tooltip-bg-light: var(--color-white); /* #ffffff */\n230\t --tooltip-border-dark: var(--color-grey-8); /* #595959 */\n231\t --tooltip-border-light: var(--color-grey-3); /* #f0f0f0 */\n232\t --tooltip-text-dark: var(--color-grey-2); /* #f8f8f8 */\n233\t --tooltip-text-light: var(--color-grey-13); /* #141414 */\n234\t /* Progress variant tokens (D2 revert + theme-stable) */\n235\t --progress-track-bg-dark: var(--line-deep); /* #353535 — visual fix (CANONICAL-004); figma sub-node 真源 pending T1c */\n236\t --progress-track-bg-light: var(--color-grey-4); /* #dbdbdb — figma 真源 light theme */\n237\t /* Switch variant tokens */\n238\t --switch-bg-off-dark: var(--color-grey-8); /* #595959 */\n239\t --switch-bg-off-light: var(--color-grey-6); /* #9e9e9e */\n240\t --switch-bg-disabled-off-dark: var(--color-grey-9); /* #434343 */\n241\t --switch-bg-disabled-off-light: var(--color-grey-5); /* #cccccc */\n242\t --switch-thumb-disabled-dark: var(--color-grey-7); /* #7b7b7b — Figma disabled thumb Ellipse 140 (dark) */\n243\t --switch-thumb-disabled-light: var(--color-grey-3); /* #f0f0f0 — Figma disabled thumb Ellipse 140 (light) */\n244\t\n245\t /* === Domain-specific structural dimension tokens (B-many sub-type) === */\n246\t /* Pagination */\n247\t --pagination-pagesize-selector-width: 120px;\n248\t --pagination-jumper-input-width: 64px;\n249\t --pagination-simple-nav-width: 80px;\n250\t /* TopBar */\n251\t --topbar-section-gap: 80px;\n252\t --topbar-height: 64px;\n253\t /* PromptMessage */\n254\t --prompt-message-l-max-width: 480px;\n255\t --prompt-message-m-max-width: 320px;\n256\t /* Notification */\n257\t --notification-width-default: 480px;\n258\t --notification-width-side-pop: 320px;\n259\t /* Tooltip */\n260\t --tooltip-max-width: 320px;\n261\t /* CheckBox */\n262\t --checkbox-size: 16px;\n263\t --checkbox-radius: 1.2px;\n264\t /* Radio */\n265\t --radio-circle-size: 16px;\n266\t --radio-circle-border-width: 1.2px;\n267\t --radio-selected-dot-size: 6px;\n268\t /* Rating */\n269\t --rating-star-size: 24px;\n270\t /* Slider */\n271\t --slider-track-h-m: var(--sp-xs); /* 8px — figma 真源 */\n272\t --slider-track-h-s: var(--sp-xxs); /* 4px — figma 真源 */\n273\t --slider-thumb-size-m: 16px;\n274\t --slider-thumb-size-s: 12px;\n275\t --slider-thumb-dot-radius-m: 3.2px;\n276\t --slider-thumb-dot-radius-s: 2.4px;\n277\t /* Progress (size) */\n278\t --progress-track-h-m: 8px;\n279\t --progress-track-h-s: 4px;\n280\t --progress-track-radius: 20px;\n281\t /* Badge */\n282\t --badge-circle-size: 24px;\n283\t /* Switch (size) */\n284\t --switch-track-w: 40px;\n285\t --switch-track-h: 20px;\n286\t --switch-thumb-size: 16px;\n287\t --switch-thumb-inset: 2px;\n288\t --switch-thumb-travel: 20px;\n289\t /* FormItem */\n290\t --form-item-row-height: 32px;\n291\t --form-item-textarea-min-height: 100px;\n292\t /* InputNumber */\n293\t --input-number-min-width: 100px;\n294\t --input-number-default-width: 128px;\n295\t --input-number-max-width: 200px;\n296\t /* Cross-component control height */\n297\t --control-height-xxs: 32px;\n298\t}\n299\t\n300\t/* ── Effect Style tokens — figma 真源 (3-layered drop shadows) ──\n301\t Source: figma-data/raw/design-tokens.tokens.json (Figma Design Tokens plugin export)\n302\t Normalized truth: figma-data/normalized/figma-styles.json effectStyles\n303\t 2026-05-07 update: 从单层 simplified 改为 figma 真源 3-layered */\n304\t:root {\n305\t --shadow-l1:\n306\t 0 5px 12px 4px #00000017,\n307\t 0 3px 6px 0 #0000001f,\n308\t 0 1px 2px -2px #00000029;\n309\t --shadow-l2:\n310\t 0 9px 28px 8px #0000000d,\n311\t 0 6px 16px 0 #00000014,\n312\t 0 3px 6px -4px #0000001f;\n313\t --shadow-l3:\n314\t 0 12px 48px 16px #00000008,\n315\t 0 9px 28px 0 #0000000d,\n316\t 0 6px 16px -8px #00000014;\n317\t /* Mask blur8 #000-60% — figma 真源: 8px backdrop-blur + #000@60% bg */\n318\t --mask-overlay: rgba(0, 0, 0, 0.6);\n319\t --mask-overlay-blur: 8px;\n320\t}\n321\t\n322\t/* ── Text Style tokens — figma 真源 7 Text Styles ──\n323\t Source: figma-data/raw/design-tokens.tokens.json typography.roboto\n324\t Composite shorthand: use as `font: var(--text-style-body)`\n325\t\n326\t ⚠️ 从 Figma 承接的只有 weight / size / line-height 三段。**family 段不是 Roboto** ——\n327\t 它走 --font-family-base（系统字体栈，Roboto 在 --font-family-en 里排第 4 位，\n328\t 前面有 -apple-system / BlinkMacSystemFont / 'Segoe UI'）⇒ macOS 渲染 SF Pro、\n329\t Windows 渲染 Segoe UI，**实际永远轮不到 Roboto**。\n330\t 本注释此前写「figma 真源 7 Text Styles (Roboto family)」，会被读成「code 也是 Roboto」\n331\t （INFRA-F124 ① 实证：mockup-conventions.md 两处据它转述成「与 DS 真源一致」）。\n332\t 这是 owner 2026-08-13 拍定的 code-first divergence，已登记\n333\t translation/divergences-decisions.json → font-family-system-stack-not-roboto-2026-08-13。\n334\t ⛔ 别把本行改回「Roboto family」，也别据它断言 Figma 稿与 shipped 渲染字形一致。 */\n335\t:root {\n336\t --text-style-tips: 400 12px/16px var(--font-family-base);\n337\t --text-style-body: 400 14px/21px var(--font-family-base);\n338\t --text-style-pop-title: 600 16px/24px var(--font-family-base);\n339\t --text-style-headline-2: 600 18px/27px var(--font-family-base);\n340\t --text-style-headline-1: 600 20px/30px var(--font-family-base);\n341\t --text-style-large-title-22: 600 22px/33px var(--font-family-base);\n342\t --text-style-large-title-24: 600 24px/36px var(--font-family-base);\n343\t\n344\t /* Atomic font tokens — for partial overrides (size only / weight only) */\n345\t --font-size-tips: 12px;\n346\t --font-size-body: 14px;\n347\t --font-size-pop-title: 16px;\n348\t --font-size-headline-2: 18px;\n349\t --font-size-headline-1: 20px;\n350\t --font-size-large-title-22: 22px;\n351\t --font-size-large-title-24: 24px;\n352\t --line-height-tips: 16px;\n353\t --line-height-body: 21px;\n354\t --line-height-pop-title: 24px;\n355\t --line-height-headline-2: 27px;\n356\t --line-height-headline-1: 30px;\n357\t --line-height-large-title-22: 33px;\n358\t --line-height-large-title-24: 36px;\n359\t --font-weight-regular: 400;\n360\t --font-weight-semibold: 600;\n361\t}\n362\t\n363\t/* ── Derived aliases for component compatibility ── */\n364\t:root {\n365\t --input-filled-bg: var(--bg-layer4);\n366\t --green-bg: var(--brand-match);\n367\t /* PromptMessage 状态色（固定语义，dark/light 两 theme 同值） */\n368\t --prompt-success-bg: #f1fbf3;\n369\t --prompt-success-text: #2fb54e;\n370\t --prompt-info-text: #3892f3;\n371\t --prompt-error-text: #ea4233;\n372\t --prompt-warning-text: #f68512;\n373\t /* FormItem layout widths */\n374\t --form-item-root-width-single-line: 638px;\n375\t --form-item-root-width-two-lines: 440px;\n376\t --form-item-label-width-120: 120px;\n377\t --form-item-label-width-200: 200px;\n378\t --form-item-label-width-dynamic: auto;\n379\t --line-divider-deep: var(--line-deep);\n380\t --line-divider-light: var(--line-light);\n381\t --control-default-border: var(--icon-placeholder);\n382\t --control-disabled-bg: var(--line-deep);\n383\t --control-disabled-border: var(--line-border);\n384\t --control-disabled-text: var(--text-disabled);\n385\t --control-disabled-selected-bg: var(--brand-disable);\n386\t --control-disabled-selected-icon: var(--text-tips);\n387\t --radio-default-border: var(--text-tips);\n388\t --radio-selected-dot: var(--bg-layer1);\n389\t --radio-disabled-off-bg: var(--text-disabled);\n390\t --radio-disabled-off-border: var(--bg-layer4);\n391\t --radio-disabled-selected-bg: var(--brand-disable);\n392\t}\n393\t\n394\t/* ── Light mode overrides ── */\n395\t[data-theme=\"light\"] {\n396\t /* ===== Neutrals (grey scale, light → dark) ===== */\n397\t --color-white: #ffffff;\n398\t --color-grey-2: #f8f8f8;\n399\t --color-grey-3: #f0f0f0;\n400\t --color-grey-4: #dbdbdb;\n401\t --color-grey-5: #cccccc;\n402\t --color-grey-6: #9e9e9e;\n403\t --color-grey-7: #7b7b7b;\n404\t --color-grey-8: #595959;\n405\t --color-grey-9: #434343;\n406\t --color-grey-10: #353535;\n407\t --color-grey-11: #262626;\n408\t --color-grey-12: #1f1f1f;\n409\t --color-grey-13: #141414;\n410\t --color-grey-14: #000000;\n411\t\n412\t /* ===== Brand & status ===== */\n413\t --brand: #299f45;\n414\t --brand-hover: #00ac39;\n415\t --brand-match: #f1fbf3;\n416\t --brand-disable: #8fcc9d;\n417\t --red: #dc2717;\n418\t --red-hover: #eb493a;\n419\t --red-bg: #fff1f0;\n420\t --orange: #e26601;\n421\t --orange-hover: #e97413;\n422\t --orange-bg: #fff3db;\n423\t --orange-tz: #d39f39;\n424\t --blue: #0473d5;\n425\t --blue-hover: #118dfb;\n426\t --blue-bg: #e1eefd;\n427\t\n428\t /* ===== Message soft backgrounds =====\n429\t BRIDGE-MOCKUP-001 light-mode 软背景 (tinted ~18% over white). Pair with dark above. */\n430\t --msg-bg-red: #fbddda;\n431\t --msg-bg-brand: #daf2df;\n432\t --msg-bg-blue: #dbebfd;\n433\t --msg-bg-grey: #f6f6f6;\n434\t\n435\t /* ===== Text ===== */\n436\t --text-heading: #000000;\n437\t --text-body: #141414;\n438\t --text-2: #434343;\n439\t --text-tips: #595959;\n440\t --text-placeholder: #9e9e9e;\n441\t --text-disabled: #cccccc;\n442\t --text-grey-en: #434343;\n443\t --text-grey-dis: #9e9e9e;\n444\t --text-grey-hv: #434343;\n445\t --text-primary-btn: #f8f8f8;\n446\t\n447\t /* ===== Icon ===== */\n448\t --icon-active: #434343;\n449\t --icon-default: #595959;\n450\t --icon-disabled: #cccccc;\n451\t --icon-placeholder: #9e9e9e;\n452\t --icon-grey-dis: #9e9e9e;\n453\t\n454\t /* ===== Surface / background ===== */\n455\t --bg-layer1: #ffffff;\n456\t --bg-layer2: #f8f8f8;\n457\t --bg-layer3: #f0f0f0;\n458\t --bg-layer4: #dbdbdb;\n459\t --bg-topbar: #ffffff;\n460\t --bg-grey-btn-hv: #cccccc;\n461\t --bg-grey-btn-en: #dbdbdb;\n462\t --bg-grey-btn-dis: #dbdbdb;\n463\t\n464\t /* ===== Line / border ===== */\n465\t --line-border: #f0f0f0;\n466\t --line-deep: #dbdbdb;\n467\t --line-light: #cccccc;\n468\t\n469\t /* ===== Input / select border aliases ===== */\n470\t --input-line-border: var(--color-grey-5);\n471\t --input-disabled-border: var(--color-grey-5);\n472\t --select-line-border: var(--color-grey-5);\n473\t --select-disabled-border: var(--color-grey-5);\n474\t --select-multi-line-border: var(--color-grey-4);\n475\t --select-chip-border: var(--color-grey-4);\n476\t --select-chip-filled-bg: var(--color-grey-3);\n477\t\n478\t /* ===== Chart categorical palette · light theme variants ===== */\n479\t --chart-color-1: var(--brand); /* 299f45 light brand */\n480\t --chart-color-2: var(--red); /* dc2717 */\n481\t --chart-color-3: var(--blue); /* 0473d5 */\n482\t --chart-color-4: var(--orange); /* e26601 */\n483\t --chart-color-5: #13a886; /* 青绿 */\n484\t --chart-color-6: #b3a113; /* 黄 */\n485\t --chart-color-7: #7a25c9; /* 紫 */\n486\t --chart-color-8: #c52596; /* 洋红 */\n487\t --chart-color-9: #2545c9; /* 靛蓝 */\n488\t --chart-color-10: #c95425; /* 珊瑚 */\n489\t --chart-color-11: #a83bd1; /* lavender */\n490\t --chart-color-12: #7ab313; /* chartreuse */\n491\t\n492\t /* ===== Derived aliases for component compatibility (light) ===== */\n493\t --input-filled-bg: var(--bg-layer1);\n494\t --green-bg: var(--brand-match);\n495\t --line-divider-deep: var(--line-deep);\n496\t --line-divider-light: var(--line-light);\n497\t --control-default-border: var(--icon-placeholder);\n498\t --control-disabled-bg: #dbdbdb;\n499\t --control-disabled-border: #f0f0f0;\n500\t --control-disabled-text: #cccccc;\n501\t --control-disabled-selected-bg: var(--brand-disable);\n502\t --control-disabled-selected-icon: var(--text-primary-btn);\n503\t --radio-default-border: var(--icon-placeholder);\n504\t --radio-selected-dot: var(--bg-layer1);\n505\t --radio-disabled-off-bg: #f0f0f0;\n506\t --radio-disabled-off-border: #dbdbdb;\n507\t --radio-disabled-selected-bg: var(--brand-disable);\n508\t}\n509\t\n510\t/* ==========================================================================\n511\t * Element base layer — spec 2026-07-23-ds-rule-consumption-L5-enforcement (Tier 1)\n512\t * 语义 HTML 的 correct-by-construction 兜底（非 WC；WC 自带 shadow 样式）。\n513\t * 顶层规则、token-only、低特异度单元素/属性选择器、仅安全属性\n514\t * （font / line-height / color / 表单控件 border·padding·radius·background）。\n515\t * 无 layout、无 !important —— author 规则恒胜。radius 走 --r-* token。\n516\t * 随 variables.css 走两条 sync；吸收前序 L1 的 body 排版（不再靠 driver patch）。\n517\t * ⚠️ 必须在最后一个 token 块 } 之后（顶层），否则 renderTokens 会当 token 行处理。\n518\t * ========================================================================== */\n519\t\n520\t/* 正文：默认 14px + DS 字族（对齐前序 L1；只设 font，色由 Surface/组件按主题定） */\n521\tbody {\n522\t font: var(--text-style-body);\n523\t font-family: var(--font-family-base);\n524\t}\n525\t\n526\t/* 标题层级 */\n527\th1 { font: var(--text-style-headline-1); color: var(--text-body); }\n528\th2 { font: var(--text-style-headline-2); color: var(--text-body); }\n529\th3 { font: var(--text-style-pop-title); color: var(--text-body); }\n530\t\n531\t/* 文本元素 */\n532\tlabel { font: var(--text-style-body); color: var(--text-body); }\n533\ta { color: var(--brand); }\n534\tcode,\n535\tkbd { font-family: monospace; font-size: var(--font-size-tips); }\n536\t\n537\t/* ⚠️ INFRA-F129 ①（2026-08-18）—— 下面这批**元素级**基线有一个结构性陷阱，改它们之前先读：\n538\t 本仓的组件同时以两种形态交付 —— Vue SFC（light DOM，吃得到这些全局 element 规则）与\n539\t web component（`tvu-*`，**渲染进 shadow root**，全局 element 级规则进不去）。⇒ 同一个组件在\n540\t 两条消费链上可能渲成不同样子，而**两条链的 render-verification 各看自己那份，谁也不会报**。\n541\t\n542\t 已实证的一例：`td { border-top: 1px solid var(--line-border) }`（见下方 §表格）在\n543\t `border-collapse` 冲突里赢过 `Table.vue` 自己的 `.tbl-body .tbl-row` border-bottom\n544\t (`--line-light`) ⇒ Vue 消费者看到 `--line-border` 的行分隔线、React/CE 消费者看到\n545\t `--line-light`。已在 `Table.vue` 内中和（那里有完整的像素实测留痕）。\n546\t\n547\t ⛔ **诚实边界（别读成「其余都没问题」）**：本轮只测了 `td` 这一条在 `Table` 上的表现。\n548\t 同样穿不过 shadow 边界的还有下面的 `button` / `input` / `textarea` / `select` / `th`\n549\t 以及 `[role=*]` 那批 —— **它们在别的组件上有没有同类分叉，2026-08-18 那轮没测**，\n550\t ⛔ 不是「已确认没有」。要查一条：拿它影响的属性去对拉两份 report 的同一 manifestId\n551\t （`figma-data/normalized/render-verification.report.json` 与 `…/react-render-verification.report.json`），\n552\t 两侧 actual 不同就是又一例。 */\n553\t\n554\t/* 表单控件（safe box props only；radius 走 --r-s token） */\n555\tbutton {\n556\t font: var(--text-style-body);\n557\t color: inherit;\n558\t border-radius: var(--r-s);\n559\t}\n560\tinput,\n561\ttextarea,\n562\tselect {\n563\t font: var(--text-style-body);\n564\t color: var(--text-body);\n565\t background: var(--input-filled-bg);\n566\t border: 1px solid var(--line-border);\n567\t border-radius: var(--r-s);\n568\t padding: var(--sp-xs) var(--sp-s);\n569\t}\n570\tinput::placeholder,\n571\ttextarea::placeholder { color: var(--text-placeholder); }\n572\t\n573\t/* 表格 */\n574\ttable {\n575\t font: var(--text-style-body);\n576\t color: var(--text-body);\n577\t border-collapse: collapse;\n578\t}\n579\tth {\n580\t font-weight: 600;\n581\t color: var(--text-body);\n582\t text-align: left;\n583\t padding: var(--sp-xs) var(--sp-s);\n584\t}\n585\ttd {\n586\t padding: var(--sp-xs) var(--sp-s);\n587\t border-top: 1px solid var(--line-border);\n588\t}\n589\t\n590\t/* ARIA 复合角色（元素级兜底；结构仍应走真 ，见 §0 Tier 2） */\n591\t[role=\"menuitem\"] { font: var(--text-style-body); color: var(--text-body); }\n592\t[role=\"tab\"] { font: var(--text-style-body); color: var(--text-body); }\n593\t[role=\"dialog\"] { font: var(--text-style-body); color: var(--text-body); background: var(--bg-layer2); border-radius: var(--r-l); }\n594\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"1d2a4e0d-6b49-4cdb-bb12-a607484feb3a","timestamp":"2026-08-25T10:18:02.894Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/tokens/variables.css","content":"/* AUTO-GENERATED — Figma-synced tokens refreshed; code-authored tokens PRESERVED.\n *\n * SYNCED FROM FIGMA by `pnpm generate` (source figma-data/normalized/variables.json) —\n * all 54 Figma Variables, matched BY NAME. NOT just the raw palette (--color-grey-*,\n * --brand, --red, --orange, --blue): it INCLUDES the semantic color layer (Figma\n * \"Color Type/*\" → --text-*, --icon-*, --bg-*, --line-*). Gated by `pnpm audit:token-contract`.\n * Do NOT hand-edit their values — edit Figma + re-sync. (The semantic color ones ARE\n * Figma-sourced even though they look \"authored\"; hand-editing them fails the gate.)\n * CODE-AUTHORED (no Figma Variable; PRESERVED verbatim) — spacing (--sp-*), control sizing,\n * effect/text-style composites, component-variant (--notification-* / --progress-* / --slider-*),\n * derived aliases. Values hand-aligned to Figma Styles/nodes; NOT gated.\n *\n * Dark/Light theme: apply [data-theme=\"light\"] to to switch to light mode.\n */\n\n/* ── Dark mode (default) ── */\n:root {\n /* ===== Neutrals (grey scale, light → dark) ===== */\n --color-white: #ffffff;\n --color-grey-2: #f8f8f8;\n --color-grey-3: #f0f0f0;\n --color-grey-4: #dbdbdb;\n --color-grey-5: #cccccc;\n --color-grey-6: #9e9e9e;\n --color-grey-7: #7b7b7b;\n --color-grey-8: #595959;\n --color-grey-9: #434343;\n --color-grey-10: #353535;\n --color-grey-11: #262626;\n --color-grey-12: #1f1f1f;\n --color-grey-13: #141414;\n --color-grey-14: #000000;\n\n /* ===== Brand & status ===== */\n --brand: #2fb54e;\n --brand-hover: #41c760;\n --brand-match: #0b2b13;\n --brand-disable: #1a652c;\n --red: #ea4233;\n --red-hover: #ed5b4e;\n --red-bg: #fff1f0;\n --orange: #f68512;\n --orange-hover: #f89c3e;\n --orange-bg: #fff3db;\n --orange-tz: #d39f39;\n --blue: #3892f3;\n --blue-hover: #62a9f6;\n --blue-bg: #e1eefd;\n\n /* ===== Message soft backgrounds =====\n BRIDGE-MOCKUP-001: dark-mode 软背景 (tinted ~18% over bg). 见 divergences-decisions.json `msg-bg-tinted-dark-set-2026-05-19`. Figma sync pending. */\n --msg-bg-red: #3b1c1a;\n --msg-bg-brand: #19311e;\n --msg-bg-blue: #1a2b3c;\n --msg-bg-grey: #353535;\n\n /* ===== Text ===== */\n --text-heading: #ffffff;\n --text-body: #f8f8f8;\n --text-2: #cccccc;\n --text-tips: #9e9e9e;\n --text-placeholder: #7b7b7b;\n --text-disabled: #595959;\n --text-grey-en: #cccccc;\n --text-grey-dis: #7b7b7b;\n --text-grey-hv: #cccccc;\n --text-primary-btn: #f8f8f8;\n\n /* ===== Icon ===== */\n --icon-active: #f8f8f8;\n --icon-default: #9e9e9e;\n --icon-disabled: #595959;\n --icon-placeholder: #7b7b7b;\n --icon-grey-dis: #7b7b7b;\n\n /* ===== Surface / background ===== */\n --bg-layer1: #141414;\n --bg-layer2: #1f1f1f;\n --bg-layer3: #262626;\n --bg-layer4: #353535;\n --bg-topbar: #000000;\n --bg-grey-btn-hv: #595959;\n --bg-grey-btn-en: #434343;\n --bg-grey-btn-dis: #434343;\n\n /* ===== Line / border ===== */\n --line-border: #595959;\n --line-deep: #353535;\n --line-light: #434343;\n\n /* ===== Input / select border aliases ===== */\n --input-line-border: var(--color-grey-8);\n --input-disabled-border: var(--color-grey-8);\n --select-line-border: var(--color-grey-8);\n --select-disabled-border: var(--color-grey-8);\n --select-multi-line-border: var(--color-grey-8);\n --select-chip-border: var(--color-grey-9);\n --select-chip-filled-bg: var(--color-grey-13);\n\n /* ===== Chart categorical palette (12 colors) — CANONICAL-011 D1 =====\n 4 reuse existing base hues; 8 new derived by HSL hue rotation\n maintaining S 65-78% / L 50-60% to match brand-level visual weight.\n Order matches Option C warm/cool alternating (1=cool brand → 12=warm). */\n --chart-color-1: var(--brand); /* 134° 绿 (brand) */\n --chart-color-2: var(--red); /* 6° 红 */\n --chart-color-3: var(--blue); /* 211° 蓝 */\n --chart-color-4: var(--orange); /* 31° 橙 */\n --chart-color-5: #2dceae; /* 169° 青绿 */\n --chart-color-6: #d8c537; /* 52° 黄 */\n --chart-color-7: #9a4ee5; /* 265° 紫 */\n --chart-color-8: #e54eb4; /* 320° 洋红 */\n --chart-color-9: #4e6ee5; /* 228° 靛蓝 */\n --chart-color-10: #e57a4e; /* 17° 珊瑚 */\n --chart-color-11: #c47de8; /* 293° lavender */\n --chart-color-12: #a3d837; /* 90° chartreuse */\n}\n\n/* ── Spacing ── */\n:root {\n --sp-xxs: 4px;\n --sp-xs: 8px;\n --sp-s: 12px;\n --sp-m: 16px;\n --sp-l: 24px;\n --sp-xl: 32px;\n --sp-xxl: 40px;\n --sp-xxxl: 56px;\n}\n\n/* ── Radius ── */\n:root {\n --r-xs: 2px;\n --r-s: 4px;\n --r-m: 8px;\n --r-l: 12px;\n --r-xl: 16px;\n --r-xxl: 20px; /* mirror Figma Radius/XXL=20 (was 100px — false alias to radius/xxl, drift 修复 2026-06-12). Switch track(h=20) 仍 pill：border-radius clamp 到 height/2=10 */\n}\n\n/* ── Z-Index / Elevation ──\n code-authored（无 Figma Variable 上游，同 --sp-* 性质 → 不受 audit:token-contract 管，\n 但受 audit:sort-tokens I1/I2 管）。TKN-02：此前 4 个浮层各自写死魔法数字，消费方想把\n 自己的浮层插进这套层级只能猜。\n ⚠️ 每个值都**等于替换前的实测现值**，本组纯命名化、不改任何层叠顺序 —— 刻意不规整成\n 100/200/300，那会改变层叠关系 = 视觉回归。若要整齐标度，另立一项并单独过视觉门。\n 只登记有真实消费者且有实测值的层；`--z-toast` 一类当前无消费者、无实测值，不凭空造。 */\n:root {\n --z-dropdown: 1000; /* UserMenu 面板 */\n --z-tooltip: 1000; /* Tooltip */\n --z-modal: 1000; /* PopupBox */\n --z-select-portal: 1100; /* Select 的 teleport 下拉 —— 高于 modal 是因为 modal 内也放 select */\n}\n\n/* ── Layout breakpoints ──\n code-authored（无 Figma Variable 上游，同 --sp-* / --z-* 性质 → 不受 audit:token-contract 管，\n 受 audit:sort-tokens I1/I2 + audit:layout-tokens 管）。INFRA-F68 DG-1，owner 2026-07-31 拍\n 路线 B（code-first token）；登记在 translation/divergences-decisions.json。\n ⚠️ 四个值**逐字取自替换前仓库里真实在用的 @media 值**（1100/960/640 各出现 2 处，1280 = docs\n 站与视觉闸的 viewport 宽），本组纯命名化、不改任何断点行为 —— 刻意不规整成 600/900/1200/1500，\n 那会改窄屏布局 = 视觉回归，且属 owner/designer 的视觉裁定。\n ⚠️ CSS `@media` 语法吃不了 `var()`，所以\"引用\"的可校验形式 = 字面量必须 ∈ 本组值集合，由\n `pnpm audit:layout-tokens` 机械核（另有 3 条存量一次性值走该闸的具名带日期 shrink-only 豁免）。\n 非 CSS 消费方（AI / 非 web 工具 / consumer JS）走 `./tokens` DTCG + `./tokens/js` 出口，\n 由 generate-token-exports 从本文件派生 —— 值只有这一处定义。 */\n:root {\n --bp-sm: 640px; /* 现用于 docs.css 手机档 / react-pilot chart demo */\n --bp-md: 960px; /* 现用于 ColorPage / react-pilot button demo */\n --bp-lg: 1100px; /* 现用于 docs.css 主栏塌陷 / CanonicalShowcase */\n --bp-xl: 1280px; /* = docs 站与 test:visual 的 viewport 宽 */\n}\n\n/* ── Layout containers ──\n 同上：值逐字取自替换前实测现值，纯命名化。与 --bp-* 的区别 = 容器宽可以直接\n `max-width: var(--container-*)` 引用（CSS 允许），故这几处已改成真引用、不再有字面量副本。\n ⚠️ 仓库里还有一批**内容宽**字面量（600/760/860/900/980/1200 等，各 1-3 处）刻意未纳入：\n 它们是 demo/页面内容宽而非布局容器，硬塞进容器档位就是\"把偶然值当契约\"。audit:layout-tokens\n 会 report-only 逐条印出它们 + 计数，drift 可见但不阻塞。 */\n:root {\n --container-narrow: 720px; /* 正文窄栏 .intro（docs 站 + CanonicalShowcase 两处） */\n --container-prose: 840px; /* 段落摘要 .docs-section__summary */\n --container-page: 1600px; /* CanonicalShowcase 页宽 */\n --container-wide: 1800px; /* docs 站外壳最大宽 */\n}\n\n/* ── Typography ── */\n\n/* TopBar timezone clock face — the SAME font Figma uses.\n Figma 真源 (node 4771:7194) 用 \"Digital Numbers\" by Stephan Ahlf\n (github.com/s-a/digital-numbers-font, SIL OFL 1.1). Figma 按字体名引用，\n 我们 self-host 原版 OFL 文件做到 1:1 一致（非替代字体）。\n 字体文件 + 许可证: src/tokens/fonts/DigitalNumbers-Regular.{woff,ttf} + DigitalNumbers-OFL.txt。 */\n@font-face {\n font-family: 'Digital Numbers';\n src: url('./fonts/DigitalNumbers-Regular.woff') format('woff'),\n url('./fonts/DigitalNumbers-Regular.ttf') format('truetype');\n font-weight: 400;\n font-style: normal;\n font-display: swap;\n}\n\n:root {\n --font-family-en: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, Oxygen, Ubuntu, 'Fira Sans',\n 'Droid Sans', 'Helvetica Neue', sans-serif;\n --font-family-zh: 'PingFang SC', 'Microsoft YaHei', Helvetica, Arial, sans-serif;\n --font-family-base: var(--font-family-en), var(--font-family-zh);\n /* TopBar timezone CLOCK FACE ONLY — Figma \"Digital Numbers\" 7-segment LED display\n (self-hosted original, OFL 1.1). Reserved for the clock readout in the top bar,\n paired with --orange-tz (amber). Everything else — UI text AND data (IP / MAC /\n serial / dBm / byte counts) — uses --font-family-base (the normal EN/ZH stack);\n for column-aligned digits add `font-variant-numeric: tabular-nums`. There is\n deliberately NO separate monospace font in this system. */\n --font-family-clock: 'Digital Numbers', 'Courier New', monospace;\n}\n\n/* ── Domain-specific component-variant tokens (theme-stable) ──\n 2026-05-07: 组件内部有 theme variant prop (e.g. Notification theme='light'/'dark')\n 不应使用 site-theme-aware tokens (--bg-layer*)。这里定义 variant-specific 固定值，\n theme-stable (两 site theme 都同值)，对齐 figma 真源 */\n:root {\n /* Notification component variant bg (figma 真源: dark=#353535 grey-10, light=#f8f8f8 grey-2)\n 2026-05-07 D1 correction: light 不是 #ffffff（之前误设），figma 真源是 #f8f8f8 */\n --notification-bg-dark: var(--color-grey-10);\n --notification-bg-light: var(--color-grey-2);\n\n /* === Component-variant theme-stable tokens (D2/D4 — 同 Notification 模式) === */\n /* Tooltip / Progress / Switch / Radio / CheckBox 都有 own theme axis */\n /* Tooltip variant tokens */\n --tooltip-bg-dark: var(--color-grey-10); /* #353535 */\n --tooltip-bg-light: var(--color-white); /* #ffffff */\n --tooltip-border-dark: var(--color-grey-8); /* #595959 */\n --tooltip-border-light: var(--color-grey-3); /* #f0f0f0 */\n --tooltip-text-dark: var(--color-grey-2); /* #f8f8f8 */\n --tooltip-text-light: var(--color-grey-13); /* #141414 */\n /* Progress variant tokens (D2 revert + theme-stable) */\n --progress-track-bg-dark: var(--line-deep); /* #353535 — visual fix (CANONICAL-004); figma sub-node 真源 pending T1c */\n --progress-track-bg-light: var(--color-grey-4); /* #dbdbdb — figma 真源 light theme */\n /* Switch variant tokens */\n --switch-bg-off-dark: var(--color-grey-8); /* #595959 */\n --switch-bg-off-light: var(--color-grey-6); /* #9e9e9e */\n --switch-bg-disabled-off-dark: var(--color-grey-9); /* #434343 */\n --switch-bg-disabled-off-light: var(--color-grey-5); /* #cccccc */\n --switch-thumb-disabled-dark: var(--color-grey-7); /* #7b7b7b — Figma disabled thumb Ellipse 140 (dark) */\n --switch-thumb-disabled-light: var(--color-grey-3); /* #f0f0f0 — Figma disabled thumb Ellipse 140 (light) */\n\n /* === Domain-specific structural dimension tokens (B-many sub-type) === */\n /* Pagination */\n --pagination-pagesize-selector-width: 120px;\n --pagination-jumper-input-width: 64px;\n --pagination-simple-nav-width: 80px;\n /* TopBar */\n --topbar-section-gap: 80px;\n --topbar-height: 64px;\n /* PromptMessage */\n --prompt-message-l-max-width: 480px;\n --prompt-message-m-max-width: 320px;\n /* Notification */\n --notification-width-default: 480px;\n --notification-width-side-pop: 320px;\n /* Tooltip */\n --tooltip-max-width: 320px;\n /* CheckBox */\n --checkbox-size: 16px;\n --checkbox-radius: 1.2px;\n /* Radio */\n --radio-circle-size: 16px;\n --radio-circle-border-width: 1.2px;\n --radio-selected-dot-size: 6px;\n /* Rating */\n --rating-star-size: 24px;\n /* Slider */\n --slider-track-h-m: var(--sp-xs); /* 8px — figma 真源 */\n --slider-track-h-s: var(--sp-xxs); /* 4px — figma 真源 */\n --slider-thumb-size-m: 16px;\n --slider-thumb-size-s: 12px;\n --slider-thumb-dot-radius-m: 3.2px;\n --slider-thumb-dot-radius-s: 2.4px;\n /* Progress (size) */\n --progress-track-h-m: 8px;\n --progress-track-h-s: 4px;\n --progress-track-radius: 20px;\n /* Badge */\n --badge-circle-size: 24px;\n /* Switch (size) */\n --switch-track-w: 40px;\n --switch-track-h: 20px;\n --switch-thumb-size: 16px;\n --switch-thumb-inset: 2px;\n --switch-thumb-travel: 20px;\n /* FormItem */\n --form-item-row-height: 32px;\n --form-item-textarea-min-height: 100px;\n /* InputNumber */\n --input-number-min-width: 100px;\n --input-number-default-width: 128px;\n --input-number-max-width: 200px;\n /* Cross-component control height */\n --control-height-xxs: 32px;\n}\n\n/* ── Effect Style tokens — figma 真源 (3-layered drop shadows) ──\n Source: figma-data/raw/design-tokens.tokens.json (Figma Design Tokens plugin export)\n Normalized truth: figma-data/normalized/figma-styles.json effectStyles\n 2026-05-07 update: 从单层 simplified 改为 figma 真源 3-layered */\n:root {\n --shadow-l1:\n 0 5px 12px 4px #00000017,\n 0 3px 6px 0 #0000001f,\n 0 1px 2px -2px #00000029;\n --shadow-l2:\n 0 9px 28px 8px #0000000d,\n 0 6px 16px 0 #00000014,\n 0 3px 6px -4px #0000001f;\n --shadow-l3:\n 0 12px 48px 16px #00000008,\n 0 9px 28px 0 #0000000d,\n 0 6px 16px -8px #00000014;\n /* Mask blur8 #000-60% — figma 真源: 8px backdrop-blur + #000@60% bg */\n --mask-overlay: rgba(0, 0, 0, 0.6);\n --mask-overlay-blur: 8px;\n}\n\n/* ── Text Style tokens — figma 真源 7 Text Styles ──\n Source: figma-data/raw/design-tokens.tokens.json typography.roboto\n Composite shorthand: use as `font: var(--text-style-body)`\n\n ⚠️ 从 Figma 承接的只有 weight / size / line-height 三段。**family 段不是 Roboto** ——\n 它走 --font-family-base（系统字体栈，Roboto 在 --font-family-en 里排第 4 位，\n 前面有 -apple-system / BlinkMacSystemFont / 'Segoe UI'）⇒ macOS 渲染 SF Pro、\n Windows 渲染 Segoe UI，**实际永远轮不到 Roboto**。\n 本注释此前写「figma 真源 7 Text Styles (Roboto family)」，会被读成「code 也是 Roboto」\n （INFRA-F124 ① 实证：mockup-conventions.md 两处据它转述成「与 DS 真源一致」）。\n 这是 owner 2026-08-13 拍定的 code-first divergence，已登记\n translation/divergences-decisions.json → font-family-system-stack-not-roboto-2026-08-13。\n ⛔ 别把本行改回「Roboto family」，也别据它断言 Figma 稿与 shipped 渲染字形一致。 */\n:root {\n --text-style-tips: 400 12px/16px var(--font-family-base);\n --text-style-body: 400 14px/21px var(--font-family-base);\n --text-style-pop-title: 600 16px/24px var(--font-family-base);\n --text-style-headline-2: 600 18px/27px var(--font-family-base);\n --text-style-headline-1: 600 20px/30px var(--font-family-base);\n --text-style-large-title-22: 600 22px/33px var(--font-family-base);\n --text-style-large-title-24: 600 24px/36px var(--font-family-base);\n\n /* Atomic font tokens — for partial overrides (size only / weight only) */\n --font-size-tips: 12px;\n --font-size-body: 14px;\n --font-size-pop-title: 16px;\n --font-size-headline-2: 18px;\n --font-size-headline-1: 20px;\n --font-size-large-title-22: 22px;\n --font-size-large-title-24: 24px;\n --line-height-tips: 16px;\n --line-height-body: 21px;\n --line-height-pop-title: 24px;\n --line-height-headline-2: 27px;\n --line-height-headline-1: 30px;\n --line-height-large-title-22: 33px;\n --line-height-large-title-24: 36px;\n --font-weight-regular: 400;\n --font-weight-semibold: 600;\n}\n\n/* ── Derived aliases for component compatibility ── */\n:root {\n --input-filled-bg: var(--bg-layer4);\n --green-bg: var(--brand-match);\n /* PromptMessage 状态色（固定语义，dark/light 两 theme 同值） */\n --prompt-success-bg: #f1fbf3;\n --prompt-success-text: #2fb54e;\n --prompt-info-text: #3892f3;\n --prompt-error-text: #ea4233;\n --prompt-warning-text: #f68512;\n /* FormItem layout widths */\n --form-item-root-width-single-line: 638px;\n --form-item-root-width-two-lines: 440px;\n --form-item-label-width-120: 120px;\n --form-item-label-width-200: 200px;\n --form-item-label-width-dynamic: auto;\n --line-divider-deep: var(--line-deep);\n --line-divider-light: var(--line-light);\n --control-default-border: var(--icon-placeholder);\n --control-disabled-bg: var(--line-deep);\n --control-disabled-border: var(--line-border);\n --control-disabled-text: var(--text-disabled);\n --control-disabled-selected-bg: var(--brand-disable);\n --control-disabled-selected-icon: var(--text-tips);\n --radio-default-border: var(--text-tips);\n --radio-selected-dot: var(--bg-layer1);\n --radio-disabled-off-bg: var(--text-disabled);\n --radio-disabled-off-border: var(--bg-layer4);\n --radio-disabled-selected-bg: var(--brand-disable);\n}\n\n/* ── Light mode overrides ── */\n[data-theme=\"light\"] {\n /* ===== Neutrals (grey scale, light → dark) ===== */\n --color-white: #ffffff;\n --color-grey-2: #f8f8f8;\n --color-grey-3: #f0f0f0;\n --color-grey-4: #dbdbdb;\n --color-grey-5: #cccccc;\n --color-grey-6: #9e9e9e;\n --color-grey-7: #7b7b7b;\n --color-grey-8: #595959;\n --color-grey-9: #434343;\n --color-grey-10: #353535;\n --color-grey-11: #262626;\n --color-grey-12: #1f1f1f;\n --color-grey-13: #141414;\n --color-grey-14: #000000;\n\n /* ===== Brand & status ===== */\n --brand: #299f45;\n --brand-hover: #00ac39;\n --brand-match: #f1fbf3;\n --brand-disable: #8fcc9d;\n --red: #dc2717;\n --red-hover: #eb493a;\n --red-bg: #fff1f0;\n --orange: #e26601;\n --orange-hover: #e97413;\n --orange-bg: #fff3db;\n --orange-tz: #d39f39;\n --blue: #0473d5;\n --blue-hover: #118dfb;\n --blue-bg: #e1eefd;\n\n /* ===== Message soft backgrounds =====\n BRIDGE-MOCKUP-001 light-mode 软背景 (tinted ~18% over white). Pair with dark above. */\n --msg-bg-red: #fbddda;\n --msg-bg-brand: #daf2df;\n --msg-bg-blue: #dbebfd;\n --msg-bg-grey: #f6f6f6;\n\n /* ===== Text ===== */\n --text-heading: #000000;\n --text-body: #141414;\n --text-2: #434343;\n --text-tips: #595959;\n --text-placeholder: #9e9e9e;\n --text-disabled: #cccccc;\n --text-grey-en: #434343;\n --text-grey-dis: #9e9e9e;\n --text-grey-hv: #434343;\n --text-primary-btn: #f8f8f8;\n\n /* ===== Icon ===== */\n --icon-active: #434343;\n --icon-default: #595959;\n --icon-disabled: #cccccc;\n --icon-placeholder: #9e9e9e;\n --icon-grey-dis: #9e9e9e;\n\n /* ===== Surface / background ===== */\n --bg-layer1: #ffffff;\n --bg-layer2: #f8f8f8;\n --bg-layer3: #f0f0f0;\n --bg-layer4: #dbdbdb;\n --bg-topbar: #ffffff;\n --bg-grey-btn-hv: #cccccc;\n --bg-grey-btn-en: #dbdbdb;\n --bg-grey-btn-dis: #dbdbdb;\n\n /* ===== Line / border ===== */\n --line-border: #f0f0f0;\n --line-deep: #dbdbdb;\n --line-light: #cccccc;\n\n /* ===== Input / select border aliases ===== */\n --input-line-border: var(--color-grey-5);\n --input-disabled-border: var(--color-grey-5);\n --select-line-border: var(--color-grey-5);\n --select-disabled-border: var(--color-grey-5);\n --select-multi-line-border: var(--color-grey-4);\n --select-chip-border: var(--color-grey-4);\n --select-chip-filled-bg: var(--color-grey-3);\n\n /* ===== Chart categorical palette · light theme variants ===== */\n --chart-color-1: var(--brand); /* 299f45 light brand */\n --chart-color-2: var(--red); /* dc2717 */\n --chart-color-3: var(--blue); /* 0473d5 */\n --chart-color-4: var(--orange); /* e26601 */\n --chart-color-5: #13a886; /* 青绿 */\n --chart-color-6: #b3a113; /* 黄 */\n --chart-color-7: #7a25c9; /* 紫 */\n --chart-color-8: #c52596; /* 洋红 */\n --chart-color-9: #2545c9; /* 靛蓝 */\n --chart-color-10: #c95425; /* 珊瑚 */\n --chart-color-11: #a83bd1; /* lavender */\n --chart-color-12: #7ab313; /* chartreuse */\n\n /* ===== Derived aliases for component compatibility (light) ===== */\n --input-filled-bg: var(--bg-layer1);\n --green-bg: var(--brand-match);\n --line-divider-deep: var(--line-deep);\n --line-divider-light: var(--line-light);\n --control-default-border: var(--icon-placeholder);\n --control-disabled-bg: #dbdbdb;\n --control-disabled-border: #f0f0f0;\n --control-disabled-text: #cccccc;\n --control-disabled-selected-bg: var(--brand-disable);\n --control-disabled-selected-icon: var(--text-primary-btn);\n --radio-default-border: var(--icon-placeholder);\n --radio-selected-dot: var(--bg-layer1);\n --radio-disabled-off-bg: #f0f0f0;\n --radio-disabled-off-border: #dbdbdb;\n --radio-disabled-selected-bg: var(--brand-disable);\n}\n\n/* ==========================================================================\n * Element base layer — spec 2026-07-23-ds-rule-consumption-L5-enforcement (Tier 1)\n * 语义 HTML 的 correct-by-construction 兜底（非 WC；WC 自带 shadow 样式）。\n * 顶层规则、token-only、低特异度单元素/属性选择器、仅安全属性\n * （font / line-height / color / 表单控件 border·padding·radius·background）。\n * 无 layout、无 !important —— author 规则恒胜。radius 走 --r-* token。\n * 随 variables.css 走两条 sync；吸收前序 L1 的 body 排版（不再靠 driver patch）。\n * ⚠️ 必须在最后一个 token 块 } 之后（顶层），否则 renderTokens 会当 token 行处理。\n * ========================================================================== */\n\n/* 正文：默认 14px + DS 字族（对齐前序 L1；只设 font，色由 Surface/组件按主题定） */\nbody {\n font: var(--text-style-body);\n font-family: var(--font-family-base);\n}\n\n/* 标题层级 */\nh1 { font: var(--text-style-headline-1); color: var(--text-body); }\nh2 { font: var(--text-style-headline-2); color: var(--text-body); }\nh3 { font: var(--text-style-pop-title); color: var(--text-body); }\n\n/* 文本元素 */\nlabel { font: var(--text-style-body); color: var(--text-body); }\na { color: var(--brand); }\ncode,\nkbd { font-family: monospace; font-size: var(--font-size-tips); }\n\n/* ⚠️ INFRA-F129 ①（2026-08-18）—— 下面这批**元素级**基线有一个结构性陷阱，改它们之前先读：\n 本仓的组件同时以两种形态交付 —— Vue SFC（light DOM，吃得到这些全局 element 规则）与\n web component（`tvu-*`，**渲染进 shadow root**，全局 element 级规则进不去）。⇒ 同一个组件在\n 两条消费链上可能渲成不同样子，而**两条链的 render-verification 各看自己那份，谁也不会报**。\n\n 已实证的一例：`td { border-top: 1px solid var(--line-border) }`（见下方 §表格）在\n `border-collapse` 冲突里赢过 `Table.vue` 自己的 `.tbl-body .tbl-row` border-bottom\n (`--line-light`) ⇒ Vue 消费者看到 `--line-border` 的行分隔线、React/CE 消费者看到\n `--line-light`。已在 `Table.vue` 内中和（那里有完整的像素实测留痕）。\n\n ⛔ **诚实边界（别读成「其余都没问题」）**：本轮只测了 `td` 这一条在 `Table` 上的表现。\n 同样穿不过 shadow 边界的还有下面的 `button` / `input` / `textarea` / `select` / `th`\n 以及 `[role=*]` 那批 —— **它们在别的组件上有没有同类分叉，2026-08-18 那轮没测**，\n ⛔ 不是「已确认没有」。要查一条：拿它影响的属性去对拉两份 report 的同一 manifestId\n （`figma-data/normalized/render-verification.report.json` 与 `…/react-render-verification.report.json`），\n 两侧 actual 不同就是又一例。 */\n\n/* 表单控件（safe box props only；radius 走 --r-s token） */\nbutton {\n font: var(--text-style-body);\n color: inherit;\n border-radius: var(--r-s);\n}\ninput,\ntextarea,\nselect {\n font: var(--text-style-body);\n color: var(--text-body);\n background: var(--input-filled-bg);\n border: 1px solid var(--line-border);\n border-radius: var(--r-s);\n padding: var(--sp-xs) var(--sp-s);\n}\ninput::placeholder,\ntextarea::placeholder { color: var(--text-placeholder); }\n\n/* 表格 */\ntable {\n font: var(--text-style-body);\n color: var(--text-body);\n border-collapse: collapse;\n}\nth {\n font-weight: 600;\n color: var(--text-body);\n text-align: left;\n padding: var(--sp-xs) var(--sp-s);\n}\ntd {\n padding: var(--sp-xs) var(--sp-s);\n border-top: 1px solid var(--line-border);\n}\n\n/* ARIA 复合角色（元素级兜底；结构仍应走真 ，见 §0 Tier 2） */\n[role=\"menuitem\"] { font: var(--text-style-body); color: var(--text-body); }\n[role=\"tab\"] { font: var(--text-style-body); color: var(--text-body); }\n[role=\"dialog\"] { font: var(--text-style-body); color: var(--text-body); background: var(--bg-layer2); border-radius: var(--r-l); }\n","numLines":594,"startLine":1,"totalLines":594}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"319e790a-314b-44d8-be3d-1f7fd3f77beb","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"fd4c9908-0cc8-4875-aea9-e3672e0d57b7","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":300,"estimated_tokens_delta":150,"uuid":"6d28d0f7-0475-49ef-86e2-513ce87500e1","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":400,"estimated_tokens_delta":100,"uuid":"dc3ec455-aa3a-4e62-9d57-11840be339db","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":500,"estimated_tokens_delta":100,"uuid":"7e6ec7fe-b0ce-4d43-88fa-6f8954016653","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":600,"estimated_tokens_delta":100,"uuid":"84c0e194-061f-48c0-9645-5820f9e91a05","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":650,"estimated_tokens_delta":50,"uuid":"f577264f-10a4-49be-a7b0-5b7544b46e80","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":750,"estimated_tokens_delta":100,"uuid":"346a5a26-597f-497d-8e35-e055eb0c1d93","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":850,"estimated_tokens_delta":100,"uuid":"a8287db7-3024-4811-b785-35b4d51cd435","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":950,"estimated_tokens_delta":100,"uuid":"9fe407df-8f64-4eb5-a1ae-3d8fc2d96720","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1050,"estimated_tokens_delta":100,"uuid":"852cb532-a8d8-4f50-a30a-060c4052c586","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ5vbgpMi577VW5fnPG","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"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"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":13611,"cache_read_input_tokens":159364,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":13611},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"fd76065b-c1a1-4dd3-8db7-2bfe99fbc236","timestamp":"2026-08-25T10:18:22.594Z","request_id":"req_011CePJ5r1MsD7JSNUDHtzXE"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ5vbgpMi577VW5fnPG","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_018kC4NZYCoA6kTNUAhpN3Ua","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/canonical/TabItem.vue"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":13611,"cache_read_input_tokens":159364,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":13611},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"2e4bab44-e1fc-4dbf-ba17-35d81c644eb2","timestamp":"2026-08-25T10:18:23.867Z","request_id":"req_011CePJ5r1MsD7JSNUDHtzXE"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ5vbgpMi577VW5fnPG","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01KpnFbF8bBEmqcs8oc3o1rr","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/canonical/TabList.vue"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":13611,"cache_read_input_tokens":159364,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":13611},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"5e84db62-9973-4e62-8bae-4617ab4aa365","timestamp":"2026-08-25T10:18:23.873Z","request_id":"req_011CePJ5r1MsD7JSNUDHtzXE"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01KpnFbF8bBEmqcs8oc3o1rr","type":"tool_result","content":"1\t\n33\t\n34\t\n46\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"49060f23-3169-413d-a5b5-faa64ad84b43","timestamp":"2026-08-25T10:18:23.878Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/canonical/TabList.vue","content":"\n\n\n","numLines":46,"startLine":1,"totalLines":46}}} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_018kC4NZYCoA6kTNUAhpN3Ua","type":"tool_result","content":"1\t\n51\t\n52\t\n64\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"65da0e9b-3fe1-497e-b46c-60b4f9a1be57","timestamp":"2026-08-25T10:18:23.879Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/canonical/TabItem.vue","content":"\n\n\n","numLines":64,"startLine":1,"totalLines":64}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"c3d41e01-d6df-4416-9ea8-db17abefb648","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":92,"estimated_tokens_delta":42,"uuid":"f54b74af-cd5d-4495-be62-c2977019387b","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ7UFy1KejZdz79xoCj","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAIS5gIKpgEIERgCKkBTvIZ6vgW0h8o+BTc6n943wOUV4E9GU4wlZ23T+M/QIUGU3k4Vg86kw4OqRvLUgjPMziJb55QGlKQgXxk+umGGMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAfPXtdQGsAECEgyNffzrhdCjCQNic4YaDPpEnjspGhqLNB2+IyIwKsrfgk+brCg9WmTiXDESkHquifkIukwhtbp6Fn59UrGc1DpQG73MmhT1QVaDvlrFKm2m8M0eLHIdWLi8e8AsWCCcp/dJDT8VQ/1z+71dKCsWubi7zviony2q7nCMQBVB4j8yz2WTDbQnQnqtJ+DrOYFEKOX7idc1DX5SsGwwCvbAlJ4Ken67SZWENGaKqsonFxDnbyTD2Bhs5V2WqHsvGAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3248,"cache_read_input_tokens":172975,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3248},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"dd8c9d88-f010-47f4-86ad-97a5e39bab21","timestamp":"2026-08-25T10:18:27.504Z","request_id":"req_011CePJ7PbvZep6dsorvSeEV"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ7UFy1KejZdz79xoCj","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01XS8HnaZ9aYmq75GDe3dcx3","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Tab/TabItem.vue"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3248,"cache_read_input_tokens":172975,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3248},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"dd0ba897-a1d8-4b05-8ae4-9189d6558672","timestamp":"2026-08-25T10:18:28.216Z","request_id":"req_011CePJ7PbvZep6dsorvSeEV"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01XS8HnaZ9aYmq75GDe3dcx3","type":"tool_result","content":"1\t\n45\t\n46\t\n66\t\n67\t\n103\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"b239b1c5-9a05-49df-a522-1a49baf6adae","timestamp":"2026-08-25T10:18:28.227Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Tab/TabItem.vue","content":"\n\n\n\n\n","numLines":103,"startLine":1,"totalLines":103}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ7UFy1KejZdz79xoCj","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_016U6fjGUZ7i278K1vSsqEZx","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Tab/TabList.vue"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3248,"cache_read_input_tokens":172975,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3248},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"2324c6df-c4e4-48e3-a807-131d2cd2d8a4","timestamp":"2026-08-25T10:18:28.949Z","request_id":"req_011CePJ7PbvZep6dsorvSeEV"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_016U6fjGUZ7i278K1vSsqEZx","type":"tool_result","content":"1\t\n42\t\n43\t\n64\t\n65\t\n104\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"ffdf2c67-a863-4ecd-86ac-fb20ce1d4d76","timestamp":"2026-08-25T10:18:28.959Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Tab/TabList.vue","content":"\n\n\n\n\n","numLines":104,"startLine":1,"totalLines":104}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"db9c8ef1-3a68-410f-a7a0-94b23f8c20ac","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"8f099cb7-25b1-4be7-adee-e8b0efdd07d0","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":250,"estimated_tokens_delta":100,"uuid":"4d4e2cb0-3fc9-4053-a6f7-a3eaeb859641","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":400,"estimated_tokens_delta":150,"uuid":"95fe73ba-b2f8-48b0-ba03-935e81f8f187","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ7rPjjcYmfnirHPXaW","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISqQkKpgEIERgCKkBxaukZSf2h9XN6B/BetVStK98IK23i0aSMVwlvcKHiqmsYJiiuJj9Vopc5DNaZL/0HmMopmdpR4CHE3rBJ2L8lMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAf3XtdQGsAECEgzTOB0ErfL+mUUAYV0aDHJVPNhvtY0SYNmKVCIwTJfuaJgCkU1Zru4zj5JTu+bR9wJF4U/8fi963CqcWXjsD/GXpqbTOfK+xeScng9VKq8HgWjORuNKTCkB7qEcq5gVIYTp/PbOplBjkjCM7tuSozgaAGROj6OjxPw+Na8mZ+yhRTl4t5cM3Ygq+OfT5ky6aI/kZHRABdCYr8hZom7IRV+bbrdIBO7wXRm7lp9nel/acp7Oj2acn+LbU5IozyjoeCcisftgQfrwOFcP2px2MG1e9welg+uviD7+5Lw89I9fZVHjypzahsqxnpsNYtrfIvFptPb9REPUzhZpnHvKIjkLeEEwPsWsyrlTMZg6z76r67nwuw4m7Kngwe9peB7ZcZrB+IIB2lMp84oywQ6adXuTWCHazPXLrz5QLSdk1R4QEuLWjDQoqs3jkL5ff3xP70e1NqJmFFtKVBdAgzP7ky2HBXNPS2IcZnlVaeSg5PECayvsYDrrmB6EHpveoRwNi5CdA9BCLTzMvFh/1Ynno+inZX2kUAVAtkxFtUO7pMMtMbRLXXkIlztn46jw2FF3wV10JpzHxx8oc3IY/c3mwfw3wFUsT5xg99zW/qw9dV2fE2j1pRwM+S2aqUuw6EZCySr9QpbccMs49lk7QiMtHfUgzrxQQCOD+lHkUah+cxWuef/lprIM/r9nR2C6IsWcY0KRj+uOsXnTirm209Cl+G2hbKhaK0+mjSbDGBTyJKkJEk9XEvHkIUkxg1gwQeqlQ1dOc1iY50XUneYDElYc7egmAUJt0C1kwI3V40If6KkbUgw1K6B/HfDCrZVg9IeC9K1tp+obi1L8U1RZjPF8RrMXKHUiwnlbVyNVN5W1xyL8ch6QZF3XigOdIF2T/LzVyPD4ajFZb52zHGkdigQQXfare5Wzi6Sp8H9t1Iwh1UljsDidlJAwlIte+1ADgLyxRBqEBFe0JLqH/eawOe0yZ4P1wovr0jnX+CdTjxLdmBM59YUy99LtvI1RsEaqb+jhEZkeRanVFYgcvfYnBbolHNujSnnpbQVvTB4xkJlusnYefplrB5PAqTt0i7n36lXeDtXuOt0xta0erJiwRGvtHmaiPInqkA/InW9Acs6yPBNU2AlCXTjg06JPqaww3CMrWxylcYIGOhfoGeU6nDDWISPIyyROWaFMeof7AQuu2EJCq9WrKrW8eDcdGb52qANyXmgRB5qDAo1QdZQnvSBMyoFL284XCC+xKY5NskcseTiM/O+K0il8w3CcPAYDFAN02fx4Zq+ImMu8Fgm7DoVJ3EkI4vrg43j3XeVznx0kOEw7ZG+q8YdZ3pd+KFwGVv602ZPXS6qte06qILcUVaZGtBgB"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3452,"cache_read_input_tokens":176223,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3452},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"a515611d-bc29-481c-b8ef-1bfdb6d1bab1","timestamp":"2026-08-25T10:18:37.805Z","request_id":"req_011CePJ7mMsMWhMdwg447dhF"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ7rPjjcYmfnirHPXaW","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01VYYsxLHV4CKbKKRwfrnBU5","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/canonical/ButtonBridge.vue"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3452,"cache_read_input_tokens":176223,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3452},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"655c88c8-e317-4dd2-8efd-bd9f3db0b73c","timestamp":"2026-08-25T10:18:39.146Z","request_id":"req_011CePJ7mMsMWhMdwg447dhF"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01VYYsxLHV4CKbKKRwfrnBU5","type":"tool_result","content":"1\t\n52\t\n53\t\n78\t\n79\t\n96\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"59950f2b-5254-49d4-837d-ad444e8c72e1","timestamp":"2026-08-25T10:18:39.156Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/canonical/ButtonBridge.vue","content":"\n\n\n\n\n","numLines":96,"startLine":1,"totalLines":96}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ7rPjjcYmfnirHPXaW","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01HVVic7BhfE8irFgcgKzjgs","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/canonical/PillStatus.vue"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3452,"cache_read_input_tokens":176223,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3452},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"763b492c-11ec-4e0d-8180-76a098694b05","timestamp":"2026-08-25T10:18:39.922Z","request_id":"req_011CePJ7mMsMWhMdwg447dhF"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01HVVic7BhfE8irFgcgKzjgs","type":"tool_result","content":"1\t\n26\t\n85\t\n86\t\n98\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"063ecc22-9a16-41a0-a70c-ae5dd6965d0b","timestamp":"2026-08-25T10:18:39.928Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/canonical/PillStatus.vue","content":"\n\n\n\n","numLines":98,"startLine":1,"totalLines":98}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"6e57c87e-c6c2-4d7d-b78c-b9e84dc76eb9","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"da523ceb-ef2d-4ab9-b9d7-c94dad85c5ab","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":250,"estimated_tokens_delta":100,"uuid":"02abd251-e405-46d8-8a7a-a05d1198139c","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":350,"estimated_tokens_delta":100,"uuid":"6bd033ba-a3fc-4368-b8c6-09f79a3a91e5","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ8fwiNpnzAhUQYKMLM","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAIS2AgKpgEIERgCKkAzfBZRwtSiCg2xjUuUM+R0OSewrZvH3jXHWFAjfKfdD/13psZgnmb4I6ACXx/Ja/C6ByWEEapBK7EJkUBOzJBQMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAYjYtdQGsAECEgyOnMf+92z0PA2tMjUaDGHUAwLDsM2SuPXgtCIwotuLlSa9T0neLaKTYCWOn5w8TbIHtH10J3uXitOQ41x+84LFZQZXbAQQ04pJWjbQKt4GK7b02GekBA6BNlyFEbjAYWqMwJpaoMqIpWeAtVme2PGF9vfgnZM0oIoJDQcDvJMZMH4ntxYzKK/dHPJu1EsJSP/1xMWb/uZanOJ6scE1nWLpzK5tLgm3365qy1OlRrC1mrVA+ZsGKO+C9Gb3Tc+WS7ie6ogblAwaJSl2QNBKgcNHaAv+xBt2OSnbiF0aiiaJpoQVInnH8lBH59aQxRAAKzml3lyDBV3sphH/xxcsPWKBBrUg33p1IoqMi9QFG7h7h3cGNVPCrUyI95wVd1zltIkbPAlCOORGXhzrjkRurzo+HR+BZG4j2DQs6qDbloOCoPc0Asfr+8BOl06MA27L/tDuOKDIbgJAGlt1TdgJG6zfMV/psm9FiFpJpJVnJCeucwjYTem3N0EjqRQuvQdEAcr/1Nsj/zcPlcap//oeuCYQIEypTvsM7Z1NpMeQOJI/lBs1jd56bITNoPCB7I8PpwAsAduMmtZ692cKDtoTcRh4kqtboJP6MHkb7ci4Vf/szM3iJAbYYeK8d33gZktD58fVczVg2K4ww3wuD8Y4gFICk7Z2RCaaSJGIF88zj6ehqY+kU8JQAvVrRUHkkR4NtdLitdNbwz1lPt6s8VW2NLb/yecQNvaCJ1iKlpA/gW/Vh+Rn5GBYDeRbi+aFtLkvAXLA2t8NQrhNsuLs+cNhChrJoby8QuotTcF0xgZ1MzmHOha/+/YlBeSiqj//2ok68q4saqSkWaS+GvA5AQvT3uuzGLqIRhlf19VMY1DdK+DcUYFnFHtjQ9ZeFC0wFzLeR9f9G5uuzdVsTtGV5WzyMZLPmvOmRQ9UCt7XONAwJ7/TB7l8NJZLtoib9IfZb//4Vktt2Y7Hd856sQk3ZAkejsnrGyl3/RCFavXhaduQ+bhk3BMirSQLfOwrLqX5R7byGMrSdAuy5yxlAJiSjYDnULfnR4/6M24jGKvm86A9FWz+Rzv/LPvZqAPUyh0yNcTZr9hMXLygwO2r52QyWIlz97OYWt4wp+2R0hm1B6sQHnbjWv2r5F5OEc8bwPl4E2F0rW3YOpSU9VAQp5kNfg3svRTFgtbVnQEXsoUySwazI7lqaGP8PrHljn7mVgFXEBUFQeR+jm7IuMmsqf5t1tD1Xbp+HqNkRpRcSuJ5++7zEhgB"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3793,"cache_read_input_tokens":179675,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3793},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"bf8b386d-f0d4-4d55-8a5a-024ae5f332c2","timestamp":"2026-08-25T10:18:48.054Z","request_id":"req_011CePJ8b2Hu52fnQAekNQhT"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ8fwiNpnzAhUQYKMLM","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01JuxDCZ4dtyH15NCSXLadzk","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Pill/Pill.vue"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3793,"cache_read_input_tokens":179675,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3793},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"3c904e9c-8e4c-448e-bcb0-8e6320fc3684","timestamp":"2026-08-25T10:18:49.494Z","request_id":"req_011CePJ8b2Hu52fnQAekNQhT"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01JuxDCZ4dtyH15NCSXLadzk","type":"tool_result","content":"1\t\n2\t\n12\t\n66\t\n67\t\n74\t\n75\t\n114\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"9c51113d-3a62-4cb8-ab1a-63644d5e8c45","timestamp":"2026-08-25T10:18:49.502Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Pill/Pill.vue","content":"\n\n\n\n\n\n\n","numLines":114,"startLine":1,"totalLines":114}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ8fwiNpnzAhUQYKMLM","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01JkQovGJTUg6fWoXqgQSzjm","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/canonical/Badge.vue"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3793,"cache_read_input_tokens":179675,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3793},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"4066e11d-eec5-450e-98a1-4ad05fc96651","timestamp":"2026-08-25T10:18:49.898Z","request_id":"req_011CePJ8b2Hu52fnQAekNQhT"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01JkQovGJTUg6fWoXqgQSzjm","type":"tool_result","content":"1\t\n62\t\n63\t\n77\t\n78\t\n101\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"e9a4f5aa-77c0-4c53-b2e7-9afdd68f425b","timestamp":"2026-08-25T10:18:49.909Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/canonical/Badge.vue","content":"\n\n\n\n\n","numLines":101,"startLine":1,"totalLines":101}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"92d26b26-7300-468f-a3cb-930db3ff8e7a","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":100,"estimated_tokens_delta":50,"uuid":"1a7c5b88-8d11-45ec-9874-264fb949aa0e","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":200,"estimated_tokens_delta":100,"uuid":"b81bc8c6-4e06-41fe-a8ce-506538e2fc7e","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":300,"estimated_tokens_delta":100,"uuid":"a0d9e8e6-05e8-46fd-b507-53419879d61c","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ9PiRz2Gf6qq9q9B9s","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAIS6ggKpgEIERgCKkD0URw3iy2l7i4Q8zAt/c7UrW91YMdOww4VulHcbFyooX29nPvsIM325xKEGeHAYANAo5DWQTVCIDqtqzqo0wEHMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAZPYtdQGsAECEgzWP5qNq8xH1yYNC68aDFvpzStKhHFD3ATkViIwf9TlLTL9C9X2kqyoHF9nHxPp2Ww/timmEW5k2kdc84HwB3QqjnnqNtoR+6C3r1lUKvAGMWNZoSmJZhJx4zoXfAd+SCfZQOOTcGbRdHPDrY6Rq+0vFIeA60ysu38qM6lpdfZMNyFXlN7nb/th70zXkqQnbYp75FQ9zxZDGZ7tpbnJa+1/Il23ZtEEpcsgplYW0LzTB1SfgWTWYDkvfKS4trM5iAQ18LsE8owjZAJLYWMRo+sNJSACLOx3t+BuUN8rzs8QREpwShuMCp/kd8Wx2t8dZnZoIAQTxfH0kf3IPHHJYFvS8EMjvyljU9GfUYWHmOvXA7V69ayNxOsyw9tD6P2UTj0KuO9iupA9+ZZwSIAPUTubi9mjvCUHG+/QU1CrZp1zMEhZdrL5Kr6pUJSllPS0lUut/V3uck+wIo9nC5oevmGUCeCERXfNPaQFRMg/OPmw5fojRVHrvnoiSNs0iGxTPxefVRoLfnYSj/jB5ORghadDmN9NBna7KBFbntJ3MLRjtDuzbunbNa6ntyYfJCH8CO7xlGvYX1exJFLk4GjDzWNt1vLFOej6SCwHws010vMIPJMLteGzsHVyXjRIikKDppGZwmmXSSOZUJIL3YqFoahIdSYKjl5ARSmmqKanNANc04/Aldi2p908BKk/+pIBI5R8/Tfkz8y+rsoiQ54Sb1eE1qolrefANj7aaOxjaP5SPivwLuL4ES4rYTnPDICboXmTePwS14ltg2IrjL+mHqtmvglZTMQuW9wqTssJ1nY0qKsrEJ8pJX6H9yjmZGNSkeMRxoppT0FnlbVxG3evOAzVmtClq1Ex6jR7kglSBRZ2r27fyGf5Aq+rCEqvpVJ1UmL6P0pHvQixy0jcBVfpsbUDNOxXRfsmZyIYgAn7+gk5nlaRs2+GFXJ7unOfTh1j/ozl++98/y91jfRDB49Wmyq0esuTf5esPBXfP7Dzd3/IiZuwxwNZPwi34EzEBP8hVIqTlpqJP2DMaxo//qbMsXPKUsK1dR1JXH2KqoceWZM3Tzt9NVidXHZxLFh7fzn/yV2rPsBhYxV/iprnCBA9xfHeS5PIDNHt8Y8Kbrt4FoJtNXgRhCpykT1UtPlIXiWzuTSCDPvhj/Z7/aLx9VxVBDvRrb4AoAPvE9BTXgAktsoIvxifyAPgXC+ohcjMJcqMUjelGnHwMGBMBwbtKiXZaUWKj96NnJxYNP/SiFF4T4HRkf3G1TMdl7sbBaHo1d7cehgB"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":4309,"cache_read_input_tokens":183468,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":4309},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"94e7abab-3127-432a-b88a-06ec180ec79d","timestamp":"2026-08-25T10:18:59.339Z","request_id":"req_011CePJ9JmmjcofFxkMAxGcG"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ9PiRz2Gf6qq9q9B9s","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01XQFjcNQapfuMxmfcMezQjD","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/domain-tvu.md","limit":150},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":4309,"cache_read_input_tokens":183468,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":4309},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"2ca2725a-05f7-4f70-bdfb-35d1432f79b7","timestamp":"2026-08-25T10:19:00.705Z","request_id":"req_011CePJ9JmmjcofFxkMAxGcG"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01XQFjcNQapfuMxmfcMezQjD","type":"tool_result","content":"1\t# TVU Business Domain Rules\n2\t\n3\t> TVU 产品特有的业务规则，**适用于两条 path**（Path A Figma mockup + Path B 代码生成）。\n4\t> 来源：TVU 行业背景（广播 / 直播 / 媒体处理）+ 产品特性积累。\n5\t>\n6\t> 通用 process 规则 → [`design-process.md`](./design-process.md)\n7\t> Figma 工具 quirks → [`figma-technical-reference.md`](./figma-technical-reference.md)\n8\t> Path 专属细节 → [`mockup-conventions.md`](./mockup-conventions.md) / [`code-conventions.md`](./code-conventions.md)\n9\t\n10\t\n11\t> **本文件规则清单 —— 唯一真源**（机械核 `pnpm audit:rule-inventory`；scoped 与 lazy 加载按本清单挑，别处一律只放指针）\n12\t>\n13\t> TVU SaaS 产品默认 Persona 列表 / M3 / M4 / M5 / M7 / M8 / M9 / M10 / M11 / M12 / M13 / M17\n14\t\n15\t\n16\t> ⚠️ **本清单从活源 H2 标题派生，别手抄别处的版本。** 2026-08-03 实测：仓库里曾有 4 处都把本文件写成\n17\t> `M3 / M4 / M5 / M7 / M8 / M9`（6 条），而实际有 12 条 —— **M10 / M11 / M12 / M13 / M17 与 Persona 表\n18\t> 从未被列进任何一份清单**，整整一半。\n19\t\n20\t---\n21\t\n22\t## TVU SaaS 产品默认 Persona 列表\n23\t\n24\t> 适用于 TVU Usage Service / SaaS Dashboard / 管理后台类产品。F2 persona simulation 无需手动提供，默认读此表。\n25\t> 监控台 / operator console 类产品另有 persona（重度运营 / SRE），在具体产品 brief 中定义。\n26\t\n27\t| Persona | 角色 | 核心关注点 | 看 dashboard 核心目标 |\n28\t|---|---|---|---|\n29\t| **CFO / Business Owner** | 财务负责人 / 高管 | 盈利健康、成本趋势、ROI、Savings | 3 秒内获取 margin % + 趋势方向 + 是否改善 |\n30\t| **PM（产品经理）** | 产品负责人 | 功能 PRD scope 边界、user story 覆盖、无 scope creep | 确认交付边界，功能不越界也不遗漏 |\n31\t| **SRE / DevOps** | 基础设施 / 可靠性 | 数据管道健康、延迟、告警、数据新鲜度 | 数据是否实时、有无 pipeline 故障信号 |\n32\t\n33\t---\n34\t\n35\t## M3 — Status 色绑定遵循广播行业 ON AIR 惯例\n36\t\n37\tTVU 产品 session / stream 状态色：\n38\t\n39\t| 状态 | 颜色 | Token (dark) |\n40\t|---|---|---|\n41\t| **Live** (output on air) | 🔴 红 | `--red` (#ea4233) → library var `UX/Red/Default` |\n42\t| **Previewing / Standby** | 🟢 绿 | `--brand` (#2fb54e) → library var `UX/Brand/Brand` |\n43\t| **Inactive** | ⚫ 灰 | library var `Color Type/Background/Disable Grey Button` |\n44\t| **N/A** (component 不支持) | ⚪ 浅灰斜杠 | `--text-disabled` |\n45\t\n46\t**不要**按 SaaS 默认（绿=活跃、红=危险）配色。客户是广播 / 直播 / 媒体处理工程师，红=Live 是肌肉记忆。\n47\t\n48\tDestructive 操作（Stop / Remove confirm）也用红，但出现在 modal 内部，与 Live badge（table 行）位置不重叠，不冲突。\n49\t\n50\t---\n51\t\n52\t## M4 — Monitoring / Operator console 类页面默认 dark theme only\n53\t\n54\t监控类 / 运营操控台类产品 deliverable 默认**仅交付 dark mode**，除非用户显式要求。不画 / 生成 light mode 对比图。\n55\t\n56\t**Why:** 广播控制台 industry default + 长时间盯屏视疲劳。\n57\t\n58\t---\n59\t\n60\t## M5 — 不在 dashboard / monitoring 页面创建 session\n61\t\n62\tMonitoring 类产品（如 Session Dashboard）默认是 **readonly 监控 + 控制台**：\n63\t\n64\t- ❌ 不暴露 `+ New Session` 或类似创建入口\n65\t- ✅ session 由后端 / MicroApp 自身创建后 push 到 dashboard\n66\t- ✅ dashboard 仅做：查看状态 / 启停 / 跳转 / 移除\n67\t\n68\t---\n69\t\n70\t## M7 — Control surface 视觉权重：actions > identifiers > status\n71\t\n72\t监控 / operator console 类页面的视觉层级**必须**：\n73\t\n74\t1. **Actions（操作按钮）最显眼** — 必须用正规尺寸 button，不允许自制 XS chip；column 不够宽就让 column 宽，不要缩按钮（违反 Fitts 定律）\n75\t2. **Identifiers（PID / Object ID 等）次要** — 文字层级中等，operator 偶尔需要复制 ID\n76\t3. **Status pills 最安静** — 短词（`Live` / `Preview` / `Inactive`），暗色块或低饱和 bg，小 padding；**绝不**用 solid 大色块抢 action 焦点\n77\t\n78\t**反例**（2026-05-06 Session Dashboard 第一版）: Status pill 全饱和 solid 红/绿 + 白字（视觉权重最重）; Action 按钮自制 XS chip（视觉权重最轻）→ operator 一眼看到的是 status，找 action 要扫一遍，视觉层级完全反了。\n79\t\n80\t**Why:** operator 看 dashboard 目标 90% 是操作（启停/跳转），10% 才是被动监控状态。视觉权重服务主任务。\n81\t\n82\t---\n83\t\n84\t## M8 — Dashboard 折叠卡片默认状态规则\n85\t\n86\t所有按 entity 分组的 dashboard card 默认状态**必须**：\n87\t\n88\t| 该 entity 状态 | 卡片默认 | Badge |\n89\t|---|---|---|\n90\t| 至少 1 个 active session | **expanded** | 🟢 `X active`（绿）|\n91\t| 全部 inactive | **collapsed** | ⚪ `X sessions`（灰）|\n92\t\n93\tChevron 图标方向反映展开/折叠状态。\"所有 card 一律展开 + 一律绿 badge\" → ❌ 把折叠功能做空，背离它存在的意义。\n94\t\n95\t**Why:** dashboard 长 list 默认全展开噪音过大；折叠规则把\"没在跑的 entity\"压扁、\"有活动的\"暴露出来。badge 颜色变化（绿 active → 灰 sessions）本身就是 affordance。\n96\t\n97\t---\n98\t\n99\t## M9 — Operator console action label 用 literal 动词\n100\t\n101\t行内 / 卡片内 action button label **必须**用动词短语，不允许用图标缩写、字符画、或动作的对象名替代动词：\n102\t\n103\t| ✅ 正确 | ❌ 错误 |\n104\t|---|---|\n105\t| `Open GUI` | `Ctrl ↗` / `GUI` |\n106\t| `Stop In` | `■ In` / `In` |\n107\t| `Start Out` | `▶ Out` / `Out` |\n108\t| `Remove` | `✕` |\n109\t\n110\tIcon 可以**配合**文字（button 支持 icon=left/right），但不能**替代**文字。\n111\t\n112\t**Why:** 字符画在 dark theme 小字号下识别度低，broadcasting 软件标准（vMix / TriCaster / OBS）全用 literal verb，且 i18n（图标符号难翻译）和 a11y（screen reader 念不出 ↗）更友好。\n113\t\n114\t---\n115\t\n116\t## M10 — List row Inactive 状态至少分两子型（Idle vs NeverStarted）\n117\t\n118\t监控 / operator console 类列表 row 的 \"off / 未运行\" 状态**至少**分两个子型，**不允许合并为单一 Inactive variant**：\n119\t\n120\t| 子型 | 副标题内容 | 行内可见字段 | 用户心智 |\n121\t|---|---|---|---|\n122\t| **Inactive-Idle**（曾运行有 history） | `Last ran HH:MM → HH:MM · N min`（可附 last delta）| route + history meta | \"停了可重启\" |\n123\t| **Inactive-NeverStarted**（从未运行） | `Never started` + CTA `Set <资源 A> and <资源 B>` | 无 route / 无 delta，只 CTA prompt | \"从未配置，先配再用\" |\n124\t\n125\t**Why:** 两子型 user mental model 完全不同。合并 → bootstrap 引导场景丢失，user 看 `Inactive` 不知该 click \"重启\" 还是 \"去配置\"。\n126\t\n127\t**反例**（2026-05-26 Video Sync Phase B 初版）：原计划 8 variants (`state×selected×expanded = 2×2×2`)，把 `#3 TV2_Feed Last ran ...` 与 `#5 Test_Session Never started` 都画成同一 Inactive variant → 用户分不清是 stopped 还是 never-configured → 实际派生 12 variants (`state(3) × selected × expanded`)。\n128\t\n129\t**Acceptance:**\n130\t- Component 设计：variant property `state` 至少包含 `{Active, Inactive-Idle, Inactive-NeverStarted}` 三值\n131\t- Mockup 设计：list 内同时出现两子型 row 时，副标题措辞必须区分（\"Last ran X\" vs \"Never started\"），不混用\n132\t- Bootstrap session 必为 NeverStarted 子型，对应 CTA 必为 literal verb（如 `Set Stream A and Stream B`）\n133\t\n134\t---\n135\t\n136\t## M11 — Trend visualization: icon + 数值颜色双层信号\n137\t\n138\tDelta / latency / metric trend 可视化用 ↑↓ icon 时，**仅 icon 不够**——**数值本身也要染色**，icon + 数值色构成双层视觉信号：\n139\t\n140\t| 状态 | Icon | 数值颜色 | Token (dark) |\n141\t|---|---|---|---|\n142\t| **Converging** (delta 收敛 / metric 改善) | ↓ | 绿 | `UX/Brand/Brand` (`--brand`) |\n143\t| **Diverging** (delta 发散 / metric 恶化) | ↑ | 橙红 | `Color/Text/Warning` (`--text-warning`) |\n144\t| **Stable** (变化在阈值内) | 无 icon | 中性色 | `Color/Text/Primary` |\n145\t\n146\t**阈值规则示例**（不同 metric 取值）：Δ ≤ -2 ms 显 ↓ 绿；Δ ≥ +2 ms 显 ↑ 橙红；±2 ms 内无 icon 中性色。具体阈值由业务定，但**双层信号格式必须遵守**。\n147\t\n148\t**Why:** icon 小（通常 16×16）+ dark theme 下易被忽略；数值大字号染色让 user 一眼 grasp 方向。仅 icon 漏掉 = monitoring console 高频信息密度场景下信号弱。\n149\t\n150\t**任何 trend rule 必须同时描述：** (1) icon 触发阈值 (2) 数值颜色映射 (3) Token 引用。漏写颜色规则 = 不完整 spec。"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"5965da10-cb1f-4008-b7e1-de2a97eb3d5f","timestamp":"2026-08-25T10:19:00.713Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/domain-tvu.md","content":"# TVU Business Domain Rules\n\n> TVU 产品特有的业务规则，**适用于两条 path**（Path A Figma mockup + Path B 代码生成）。\n> 来源：TVU 行业背景（广播 / 直播 / 媒体处理）+ 产品特性积累。\n>\n> 通用 process 规则 → [`design-process.md`](./design-process.md)\n> Figma 工具 quirks → [`figma-technical-reference.md`](./figma-technical-reference.md)\n> Path 专属细节 → [`mockup-conventions.md`](./mockup-conventions.md) / [`code-conventions.md`](./code-conventions.md)\n\n\n> **本文件规则清单 —— 唯一真源**（机械核 `pnpm audit:rule-inventory`；scoped 与 lazy 加载按本清单挑，别处一律只放指针）\n>\n> TVU SaaS 产品默认 Persona 列表 / M3 / M4 / M5 / M7 / M8 / M9 / M10 / M11 / M12 / M13 / M17\n\n\n> ⚠️ **本清单从活源 H2 标题派生，别手抄别处的版本。** 2026-08-03 实测：仓库里曾有 4 处都把本文件写成\n> `M3 / M4 / M5 / M7 / M8 / M9`（6 条），而实际有 12 条 —— **M10 / M11 / M12 / M13 / M17 与 Persona 表\n> 从未被列进任何一份清单**，整整一半。\n\n---\n\n## TVU SaaS 产品默认 Persona 列表\n\n> 适用于 TVU Usage Service / SaaS Dashboard / 管理后台类产品。F2 persona simulation 无需手动提供，默认读此表。\n> 监控台 / operator console 类产品另有 persona（重度运营 / SRE），在具体产品 brief 中定义。\n\n| Persona | 角色 | 核心关注点 | 看 dashboard 核心目标 |\n|---|---|---|---|\n| **CFO / Business Owner** | 财务负责人 / 高管 | 盈利健康、成本趋势、ROI、Savings | 3 秒内获取 margin % + 趋势方向 + 是否改善 |\n| **PM（产品经理）** | 产品负责人 | 功能 PRD scope 边界、user story 覆盖、无 scope creep | 确认交付边界，功能不越界也不遗漏 |\n| **SRE / DevOps** | 基础设施 / 可靠性 | 数据管道健康、延迟、告警、数据新鲜度 | 数据是否实时、有无 pipeline 故障信号 |\n\n---\n\n## M3 — Status 色绑定遵循广播行业 ON AIR 惯例\n\nTVU 产品 session / stream 状态色：\n\n| 状态 | 颜色 | Token (dark) |\n|---|---|---|\n| **Live** (output on air) | 🔴 红 | `--red` (#ea4233) → library var `UX/Red/Default` |\n| **Previewing / Standby** | 🟢 绿 | `--brand` (#2fb54e) → library var `UX/Brand/Brand` |\n| **Inactive** | ⚫ 灰 | library var `Color Type/Background/Disable Grey Button` |\n| **N/A** (component 不支持) | ⚪ 浅灰斜杠 | `--text-disabled` |\n\n**不要**按 SaaS 默认（绿=活跃、红=危险）配色。客户是广播 / 直播 / 媒体处理工程师，红=Live 是肌肉记忆。\n\nDestructive 操作（Stop / Remove confirm）也用红，但出现在 modal 内部，与 Live badge（table 行）位置不重叠，不冲突。\n\n---\n\n## M4 — Monitoring / Operator console 类页面默认 dark theme only\n\n监控类 / 运营操控台类产品 deliverable 默认**仅交付 dark mode**，除非用户显式要求。不画 / 生成 light mode 对比图。\n\n**Why:** 广播控制台 industry default + 长时间盯屏视疲劳。\n\n---\n\n## M5 — 不在 dashboard / monitoring 页面创建 session\n\nMonitoring 类产品（如 Session Dashboard）默认是 **readonly 监控 + 控制台**：\n\n- ❌ 不暴露 `+ New Session` 或类似创建入口\n- ✅ session 由后端 / MicroApp 自身创建后 push 到 dashboard\n- ✅ dashboard 仅做：查看状态 / 启停 / 跳转 / 移除\n\n---\n\n## M7 — Control surface 视觉权重：actions > identifiers > status\n\n监控 / operator console 类页面的视觉层级**必须**：\n\n1. **Actions（操作按钮）最显眼** — 必须用正规尺寸 button，不允许自制 XS chip；column 不够宽就让 column 宽，不要缩按钮（违反 Fitts 定律）\n2. **Identifiers（PID / Object ID 等）次要** — 文字层级中等，operator 偶尔需要复制 ID\n3. **Status pills 最安静** — 短词（`Live` / `Preview` / `Inactive`），暗色块或低饱和 bg，小 padding；**绝不**用 solid 大色块抢 action 焦点\n\n**反例**（2026-05-06 Session Dashboard 第一版）: Status pill 全饱和 solid 红/绿 + 白字（视觉权重最重）; Action 按钮自制 XS chip（视觉权重最轻）→ operator 一眼看到的是 status，找 action 要扫一遍，视觉层级完全反了。\n\n**Why:** operator 看 dashboard 目标 90% 是操作（启停/跳转），10% 才是被动监控状态。视觉权重服务主任务。\n\n---\n\n## M8 — Dashboard 折叠卡片默认状态规则\n\n所有按 entity 分组的 dashboard card 默认状态**必须**：\n\n| 该 entity 状态 | 卡片默认 | Badge |\n|---|---|---|\n| 至少 1 个 active session | **expanded** | 🟢 `X active`（绿）|\n| 全部 inactive | **collapsed** | ⚪ `X sessions`（灰）|\n\nChevron 图标方向反映展开/折叠状态。\"所有 card 一律展开 + 一律绿 badge\" → ❌ 把折叠功能做空，背离它存在的意义。\n\n**Why:** dashboard 长 list 默认全展开噪音过大；折叠规则把\"没在跑的 entity\"压扁、\"有活动的\"暴露出来。badge 颜色变化（绿 active → 灰 sessions）本身就是 affordance。\n\n---\n\n## M9 — Operator console action label 用 literal 动词\n\n行内 / 卡片内 action button label **必须**用动词短语，不允许用图标缩写、字符画、或动作的对象名替代动词：\n\n| ✅ 正确 | ❌ 错误 |\n|---|---|\n| `Open GUI` | `Ctrl ↗` / `GUI` |\n| `Stop In` | `■ In` / `In` |\n| `Start Out` | `▶ Out` / `Out` |\n| `Remove` | `✕` |\n\nIcon 可以**配合**文字（button 支持 icon=left/right），但不能**替代**文字。\n\n**Why:** 字符画在 dark theme 小字号下识别度低，broadcasting 软件标准（vMix / TriCaster / OBS）全用 literal verb，且 i18n（图标符号难翻译）和 a11y（screen reader 念不出 ↗）更友好。\n\n---\n\n## M10 — List row Inactive 状态至少分两子型（Idle vs NeverStarted）\n\n监控 / operator console 类列表 row 的 \"off / 未运行\" 状态**至少**分两个子型，**不允许合并为单一 Inactive variant**：\n\n| 子型 | 副标题内容 | 行内可见字段 | 用户心智 |\n|---|---|---|---|\n| **Inactive-Idle**（曾运行有 history） | `Last ran HH:MM → HH:MM · N min`（可附 last delta）| route + history meta | \"停了可重启\" |\n| **Inactive-NeverStarted**（从未运行） | `Never started` + CTA `Set <资源 A> and <资源 B>` | 无 route / 无 delta，只 CTA prompt | \"从未配置，先配再用\" |\n\n**Why:** 两子型 user mental model 完全不同。合并 → bootstrap 引导场景丢失，user 看 `Inactive` 不知该 click \"重启\" 还是 \"去配置\"。\n\n**反例**（2026-05-26 Video Sync Phase B 初版）：原计划 8 variants (`state×selected×expanded = 2×2×2`)，把 `#3 TV2_Feed Last ran ...` 与 `#5 Test_Session Never started` 都画成同一 Inactive variant → 用户分不清是 stopped 还是 never-configured → 实际派生 12 variants (`state(3) × selected × expanded`)。\n\n**Acceptance:**\n- Component 设计：variant property `state` 至少包含 `{Active, Inactive-Idle, Inactive-NeverStarted}` 三值\n- Mockup 设计：list 内同时出现两子型 row 时，副标题措辞必须区分（\"Last ran X\" vs \"Never started\"），不混用\n- Bootstrap session 必为 NeverStarted 子型，对应 CTA 必为 literal verb（如 `Set Stream A and Stream B`）\n\n---\n\n## M11 — Trend visualization: icon + 数值颜色双层信号\n\nDelta / latency / metric trend 可视化用 ↑↓ icon 时，**仅 icon 不够**——**数值本身也要染色**，icon + 数值色构成双层视觉信号：\n\n| 状态 | Icon | 数值颜色 | Token (dark) |\n|---|---|---|---|\n| **Converging** (delta 收敛 / metric 改善) | ↓ | 绿 | `UX/Brand/Brand` (`--brand`) |\n| **Diverging** (delta 发散 / metric 恶化) | ↑ | 橙红 | `Color/Text/Warning` (`--text-warning`) |\n| **Stable** (变化在阈值内) | 无 icon | 中性色 | `Color/Text/Primary` |\n\n**阈值规则示例**（不同 metric 取值）：Δ ≤ -2 ms 显 ↓ 绿；Δ ≥ +2 ms 显 ↑ 橙红；±2 ms 内无 icon 中性色。具体阈值由业务定，但**双层信号格式必须遵守**。\n\n**Why:** icon 小（通常 16×16）+ dark theme 下易被忽略；数值大字号染色让 user 一眼 grasp 方向。仅 icon 漏掉 = monitoring console 高频信息密度场景下信号弱。\n\n**任何 trend rule 必须同时描述：** (1) icon 触发阈值 (2) 数值颜色映射 (3) Token 引用。漏写颜色规则 = 不完整 spec。","numLines":150,"startLine":1,"totalLines":263}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJ9PiRz2Gf6qq9q9B9s","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01DMWGr34q7UHuHH73x2CgGy","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","offset":995,"limit":95},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":4309,"cache_read_input_tokens":183468,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":4309},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"a0882685-a796-4475-9143-f6d541c68c02","timestamp":"2026-08-25T10:19:01.275Z","request_id":"req_011CePJ9JmmjcofFxkMAxGcG"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01DMWGr34q7UHuHH73x2CgGy","type":"tool_result","content":"995\t## R14 — Layout Primitive Selection（code-side mirror of M31）\n996\t\n997\t写 product UI 代码（JSX / Vue template / HTML）时，**必须按场景选最合适的 CSS layout 机制**，绝对定位（`position: absolute / fixed`）仅在有充足理由时使用。\"先 flex/grid，找不到合适的再退到 absolute\" 是默认顺序。\n998\t\n999\t#### 决策树\n1000\t\n1001\t| 场景 | 推荐 | 理由 |\n1002\t|---|---|---|\n1003\t| 1D 排列（按钮组 / nav / list / footer action row） | **flex** (`display: flex`) | 内容长度变化自动重排；`gap` / `justify-content` / `align-items` 处理间距和对齐 |\n1004\t| 2D 网格（dashboard / form grid / card 网格） | **grid** (`display: grid`) | row / col 显式，比 nested flex 清晰 |\n1005\t| 子元素的\"显示 / 隐藏\"是状态 | **conditional render**（`v-if` / `&&` / ternary） | 不要 `position: absolute; visibility: hidden` 留尸 DOM |\n1006\t| 子元素位置随 sibling 动（流式 wrap / baseline align） | **flex-wrap + align-items** | 不手算 `top` / `left` |\n1007\t| 一次性 overlay 浮层（dialog / popover / tooltip / dropdown menu） | **`position: fixed / absolute`** 允许，但必须 JSDoc / 注释注明理由 | overlay 类没 layout 语义 |\n1008\t| 动画 transform 起点终点 | **`position: absolute`** 允许（动画 anchor 限定） | transform origin 需要稳定 reference |\n1009\t\n1010\t#### 反例\n1011\t\n1012\t| ❌ 错误做法 | 后果 |\n1013\t|---|---|\n1014\t| dialog 内 title / body / button row 各自 `position: absolute; top/left` | 改 title 字数 / 加按钮 / 改 padding → 全部要重算坐标 |\n1015\t| sidebar field row 用 `position: absolute` + 手写 `top: 48px / 90px / 132px` | 加一行字段就要平移下面所有 `top`；改字段顺序要重排所有坐标 |\n1016\t| 用 inline style 写 `style={{position: 'absolute', top: ..., left: ...}}` 不写注释 | 后续维护者无法判断是浮层还是图省事 |\n1017\t\n1018\t#### Acceptance\n1019\t\n1020\t- 任何 dialog / sidebar / footer / list row / toolbar → **必须 flex 或 grid**\n1021\t- 任何 `position: absolute / fixed` 必须有 JSDoc / inline comment 注明 affordance（`/* overlay anchored to backdrop */` / `/* portal mount point */`）\n1022\t- ✅ **已 gate（2026-07-20，INFRA-F68 §L7 consumer 档）**：`audit:consumer-code`（`scripts/audit-product-code.mjs` probe **R14**，blocking）禁止 inline style 含 `position: absolute/fixed` 而无紧邻注释（同行或前一行）。作用域限 inline style；`\n264\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"99c636b4-be92-4e1a-8bd9-fe9cd2937482","timestamp":"2026-08-25T10:20:56.931Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Tooltip/Tooltip.vue","content":"\n\n\n\n\n","numLines":264,"startLine":1,"totalLines":264}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJHwg1p1hEYZB3T8QRv","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01UMiRsS33EeGcPCbBPDjN5t","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/design-process.md","limit":60},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":4785,"cache_read_input_tokens":232298,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":4785},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"3b7c6a90-4e84-4812-85ec-49086dffeafe","timestamp":"2026-08-25T10:20:57.321Z","request_id":"req_011CePJHr5Acz5FkmhbXFnd8"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01UMiRsS33EeGcPCbBPDjN5t","type":"tool_result","content":"1\t# Design Process — Shared Conventions\n2\t\n3\t> **通用 process 原则**，path-agnostic，适用于 Path A（Figma mockup）和 Path B（代码生成）。\n4\t> 语言 voice-neutral：不说 \"画\"、不说 \"写\"，统称 \"生成 deliverable\" / \"采用 source 组件\"。\n5\t>\n6\t> **不包含**：TVU 业务规则（→ [`domain-tvu.md`](./domain-tvu.md)）/ Figma API quirks（→ [`figma-technical-reference.md`](./figma-technical-reference.md)）/ Path 专属细节（→ [`mockup-conventions.md`](./mockup-conventions.md) / [`code-conventions.md`](./code-conventions.md)）。\n7\t\n8\t\n9\t> **本文件规则清单 —— 唯一真源**（机械核 `pnpm audit:rule-inventory`；scoped 与 lazy 加载按本清单挑，别处一律只放指针）\n10\t>\n11\t> 完整产品需求设计流程 / UX 交付物形态 / Convention Priority Hierarchy / M22 / M48 / M49 / M50 / M51 / Pre-Phase 0 / Stage 0.5 / Phase 0 / Library-First + Evidence Discipline / M6 / M11 / M14 / M15 / M16 / M21 / M-PRD-EG / M-CARDINALITY / M-IA-FIRST / M-LIFECYCLE-CRUD / Lazy Reference Loading / Scope Handling / Delivery Cleanup Gate\n12\t\n13\t\n14\t> ⚠️ **本清单从活源 H2 标题派生，别手抄别处的版本。** 2026-08-03 实测：仓库里曾有 5 处各枚举一套\n15\t> 「本文件有哪些规则」，内容 4 种、全部 stale，五处一致漏掉 11 个真实 section —— 含标着「起手强制 Gate」\n16\t> 的 M48 与 M49 / M50 / M51，以及 `Phase 0` 与 `Stage 0.5` 各被漏在不同版本里（这两个 + `Pre-Phase 0`\n17\t> 在本文件里是三个独立 section）。按那种清单做按需加载会漏掉一半以上规则。\n18\t\n19\t---\n20\t\n21\t## 完整产品需求设计流程（⓪ Stage 0 + 8 步，Jira 关联型 mockup）— 2026-05-27 新增；2026-06-05 加 ⓪ Stage 0 上游 framing\n22\t\n23\t接到一条 Jira 需求 → 产出完整 mockup + UX 交付物的标准流程。每一步对应已有规则的入口；本节是 top-level overview，细节查对应规则真源。\n24\t\n25\t```\n26\t[Jira 需求 FB-xxxx]\n27\t │\n28\t ▼\n29\t⓪ Stage 0 上游 framing —— persona + 关键 journey + 边界/异常态清单 + 数据可行性提问，\n30\t │ **用来指导 ③ 怎么建**（不是建完才想）。US-1/2/3 都走；US-3 走 lite 版\n31\t │ （persona + journey + 边界态清单 + 固件/数据提问即可，不必全套 discovery）。\n32\t │ 真源：`design-discovery` skill（重设计/新 persona）+ 本文件 § Stage 0.5 + F2-early。\n33\t ▼\n34\t⓪.5 Design Quality Contract —— 轻量设计质量合同（M49）：Baseline / Delta / Semantic / Feedback Inventory / UX / Simplicity / Content\n35\t │ 先定义\"哪些沿用、哪些改、同类语义用什么模式、哪些文案是唯一术语\"。\n36\t │ **用来约束 ③ 怎么生成**；⑤⑥⑦ 只验证它是否被满足。\n37\t ▼\n38\t① Page + Sections —— rename/新建 page，命名 `< FB-xxxx > YYYYMMDD`（M45）；\n39\t │ page 内用 **具名 Section 组织交付物，禁散落 page**。**推荐三段式**：\n40\t │ (a)「Context」Section = PRD + Jira + UX 卡 · (b) **BEFORE** Section · (c) **AFTER** Section；\n41\t │ **BEFORE 与 AFTER 必须各自独立 Section**（便于 dev/QA/PM 版本对比与单独导航），\n42\t │ Section 名带 `BEFORE` / `AFTER` 标识、与 page 对齐；两对照 section 布局须互相\n43\t │ mirror（[`mockup-conventions.md` §I1](./mockup-conventions.md)）。**无 before/after 对比的全新页（US-1/2）单 Section 即可，不强套 BEFORE/AFTER**\n44\t │ **画布左右序（2026-07-29 owner 回流）**：**对照物一律在左、交付集在右**，从左到右\n45\t │ `REFERENCE` → `BEFORE` → 交付 Section，各自独立 Section、间距 40。见下方 §参考物落地。\n46\t ▼\n47\t② Jira component —— 加 `Jira requirement` instance + FB-id setRangeHyperlink 真实 URL（M23.8）；\n48\t │ 该组件 file-local 不发布 → clone 同文件现成 instance，不 import-by-key 跨文件\n49\t │\n50\t ▼\n51\t③ Mockup 主体 —— Phase 0 mapping + library-first 生成（M0 / M32 / M-COLOR / M-INTEGRITY 等）\n52\t │ （含字段 label 业务词化 M44 + cell 溢出 3 状态 M43）\n53\t ▼\n54\t④ UX 交付说明 —— M23.0 canonical 规则卡（navy #2B2D42 + 4px #33A4FD 左 stroke + Layout A-逐行双语）\n55\t │ 段落覆盖：Why / Changes / Data / Interaction / Acceptance\n56\t ▼\n57\t ——— 以下 ⑤⑥⑦ = 验证 ⓪ Stage 0 的假设是否被满足（对已建产物走查；没产物没法走查）———\n58\t ▼\n59\t⑤ 设计走查 F1 —— 6-section audit（详见 `skills/design-walkthrough/SKILL.md`）\n60\t │ 输出走查 report 卡（沿用 M23 规则卡样式）"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"e205593b-379d-4c3f-ae2d-0082991969bc","timestamp":"2026-08-25T10:20:57.332Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/design-process.md","content":"# Design Process — Shared Conventions\n\n> **通用 process 原则**，path-agnostic，适用于 Path A（Figma mockup）和 Path B（代码生成）。\n> 语言 voice-neutral：不说 \"画\"、不说 \"写\"，统称 \"生成 deliverable\" / \"采用 source 组件\"。\n>\n> **不包含**：TVU 业务规则（→ [`domain-tvu.md`](./domain-tvu.md)）/ Figma API quirks（→ [`figma-technical-reference.md`](./figma-technical-reference.md)）/ Path 专属细节（→ [`mockup-conventions.md`](./mockup-conventions.md) / [`code-conventions.md`](./code-conventions.md)）。\n\n<!-- rule-inventory:design-process -->\n> **本文件规则清单 —— 唯一真源**（机械核 `pnpm audit:rule-inventory`；scoped 与 lazy 加载按本清单挑，别处一律只放指针）\n>\n> 完整产品需求设计流程 / UX 交付物形态 / Convention Priority Hierarchy / M22 / M48 / M49 / M50 / M51 / Pre-Phase 0 / Stage 0.5 / Phase 0 / Library-First + Evidence Discipline / M6 / M11 / M14 / M15 / M16 / M21 / M-PRD-EG / M-CARDINALITY / M-IA-FIRST / M-LIFECYCLE-CRUD / Lazy Reference Loading / Scope Handling / Delivery Cleanup Gate\n<!-- /rule-inventory -->\n\n> ⚠️ **本清单从活源 H2 标题派生，别手抄别处的版本。** 2026-08-03 实测：仓库里曾有 5 处各枚举一套\n> 「本文件有哪些规则」，内容 4 种、全部 stale，五处一致漏掉 11 个真实 section —— 含标着「起手强制 Gate」\n> 的 M48 与 M49 / M50 / M51，以及 `Phase 0` 与 `Stage 0.5` 各被漏在不同版本里（这两个 + `Pre-Phase 0`\n> 在本文件里是三个独立 section）。按那种清单做按需加载会漏掉一半以上规则。\n\n---\n\n## 完整产品需求设计流程（⓪ Stage 0 + 8 步，Jira 关联型 mockup）— 2026-05-27 新增；2026-06-05 加 ⓪ Stage 0 上游 framing\n\n接到一条 Jira 需求 → 产出完整 mockup + UX 交付物的标准流程。每一步对应已有规则的入口；本节是 top-level overview，细节查对应规则真源。\n\n```\n[Jira 需求 FB-xxxx]\n │\n ▼\n⓪ Stage 0 上游 framing —— persona + 关键 journey + 边界/异常态清单 + 数据可行性提问，\n │ **用来指导 ③ 怎么建**（不是建完才想）。US-1/2/3 都走；US-3 走 lite 版\n │ （persona + journey + 边界态清单 + 固件/数据提问即可，不必全套 discovery）。\n │ 真源：`design-discovery` skill（重设计/新 persona）+ 本文件 § Stage 0.5 + F2-early。\n ▼\n⓪.5 Design Quality Contract —— 轻量设计质量合同（M49）：Baseline / Delta / Semantic / Feedback Inventory / UX / Simplicity / Content\n │ 先定义\"哪些沿用、哪些改、同类语义用什么模式、哪些文案是唯一术语\"。\n │ **用来约束 ③ 怎么生成**；⑤⑥⑦ 只验证它是否被满足。\n ▼\n① Page + Sections —— rename/新建 page，命名 `< FB-xxxx > <Title> YYYYMMDD`（M45）；\n │ page 内用 **具名 Section 组织交付物，禁散落 page**。**推荐三段式**：\n │ (a)「Context」Section = PRD + Jira + UX 卡 · (b) **BEFORE** Section · (c) **AFTER** Section；\n │ **BEFORE 与 AFTER 必须各自独立 Section**（便于 dev/QA/PM 版本对比与单独导航），\n │ Section 名带 `BEFORE` / `AFTER` 标识、与 page 对齐；两对照 section 布局须互相\n │ mirror（[`mockup-conventions.md` §I1](./mockup-conventions.md)）。**无 before/after 对比的全新页（US-1/2）单 Section 即可，不强套 BEFORE/AFTER**\n │ **画布左右序（2026-07-29 owner 回流）**：**对照物一律在左、交付集在右**，从左到右\n │ `REFERENCE` → `BEFORE` → 交付 Section，各自独立 Section、间距 40。见下方 §参考物落地。\n ▼\n② Jira component —— 加 `Jira requirement` instance + FB-id setRangeHyperlink 真实 URL（M23.8）；\n │ 该组件 file-local 不发布 → clone 同文件现成 instance，不 import-by-key 跨文件\n │\n ▼\n③ Mockup 主体 —— Phase 0 mapping + library-first 生成（M0 / M32 / M-COLOR / M-INTEGRITY 等）\n │ （含字段 label 业务词化 M44 + cell 溢出 3 状态 M43）\n ▼\n④ UX 交付说明 —— M23.0 canonical 规则卡（navy #2B2D42 + 4px #33A4FD 左 stroke + Layout A-逐行双语）\n │ 段落覆盖：Why / Changes / Data / Interaction / Acceptance\n ▼\n ——— 以下 ⑤⑥⑦ = 验证 ⓪ Stage 0 的假设是否被满足（对已建产物走查；没产物没法走查）———\n ▼\n⑤ 设计走查 F1 —— 6-section audit（详见 `skills/design-walkthrough/SKILL.md`）\n │ 输出走查 report 卡（沿用 M23 规则卡样式）","numLines":60,"startLine":1,"totalLines":1489}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":100,"estimated_tokens_delta":100,"uuid":"6cb65d79-e76b-46c8-9c62-79d516005212","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":200,"estimated_tokens_delta":100,"uuid":"9accadce-80b1-403f-ad9f-3f8dd5a72087","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":250,"estimated_tokens_delta":50,"uuid":"4847260d-43d2-455f-954e-f05af92e91ed","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":350,"estimated_tokens_delta":100,"uuid":"00a2bff0-7c27-41d8-96a5-4d135b4f9e4a","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJJoTBbi9ZGS35uX4Qp","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAIS0AkKpgEIERgCKkAgO5twQKsTHKk9q6SaVBzAo76QV3s4idNkUffV3bei71ci4d8y3EWTcxl2Li2DyJBLdrKsOhx0VgXiA52ZxIoZMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAZTZtdQGsAECEgyPhTfWSM2kPckVAvAaDFqpWDSLEzcN/EsZgyIwkOIpUTSRQ6K//Itbvvp1Q4wmvcNnFf7bu8Yp8huazjIbkwrJKIanOFu5FLFCrYo6KtYHLOV++k9s764Ucl1yxuSOFOjYF3VMQ7fLRPnT+dGWnJJEXbzQ/bVcQVItSyuEHvzNXF4EAu61VEipQx3HNpfBlAmqXxErS8QLfXBIXztrokcMweE2nIXejnh7u0bdlmdQgx0S0d1JzI/No7E9nt+OqVD5cqPia2RdJfEbv+iGsiDzYxIAOiux5x9VnGf9CbRgWkfrkqMh/cdIsp0NcgixNAV/nMClu/YD9JXGyz/iPXpX2ZF091r4k49PHKsaj+yynhpaZIm4To/mkmhjlMcy3uqjE3B3ZI9fXWcA1vbqFYtLbC3RadAdHd+DWMCMj3gZD7ZCMtmx1XMXXlb8JCXHxHw5BwKvuIUrVBDvHhZK7s9OEiaSiI/i4+0uP5YbMszy209nDmZOG8EhvazVsTVPt5utJh2s2aW1ACfYUOX0oQa6me3m4FZXYK/oOxYHv5GxNxPe7c5YfRXi3PywkKBU04EeRAZGcxfKpAh6gwKCFzT4tjHRVNx4YPgtNejnfeDnX6avEeWijuk/tzJrZ9nzpYo2Nv+UIROH1HkfxVfdpgovIlsdcSZ6W+Z5iihZc7fHvnBqJ7s/+Y+nFaZ7LXPztuZoWgsw53RLFwFm2VdSqCHLDLhsAkgj7cJsFZjZzCItwOFzACYzQTLZV0ehPyVn+IwwieztbRVJwvPftid8psXMzrPweyAnbeTE04ML1zDZMgPiweG7BuNy3s8fnzv24A0zFRP0jn1FpGtg6Cvm+EHLJjaHjYgP7y6cbT+0G7i3sx3NjkTdljLqaJhflmmJtiiFJfWtMPdZwexio66o1ew9nWZZimF8wmkiKIeB40lTCkNS2a1or3Xec81pBKmVLDLpiLDGjvdxlitOeS8+goam+Hc5lTmiEVCCvBAY2AeghWU6AyzLLRtsEa7qnpkoS4M2Rd71ZpxuNCkNEp4rEmUFWZ/36PRwPD8wG7IwPF02EXa7OM8z8mxaKDcVtqhVPsv0r6xJMKfJcgxlap7y5ZyhPmAmtJ/3i3LRSo0CTRu6xHqmKsx/ITW1BrOW0wvYIV50uNV6Uewnr2uCd02cmXmc+H4kPxiP+mCWiUkhZ84KJtpRw7nQm0CY/sN7NJj+XMjM9pb+W/eVarImeT0ULLhwIwdfuGgJ6okbVAFNdAEgfEkeyoJsjReb1n7W9zyVYBexMwS1eMWrX5uIBsflt5zg+Kd3fLEeyPQOen2oKzUn1yOXbpyj4cVl+0d5NFPehfFwOkhrX0zF3cB64QTYNW6iqaJn0gRasrMNM50odyoUFCQKwk9PoJXerljf1Ksw+U7qt7gNERgB"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":6080,"cache_read_input_tokens":237083,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":6080},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"87f3152e-5783-4f85-8ca0-4988cabc38c8","timestamp":"2026-08-25T10:21:08.235Z","request_id":"req_011CePJJhiA8D8CFzuHo9izR"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJJoTBbi9ZGS35uX4Qp","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01T6TJ57VBZwFbFqK5GcbuPJ","name":"Grep","input":{"pattern":"^## ","path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/design-process.md","output_mode":"content","-n":true},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":6080,"cache_read_input_tokens":237083,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":6080},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"5886a719-c8a3-469c-bfd9-4279e7bdbc0a","timestamp":"2026-08-25T10:21:10.043Z","request_id":"req_011CePJJhiA8D8CFzuHo9izR"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01T6TJ57VBZwFbFqK5GcbuPJ","type":"tool_result","content":"21:## 完整产品需求设计流程（⓪ Stage 0 + 8 步，Jira 关联型 mockup）— 2026-05-27 新增；2026-06-05 加 ⓪ Stage 0 上游 framing\n229:## UX 交付物形态 — WYSIWYG 完整界面流（非注释卡讲解）— 2026-06-09 新增\n261:## Convention Priority Hierarchy\n274:## M22 — User Design Intent Acknowledgment（前置 Gate）\n300:## M48 — Startup Rule-Coverage Self-Check（起手强制 Gate）— 2026-06-05 新增\n352:## M49 — Design Quality Contract Gate（设计质量合同，前置 + 回归）— 2026-06-11 新增\n505:## M50 — One-Page Design Kickoff Packet（起手总控包）— 2026-06-11 新增\n538:## M51 — Change Control + Regression Snapshot（变更控制 + 回归快照）— 2026-06-11 新增\n565:## Pre-Phase 0：Product Definition Gate\n788:## Stage 0.5 — Pre-Design Validation（discovery 完成后、Phase 0 前）\n869:## User Journey Map — <Feature Name>\n920:## Phase 0：Element-to-Source Mapping（前置硬规则）\n952:## Library-First + Evidence Discipline\n970:## M6 — Reusable Pattern Marking\n983:## M11 — Self-audit Discipline\n1009:## M14 — Reference Input Adaptation（复刻前问适配性）\n1077:## M15 — Source 未实证不得宣告\"不存在\"\n1103:## M16 — Deliverable Defaults Must Be Evaluated\n1142:## M21 — Existing Product Incremental Local Reuse\n1271:## M-PRD-EG — PRD \"e.g.\" 列表必须显式确认 in-scope\n1290:## M-CARDINALITY — 起手 5 个对象关系问题 self-check\n1317:## M-IA-FIRST — Multi-object feature 必先确认 IA（Information Architecture）再进 mockup\n1354:## M-LIFECYCLE-CRUD — first-class entity 必须显式回答 Create / Read / Update / Delete 4 件套\n1388:## Lazy Reference Loading\n1404:## Scope Handling — \"本期不动 X\" ≠ \"删 / 隐藏 X\"（2026-05-28 新增）\n1440:## Delivery Cleanup Gate — 收尾前必走的 cleanup 协议（2026-05-28 新增）"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"28125980-7470-4902-bfc9-9d7ef89a8480","timestamp":"2026-08-25T10:21:10.064Z","tool_use_result":{"mode":"content","numFiles":0,"filenames":[],"content":"21:## 完整产品需求设计流程（⓪ Stage 0 + 8 步，Jira 关联型 mockup）— 2026-05-27 新增；2026-06-05 加 ⓪ Stage 0 上游 framing\n229:## UX 交付物形态 — WYSIWYG 完整界面流（非注释卡讲解）— 2026-06-09 新增\n261:## Convention Priority Hierarchy\n274:## M22 — User Design Intent Acknowledgment（前置 Gate）\n300:## M48 — Startup Rule-Coverage Self-Check（起手强制 Gate）— 2026-06-05 新增\n352:## M49 — Design Quality Contract Gate（设计质量合同，前置 + 回归）— 2026-06-11 新增\n505:## M50 — One-Page Design Kickoff Packet（起手总控包）— 2026-06-11 新增\n538:## M51 — Change Control + Regression Snapshot（变更控制 + 回归快照）— 2026-06-11 新增\n565:## Pre-Phase 0：Product Definition Gate\n788:## Stage 0.5 — Pre-Design Validation（discovery 完成后、Phase 0 前）\n869:## User Journey Map — <Feature Name>\n920:## Phase 0：Element-to-Source Mapping（前置硬规则）\n952:## Library-First + Evidence Discipline\n970:## M6 — Reusable Pattern Marking\n983:## M11 — Self-audit Discipline\n1009:## M14 — Reference Input Adaptation（复刻前问适配性）\n1077:## M15 — Source 未实证不得宣告\"不存在\"\n1103:## M16 — Deliverable Defaults Must Be Evaluated\n1142:## M21 — Existing Product Incremental Local Reuse\n1271:## M-PRD-EG — PRD \"e.g.\" 列表必须显式确认 in-scope\n1290:## M-CARDINALITY — 起手 5 个对象关系问题 self-check\n1317:## M-IA-FIRST — Multi-object feature 必先确认 IA（Information Architecture）再进 mockup\n1354:## M-LIFECYCLE-CRUD — first-class entity 必须显式回答 Create / Read / Update / Delete 4 件套\n1388:## Lazy Reference Loading\n1404:## Scope Handling — \"本期不动 X\" ≠ \"删 / 隐藏 X\"（2026-05-28 新增）\n1440:## Delivery Cleanup Gate — 收尾前必走的 cleanup 协议（2026-05-28 新增）","numLines":26,"totalLines":26}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"e3900be1-0bae-474c-9690-590b81013812","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":200,"estimated_tokens_delta":150,"uuid":"f36935d3-509c-46a8-93a2-f0e19e480c80","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":350,"estimated_tokens_delta":150,"uuid":"f755d4a7-d1fc-4912-95d0-1d89e13cdd48","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJKjaJVMVKMHpoimKV8","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAIS0QgKpgEIERgCKkCUCLq86XhlRQG33YiuDUPfShfOCIkeXOX9e1v1xS18WLmNmBSbgV/lnwUj8bA5uK8TC+eDFeOhHy5C/LAUKIzSMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAZ3ZtdQGsAECEgxNmJg0baiq2LJhli0aDIsaIauoDI2aunlqUiIw9F2kcwLzx81lFjTSGllaIDB1lN7Om5qUfTkHk8i/SV8dGcs3/hUM72Kgf70mB+U0KtcGFdYRiVyvJnLDd6upOJXsqAvpAqclyPfwKMRPV+fqzzPjwRFZBTeMyihgXlpVUhRwk32Xwz/X8c5grlGGYtsIoWfGXn8U2hEsugtdP6rRmTDqXlKlnD4FnAWw8pYvp+X2B1AC3sCRJVOyFqpzB8PzGLqPVqxGj71Oyd/6unFh9DsUWLy0p5o8Eqaunf0LAemzgfE3IzIDZ4K9jem3qim5+MSajuCbcjMrRGsKIJ7CWjT3mdROzc1nuiPtC0CHNKkHgoogbC9lbj8ObOWGFCYka9rKZA0KiPSvPzt1YAaeNCnChI/50Ev1s00L5VRsuICSTtsON30c+qugzu1eoU8gCz4HmKOjQiAWY1mf6iBMgWu3C//ZwCrZos7yYu8mK4r6vDibd2FgszztR5LcFmVbvMlvvyPJDH/UcqTVhIcJNmNqsgEO0pqOThBFyh4yYiZKo5qjrSBGQCbvno8Pt9I6QlIjqPXUVzL+6H8Vuaz0beF3qfLL455ooeCqrksV0uh+u4wZk4n2lf7S0JWum5CQKdmKBpezB7LHqhbzjsRkEY5y5yqkRZsKUGbPyvfWMTkBW5z38GoHsekJqSAPaqJ8GRSyBhMEkHmksc+FUitX/wdQgytit7FBGfO79Y/Of/87PA03NVXdEXIICx+L47TKEDLNpBdOrIrJvJJrkXeG/c25u14b1ZMfwzQpiyK7kjiQaceqOKebbm35InX6DVwh9Wf2Ne8C/nQJtBAb6fZWTG0JQx07YdbogxzYmmQAFDvju9lU3/enUAm6L7VKnE18qHcNRA0pZUhdSrVMjfqAAXaLsgexwBmpna8/P9yQBCs731+lVmKkl3Pn6JXqohBoRfHh7r+34EwSOhs4QEr6SC1bxTe2j3ejI7V6yt+tOM08Mzx0tWylwXciu+fiYRMgd6KabymnF47mU4ZgXl6pK5ZH1cp2VnCJT64G1F0VyihWK146pb1vQfFTkBsu0cJ5bDTi77jOkuyIEH8nt/+67/5GDZcIG/Og/vOx/6Yaj8pD5hAoDjbOiFDNzU9gEa3zHRCmDy9EJyQ7itcnW3Tkl42+vEXQgN0MFPfuKMYrtuZcRWyHSkBVnzcUW9/kTCBUND/7UKGRyzJ3JkUP79bsiPaMyG8urxfkGAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1451,"cache_read_input_tokens":243163,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1451},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"10d48f4e-dcaf-467c-8dd5-6ceb0bee37bc","timestamp":"2026-08-25T10:21:17.529Z","request_id":"req_011CePJKduVAUQAy5bi56Ksd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJKjaJVMVKMHpoimKV8","type":"message","role":"assistant","content":[{"type":"text","text":"起手还有两个强制 Gate 没吃（M48 起手规则覆盖自检 / M22 意图确认），加上「UX 交付物形态」——mockup 类交付物的形态就定在那一节。"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1451,"cache_read_input_tokens":243163,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1451},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"e4a0848a-97f7-4354-8163-c2a767055ee2","timestamp":"2026-08-25T10:21:19.015Z","request_id":"req_011CePJKduVAUQAy5bi56Ksd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJKjaJVMVKMHpoimKV8","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01Coc8BRCsQKAY82gBjvY9KD","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/design-process.md","offset":229,"limit":125},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1451,"cache_read_input_tokens":243163,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1451},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"a4530303-178d-4391-accd-17581a1f779b","timestamp":"2026-08-25T10:21:19.764Z","request_id":"req_011CePJKduVAUQAy5bi56Ksd"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01Coc8BRCsQKAY82gBjvY9KD","type":"tool_result","content":"229\t## UX 交付物形态 — WYSIWYG 完整界面流（非注释卡讲解）— 2026-06-09 新增\n230\t\n231\tUX 交付（上方 §完整流程 步 ③④ 的产出）的**形态**必须是**浮层叠在真实 App 页上的完整界面流（WYSIWYG，所见即所得）**——把每个交互状态 / 步骤画成完整的产品界面（真实页 + 真实库组件 + 浮层 / 弹窗叠在其上），让 dev / PM 一眼看到\"用户实际会看到的画面\"。**不是**用一排注释卡 / Build-Scope 卡去\"讲\"流程。\n232\t\n233\t这是 **UX 设计 vs PRD / 原型文字描述**的本质区别：PRD 用文字\"描述\"流程，UX mockup 用**界面本身**呈现流程。\n234\t\n235\t| 形态 | 角色 | 怎么用 |\n236\t|---|---|---|\n237\t| **完整界面流（WYSIWYG）** | UX 交付**主体** | 每个状态 / 步骤一屏完整界面；浮层（popover / modal / toast）叠在真实页上——叠法见 [`figma-technical-reference.md` Q17](./figma-technical-reference.md)（append 到竖向 auto-layout 页须设 `layoutPositioning='ABSOLUTE'`）|\n238\t| **注释卡 / 规则卡 / 对比卡（M23）** | 交付**补充** | 只补 rationale / data contract / 方案对比 / 验收——**注解界面，不替代界面** |\n239\t\n240\t### 反模式\n241\t\n242\t- ❌ 用 \"Build Scope / 流程说明\" 注释卡画廊去\"讲\"一个本该有完整界面的流程 → reader 看不到真实画面，等于退回 PRD 文字\n243\t- ❌ 把状态流程只用文字 bullet 列在一张卡里，不画对应的完整界面屏\n244\t\n245\t### 实证\n246\t\n247\t**2026-06-09 BM-1047 V3 split-wallet**：AI 先用 Build Scope 注释卡\"讲\"token 计费流程，用户纠\"这就是 UX 设计与 PRD / 原型的区别，所见即所得——直接用完整 UI 效果图画流程，不要用卡讲\"。推翻注释画廊，重建 **9 屏完整界面流**（顶栏 token 菜单 / Stripe / 成功 / 失败 / 席位 Owner-Finance / 席位 Standard / 低余额告警 / Home 席位制变体）+ 浮层叠真实 App 页 + 注释卡仅补 PRD / 对比。本节即此回流。\n248\t\n249\t### 规范单元 — 1 全景 + 弹窗卡（2026-06-15 精炼回流）\n250\t\n251\tWYSIWYG 流程的**最小规范单元** = **1 张全景（真实 App 页满屏）+ 该状态的弹窗/浮层卡叠在其上**（ABSOLUTE）。不是\"为每个浮层单独画一张脱离全景的卡\"，也不是\"一排注释卡讲流程\"。每个交互状态 = 1 全景 + 1 浮层；role×state 等矩阵差异用注释/对比卡（M23）补充，**不替代全景**。\n252\t\n253\t- **实证 2026-06-15 BM-1047 V3**：PM（Paul / Devansh, BM-1044）要求 token 余额从顶栏 chip 移入用户头像下拉。交付即「Standard Conversion 全景页 + user-icon dropdown 浮层叠其上」一屏到位，dev / PM 一眼看到真实画面；下拉的 role×state 矩阵（admin / premium / standard × healthy / low / negative / paused / no-tokens）由 Devansh spec 卡补充。\n254\t\n255\t### Mirror\n256\t\n257\t主要针对 **Path A（Figma mockup）**；Path B 代码生成天然 WYSIWYG（跑起来即真界面），无需此提醒。\n258\t\n259\t---\n260\t\n261\t## Convention Priority Hierarchy\n262\t\n263\t| 级别 | 来源 | 何时引用 |\n264\t|---|---|---|\n265\t| **P0 最高** | TVU 项目级硬规则（[`AGENTS.md`](../../AGENTS.md) 硬规则 #1-#N）| 任意 TVU 相关任务 |\n266\t| **P1** | TVU consumption conventions（本文件 + path-specific conventions）| 消费 TVU 库时 |\n267\t| **P2** | `role-ux` skill UX guidance | Pre-Phase 0 / UX 判断 |\n268\t| **P3 兜底** | 通用 UX heuristics（Nielsen / WCAG / 平台惯例）| TVU 未覆盖的判断 |\n269\t\n270\t高优先级胜出。TVU 未规定 → P3 兜底，**不停下追问**。\n271\t\n272\t---\n273\t\n274\t## M22 — User Design Intent Acknowledgment（前置 Gate）\n275\t\n276\t任何 deliverable 生成前，先检测用户 brief 是否含 design direction 类语句。\n277\t\n278\t**触发信号词**：`feel like` / `should feel` / `design proposal` / `direction` / `tone` / \"感觉像\" / \"整体方向\" / \"调性\" / \"business health\" / \"commercial feel\"\n279\t\n280\t**不触发**：纯 element 清单（\"加 button\" / \"table 加一列\"）。\n281\t\n282\t### 必做（任何 Phase 0 mapping 前）\n283\t\n284\t1. AI 复述 user 的 design ask 为 bullet list（原话直引 + 一句话解读）\n285\t2. 每条 ask 映射到具体 deliverable decision（color / structure / element 取舍 / information hierarchy）\n286\t3. 按 ask 数量分支：\n287\t - **小 ask（< 3 条）**：合并进 Phase 0 mapping，作为上方 \"Design intent acknowledgment\" 段一起对账\n288\t - **大 ask（≥ 3 条 或 跨全局调性）**：独立 gate — 复述发给 user 确认后才进 Phase 0\n289\t\n290\t### Why\n291\t\n292\tUser design ask 是 deliverable 视觉合同的最高优先级输入。跳过 = 把\"用户想要什么\"降级成\"AI 觉得用户想要什么\"。\n293\t\n294\t### 优先级关系\n295\t\n296\t**M22 > M21 > M14**：user 显式 design ask override sibling 视觉合同（M21）；override 参考输入（M14）。\n297\t\n298\t---\n299\t\n300\t## M48 — Startup Rule-Coverage Self-Check（起手强制 Gate）— 2026-06-05 新增\n301\t\n302\t任何 mockup / 设计任务起手（**Phase 0 element-mapping 之前**），AI **必须先产出一份「本任务命中的 locked spec + active M-rule 清单」并逐条标注覆盖计划**，作为可 audit 的 deliverable——**不允许凭\"我知道规则\"的印象直接开建**。\n303\t\n304\t### 必做（产出格式，mandatory）\n305\t\n306\t| 来源 | 命中项（逐条列） | 本任务怎么遵守（一句话落地） |\n307\t|---|---|---|\n308\t| **handoff / PRD locked spec** | 如「余额=大数字+tokens 小灰」/「expanded state scrolls, height≤775」/「state-label = `frame.y−h−50`」 | … |\n309\t| **active M-rule（按场景触发）** | 编号 + 名（M1 / M23.x / M-COLOR / M-INTEGRITY §I1.1 / M32 / M46 / M47 …） | … |\n310\t| **state-completeness（首类实体全态，2026-06-15 升起手）** | 每个 first-class entity 列出本任务须覆盖的状态：CRUD / 选择(单·多) / 动作前·中·后 / 后置修改 / edge·错误（含空 / 负 / 暂停 / 无权等）——枚举清单见本文件 §State-Completeness Enumeration | … |\n311\t\n312\t- **locked spec 来源** = handoff / PRD 卡 / 用户当前明确约束。\n313\t- **state-completeness 来源** = 本文件 §State-Completeness Enumeration（2026-06-15 起前移：原仅 F2-late + 体验地图必做前置，现同时作为 M48 起手清单一行——起手即枚举全态，避免建到 F2-late 才发现漏态返工；本轮 BM-1047 Devansh dropdown 即 role×state 矩阵，起手枚举可一次盘清 13 态）。\n314\t- **M-rule 来源** = [`mockup-conventions.md` §AI 读取指引 Quick Reference](./mockup-conventions.md) 按\"触发条件\"逐行勾选命中项（不是凭记忆）。\n315\t- 主建过程中每完成一个 frame / 区块，对照清单打勾；**交付前清单必须全绿**（未覆盖项必写 rationale）。\n316\t- **PRD 业务约束 parity（2026-06-17 新增）**：起手清单须把 PRD 的**业务约束**——**权限 / 角色矩阵**、tier 规则、可见性规则等——当 locked spec **逐条列**，并在建对应 UI（按钮可见性 / 入口归属）前对照。不止 state-completeness。**实证 BM-1047**：按单句指令建下拉按钮、没回查 PRD 权限矩阵 → Premium User（Member）误给 Manage Subscriptions、admin 混\"买+分配\"，整套按钮权限重构。\n317\t- **机械命中项必附 gate 输出（keystone，2026-06-17 新增）**：清单里**机械可判**的命中项（M32 库归属 / M-COLOR / M52 binding / M32.2 三件套 ①② 等）的\"打勾\"**必须附对应机检 gate 的 pass/fail**，不允许凭印象自填 `✅`——同 [design-walkthrough §0 机械维度证据化](../../skills/design-walkthrough/SKILL.md)。起手\"勾了\"≠ 已做，自我声明式 checklist 的失效根因正在此。\n318\t- **委派边界规则传递（delegation-boundary rule handoff，2026-07-09 新增）**：当把 Figma 写作 / mockup 生成**委派给 subagent** 执行时，M48 self-check 命中的每条 M-rule / locked spec **必须逐条写进 subagent 的执行 spec**（具体到「套用 M23.14 A-逐行：<要求>」这种可执行指令），并显式声明 **[M23.16](./mockup-conventions.md) 规则优先于范本**——禁止只给「复刻范本 / 参照 sibling」这类模糊指令让 subagent 自行 imitation。**实证 2026-07-09 V4-2333**：主线 M48 已列 M23.14 双语行距，但委派写 PRD 时只说「复刻范本」、没把 M23.14 具体要求带过去 → subagent 照范本印象做成被禁的「EN 整组 + ZH 整组」，用户走查抓出。根因 = 自检识别了规则、委派边界把它漏掉（「读了不执行」的委派变体）。\n319\t\n320\t### Why（根因 — 两次实证）\n321\t\n322\t违例的绝大多数**不是规则缺失，而是规则 / locked spec 已存在但起手没主动调用**。加再多细则都堵不住\"凭印象开建\"——唯一能堵的是把\"核对已有规则\"从隐性变成**起手强制产出物**：AI 不写清单就完不成起手，核对被外化为可 audit / 可拦截的 trace（同 [M35](./mockup-conventions.md#m35--affordance-category-search-discipline思考产物外化为强制-trace) 把思考外化为 trace 的机制）。\n323\t\n324\t- **2026-06-01 BM-1047**：design-process 完整 8 步只命中 3/8，M45 / M23.8 / M23 / M23.6 / audit 全靠用户走查补。\n325\t- **2026-06-05 BM-1047 Stage 4–6**：locked spec「expanded scrolls / 余额 tokens 弱化 / 50px state-label gap」+ M23 §条件标签 z-order + figma-use resize-重置-sizing 等 **~6 处已有明文规则没遵守**，9 轮用户走查兜底。两次同一复发模式 → 抽象为本 Gate。\n326\t- **2026-06-08 V4-2285/2286 Embedded Audio Routing**：catalog 早写明「647 icons，直接用，不要 Unicode glyph 替代」+ M32 §icons 已覆盖，仍手搓 `→ Transmitter` 箭头 / `✕` 删除 / `+ Add routing`（AFTER 屏 + 状态帧 S0–S5 共 7×→ / 11×✕ / 7×+Add），用户**第三次**纠正\"图标不能手搓\"后批量换真组件。典型「规则已存在、起手没把 glyph 扫描列进 self-check」→ 故本 Gate 新增上方「Glyph 自查」必扫项。\n327\t\n328\t### Acceptance\n329\t\n330\t- [ ] 起手 deliverable 含 rule-coverage 清单（locked spec 行 + M-rule 行），非空\n331\t- [ ] 交付前清单逐条标\"已覆盖\"（未覆盖项写 rationale）\n332\t- [ ] handoff 记录该清单（供下次 review 反查）\n333\t- [ ] **自建件三件套（含自建产品 UI 件时必勾）**：每个自建卡 / 浮层 / 面板列明 ① 真组件（M1 / M32）② 绑 Color Variable（M-COLOR §C1）③ 复用页面 / PRD / sibling 现成措辞，三腿落地——详见 [`mockup-conventions.md` M32.2](./mockup-conventions.md)；治\"自建时跳过设计系统起手检查\"元根因 <!-- rule-inventory-ok: 三腿各引一条规则做交叉引用，不是复述 mockup-conventions 的规则清单；删掉会丢掉「哪一腿对应哪条规则」这个信息 -->\n334\t- [ ] **Glyph 自查（必扫项）**：交付前在**产品区**扫 Unicode 装饰字符（`→ ← ↑ ↓ ✕ × ＋ + ✓ ✔ ⚠ ▾ ▸ ●` 等），命中即 **M32 §icons 违例**——产品 UI 的图标必为库组件实例（catalog 647 icons），禁手搓 glyph。脚本式扫法：`section.findAll(n=>n.type==='TEXT')` + glyph 正则，按 parent name 区分产品区 vs 注释区（**帧外注释/PRD/journey 卡内的描述性字符不算**）。\n335\t- [ ] **字体自查（必扫项，与 Glyph 自查对称）**：交付前在**注释区**（UX 交付卡 / PRD / journey / state-note / spec / changelog 等帧外说明）扫所有 TEXT 的 `fontName.family`，∉ {`Roboto`(EN), `Noto Sans SC`(ZH)} 即 **M23 §字体规范 / M47 违例**——Figma `createText()` 默认 `Inter`，\"不主动设\" = 自动错（同 Glyph 是\"Figma 默认值陷阱\"）。**产品 mockup 本体文案豁免**（按库 instance / file-level baseline，见 [`mockup-conventions.md` §342 C4](./mockup-conventions.md)）。脚本式扫法同 Glyph，但产品区/注释区判定**方向相反**：**Glyph 罚产品区、Font 罚注释区**。<!-- rule-inventory-ok: M23/M47/C4 是本条判据各自的出处引用，不是 mockup-conventions 的清单镜像 -->\n336\t- [ ] **机械 gate（必跑）**：上述 Glyph + 字体两类不再只靠人肉扫——已落为 [`scripts/audit-mockup-typography-icon.mjs`](../../scripts/audit-mockup-typography-icon.mjs)，接进 `pnpm audit:consumer-mockup`（与 M-COLOR / M-INTEGRITY 三件套并列），pre-handoff `exit 1` 拦截。半角 `+` / `x` / `×` 因高误报不机械扫，仍靠人肉 Glyph 自查兜底（脚本 footer 已 log，no silent cap）。**综合 pre-handoff 单闸**：`pnpm audit:mockup-conformance --file <fileKey>`（[`audit-mockup-conformance.mjs`](../../scripts/audit-mockup-conformance.mjs)）**单进程**跑全部 mockup 规则，聚合一个 pass/fail；场景 2 增量加 `--non-blocking`（M21 优先 local 视觉合同，不全量误报 legacy）。⛔ **条数与清单不写在这里** —— 跑 `pnpm audit:mockup-conformance --list-rules`（引擎现算）。本行此前写死「全 5 个」，而活源当时早已是 9 条、2026-08-24 合并后是 10 条 —— 那正是「文档里的清单会 stale」的实例。\n337\t- [ ] **委派 spec 完整性（委派 subagent 写 Figma 时必勾）**：self-check 命中的 M-rule + locked spec 已**逐条写进委派 spec**（非「复刻范本 / 参照 sibling」模糊委派），并声明规则优先于范本（M23.16）\n338\t\n339\t### 反例（命中即起手不合格，重做）\n340\t\n341\t| ❌ | 后果 |\n342\t|---|---|\n343\t| \"规则我都知道，直接开画\" | 凭印象漏调用 → 主建后大批走查违例（本 Gate 即此回流） |\n344\t| 清单只列 M-rule 不列 locked spec | handoff/PRD 的数值型规范（字号/高度/滚动/留白）最易被跳过 |\n345\t| 清单产出了但交付前不回头打勾 | 建的过程偏离清单无人察觉 |\n346\t| 产品区图标敲 Unicode glyph（`→`/`✕`/`+`）当图标用 | M32 §icons 违例；2026-06-08 V4-2285/2286 路由列手搓 →/✕/+，用户三次纠正后批量换真组件（见上方 Glyph 自查必扫项） |\n347\t| load / 起手后先探查、看结构（`get_metadata` / `use_figma` 勘察），把\"读真源 + M48\"挪到探查之后 | 探查 = 动手；跳 Step 2 → 下游 M-rule jump（如 M23.14 双语行距）全部失效；2026-07-06 V4-2335 照抄 pre-规则 PRD 范本 `8805:2` 致字号/opacity/行距范式全错 + 建错文件。修法：起手第一动作 = TodoWrite 物化起手协议，探查排在读真源起手段 + 本清单之后 |\n348\t| 委派 subagent 写作时只给「复刻范本 / 参照 sibling」，没把 self-check 命中的 M-rule 逐条带进 spec | subagent 照范本印象走、绕过规则；2026-07-09 V4-2333 PRD 双语 A-逐行 被做成禁用的 EN/ZH 分组，用户走查兜底 |\n349\t\n350\t---\n351\t\n352\t## M49 — Design Quality Contract Gate（设计质量合同，前置 + 回归）— 2026-06-11 新增\n353\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"236f1c30-f78f-4dd2-b2ee-acecfddf22b2","timestamp":"2026-08-25T10:21:19.771Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/design-process.md","content":"## UX 交付物形态 — WYSIWYG 完整界面流（非注释卡讲解）— 2026-06-09 新增\n\nUX 交付（上方 §完整流程 步 ③④ 的产出）的**形态**必须是**浮层叠在真实 App 页上的完整界面流（WYSIWYG，所见即所得）**——把每个交互状态 / 步骤画成完整的产品界面（真实页 + 真实库组件 + 浮层 / 弹窗叠在其上），让 dev / PM 一眼看到\"用户实际会看到的画面\"。**不是**用一排注释卡 / Build-Scope 卡去\"讲\"流程。\n\n这是 **UX 设计 vs PRD / 原型文字描述**的本质区别：PRD 用文字\"描述\"流程，UX mockup 用**界面本身**呈现流程。\n\n| 形态 | 角色 | 怎么用 |\n|---|---|---|\n| **完整界面流（WYSIWYG）** | UX 交付**主体** | 每个状态 / 步骤一屏完整界面；浮层（popover / modal / toast）叠在真实页上——叠法见 [`figma-technical-reference.md` Q17](./figma-technical-reference.md)（append 到竖向 auto-layout 页须设 `layoutPositioning='ABSOLUTE'`）|\n| **注释卡 / 规则卡 / 对比卡（M23）** | 交付**补充** | 只补 rationale / data contract / 方案对比 / 验收——**注解界面，不替代界面** |\n\n### 反模式\n\n- ❌ 用 \"Build Scope / 流程说明\" 注释卡画廊去\"讲\"一个本该有完整界面的流程 → reader 看不到真实画面，等于退回 PRD 文字\n- ❌ 把状态流程只用文字 bullet 列在一张卡里，不画对应的完整界面屏\n\n### 实证\n\n**2026-06-09 BM-1047 V3 split-wallet**：AI 先用 Build Scope 注释卡\"讲\"token 计费流程，用户纠\"这就是 UX 设计与 PRD / 原型的区别，所见即所得——直接用完整 UI 效果图画流程，不要用卡讲\"。推翻注释画廊，重建 **9 屏完整界面流**（顶栏 token 菜单 / Stripe / 成功 / 失败 / 席位 Owner-Finance / 席位 Standard / 低余额告警 / Home 席位制变体）+ 浮层叠真实 App 页 + 注释卡仅补 PRD / 对比。本节即此回流。\n\n### 规范单元 — 1 全景 + 弹窗卡（2026-06-15 精炼回流）\n\nWYSIWYG 流程的**最小规范单元** = **1 张全景（真实 App 页满屏）+ 该状态的弹窗/浮层卡叠在其上**（ABSOLUTE）。不是\"为每个浮层单独画一张脱离全景的卡\"，也不是\"一排注释卡讲流程\"。每个交互状态 = 1 全景 + 1 浮层；role×state 等矩阵差异用注释/对比卡（M23）补充，**不替代全景**。\n\n- **实证 2026-06-15 BM-1047 V3**：PM（Paul / Devansh, BM-1044）要求 token 余额从顶栏 chip 移入用户头像下拉。交付即「Standard Conversion 全景页 + user-icon dropdown 浮层叠其上」一屏到位，dev / PM 一眼看到真实画面；下拉的 role×state 矩阵（admin / premium / standard × healthy / low / negative / paused / no-tokens）由 Devansh spec 卡补充。\n\n### Mirror\n\n主要针对 **Path A（Figma mockup）**；Path B 代码生成天然 WYSIWYG（跑起来即真界面），无需此提醒。\n\n---\n\n## Convention Priority Hierarchy\n\n| 级别 | 来源 | 何时引用 |\n|---|---|---|\n| **P0 最高** | TVU 项目级硬规则（[`AGENTS.md`](../../AGENTS.md) 硬规则 #1-#N）| 任意 TVU 相关任务 |\n| **P1** | TVU consumption conventions（本文件 + path-specific conventions）| 消费 TVU 库时 |\n| **P2** | `role-ux` skill UX guidance | Pre-Phase 0 / UX 判断 |\n| **P3 兜底** | 通用 UX heuristics（Nielsen / WCAG / 平台惯例）| TVU 未覆盖的判断 |\n\n高优先级胜出。TVU 未规定 → P3 兜底，**不停下追问**。\n\n---\n\n## M22 — User Design Intent Acknowledgment（前置 Gate）\n\n任何 deliverable 生成前，先检测用户 brief 是否含 design direction 类语句。\n\n**触发信号词**：`feel like` / `should feel` / `design proposal` / `direction` / `tone` / \"感觉像\" / \"整体方向\" / \"调性\" / \"business health\" / \"commercial feel\"\n\n**不触发**：纯 element 清单（\"加 button\" / \"table 加一列\"）。\n\n### 必做（任何 Phase 0 mapping 前）\n\n1. AI 复述 user 的 design ask 为 bullet list（原话直引 + 一句话解读）\n2. 每条 ask 映射到具体 deliverable decision（color / structure / element 取舍 / information hierarchy）\n3. 按 ask 数量分支：\n - **小 ask（< 3 条）**：合并进 Phase 0 mapping，作为上方 \"Design intent acknowledgment\" 段一起对账\n - **大 ask（≥ 3 条 或 跨全局调性）**：独立 gate — 复述发给 user 确认后才进 Phase 0\n\n### Why\n\nUser design ask 是 deliverable 视觉合同的最高优先级输入。跳过 = 把\"用户想要什么\"降级成\"AI 觉得用户想要什么\"。\n\n### 优先级关系\n\n**M22 > M21 > M14**：user 显式 design ask override sibling 视觉合同（M21）；override 参考输入（M14）。\n\n---\n\n## M48 — Startup Rule-Coverage Self-Check（起手强制 Gate）— 2026-06-05 新增\n\n任何 mockup / 设计任务起手（**Phase 0 element-mapping 之前**），AI **必须先产出一份「本任务命中的 locked spec + active M-rule 清单」并逐条标注覆盖计划**，作为可 audit 的 deliverable——**不允许凭\"我知道规则\"的印象直接开建**。\n\n### 必做（产出格式，mandatory）\n\n| 来源 | 命中项（逐条列） | 本任务怎么遵守（一句话落地） |\n|---|---|---|\n| **handoff / PRD locked spec** | 如「余额=大数字+tokens 小灰」/「expanded state scrolls, height≤775」/「state-label = `frame.y−h−50`」 | … |\n| **active M-rule（按场景触发）** | 编号 + 名（M1 / M23.x / M-COLOR / M-INTEGRITY §I1.1 / M32 / M46 / M47 …） | … |\n| **state-completeness（首类实体全态，2026-06-15 升起手）** | 每个 first-class entity 列出本任务须覆盖的状态：CRUD / 选择(单·多) / 动作前·中·后 / 后置修改 / edge·错误（含空 / 负 / 暂停 / 无权等）——枚举清单见本文件 §State-Completeness Enumeration | … |\n\n- **locked spec 来源** = handoff / PRD 卡 / 用户当前明确约束。\n- **state-completeness 来源** = 本文件 §State-Completeness Enumeration（2026-06-15 起前移：原仅 F2-late + 体验地图必做前置，现同时作为 M48 起手清单一行——起手即枚举全态，避免建到 F2-late 才发现漏态返工；本轮 BM-1047 Devansh dropdown 即 role×state 矩阵，起手枚举可一次盘清 13 态）。\n- **M-rule 来源** = [`mockup-conventions.md` §AI 读取指引 Quick Reference](./mockup-conventions.md) 按\"触发条件\"逐行勾选命中项（不是凭记忆）。\n- 主建过程中每完成一个 frame / 区块，对照清单打勾；**交付前清单必须全绿**（未覆盖项必写 rationale）。\n- **PRD 业务约束 parity（2026-06-17 新增）**：起手清单须把 PRD 的**业务约束**——**权限 / 角色矩阵**、tier 规则、可见性规则等——当 locked spec **逐条列**，并在建对应 UI（按钮可见性 / 入口归属）前对照。不止 state-completeness。**实证 BM-1047**：按单句指令建下拉按钮、没回查 PRD 权限矩阵 → Premium User（Member）误给 Manage Subscriptions、admin 混\"买+分配\"，整套按钮权限重构。\n- **机械命中项必附 gate 输出（keystone，2026-06-17 新增）**：清单里**机械可判**的命中项（M32 库归属 / M-COLOR / M52 binding / M32.2 三件套 ①② 等）的\"打勾\"**必须附对应机检 gate 的 pass/fail**，不允许凭印象自填 `✅`——同 [design-walkthrough §0 机械维度证据化](../../skills/design-walkthrough/SKILL.md)。起手\"勾了\"≠ 已做，自我声明式 checklist 的失效根因正在此。\n- **委派边界规则传递（delegation-boundary rule handoff，2026-07-09 新增）**：当把 Figma 写作 / mockup 生成**委派给 subagent** 执行时，M48 self-check 命中的每条 M-rule / locked spec **必须逐条写进 subagent 的执行 spec**（具体到「套用 M23.14 A-逐行：<要求>」这种可执行指令），并显式声明 **[M23.16](./mockup-conventions.md) 规则优先于范本**——禁止只给「复刻范本 / 参照 sibling」这类模糊指令让 subagent 自行 imitation。**实证 2026-07-09 V4-2333**：主线 M48 已列 M23.14 双语行距，但委派写 PRD 时只说「复刻范本」、没把 M23.14 具体要求带过去 → subagent 照范本印象做成被禁的「EN 整组 + ZH 整组」，用户走查抓出。根因 = 自检识别了规则、委派边界把它漏掉（「读了不执行」的委派变体）。\n\n### Why（根因 — 两次实证）\n\n违例的绝大多数**不是规则缺失，而是规则 / locked spec 已存在但起手没主动调用**。加再多细则都堵不住\"凭印象开建\"——唯一能堵的是把\"核对已有规则\"从隐性变成**起手强制产出物**：AI 不写清单就完不成起手，核对被外化为可 audit / 可拦截的 trace（同 [M35](./mockup-conventions.md#m35--affordance-category-search-discipline思考产物外化为强制-trace) 把思考外化为 trace 的机制）。\n\n- **2026-06-01 BM-1047**：design-process 完整 8 步只命中 3/8，M45 / M23.8 / M23 / M23.6 / audit 全靠用户走查补。\n- **2026-06-05 BM-1047 Stage 4–6**：locked spec「expanded scrolls / 余额 tokens 弱化 / 50px state-label gap」+ M23 §条件标签 z-order + figma-use resize-重置-sizing 等 **~6 处已有明文规则没遵守**，9 轮用户走查兜底。两次同一复发模式 → 抽象为本 Gate。\n- **2026-06-08 V4-2285/2286 Embedded Audio Routing**：catalog 早写明「647 icons，直接用，不要 Unicode glyph 替代」+ M32 §icons 已覆盖，仍手搓 `→ Transmitter` 箭头 / `✕` 删除 / `+ Add routing`（AFTER 屏 + 状态帧 S0–S5 共 7×→ / 11×✕ / 7×+Add），用户**第三次**纠正\"图标不能手搓\"后批量换真组件。典型「规则已存在、起手没把 glyph 扫描列进 self-check」→ 故本 Gate 新增上方「Glyph 自查」必扫项。\n\n### Acceptance\n\n- [ ] 起手 deliverable 含 rule-coverage 清单（locked spec 行 + M-rule 行），非空\n- [ ] 交付前清单逐条标\"已覆盖\"（未覆盖项写 rationale）\n- [ ] handoff 记录该清单（供下次 review 反查）\n- [ ] **自建件三件套（含自建产品 UI 件时必勾）**：每个自建卡 / 浮层 / 面板列明 ① 真组件（M1 / M32）② 绑 Color Variable（M-COLOR §C1）③ 复用页面 / PRD / sibling 现成措辞，三腿落地——详见 [`mockup-conventions.md` M32.2](./mockup-conventions.md)；治\"自建时跳过设计系统起手检查\"元根因 <!-- rule-inventory-ok: 三腿各引一条规则做交叉引用，不是复述 mockup-conventions 的规则清单；删掉会丢掉「哪一腿对应哪条规则」这个信息 -->\n- [ ] **Glyph 自查（必扫项）**：交付前在**产品区**扫 Unicode 装饰字符（`→ ← ↑ ↓ ✕ × ＋ + ✓ ✔ ⚠ ▾ ▸ ●` 等），命中即 **M32 §icons 违例**——产品 UI 的图标必为库组件实例（catalog 647 icons），禁手搓 glyph。脚本式扫法：`section.findAll(n=>n.type==='TEXT')` + glyph 正则，按 parent name 区分产品区 vs 注释区（**帧外注释/PRD/journey 卡内的描述性字符不算**）。\n- [ ] **字体自查（必扫项，与 Glyph 自查对称）**：交付前在**注释区**（UX 交付卡 / PRD / journey / state-note / spec / changelog 等帧外说明）扫所有 TEXT 的 `fontName.family`，∉ {`Roboto`(EN), `Noto Sans SC`(ZH)} 即 **M23 §字体规范 / M47 违例**——Figma `createText()` 默认 `Inter`，\"不主动设\" = 自动错（同 Glyph 是\"Figma 默认值陷阱\"）。**产品 mockup 本体文案豁免**（按库 instance / file-level baseline，见 [`mockup-conventions.md` §342 C4](./mockup-conventions.md)）。脚本式扫法同 Glyph，但产品区/注释区判定**方向相反**：**Glyph 罚产品区、Font 罚注释区**。<!-- rule-inventory-ok: M23/M47/C4 是本条判据各自的出处引用，不是 mockup-conventions 的清单镜像 -->\n- [ ] **机械 gate（必跑）**：上述 Glyph + 字体两类不再只靠人肉扫——已落为 [`scripts/audit-mockup-typography-icon.mjs`](../../scripts/audit-mockup-typography-icon.mjs)，接进 `pnpm audit:consumer-mockup`（与 M-COLOR / M-INTEGRITY 三件套并列），pre-handoff `exit 1` 拦截。半角 `+` / `x` / `×` 因高误报不机械扫，仍靠人肉 Glyph 自查兜底（脚本 footer 已 log，no silent cap）。**综合 pre-handoff 单闸**：`pnpm audit:mockup-conformance --file <fileKey>`（[`audit-mockup-conformance.mjs`](../../scripts/audit-mockup-conformance.mjs)）**单进程**跑全部 mockup 规则，聚合一个 pass/fail；场景 2 增量加 `--non-blocking`（M21 优先 local 视觉合同，不全量误报 legacy）。⛔ **条数与清单不写在这里** —— 跑 `pnpm audit:mockup-conformance --list-rules`（引擎现算）。本行此前写死「全 5 个」，而活源当时早已是 9 条、2026-08-24 合并后是 10 条 —— 那正是「文档里的清单会 stale」的实例。\n- [ ] **委派 spec 完整性（委派 subagent 写 Figma 时必勾）**：self-check 命中的 M-rule + locked spec 已**逐条写进委派 spec**（非「复刻范本 / 参照 sibling」模糊委派），并声明规则优先于范本（M23.16）\n\n### 反例（命中即起手不合格，重做）\n\n| ❌ | 后果 |\n|---|---|\n| \"规则我都知道，直接开画\" | 凭印象漏调用 → 主建后大批走查违例（本 Gate 即此回流） |\n| 清单只列 M-rule 不列 locked spec | handoff/PRD 的数值型规范（字号/高度/滚动/留白）最易被跳过 |\n| 清单产出了但交付前不回头打勾 | 建的过程偏离清单无人察觉 |\n| 产品区图标敲 Unicode glyph（`→`/`✕`/`+`）当图标用 | M32 §icons 违例；2026-06-08 V4-2285/2286 路由列手搓 →/✕/+，用户三次纠正后批量换真组件（见上方 Glyph 自查必扫项） |\n| load / 起手后先探查、看结构（`get_metadata` / `use_figma` 勘察），把\"读真源 + M48\"挪到探查之后 | 探查 = 动手；跳 Step 2 → 下游 M-rule jump（如 M23.14 双语行距）全部失效；2026-07-06 V4-2335 照抄 pre-规则 PRD 范本 `8805:2` 致字号/opacity/行距范式全错 + 建错文件。修法：起手第一动作 = TodoWrite 物化起手协议，探查排在读真源起手段 + 本清单之后 |\n| 委派 subagent 写作时只给「复刻范本 / 参照 sibling」，没把 self-check 命中的 M-rule 逐条带进 spec | subagent 照范本印象走、绕过规则；2026-07-09 V4-2333 PRD 双语 A-逐行 被做成禁用的 EN/ZH 分组，用户走查兜底 |\n\n---\n\n## M49 — Design Quality Contract Gate（设计质量合同，前置 + 回归）— 2026-06-11 新增\n","numLines":125,"startLine":229,"totalLines":1489}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"f87e4942-834f-40f9-82ea-181ab653061c","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":100,"estimated_tokens_delta":50,"uuid":"dcce1b3a-dc27-4921-8617-ab0c7b9fca7a","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":200,"estimated_tokens_delta":100,"uuid":"4cfc0a3e-8fae-4dd0-9c01-cdd736ce6f10","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":250,"estimated_tokens_delta":50,"uuid":"dddd02fa-7ebd-45b0-b93e-bae3bb467f64","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":350,"estimated_tokens_delta":100,"uuid":"9d84598c-71d8-4ced-8dd7-43b42bbf1244","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":450,"estimated_tokens_delta":100,"uuid":"475f1a62-df46-454c-8bd1-e30094053155","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJLTd8d2hzX36ZL7h2D","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"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"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":7498,"cache_read_input_tokens":244614,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":7498},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"2eeba214-22c2-4997-89e4-772609a031de","timestamp":"2026-08-25T10:21:31.132Z","request_id":"req_011CePJLMdDvD3gV4yKwpqDo"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJLTd8d2hzX36ZL7h2D","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_019vHKyo2eZWhatBQbsxnMwf","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","offset":741,"limit":80},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":7498,"cache_read_input_tokens":244614,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":7498},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"5f9b4d1e-b09f-4b91-9bc7-30d17f472d0f","timestamp":"2026-08-25T10:21:33.169Z","request_id":"req_011CePJLMdDvD3gV4yKwpqDo"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_019vHKyo2eZWhatBQbsxnMwf","type":"tool_result","content":"741\t## R9 — Static-to-Interactive Augmentation Protocol（场景 1 / 3 强制；enforcement L1，v2 待升 L3）\n742\t\n743\t### 触发场景\n744\t\n745\tR7 场景 1（visual-fidelity）/ 场景 3（greenfield TVU 构建）的 code implementation。\n746\t\n747\t- 场景 2（已有产品增量）按已有产品交互惯例\n748\t- 场景 4（compliance refactor）保持原代码状态不主动补新交互\n749\t\n750\t### 强制补的交互态（设计图没画也要补）\n751\t\n752\t| 交互态 | 推断规则 |\n753\t|---|---|\n754\t| **hover** | 从 active state 反推 — \"active 的弱版本\"（bg 略浅 / 加 subtle bg / weight 不 bold） |\n755\t| **focus** | active-like bg + outline ring（键盘 a11y） |\n756\t| **disabled** | **有 Figma 变体 → 照它的真值写**（owner 2026-08-13 裁定，见下方注）：Figma 用 token desaturation → 绑 `--control-disabled-{bg,border,text,selected-bg}` / `--text-disabled` / `--icon-disabled`；**Figma 变体自己画了容器 `opacity` → 就写那个 opacity**（那是**遵守 Figma**，不是偷懒，也不是豁免）。<br>**⭐ Figma 根本没有 disabled 变体 → 绑上面那组语义 disabled token，就地实现、⛔ 不等 designer**（owner 2026-08-14 裁定，见下方第二条注）。<br>两种都要 `cursor: not-allowed` + 去交互态。⛔ **禁止的是「Figma 明明绑了 token，code 却拿 `opacity` 一淡了之」** —— 那才是 `FIGMA_AS_SOURCE_OF_TRUTH.md:71` 说的「实现策略差 = code 偷懒」 |\n757\t| **active/pressed** | 比 hover 更深的 bg（仅交互瞬间） |\n758\t\n759\t> 🔑 **disabled 行的裁定留痕（owner 2026-08-13，[[INFRA-F120]]）** —— 本行原写 `opacity ≈0.5`，\n760\t> 与两处硬约束互斥：`docs/FIGMA_AS_SOURCE_OF_TRUTH.md:71`（**L-core #0，优先级高于本文件**）逐字把\n761\t> 「CSS opacity vs token desaturation」列为**禁止**登记 divergence 的项、理由「实现策略差 = code 偷懒」；\n762\t> `mockup-conventions.md` M32.4 逐字「不要照搬降透明度」。\n763\t>\n764\t> **裁定 = token desaturation 路线，且不再需要任何 opacity 数值** —— 此前的「四分叉」\n765\t> （code 0.4 · `Form.vue` 0.6 · mockup 侧 0.45 · 本行 ≈0.5）**整体作废**，因为\n766\t> `--control-disabled-*` / `--text-disabled` / `--icon-disabled` 是 **per-theme 的具体色值不是透明度**\n767\t> （实测 `src/tokens/variables.css`：dark `#595959` / light `#cccccc`，容器色 dark `var(--line-deep)` /\n768\t> light `#dbdbdb`）。⇒ 选路线即消解数值之争，`design-review-queue.md` #3 里那个「0.4 或 0.45」\n769\t> 的二选一框架一并作废。\n770\t>\n771\t> **裁定依据（实测，非推断）**：token 路线是仓库**多数派** —— **12 : 8**\n772\t> （⚠️ **2026-08-13 晚回读活源订正**：原写「12 : 6」并列了两份名单，那是**一个误计 + 一个漏计**恰好凑出 12 的\n773\t> —— `UserMenu` **不是** token 消费方（`:397` 是注释、`:401`/`:404` 是 `:not(.is-disabled)` **排除选择器**，\n774\t> 真绑定在 `MenuList:214` 已单独计），而 `Button` **在两边都被漏掉**；`Switch` 是**两处** opacity 不是一处。\n775\t> 同时出现在两边的是 **3 个：Switch / InputNumber / Button**）。\n776\t>\n777\t> 🔑 **owner 二次裁定（2026-08-13 晚，本行是它的落点）—— 「Figma 画的 opacity」不是豁免，是遵守**：\n778\t> 上面那条 ⛔ 一度被写成**无条件禁 opacity**，而实测 **`Button` 与 `Switch` 的 `opacity: 0.4` 恰恰是 Figma 真值**\n779\t> （`figma-data/normalized/components-tokenized/button_light_s__1545_51851.json` 里 `\"opacity\": 0.4` 命中 **80 处**，\n780\t> 全部 `status=disable`/`loading` × red|orange；`switch__348_3483.json` **4 处**，全部 `status=live, enable=no`；\n781\t> 且 `tests/Button.test.ts:247` 的测试名逐字是「applies the **extracted** container opacity to red disabled\n782\t> buttons instead of only swapping tokens」并断言 `data-figma-opacity: 0.4`）。**按无条件 ⛔ 字面执行会违反\n783\t> L-core #0 并红那条测试。** owner 原话：「确认是 Figma 中来的，那么就没关系……**它们是组件，不应该按照豁免来归类，\n784\t> 应该按照完全遵守 Figma 的样式来写的**」⇒ **⛔ 不为它们建豁免表**（豁免表意味着「违规但放行」，\n785\t> 而这里根本不违规）；规则本身就是「照 Figma 真值写」，token 与 opacity 都只是 Figma 怎么画的结果。\n786\t>\n787\t> **✅ 代码侧已落地（2026-08-14，owner 批准的合批视觉改动；逐条证据在 [[INFRA-F120]]）**：\n788\t> · `Rating` → 禁用时把 `--rating-star-on/off` 都指向 `--icon-disabled`（值靠 GLYPH `mark/star-on` vs\n789\t> `mark/star` 保留，不靠颜色）· `Slider` → `--slider-fill-color`=`--control-disabled-selected-bg` /\n790\t> `--slider-track-bg`=`--control-disabled-bg` / `--slider-value-color`=`--text-disabled`（⚠️ 选择器提权成\n791\t> `.slider.slider--disabled`，否则后声明的 `.slider--light` 会把 track 覆盖回去 —— 真浏览器实测过）·\n792\t> `Select` → 值文字 `--text-tips` + 非 filled 档边框 `--select-disabled-border`（逐字抄同族有 Figma 背书的\n793\t> `SelectBoxBase.vue`）· `InputNumber` → 值文字 `--text-tips`（抄 Figma 背书的 `Input.vue`）\n794\t> · **容器级 `Form.vue` = 本规则的唯一例外，owner 2026-08-14 拍定「维持容器 opacity」**：Figma 里**没有\n795\t> `Form` 容器**（`components.manifest.json` 零命中；divergence `form-container-topology`），`Form Item` 的\n796\t> `Status` 轴只有 `Normal|Error` ⇒ **无变体可提取**；且 `.tvu-form` 只有 `gap`、不画自己的 bg/border/text\n797\t> ⇒ **没有可绑的 token**，而 `disabled` 又不下传（`FormItem`/`useFormContext` 零处消费）⇒ 删掉那行\n798\t> `opacity: 0.6` 会让 `<Form disabled>` 与 enabled 像素相同。**完整三条理由就地注明在该组件 CSS 里**，\n799\t> ⛔ 别把它当 opacity 遗留清掉。\n800\t> · **`InputNumber` 的容器边框刻意不改** —— Figma 背书的 input 家族里 `--input-disabled-border` 与\n801\t> `--input-line-border` 在两个主题**同值**（dark `--color-grey-8` / light `--color-grey-5`），即那一族用\n802\t> **文字**而非边框表达禁用。改边框反而会偏离真源。\n803\t> · **`Switch` 的两行 opacity 保留** —— 它们是 Figma 真值（见上方 🔑）；且 `:92-94` 把 live-on-disabled 的\n804\t> background 拉回 `var(--red)` ⇒ 那行 opacity 是 live 分支**唯一**的 disabled 载体，删掉就与 enabled 像素相同\n805\t> · **`Button` 不动** —— 同上，Figma 真值\n806\t> · ~~⚠️ **前置未满足**：`Rating` / `Slider` / `Select` 的 `data-figma-node-id` 命中全为 0、Figma 侧也没有\n807\t> disabled 变体，`Form.vue` 自述 `no Figma source` ⇒ 给它们绑 token 是发明数值不是重构，值仍等\n808\t> `design-review-queue.md` #3 的 designer 在 Figma 补出这些变体。~~ → 🔑 **owner 2026-08-14 裁定：这条前置解除**，见下方第二条注。\n809\t>\n810\t> 🔑 **第二条裁定（owner 2026-08-14）—— Figma 没有 disabled 变体时，绑语义 disabled token 就是正解，⛔ 不等 designer**\n811\t>\n812\t> owner 逐字：「Figma 无 disabled 变体的前提下已经绑了 `--text-disabled`，这个合理，并统一成这个规则」。\n813\t> **触发场景**：清零第 9 批核 `Tab/Item` 时发现，它在 Figma **没有** disabled 变体，而 code\n814\t> （`src/components/Tab/TabItem.vue`）**早就**绑了 `--text-disabled` + `cursor: not-allowed` 并已随多个版本\n815\t> 发布（`.tab-item--disabled` 自 `9e3ca1ae` 2026-04-28、a11y 自 `bc326ea5` 2026-05-29）。这与上一行原写的\n816\t> 「Figma 无变体 ⇒ 绑 token = 发明数值、必须等 designer」**直接互斥**：同一条口径下 Tab 早就「违规」了，\n817\t> 却是全仓最干净的 disabled 实现之一。owner 裁定取 Tab 这一侧并**统一成规则**。\n818\t>\n819\t> **规则本身**：`--control-disabled-*` / `--text-disabled` / `--icon-disabled` 是**已发布的语义 token、不是\n820\t> 新造的数值** —— 绑它们属于「用体系内既有档位」，与「拍一个 opacity 数字」性质不同。⇒ Figma 缺变体"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"fe22e39e-dabb-4797-b9e2-d15e2e78dcf9","timestamp":"2026-08-25T10:21:33.175Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","content":"## R9 — Static-to-Interactive Augmentation Protocol（场景 1 / 3 强制；enforcement L1，v2 待升 L3）\n\n### 触发场景\n\nR7 场景 1（visual-fidelity）/ 场景 3（greenfield TVU 构建）的 code implementation。\n\n- 场景 2（已有产品增量）按已有产品交互惯例\n- 场景 4（compliance refactor）保持原代码状态不主动补新交互\n\n### 强制补的交互态（设计图没画也要补）\n\n| 交互态 | 推断规则 |\n|---|---|\n| **hover** | 从 active state 反推 — \"active 的弱版本\"（bg 略浅 / 加 subtle bg / weight 不 bold） |\n| **focus** | active-like bg + outline ring（键盘 a11y） |\n| **disabled** | **有 Figma 变体 → 照它的真值写**（owner 2026-08-13 裁定，见下方注）：Figma 用 token desaturation → 绑 `--control-disabled-{bg,border,text,selected-bg}` / `--text-disabled` / `--icon-disabled`；**Figma 变体自己画了容器 `opacity` → 就写那个 opacity**（那是**遵守 Figma**，不是偷懒，也不是豁免）。<br>**⭐ Figma 根本没有 disabled 变体 → 绑上面那组语义 disabled token，就地实现、⛔ 不等 designer**（owner 2026-08-14 裁定，见下方第二条注）。<br>两种都要 `cursor: not-allowed` + 去交互态。⛔ **禁止的是「Figma 明明绑了 token，code 却拿 `opacity` 一淡了之」** —— 那才是 `FIGMA_AS_SOURCE_OF_TRUTH.md:71` 说的「实现策略差 = code 偷懒」 |\n| **active/pressed** | 比 hover 更深的 bg（仅交互瞬间） |\n\n> 🔑 **disabled 行的裁定留痕（owner 2026-08-13，[[INFRA-F120]]）** —— 本行原写 `opacity ≈0.5`，\n> 与两处硬约束互斥：`docs/FIGMA_AS_SOURCE_OF_TRUTH.md:71`（**L-core #0，优先级高于本文件**）逐字把\n> 「CSS opacity vs token desaturation」列为**禁止**登记 divergence 的项、理由「实现策略差 = code 偷懒」；\n> `mockup-conventions.md` M32.4 逐字「不要照搬降透明度」。\n>\n> **裁定 = token desaturation 路线，且不再需要任何 opacity 数值** —— 此前的「四分叉」\n> （code 0.4 · `Form.vue` 0.6 · mockup 侧 0.45 · 本行 ≈0.5）**整体作废**，因为\n> `--control-disabled-*` / `--text-disabled` / `--icon-disabled` 是 **per-theme 的具体色值不是透明度**\n> （实测 `src/tokens/variables.css`：dark `#595959` / light `#cccccc`，容器色 dark `var(--line-deep)` /\n> light `#dbdbdb`）。⇒ 选路线即消解数值之争，`design-review-queue.md` #3 里那个「0.4 或 0.45」\n> 的二选一框架一并作废。\n>\n> **裁定依据（实测，非推断）**：token 路线是仓库**多数派** —— **12 : 8**\n> （⚠️ **2026-08-13 晚回读活源订正**：原写「12 : 6」并列了两份名单，那是**一个误计 + 一个漏计**恰好凑出 12 的\n> —— `UserMenu` **不是** token 消费方（`:397` 是注释、`:401`/`:404` 是 `:not(.is-disabled)` **排除选择器**，\n> 真绑定在 `MenuList:214` 已单独计），而 `Button` **在两边都被漏掉**；`Switch` 是**两处** opacity 不是一处。\n> 同时出现在两边的是 **3 个：Switch / InputNumber / Button**）。\n>\n> 🔑 **owner 二次裁定（2026-08-13 晚，本行是它的落点）—— 「Figma 画的 opacity」不是豁免，是遵守**：\n> 上面那条 ⛔ 一度被写成**无条件禁 opacity**，而实测 **`Button` 与 `Switch` 的 `opacity: 0.4` 恰恰是 Figma 真值**\n> （`figma-data/normalized/components-tokenized/button_light_s__1545_51851.json` 里 `\"opacity\": 0.4` 命中 **80 处**，\n> 全部 `status=disable`/`loading` × red|orange；`switch__348_3483.json` **4 处**，全部 `status=live, enable=no`；\n> 且 `tests/Button.test.ts:247` 的测试名逐字是「applies the **extracted** container opacity to red disabled\n> buttons instead of only swapping tokens」并断言 `data-figma-opacity: 0.4`）。**按无条件 ⛔ 字面执行会违反\n> L-core #0 并红那条测试。** owner 原话：「确认是 Figma 中来的，那么就没关系……**它们是组件，不应该按照豁免来归类，\n> 应该按照完全遵守 Figma 的样式来写的**」⇒ **⛔ 不为它们建豁免表**（豁免表意味着「违规但放行」，\n> 而这里根本不违规）；规则本身就是「照 Figma 真值写」，token 与 opacity 都只是 Figma 怎么画的结果。\n>\n> **✅ 代码侧已落地（2026-08-14，owner 批准的合批视觉改动；逐条证据在 [[INFRA-F120]]）**：\n> · `Rating` → 禁用时把 `--rating-star-on/off` 都指向 `--icon-disabled`（值靠 GLYPH `mark/star-on` vs\n> `mark/star` 保留，不靠颜色）· `Slider` → `--slider-fill-color`=`--control-disabled-selected-bg` /\n> `--slider-track-bg`=`--control-disabled-bg` / `--slider-value-color`=`--text-disabled`（⚠️ 选择器提权成\n> `.slider.slider--disabled`，否则后声明的 `.slider--light` 会把 track 覆盖回去 —— 真浏览器实测过）·\n> `Select` → 值文字 `--text-tips` + 非 filled 档边框 `--select-disabled-border`（逐字抄同族有 Figma 背书的\n> `SelectBoxBase.vue`）· `InputNumber` → 值文字 `--text-tips`（抄 Figma 背书的 `Input.vue`）\n> · **容器级 `Form.vue` = 本规则的唯一例外，owner 2026-08-14 拍定「维持容器 opacity」**：Figma 里**没有\n> `Form` 容器**（`components.manifest.json` 零命中；divergence `form-container-topology`），`Form Item` 的\n> `Status` 轴只有 `Normal|Error` ⇒ **无变体可提取**；且 `.tvu-form` 只有 `gap`、不画自己的 bg/border/text\n> ⇒ **没有可绑的 token**，而 `disabled` 又不下传（`FormItem`/`useFormContext` 零处消费）⇒ 删掉那行\n> `opacity: 0.6` 会让 `<Form disabled>` 与 enabled 像素相同。**完整三条理由就地注明在该组件 CSS 里**，\n> ⛔ 别把它当 opacity 遗留清掉。\n> · **`InputNumber` 的容器边框刻意不改** —— Figma 背书的 input 家族里 `--input-disabled-border` 与\n> `--input-line-border` 在两个主题**同值**（dark `--color-grey-8` / light `--color-grey-5`），即那一族用\n> **文字**而非边框表达禁用。改边框反而会偏离真源。\n> · **`Switch` 的两行 opacity 保留** —— 它们是 Figma 真值（见上方 🔑）；且 `:92-94` 把 live-on-disabled 的\n> background 拉回 `var(--red)` ⇒ 那行 opacity 是 live 分支**唯一**的 disabled 载体，删掉就与 enabled 像素相同\n> · **`Button` 不动** —— 同上，Figma 真值\n> · ~~⚠️ **前置未满足**：`Rating` / `Slider` / `Select` 的 `data-figma-node-id` 命中全为 0、Figma 侧也没有\n> disabled 变体，`Form.vue` 自述 `no Figma source` ⇒ 给它们绑 token 是发明数值不是重构，值仍等\n> `design-review-queue.md` #3 的 designer 在 Figma 补出这些变体。~~ → 🔑 **owner 2026-08-14 裁定：这条前置解除**，见下方第二条注。\n>\n> 🔑 **第二条裁定（owner 2026-08-14）—— Figma 没有 disabled 变体时，绑语义 disabled token 就是正解，⛔ 不等 designer**\n>\n> owner 逐字：「Figma 无 disabled 变体的前提下已经绑了 `--text-disabled`，这个合理，并统一成这个规则」。\n> **触发场景**：清零第 9 批核 `Tab/Item` 时发现，它在 Figma **没有** disabled 变体，而 code\n> （`src/components/Tab/TabItem.vue`）**早就**绑了 `--text-disabled` + `cursor: not-allowed` 并已随多个版本\n> 发布（`.tab-item--disabled` 自 `9e3ca1ae` 2026-04-28、a11y 自 `bc326ea5` 2026-05-29）。这与上一行原写的\n> 「Figma 无变体 ⇒ 绑 token = 发明数值、必须等 designer」**直接互斥**：同一条口径下 Tab 早就「违规」了，\n> 却是全仓最干净的 disabled 实现之一。owner 裁定取 Tab 这一侧并**统一成规则**。\n>\n> **规则本身**：`--control-disabled-*` / `--text-disabled` / `--icon-disabled` 是**已发布的语义 token、不是\n> 新造的数值** —— 绑它们属于「用体系内既有档位」，与「拍一个 opacity 数字」性质不同。⇒ Figma 缺变体","numLines":80,"startLine":741,"totalLines":1528}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJLTd8d2hzX36ZL7h2D","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_012furARdr4sDxTaxktFMRdV","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/design-process.md","offset":1103,"limit":42},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":7498,"cache_read_input_tokens":244614,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":7498},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"2796dd90-859c-410c-995b-79786c0306d4","timestamp":"2026-08-25T10:21:33.683Z","request_id":"req_011CePJLMdDvD3gV4yKwpqDo"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_012furARdr4sDxTaxktFMRdV","type":"tool_result","content":"1103\t## M16 — Deliverable Defaults Must Be Evaluated\n1104\t\n1105\tSource component default values = 预览用占位（dropdown 默认 \"Option 1/2/3\"、Button 默认 text、默认 icon、多余 variant 等）。\n1106\t\n1107\t### 采用 source component 后必做（不是必改）\n1108\t\n1109\t评估每项 default（placeholder text / 默认 icon / variant property）：\n1110\t\n1111\t- 默认值**符合**当前需求 → **可保留**\n1112\t- 默认值**不符**需求 → **必须 override**\n1113\t\n1114\t### 反模式（违规）\n1115\t\n1116\t采用 source component 后**不评估**，直接交付 placeholder 当真实内容。\n1117\t\n1118\t### Why\n1119\t\n1120\t区分 **\"未改\"（可能合理）** 和 **\"未评估\"（始终不合理）**。一刀切\"必须改\"会引出本不必要的 override，component instance 失去与 source 同步的意义。\n1121\t\n1122\t### M16.1 — Multi-state spec mockup：默认态 + 越权态双 frame 覆盖\n1123\t\n1124\tSpec mockup（给开发 / PM / 跨团队 ship 的设计文档，含 list / state-machine 类 component）**必须**同时含两类 frame：\n1125\t\n1126\t| 类别 | 必须画 | 反例 |\n1127\t|---|---|---|\n1128\t| **规则默认态** | 体现规则约束下的默认 UX（如 accordion 默认只 selected expanded） | 只画此一类 = reader 不知 user diverge 时会怎样 |\n1129\t| **User-override 态** | 体现用户主动越权后系统应当的表现（如 user 手动 expand 多个、user 全 collapse、user 触达 cap 边界） | 只画此一类 = reader 不知道默认规则是什么 |\n1130\t\n1131\t**Why:** Spec mockup 是开发实现 reference。只画默认态 → 开发遇到 user override 场景没参考 → 自由发挥导致与规则脱节。两类必须配对出现。\n1132\t\n1133\t**Acceptance:**\n1134\t- 任何含 state-machine / interactive list 的 deliverable 至少包含 1 default + 1 override frame\n1135\t- frame 名命名必含 state 字段（如 `M5 · default accordion`、`M-MultiExp · user manual expand`、`M8 · user all-collapse`），不允许只标 frame 编号\n1136\t- State-label 必显式说明该 frame 是 default 还是 override（与 M22 design intent 衔接）\n1137\t\n1138\t**实证**（2026-05-26 Video Sync Phase B）：原 spec 含 M5（默认 accordion: 1 expanded + 1 collapsed）但缺 user override 帧。用户提出 bein sports case 需 2 syncs 并行（user 主动 expand 2 个）→ 加 M-MultiExp + M8（全 collapse）两 override 帧后才完整。\n1139\t\n1140\t---\n1141\t\n1142\t## M21 — Existing Product Incremental Local Reuse\n1143\t\n1144\t### 触发场景"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"28456498-7fb7-4c0a-ae9f-a656cd95868b","timestamp":"2026-08-25T10:21:33.693Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/design-process.md","content":"## M16 — Deliverable Defaults Must Be Evaluated\n\nSource component default values = 预览用占位（dropdown 默认 \"Option 1/2/3\"、Button 默认 text、默认 icon、多余 variant 等）。\n\n### 采用 source component 后必做（不是必改）\n\n评估每项 default（placeholder text / 默认 icon / variant property）：\n\n- 默认值**符合**当前需求 → **可保留**\n- 默认值**不符**需求 → **必须 override**\n\n### 反模式（违规）\n\n采用 source component 后**不评估**，直接交付 placeholder 当真实内容。\n\n### Why\n\n区分 **\"未改\"（可能合理）** 和 **\"未评估\"（始终不合理）**。一刀切\"必须改\"会引出本不必要的 override，component instance 失去与 source 同步的意义。\n\n### M16.1 — Multi-state spec mockup：默认态 + 越权态双 frame 覆盖\n\nSpec mockup（给开发 / PM / 跨团队 ship 的设计文档，含 list / state-machine 类 component）**必须**同时含两类 frame：\n\n| 类别 | 必须画 | 反例 |\n|---|---|---|\n| **规则默认态** | 体现规则约束下的默认 UX（如 accordion 默认只 selected expanded） | 只画此一类 = reader 不知 user diverge 时会怎样 |\n| **User-override 态** | 体现用户主动越权后系统应当的表现（如 user 手动 expand 多个、user 全 collapse、user 触达 cap 边界） | 只画此一类 = reader 不知道默认规则是什么 |\n\n**Why:** Spec mockup 是开发实现 reference。只画默认态 → 开发遇到 user override 场景没参考 → 自由发挥导致与规则脱节。两类必须配对出现。\n\n**Acceptance:**\n- 任何含 state-machine / interactive list 的 deliverable 至少包含 1 default + 1 override frame\n- frame 名命名必含 state 字段（如 `M5 · default accordion`、`M-MultiExp · user manual expand`、`M8 · user all-collapse`），不允许只标 frame 编号\n- State-label 必显式说明该 frame 是 default 还是 override（与 M22 design intent 衔接）\n\n**实证**（2026-05-26 Video Sync Phase B）：原 spec 含 M5（默认 accordion: 1 expanded + 1 collapsed）但缺 user override 帧。用户提出 bein sports case 需 2 syncs 并行（user 主动 expand 2 个）→ 加 M-MultiExp + M8（全 collapse）两 override 帧后才完整。\n\n---\n\n## M21 — Existing Product Incremental Local Reuse\n\n### 触发场景","numLines":42,"startLine":1103,"totalLines":1489}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"4ffb4f56-d074-4eea-a29b-93ae10429c8c","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"761e7048-5d86-436d-ba67-8686c13f9679","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":250,"estimated_tokens_delta":100,"uuid":"09e2a7be-3e6d-49b4-a7c7-5028fb208b05","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":400,"estimated_tokens_delta":150,"uuid":"c8f2f8f2-505a-4d54-88b4-995087ba4fa4","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":500,"estimated_tokens_delta":100,"uuid":"24db58d5-6baa-45cf-9229-63a78e11e361","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":600,"estimated_tokens_delta":100,"uuid":"8a6996af-13e4-4b6e-9571-d428e948caa6","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":700,"estimated_tokens_delta":100,"uuid":"7cd38c98-502a-4849-98d6-cead6a91856d","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":800,"estimated_tokens_delta":100,"uuid":"aead171b-1563-4901-9a67-82a9d954e817","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":900,"estimated_tokens_delta":100,"uuid":"b2ff211e-deda-4c9e-92e6-be8f32cf143f","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1000,"estimated_tokens_delta":100,"uuid":"05b7eb6a-479c-49dc-8c7d-7e641127825c","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1100,"estimated_tokens_delta":100,"uuid":"6e26ddb3-6dfb-4b3f-9be0-2452124102e4","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1200,"estimated_tokens_delta":100,"uuid":"d4323c22-d025-4227-821c-a65e922944d2","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1300,"estimated_tokens_delta":100,"uuid":"b2c89919-6103-49e2-b101-582c1af35f35","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1400,"estimated_tokens_delta":100,"uuid":"2b2296a4-8e3d-4a91-b6cd-4ae87dc6d535","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1500,"estimated_tokens_delta":100,"uuid":"77bef5f6-9ad4-415e-8978-9b089bab9056","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1550,"estimated_tokens_delta":50,"uuid":"361d2528-048f-4c9b-b44d-542a5d432091","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1650,"estimated_tokens_delta":100,"uuid":"c08fed2c-fa0b-49f6-b713-fd6ac33da08d","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1800,"estimated_tokens_delta":150,"uuid":"a47acdd7-c437-49b2-b7a0-70a28e3ba316","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1850,"estimated_tokens_delta":50,"uuid":"c8fb3618-d68b-4137-a180-02b10110f558","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1950,"estimated_tokens_delta":100,"uuid":"6b092b73-60c6-48d5-84d6-f8a8e4dced77","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":2050,"estimated_tokens_delta":100,"uuid":"3895d818-0f54-4189-b4a6-e6d49db391cd","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":2150,"estimated_tokens_delta":100,"uuid":"e28ee24d-d277-4c37-8d19-03f9089182f8","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":2200,"estimated_tokens_delta":50,"uuid":"6f6b7da1-751b-441d-85cb-9bedd67f6df7","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":2300,"estimated_tokens_delta":100,"uuid":"4ed9a1de-2d5e-4cc0-a9a2-6f75ffc86d6c","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":2400,"estimated_tokens_delta":100,"uuid":"88a94b56-5bde-4eab-b63e-e8341e896888","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":2450,"estimated_tokens_delta":50,"uuid":"7c21fb81-e50b-4e77-b108-51bb4c7266f2","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":2550,"estimated_tokens_delta":100,"uuid":"b57a5830-7f41-4b4d-8810-c77c8d108093","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":2600,"estimated_tokens_delta":50,"uuid":"33ae11c7-8ca1-4ccb-91ae-e8a82a28292a","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":2700,"estimated_tokens_delta":100,"uuid":"c27b346d-ad43-4e52-aad4-90ccee63bcbf","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":2800,"estimated_tokens_delta":100,"uuid":"5d78401a-0fd4-4751-bda5-e4d92e56b164","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":2850,"estimated_tokens_delta":50,"uuid":"5a14472c-3475-4148-ac0d-96ff05ea84ef","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":3000,"estimated_tokens_delta":150,"uuid":"d097b34e-6b0c-4168-a628-5930cd769622","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":3100,"estimated_tokens_delta":100,"uuid":"0cec6ab4-c8d4-4eb6-ac70-b279b51a6ed5","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":3150,"estimated_tokens_delta":50,"uuid":"aaf5ce6d-d251-4656-b1e6-01bb8dde1957","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":3250,"estimated_tokens_delta":100,"uuid":"a5b9f5e5-be5c-407c-a1e8-dcd09ddd5e30","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":3300,"estimated_tokens_delta":50,"uuid":"12f055db-95a0-48ee-b328-ae303e76d6a5","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":3450,"estimated_tokens_delta":150,"uuid":"af582299-c8c5-4250-9c5f-e421082c2db0","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":3550,"estimated_tokens_delta":100,"uuid":"b06176ab-27eb-4207-9582-8cc23d7cf968","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":3650,"estimated_tokens_delta":100,"uuid":"f129087f-3f71-4668-86f6-d7dd0f01a689","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":3750,"estimated_tokens_delta":100,"uuid":"ca302820-8a09-4db6-a3c2-f90565cbe485","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":3950,"estimated_tokens_delta":200,"uuid":"e2b83abf-75e2-4ac9-8740-ca4e6370d53c","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":4050,"estimated_tokens_delta":100,"uuid":"aac4baef-1111-437c-9077-c161075372db","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":4150,"estimated_tokens_delta":100,"uuid":"3a63f8ef-2563-48ed-a0bc-115a7ec884df","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":4250,"estimated_tokens_delta":100,"uuid":"d1dc1509-8dcd-4405-856c-a30257a13e9d","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":4350,"estimated_tokens_delta":100,"uuid":"b47787ac-c6eb-4e82-887e-f933d4add1d6","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":4450,"estimated_tokens_delta":100,"uuid":"0cbda897-81a5-4d22-ba97-3996d19e167a","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":4500,"estimated_tokens_delta":50,"uuid":"8070ba73-6932-4ded-988e-379667cc8cc9","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":4650,"estimated_tokens_delta":150,"uuid":"7e277293-9ff4-49cd-9ee9-a65dfdbbdf22","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":4750,"estimated_tokens_delta":100,"uuid":"25579456-fccf-4db2-b3da-fa02764d1d66","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":4850,"estimated_tokens_delta":100,"uuid":"cb0116f0-112d-4002-9933-60d8b224572d","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":4950,"estimated_tokens_delta":100,"uuid":"f9789f5a-6014-4e86-ad56-012ee5f88f15","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":5050,"estimated_tokens_delta":100,"uuid":"ae42df2f-30ef-46c7-865e-4dd9c8ebc0db","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":5150,"estimated_tokens_delta":100,"uuid":"43802d65-0229-4362-8aa8-9996e07fe68b","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":5200,"estimated_tokens_delta":50,"uuid":"f4e06c23-2392-4533-baa1-0a31febc6fc4","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":5300,"estimated_tokens_delta":100,"uuid":"69376aa9-3367-4624-8388-61776b9de9a4","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":5400,"estimated_tokens_delta":100,"uuid":"eba371d5-d748-474b-ad06-1fc5a6d47e95","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":5500,"estimated_tokens_delta":100,"uuid":"cd8094d1-316e-413c-aea1-3a2c06f31971","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJMV3ErK7mhCjgsvDd9","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"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"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":5776,"cache_read_input_tokens":252112,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":5776},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"5e57794d-cc7e-4ac1-ad8a-79a3a107b9e6","timestamp":"2026-08-25T10:23:03.641Z","request_id":"req_011CePJMNyNFd7Gg7TW8faBS"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJMV3ErK7mhCjgsvDd9","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01B57own5dejehLEHy8iNtoa","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","offset":1082,"limit":64},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":5776,"cache_read_input_tokens":252112,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":5776},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"233eae0c-b2bc-45b4-9508-47b36f9fb362","timestamp":"2026-08-25T10:23:04.453Z","request_id":"req_011CePJMNyNFd7Gg7TW8faBS"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01B57own5dejehLEHy8iNtoa","type":"tool_result","content":"1082\t## R16 — Annotation vs Product UI String Boundary（code-side mirror of M33）\n1083\t\n1084\t代码侧的\"注释 / 文档\"和\"产品 UI 字符串\"是两层，**语言策略不同，必须严格分离**。\n1085\t\n1086\t#### 边界判定\n1087\t\n1088\t| 元素归属 | 语言策略 |\n1089\t|---|---|\n1090\t| 代码注释（`//` / `/* */` / JSDoc）/ commit message / PR description / handoff doc | **双语 / 多语 / 任意**——服务于团队理解 |\n1091\t| 文档（README / *.md / convention 文件）| **双语**（中英对照，便于跨语言团队）|\n1092\t| 产品 UI 字符串（button label / dialog title / tooltip / placeholder / error message）| **走 i18n key / const map，单源**——禁止 inline 中英混排 / 双语字符串拼接 |\n1093\t\n1094\t#### Why\n1095\t\n1096\t- 双语字符串在产品 UI 里直接出现 = i18n 框架（vue-i18n / react-intl）无法处理；翻译团队 audit 不到；切换语言时一处文字两边都要改\n1097\t- 即使**当前项目还没接 i18n**，也应用 `const labels = { confirm: 'Confirm', cancel: 'Cancel' }` 这种 const map 隔离，为未来 i18n 留接口\n1098\t- 代码注释里写\"// 这是 confirm 按钮 / This is the confirm button\"完全 OK，因为注释不进 runtime / 不进翻译流\n1099\t\n1100\t#### 反例\n1101\t\n1102\t| ❌ 错误做法 | 后果 |\n1103\t|---|---|\n1104\t| `<button>Confirm 确认</button>` JSX 直写双语 | 用户看到双语并排（视觉拥挤）；i18n 接入时要重写所有 JSX |\n1105\t| `alert('Channel 2 missing Receiver / 通道 2 缺少 Receiver')` | runtime 字符串硬编码双语 |\n1106\t| 用 `\\n` 在按钮文字里塞中文：`'Confirm\\n确认'` | 按钮高度被撑；CSS / 排版失控 |\n1107\t| Vue template 写 `{{ '确认' }}` 中文 hardcode | 同上 |\n1108\t\n1109\t#### 正例\n1110\t\n1111\t```ts\n1112\t// ✅ const map（哪怕没 i18n 框架）\n1113\tconst T = {\n1114\t confirm: 'Confirm',\n1115\t cancel: 'Cancel',\n1116\t channelMissingReceiver: 'Channel {n} missing Receiver',\n1117\t};\n1118\t\n1119\t<button>{T.confirm}</button>\n1120\t\n1121\t// ✅ 注释可双语（不进 runtime）\n1122\t/**\n1123\t * Renders the partial-config confirm dialog.\n1124\t * 部分未配置确认弹窗 — partial 状态下点 Live all 触发。\n1125\t */\n1126\tfunction PartialConfirmDialog() { ... }\n1127\t```\n1128\t\n1129\t#### Acceptance\n1130\t\n1131\t- grep 产品 UI 文件（`.tsx` / `.vue` / `.html` template 部分）的字符串字面量，**不应同时包含 ASCII 字母和中文字符**\n1132\t- probe: `grep -rEn '\"\\s*[a-zA-Z]+\\s*\\p{Han}+\\s*\"' src/components/` (or 反向) → 0 命中\n1133\t- 代码注释不在此规则范围内（注释允许任何语言混排）\n1134\t\n1135\t#### 与既有规则关系\n1136\t\n1137\t- 与 [`AGENTS.md`](../../AGENTS.md) 硬规则联动：\"产品文案走 i18n / token，不 hardcode\"\n1138\t- 与 mockup-conventions.md M33 同源——M33 限定 mockup 内产品 UI 不混双语；R16 限定代码内产品 UI 不混双语\n1139\t\n1140\t#### 实证\n1141\t\n1142\t- 镜像 M33 实证（Touch-Screen v8 mockup M1 dialog v1 全双语）。代码端同源：若按 mockup v1 实现，会写 `<h3>2 channels have no Receiver 2 路通道未选择 Receiver</h3>` 这样的 hardcode 双语 JSX。R16 + R15（library 化）+ R14（layout）共同把 mockup 端 v1 三个错误模式在代码端拦下。\n1143\t\n1144\t---\n1145\t"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"a9098684-a3e6-4e37-a3d9-6937f37e26ec","timestamp":"2026-08-25T10:23:04.464Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","content":"## R16 — Annotation vs Product UI String Boundary（code-side mirror of M33）\n\n代码侧的\"注释 / 文档\"和\"产品 UI 字符串\"是两层，**语言策略不同，必须严格分离**。\n\n#### 边界判定\n\n| 元素归属 | 语言策略 |\n|---|---|\n| 代码注释（`//` / `/* */` / JSDoc）/ commit message / PR description / handoff doc | **双语 / 多语 / 任意**——服务于团队理解 |\n| 文档（README / *.md / convention 文件）| **双语**（中英对照，便于跨语言团队）|\n| 产品 UI 字符串（button label / dialog title / tooltip / placeholder / error message）| **走 i18n key / const map，单源**——禁止 inline 中英混排 / 双语字符串拼接 |\n\n#### Why\n\n- 双语字符串在产品 UI 里直接出现 = i18n 框架（vue-i18n / react-intl）无法处理；翻译团队 audit 不到；切换语言时一处文字两边都要改\n- 即使**当前项目还没接 i18n**，也应用 `const labels = { confirm: 'Confirm', cancel: 'Cancel' }` 这种 const map 隔离，为未来 i18n 留接口\n- 代码注释里写\"// 这是 confirm 按钮 / This is the confirm button\"完全 OK，因为注释不进 runtime / 不进翻译流\n\n#### 反例\n\n| ❌ 错误做法 | 后果 |\n|---|---|\n| `<button>Confirm 确认</button>` JSX 直写双语 | 用户看到双语并排（视觉拥挤）；i18n 接入时要重写所有 JSX |\n| `alert('Channel 2 missing Receiver / 通道 2 缺少 Receiver')` | runtime 字符串硬编码双语 |\n| 用 `\\n` 在按钮文字里塞中文：`'Confirm\\n确认'` | 按钮高度被撑；CSS / 排版失控 |\n| Vue template 写 `{{ '确认' }}` 中文 hardcode | 同上 |\n\n#### 正例\n\n```ts\n// ✅ const map（哪怕没 i18n 框架）\nconst T = {\n confirm: 'Confirm',\n cancel: 'Cancel',\n channelMissingReceiver: 'Channel {n} missing Receiver',\n};\n\n<button>{T.confirm}</button>\n\n// ✅ 注释可双语（不进 runtime）\n/**\n * Renders the partial-config confirm dialog.\n * 部分未配置确认弹窗 — partial 状态下点 Live all 触发。\n */\nfunction PartialConfirmDialog() { ... }\n```\n\n#### Acceptance\n\n- grep 产品 UI 文件（`.tsx` / `.vue` / `.html` template 部分）的字符串字面量，**不应同时包含 ASCII 字母和中文字符**\n- probe: `grep -rEn '\"\\s*[a-zA-Z]+\\s*\\p{Han}+\\s*\"' src/components/` (or 反向) → 0 命中\n- 代码注释不在此规则范围内（注释允许任何语言混排）\n\n#### 与既有规则关系\n\n- 与 [`AGENTS.md`](../../AGENTS.md) 硬规则联动：\"产品文案走 i18n / token，不 hardcode\"\n- 与 mockup-conventions.md M33 同源——M33 限定 mockup 内产品 UI 不混双语；R16 限定代码内产品 UI 不混双语\n\n#### 实证\n\n- 镜像 M33 实证（Touch-Screen v8 mockup M1 dialog v1 全双语）。代码端同源：若按 mockup v1 实现，会写 `<h3>2 channels have no Receiver 2 路通道未选择 Receiver</h3>` 这样的 hardcode 双语 JSX。R16 + R15（library 化）+ R14（layout）共同把 mockup 端 v1 三个错误模式在代码端拦下。\n\n---\n","numLines":64,"startLine":1082,"totalLines":1528}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"0201b067-9305-49aa-9597-d74a966cfb00","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"9495c8ae-5b8b-44b5-b328-62599a700f5e","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":300,"estimated_tokens_delta":150,"uuid":"31524e8c-6502-4499-bbe5-2ea1ad77eeb4","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":400,"estimated_tokens_delta":100,"uuid":"1c38ea47-851a-4d31-9103-49ba162fd55b","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":450,"estimated_tokens_delta":50,"uuid":"d95ad4d2-7757-4462-86a5-ad09dea74334","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":600,"estimated_tokens_delta":150,"uuid":"f8a68039-414b-4b36-be9e-f358489784e0","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":700,"estimated_tokens_delta":100,"uuid":"1eed3490-09ee-4174-92c2-8ab0702e29c5","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":800,"estimated_tokens_delta":100,"uuid":"071333f4-9021-4582-9354-28b31675c5fb","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":950,"estimated_tokens_delta":150,"uuid":"87b94dbc-586e-4577-b74c-76248584e16e","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1100,"estimated_tokens_delta":150,"uuid":"b0779869-89f9-47b1-9dc4-bab63b26f2f7","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1250,"estimated_tokens_delta":150,"uuid":"d235077f-b3c1-4826-9db0-9dea31b65130","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1350,"estimated_tokens_delta":100,"uuid":"fe084ce6-343d-4ddd-8b4c-7d19aa55216a","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1450,"estimated_tokens_delta":100,"uuid":"e634fbd1-540d-4010-991d-0305543a9b40","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1550,"estimated_tokens_delta":100,"uuid":"a67c1674-9a20-4fcf-a03b-c55761e90870","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJUBLKpYiocr34dgJo1","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"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"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":7218,"cache_read_input_tokens":257888,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":7218},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"b198b2ec-b558-4f0d-af88-be4f7dba9d9e","timestamp":"2026-08-25T10:23:30.735Z","request_id":"req_011CePJU4yqPDEtPdLfSkzm4"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJUBLKpYiocr34dgJo1","type":"message","role":"assistant","content":[{"type":"text","text":"R15 要求「自画前先穷尽同义词」——我把 card/panel/容器类做一次实证扫描，避免把「没搜到」当「没有」。"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":7218,"cache_read_input_tokens":257888,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":7218},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"1e5e437d-9aaf-4a9d-9811-2a7faaf3365d","timestamp":"2026-08-25T10:23:31.453Z","request_id":"req_011CePJU4yqPDEtPdLfSkzm4"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJUBLKpYiocr34dgJo1","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01RgKv7NWtSy4JpZrWMp62rC","name":"Grep","input":{"pattern":"card|panel|container|surface|section|accordion|collapse|widget|tile|stat|kpi|metric","path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/figma-component-catalog.md","output_mode":"content","-n":true,"-i":true,"head_limit":40},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":7218,"cache_read_input_tokens":257888,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":7218},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"7dd6d912-8d05-4a05-bc9d-412a6443d383","timestamp":"2026-08-25T10:23:33.562Z","request_id":"req_011CePJU4yqPDEtPdLfSkzm4"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01RgKv7NWtSy4JpZrWMp62rC","type":"tool_result","content":"27:## Status legend\n64:- **Code mapping**: `Badge` (status: approved)\n67:状态/计数指示器 (status pill)。最常用于 row-level INPUT/OUTPUT 状态显示。\n70:- **Status pill**（INPUT/OUTPUT 列）：`Type=Rectangle, Color=Red/Green/Black, Tag=Filled` —— Live=Red, Preview=Green, Inactive=Black\n75:- **Top-bar status counters**（\"8 Live\" / \"12 Previewing\" / \"19 Total Sessions\"）：同状态色 mapping，文本覆盖为 \"数字 + 标签\"\n76:[Omitted long matching line]\n77:- **Session OFF state pill**（同上\"未运行\"指示）：`Type=Rectangle, Color=Black, Tag=Line` —— Neutral outline，跟 N/A pill / CapabilityTag 共用 outline 风格\n90:- **Axes**: `icon` (right / left / loading / no) × `style` (filling / ghost / rimless) × `color` (gray 1 / green / orange / red) × `status` (default / loading / hover / disable) × `radius` × `fixed width`\n92:- **Code mapping**: `Button` (status: approved)\n98:- **Action buttons in table rows** (operator console)：`style=ghost`，颜色由 row state 决定 —— `gray 1` (Open GUI 中性), `red` (Stop / Remove destructive), `green` (Start)\n99:- **Modal destructive button**：`style=filling, color=red, status=default`\n100:- **Modal cancel button**：`style=ghost, color=gray 1, status=default`\n186:- **Axes**（2026-06-11 live 实测刷新，原 theme×status 记录过期）: `theme` (dark/light) × `form` (**pop confirm / dialog / slide / alert**) × `type` (warning / secondary warning / error / info / none / **success**) + BOOLEAN **`closable`** + SLOT `Notification_content`\n188:- ⚠️ 2026-06-12 Figma↔code 原子同步进行中（type 改名 secondary warning→danger / none→default，见 STATUS v0.10.0）——用前以 live probe `componentPropertyDefinitions` 为准\n195:- **Destructive 二次确认 modal**（Remove on-air layer / Stop In-Out / 删除 session 等）：用 `theme=dark, status=pop confirm`。\n203:- `importComponentByKeyAsync('23535120…')` 取的是 **SET** → 用 **`importComponentSetByKeyAsync`** 拿 set，再从 `set.children` 按名 `theme=dark, status=pop confirm` `createInstance()`。\n216:[Omitted long matching line]\n220:### Message ⟨prompt / 提示消息 / status line / 顶部瞬时消息⟩\n224:- **Axes**: `status` (success / info / error / warning) × `size` (L / M)\n235:- **背景**：`Message` 只有 `status × size` 两轴（同族 `Notification` 才有 theme 轴），所以它落在深色界面上会呈浅色。V4-2333 Config-T 走查连续两轮把这条列为「待裁定的疑似缺口」，轮十五 owner 拍板 **不立**。\n237:[Omitted long matching line]\n243:- **Axes**: `dark theme` × `status` × `enable` × `UX` × `size` × `feature`\n251:- **Search field**（filter bar 搜索 PID/Object ID）：`dark theme=on, status=default, UX=default, size=M, feature=no`\n320: （曾经每个 section 各自 prepend 一条 + Sign out 前再一条 = 4 条，2026-07-30 修正。）\n321:- 几何：panel `gap 4 / padding 4 4 8 / radius 12 / bg ux/grey/grey-11 #262626 / L3 shadow / 无 border`；\n337:- **Code mapping**: `Table` (status: approved)\n359:- **Code mapping**: `Pagination` (status: approved)\n377:- **Axes**: `Type` (Label & Input / Label & Selector / Label & Textarea / Label & Radio / Label & checkbox / Label & Switch) × `Layout` (2 lines / 1 line / 1 line & Right) × `Theme` (Dark / Light) × `Label Width` (Dynamic / 200 px / 120 px) × `Status` (Normal / Error)\n379:- **Code mapping**: `FormItem` (status: approved)\n382:表单行容器 (form-input)：包裹任意表单控件（Input / Select / Textarea / Radio / CheckBox / Switch）并统一加 label、必填星号、错误/提示文案、标签宽度与单/双行对齐。控件放 default slot，label 走 `label`、必填走 `required`、报错走 `error`（或 `status=Error`）、提示走 `hint`、对齐走 `labelWidth` / `layout`。**别用 `<label>` + 控件 + 红字 `<div>` 手拼表单行。**\n388:- **校验错误态**：`Status=Error`（或传 `error` 文案）—— 错误消息用 `--red`；**label 在错误态仍保持灰色**（CANONICAL-019）\n411:- **Axes**: `dark theme` (on / off) × `status` (off / on / some) × `enable` (yes / no)\n413:- **Code mapping**: `CheckBox` (status: approved)\n416:多选 toggle（一组选项里独立勾选 0..N 项）。`status` 三态含 `some`（半选/indeterminate），用于 select-all 父项反映子项部分勾选。\n419:- **多选 checklist**：`status=on/off, enable=yes` —— 一组可独立勾选的项，每项 v-model 各自管理\n420:- **Select-all 父项（半选）**：父 checkbox `status=some` —— 子项全选→`on`、全不选→`off`、部分→`some`，半选画 `action/minus` 横杠（不是对勾）\n421:- **策略锁定项**：`enable=no`（可叠加 `status=some`）—— 不可改的项呈禁用，仍显示当前勾选/半选结果\n433:- **Axes**: `dark theme` (on / off) × `status` (off / on) × `enable` (yes / no)\n435:- **Code mapping**: `Radio` (status: approved)\n438:互斥单选（一组里只能选中 1 项）。单个 `Radio` 是独立控件，二态 `status`（off/on），无半选；互斥由消费方维护（base `select()` 只 emit `true`，radio 不能自取消）。\n\n[Showing results with pagination = limit: 40]"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"3d29713f-a3a1-49c0-81c7-691c9692eb8c","timestamp":"2026-08-25T10:23:33.585Z","tool_use_result":{"mode":"content","numFiles":0,"filenames":[],"content":"27:## Status legend\n64:- **Code mapping**: `Badge` (status: approved)\n67:状态/计数指示器 (status pill)。最常用于 row-level INPUT/OUTPUT 状态显示。\n70:- **Status pill**（INPUT/OUTPUT 列）：`Type=Rectangle, Color=Red/Green/Black, Tag=Filled` —— Live=Red, Preview=Green, Inactive=Black\n75:- **Top-bar status counters**（\"8 Live\" / \"12 Previewing\" / \"19 Total Sessions\"）：同状态色 mapping，文本覆盖为 \"数字 + 标签\"\n76:[Omitted long matching line]\n77:- **Session OFF state pill**（同上\"未运行\"指示）：`Type=Rectangle, Color=Black, Tag=Line` —— Neutral outline，跟 N/A pill / CapabilityTag 共用 outline 风格\n90:- **Axes**: `icon` (right / left / loading / no) × `style` (filling / ghost / rimless) × `color` (gray 1 / green / orange / red) × `status` (default / loading / hover / disable) × `radius` × `fixed width`\n92:- **Code mapping**: `Button` (status: approved)\n98:- **Action buttons in table rows** (operator console)：`style=ghost`，颜色由 row state 决定 —— `gray 1` (Open GUI 中性), `red` (Stop / Remove destructive), `green` (Start)\n99:- **Modal destructive button**：`style=filling, color=red, status=default`\n100:- **Modal cancel button**：`style=ghost, color=gray 1, status=default`\n186:- **Axes**（2026-06-11 live 实测刷新，原 theme×status 记录过期）: `theme` (dark/light) × `form` (**pop confirm / dialog / slide / alert**) × `type` (warning / secondary warning / error / info / none / **success**) + BOOLEAN **`closable`** + SLOT `Notification_content`\n188:- ⚠️ 2026-06-12 Figma↔code 原子同步进行中（type 改名 secondary warning→danger / none→default，见 STATUS v0.10.0）——用前以 live probe `componentPropertyDefinitions` 为准\n195:- **Destructive 二次确认 modal**（Remove on-air layer / Stop In-Out / 删除 session 等）：用 `theme=dark, status=pop confirm`。\n203:- `importComponentByKeyAsync('23535120…')` 取的是 **SET** → 用 **`importComponentSetByKeyAsync`** 拿 set，再从 `set.children` 按名 `theme=dark, status=pop confirm` `createInstance()`。\n216:[Omitted long matching line]\n220:### Message ⟨prompt / 提示消息 / status line / 顶部瞬时消息⟩\n224:- **Axes**: `status` (success / info / error / warning) × `size` (L / M)\n235:- **背景**：`Message` 只有 `status × size` 两轴（同族 `Notification` 才有 theme 轴），所以它落在深色界面上会呈浅色。V4-2333 Config-T 走查连续两轮把这条列为「待裁定的疑似缺口」，轮十五 owner 拍板 **不立**。\n237:[Omitted long matching line]\n243:- **Axes**: `dark theme` × `status` × `enable` × `UX` × `size` × `feature`\n251:- **Search field**（filter bar 搜索 PID/Object ID）：`dark theme=on, status=default, UX=default, size=M, feature=no`\n320: （曾经每个 section 各自 prepend 一条 + Sign out 前再一条 = 4 条，2026-07-30 修正。）\n321:- 几何：panel `gap 4 / padding 4 4 8 / radius 12 / bg ux/grey/grey-11 #262626 / L3 shadow / 无 border`；\n337:- **Code mapping**: `Table` (status: approved)\n359:- **Code mapping**: `Pagination` (status: approved)\n377:- **Axes**: `Type` (Label & Input / Label & Selector / Label & Textarea / Label & Radio / Label & checkbox / Label & Switch) × `Layout` (2 lines / 1 line / 1 line & Right) × `Theme` (Dark / Light) × `Label Width` (Dynamic / 200 px / 120 px) × `Status` (Normal / Error)\n379:- **Code mapping**: `FormItem` (status: approved)\n382:表单行容器 (form-input)：包裹任意表单控件（Input / Select / Textarea / Radio / CheckBox / Switch）并统一加 label、必填星号、错误/提示文案、标签宽度与单/双行对齐。控件放 default slot，label 走 `label`、必填走 `required`、报错走 `error`（或 `status=Error`）、提示走 `hint`、对齐走 `labelWidth` / `layout`。**别用 `<label>` + 控件 + 红字 `<div>` 手拼表单行。**\n388:- **校验错误态**：`Status=Error`（或传 `error` 文案）—— 错误消息用 `--red`；**label 在错误态仍保持灰色**（CANONICAL-019）\n411:- **Axes**: `dark theme` (on / off) × `status` (off / on / some) × `enable` (yes / no)\n413:- **Code mapping**: `CheckBox` (status: approved)\n416:多选 toggle（一组选项里独立勾选 0..N 项）。`status` 三态含 `some`（半选/indeterminate），用于 select-all 父项反映子项部分勾选。\n419:- **多选 checklist**：`status=on/off, enable=yes` —— 一组可独立勾选的项，每项 v-model 各自管理\n420:- **Select-all 父项（半选）**：父 checkbox `status=some` —— 子项全选→`on`、全不选→`off`、部分→`some`，半选画 `action/minus` 横杠（不是对勾）\n421:- **策略锁定项**：`enable=no`（可叠加 `status=some`）—— 不可改的项呈禁用，仍显示当前勾选/半选结果\n433:- **Axes**: `dark theme` (on / off) × `status` (off / on) × `enable` (yes / no)\n435:- **Code mapping**: `Radio` (status: approved)\n438:互斥单选（一组里只能选中 1 项）。单个 `Radio` 是独立控件，二态 `status`（off/on），无半选；互斥由消费方维护（base `select()` 只 emit `true`，radio 不能自取消）。","numLines":40,"totalLines":80,"appliedLimit":40}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJUBLKpYiocr34dgJo1","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01BrDD4NmebyuRfpUTmwQhAA","name":"Grep","input":{"pattern":"\"(name|figmaName)\": \"[^\"]*(Card|Panel|Collapse|Accordion|Container)[^\"]*\"","path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/figma-data/figma-to-code-mapping.json","output_mode":"content","-i":true,"head_limit":20},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":7218,"cache_read_input_tokens":257888,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":7218},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"837f1343-dee2-4196-81e2-ac613c384c45","timestamp":"2026-08-25T10:23:35.107Z","request_id":"req_011CePJU4yqPDEtPdLfSkzm4"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01BrDD4NmebyuRfpUTmwQhAA","type":"tool_result","content":"No matches found"}]},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"a44161a9-b4d7-422d-9e59-d1e77e6547ca","timestamp":"2026-08-25T10:23:35.131Z","tool_use_result":{"mode":"content","numFiles":0,"filenames":[],"content":"","numLines":0,"totalLines":0}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"ae5cf9f5-54b9-4c45-9851-380c78aa7a88","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"98a522ba-9972-4dff-85da-abf9876dc1d6","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":300,"estimated_tokens_delta":150,"uuid":"21be82f7-7e70-40fe-990b-d49f622315ec","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":350,"estimated_tokens_delta":50,"uuid":"a0d27f6e-b477-4b00-9cf7-7929d27b8b38","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":450,"estimated_tokens_delta":100,"uuid":"dfc7d33d-79fe-4774-bca8-30e5085228ea","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":550,"estimated_tokens_delta":100,"uuid":"e7567c90-ad13-4eaf-b354-c6db959b7273","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":650,"estimated_tokens_delta":100,"uuid":"c64b0e83-19bd-4433-8936-0ccf25f1c9c9","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJWT4BfWJQ5gCaPhw5s","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"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"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":4472,"cache_read_input_tokens":265106,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":4472},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"d8ac0016-ef9f-4414-bc70-016b0c4e2143","timestamp":"2026-08-25T10:23:50.491Z","request_id":"req_011CePJWL4z9cyvroMB3ufcg"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJWT4BfWJQ5gCaPhw5s","type":"message","role":"assistant","content":[{"type":"text","text":"R2.1 点名的既有先例 = `playground/public/onboarding.html`（同类「独立自包含页面」）。看它怎么做壳，比我自创一套稳。"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":4472,"cache_read_input_tokens":265106,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":4472},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"ddf4551a-dc40-4dcc-8239-617d995faa66","timestamp":"2026-08-25T10:23:52.005Z","request_id":"req_011CePJWL4z9cyvroMB3ufcg"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CePJWT4BfWJQ5gCaPhw5s","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01Fb6TdgHLUQWfv5kMHBQJwZ","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/playground/public/onboarding.html","limit":110},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":4472,"cache_read_input_tokens":265106,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":4472},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"d3b5e52a-d5e0-4374-99a1-74f193337f44","timestamp":"2026-08-25T10:23:53.154Z","request_id":"req_011CePJWL4z9cyvroMB3ufcg"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01Fb6TdgHLUQWfv5kMHBQJwZ","type":"tool_result","content":"1\t<!doctype html>\n2\t<meta charset=\"utf-8\">\n3\t<meta name=\"viewport\" content=\"width=device-width, initial-scale=1\">\n4\t<title>跟 Claude 怎么说 —— 已搬进文档站\n5\t\n6\t\n7\t\n8\t\n14\t\n15\t

这一页已经搬进文档站，成了左侧「上手」组里的一页。正在跳转……

\n16\t

手动打开 →

\n17\t\n18\t\n\n\n```\n\n一句总结：**能从活源实测的我都实测了；不能实测的（宿主范式帧、机械闸）我标了未满足，没替它们打勾。** 落地前需要你拍的三件事：M11 那个不存在的 `--text-warning`、英雄数字要不要超过 24px 字阶、以及图内 tooltip 用 DS Tooltip 还是照 canonical 留 ECharts 默认（D2）。"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":2414,"cache_read_input_tokens":284327,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2414},"output_tokens":5,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","uuid":"d2c4f8e3-d961-4b68-ab8c-dc526dc2d60e","timestamp":"2026-08-25T10:34:46.352Z","request_id":"req_011CePJhBcoSxi9qfXP8ptBU"} {"is_error":false,"duration_api_ms":1145527,"num_turns":62,"stop_reason":"end_turn","session_id":"5c40dad0-5330-46a0-b062-b355b0d3aedd","total_cost_usd":8.0191405,"usage":{"input_tokens":70,"cache_creation_input_tokens":261642,"cache_read_input_tokens":6575391,"output_tokens":84587,"output_tokens_details":{"thinking_tokens":39292},"server_tool_use":{"web_search_requests":0,"web_fetch_requests":0},"service_tier":"standard","cache_creation":{"ephemeral_1h_input_tokens":261642,"ephemeral_5m_input_tokens":0},"inference_geo":"not_available","iterations":[{"input_tokens":2,"output_tokens":46961,"cache_read_input_tokens":284327,"cache_creation_input_tokens":2414,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2414},"type":"message"}],"speed":"standard"},"modelUsage":{"claude-opus-5":{"inputTokens":70,"outputTokens":84587,"cacheReadInputTokens":6575391,"cacheCreationInputTokens":261642,"webSearchRequests":0,"costUSD":8.0191405,"contextWindow":1000000,"maxOutputTokens":64000,"canonicalModel":"claude-opus-5","provider":"firstParty"}},"permission_denials":[],"terminal_reason":"completed","fast_mode_state":"off","subagent_stats":{"spawned":0,"requested":{"background":0,"foreground":0,"unset":0},"started_in_background":0,"max_depth":0,"spawned_by_subagents":0,"completed":0,"failed":0,"killed":{"parent":0,"user":0,"system":0},"refused":{"depth_limit":0,"concurrency_limit":0,"budget":0},"by_type":{}},"subtype":"success","api_error_status":null,"result":"onboarding 链路走完了（L-core 四份 + AGENTS 硬规则/Onboarding Gate + code-conventions 起手必读段 + domain-tvu + design-process 的两个起手 Gate + 相关 R-rule）。下面先交出 M48 要求的起手清单，再给文件。\n\n## R7 intent + M22\n\n**intent classified as 场景 3.2**（greenfield 单页 dashboard，用 TVU 构建）· Task Entry Mode **US-2**。\n\n一处必须说明的判据冲突：你说的是「为 **已有产品** TVU SaaS Dashboard 新增页面」（本来指向场景 2.1），但同时显式说「**用 TVU 设计系统**」，且交付物是独立单文件、不进那个仓库。宿主 surface 的 canonical 范式帧（M17 要求实测的那张）在本 session 拿不到——`tvu-saas-dashboard` 只有 `.claude/` 在可访问范围内。⇒ 我按「视觉真源 = TVU 库」走，**几何取值全部取自 DS 活源**；落地进那个产品前，M17 要求的「同类控件同宽 / 动作按钮右缘对齐 / 行高」三类仍需拿宿主范式帧复核一次。这是声明过的假设，不是默认。\n\nM22：brief 无 design-direction 类信号词（纯 element 清单），不触发。\n\n## M48 起手 rule-coverage 清单\n\n| 命中 | 怎么落地 |\n|---|---|\n| **FIGMA_AS_SOT #0** | 所有几何/颜色取自 DS 活源；无一处「code 反向要求改 Figma」 |\n| **硬规则 #4** 颜色硬编码=bug | 页面 CSS 零 hex；token 块是 `src/tokens/variables.css` **逐字副本**（非手抄色值，R2.1 要求） |\n| **硬规则 #3** 不造未登记 variant | 未新增任何 prop/variant/status 轴 |\n| **硬规则 #6** canonical 作 SoT | 镜像 `src/canonical/*` + 其 base，未取 `src/components/*` 的私有形态 |\n| **R0** Phase 0 mapping | 见下表 |\n| **R3** 无构建链 → 手写 1:1 mirror canonical | Chart/TabList/TabItem/Badge/Button/Tooltip 逐条抄实测值 |\n| **R13** affordance trace | 见下 3 行 |\n| **R14** layout primitive | 页面 grid、行 flex；唯一 `absolute` = chart tooltip 浮层，已就地注明理由 |\n| **R15** library-first | 每个元素先查 canonical + catalog；gap 标 `LIBRARY GAP` |\n| **R16** 产品 UI 字符串 | 全部走 `const T = {...}` 单源、全英单语；注释中文 |\n| **R9** 静态→交互补全 | hover / focus-visible / disabled / active 四态齐 |\n| **R2.1** 独立分享页同样受约束 | 深色为默认、`--sp-*`/`--r-*`/字阶配对、断点取 `--bp-*` 值集 |\n| **domain M11** trend 双层信号 | ↓绿改善 / ↑橙恶化 / 无icon中性，阈值 ±1.0%，三层映射表进说明面板 |\n| **domain M3** 红=Live | 恶化用 `--orange` **不用 `--red`**（红在本域是 Live） |\n| **domain Persona** | CFO（3 秒拿方向）+ SRE（数据新鲜度 T-1 行） |\n| **M16** 默认值必评估 | 默认 30D + 聚合粒度随区间切；理由写在下方 |\n| **M17**（泛化版） | ⚠️ **未满足**：宿主范式帧不可达，已声明 |\n| **M48「机械命中项必附 gate 输出」** | ⚠️ **未满足**：本 session Bash 停用，`audit:consumer-code` / `audit:no-hardcoded-design-tokens` **一条没跑**。我不给这几项打勾 |\n| **R23** 受限容器溢出 | 不触发（无固定宽 × 长度不可控内容） |\n| **R19** selected 3 层 | 不适用：无自建 selected 行；range 的 active 态照 `TabItem` Figma 真值，不改写成 rail+fill |\n\n## R0 Phase 0 mapping\n\n| Element | Figma / catalog | Code 活源 | 状态 |\n|---|---|---|---|\n| 时间范围切换 | `Tab List` + `Tab/Item`（Fill=Filled） | `canonical/TabList.vue` → `components/Tab/*.vue` | ✅ 1:1 抄 |\n| 涨跌 chip | `Badge`（Type=Rectangle, Tag=Line, Color=Green/Orange/Neutral） | `canonical/Badge.vue` | ✅ 1:1 抄 |\n| 折叠按钮 / 导出 | `Button/dark M`（S rimless / M ghost, color=gray 1） | `components/Button/Button.vue` `PALETTE_SPEC`+`SIZE_GEOMETRY` | ✅ 1:1 抄 |\n| 趋势图 | `Chart`（type=line） | `canonical/Chart.vue` → `build-chart-option.ts` + `use-chart-tokens.ts` | 🟡 **ECharts 不可用**（单文件禁 CDN）→ 按 R3 手写 SVG 镜像其视觉契约 |\n| 图 hover 提示 | `Tooltips` | `components/Tooltip/Tooltip.vue` | 🟡 canonical Chart 不给 tooltip 定样式（ECharts 默认白底）→ 我改用 `Tooltip.vue` dark 变体 token，**显式偏离** |\n| ↑↓ / 展开折叠 / 公式 / info 图标 | `icon/Arrow/Up·Down·Double up·Double down` · `icon/Edit/calculate` · `icon/Message/Info 1` | `src/icons/catalog/generated/{arrow,edit,message}.ts` | ✅ 逐字取 path + nodeId |\n| 卡片 / 面板外壳 | catalog + `figma-to-code-mapping.json` 扫 card/panel/collapse/accordion/container/surface/tile/stat/kpi → **全 miss** | — | ⚠️ 真 gap → 复用 `Chart.vue` 容器实测三值（`--bg-layer3` / `--r-m` / `--sp-m`），标 `LIBRARY GAP` |\n\n## R13 三行 trace\n\n```\n1. Affordance: directional-vertical (intent: 单位成本环比方向指示 + 说明面板展开/折叠)\n2. Vocabulary scan: [arrow/up, arrow/down, arrow/double-up, arrow/double-down, arrow/dropdown,\n arrow/sorting, arrow/updown, arrow/switch (src/icons/catalog/generated/arrow.ts 全 16 项)]\n3. Chosen: arrow/down + arrow/up = M11 指定的 ↓↑ 双层信号；arrow/double-up (1149:23074) =\n 已展开(点击折叠) · arrow/double-down (1149:23106) = 已折叠(点击展开)，语义逐字取自\n figma-component-catalog §已知具体 icon 表。另 edit/calculate (2352:15654) 作「怎么算出来的」\n 面板标题图标，message/info-1 (1168:23662) 作数据新鲜度提示（info-2 内嵌 #3892F3 硬编码，不取）。\n```\n\n## 顺手查出来的 5 件事（都已实证，不是推断）\n\n1. **`domain-tvu.md` M11 点名的 token `--text-warning` 在 `src/tokens/variables.css` 不存在**（全文件 `warning` 只命中 `--prompt-warning-text`）。我按最近语义绑 `var(--orange)`（M11 描述的「橙红」，且 `--prompt-warning-text` 与其 dark 值同为 `#f68512`）。**没造新 token、没写 hex**——但 M11 的 token 引用那一列需要 owner 订正。\n2. **DS 字阶上限是 24px**（`--font-size-large-title-24`），所以英雄数字只能到 24。CFO persona 要求「3 秒拿到方向」，通常英雄数字会到 32/40。要更大就得新增 token → owner 拍。我没越界。\n3. **`canonical/TabItem.vue` 有一个键盘可达性缺口**：`tabindex` 非 active 项恒为 `-1`，而 `TabItem`/`TabList` 都没有方向键 roving（`onKeydown` 只处理 Enter/Space）⇒ 非选中 tab 键盘到不了。本文件按 P3(WCAG) 补了 ←→ roving 并标注，DS 侧建议单独立项。\n4. **`code-conventions.md` R2.1 点名的「当前实例」`playground/public/onboarding.html` 已经不是那种页面了**——2026-08-13 起它只剩 16 行重定向壳，没有任何 DS 样式。R2.1 那句「当前实例」已 stale。\n5. **本 session 一条闸都没跑**（Bash 停用）。落地前至少要跑 `pnpm audit:no-hardcoded-design-tokens`（扫描面含 `playground/public/**/*.html`）+ `pnpm audit:consumer-code`（R14/R19/R9 probe）。**我不替它们打勾。**\n\n## 交付物说明\n\n- 深色是 DS 默认（`:root`）；浅色只靠 ``，页面**不放主题开关**，也不并排展示两套主题。\n- token 块是 `src/tokens/variables.css` **逐字副本**，唯一删减 = `@font-face 'Digital Numbers'`（指向 `./fonts/*`，独立文件旁不存在；`--font-family-clock` 变量保留、未使用）。真正的消费路径仍是 `` 到 `tvu-tokens.css` / npm `dist/style.css`——单文件不引外部资源是你的硬约束，我在文件头注明了。\n- 三个区间刻意呈现 M11 的**三种态**：7D `+2.9%`（↑橙 恶化）/ 30D `-12.0%`（↓绿 改善）/ 90D `-0.5%`（±1% 内 无 icon 中性）。数字跨区间自洽：7D 就是 30D 序列的最后 7 天，均值算得出来。\n- 默认 30D（M16 评估）：月度对账节奏 + 90D 会把这一轮改善稀释掉、7D 又只看得到尾部回升。12M 禁用并给出理由（需 12 个完整账期、现有 9 个），顺带把 R9 的 disabled 态落在一个真实状态上而不是摆样子。\n- 未纳入（明确的 scope 边界，不是漏）：TopBar / Breadcrumb 等产品外壳——那是宿主 surface 的范式，M17 说不能拿别处的参考图代替，而它的范式帧我这轮拿不到。\n\n```html\n\n\n\n\n\nCost per Token Trend · TVU SaaS Dashboard\n\n\n\n\n\n\n\n
\n\n \n
\n
\n

\n

\n
\n\n
\n \n
\n
\n
\n\n \n \n
\n
\n\n \n
\n

Period overview

\n\n
\n

\n
\n

\n \n \n
\n

\n
\n\n
\n

\n

\n

\n
\n\n
\n

\n

\n

\n
\n\n
\n

\n

\n

\n
\n
\n\n
\n\n \n
\n
\n

\n \n
\n\n \n
\n \n
\n
\n\n
\n

\n
\n\n \n \n\n
\n
\n\n\n\n\n```\n\n一句总结：**能从活源实测的我都实测了；不能实测的（宿主范式帧、机械闸）我标了未满足，没替它们打勾。** 落地前需要你拍的三件事：M11 那个不存在的 `--text-warning`、英雄数字要不要超过 24px 字阶、以及图内 tooltip 用 DS Tooltip 还是照 canonical 留 ECharts 默认（D2）。","ttft_ms":18721,"ttft_stream_ms":4589,"time_to_request_ms":1049,"type":"result","duration_ms":1149520,"uuid":"8b7b018c-b388-4f2d-9e48-e995807f9f9b"}