{"type":"system","subtype":"hook_started","hook_id":"c8fafce1-26d1-43e6-8c7d-55d4163a2a54","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"dfb90c14-e983-4f25-b0e8-5ebd30b57939","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"hook_started","hook_id":"73b6c969-34c8-4c8e-8f23-a72d181abc36","hook_name":"SessionStart:startup","hook_event":"SessionStart","uuid":"d9ebbb16-88ee-471b-a111-92b7e163b602","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"hook_response","hook_id":"c8fafce1-26d1-43e6-8c7d-55d4163a2a54","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":"b2e3799e-1e81-4bc2-8832-f147279e19f5","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"hook_response","hook_id":"73b6c969-34c8-4c8e-8f23-a72d181abc36","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":"100a6ed0-2f7d-404b-b45b-7e13ae733b0a","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"init","cwd":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d","session_id":"9d9a4203-766d-4177-a3db-def00914db27","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":"2a950bab-5fb1-4598-ad5c-6e704a0e716b","memory_paths":{"auto":"/Users/nancy/.claude/projects/-Users-nancy-Documents-AICoding-VS-Code-tvu-design-system/memory/"},"messaging_socket_path":"/tmp/cc-socks/41915.sock","fast_mode_state":"off"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"cd212580-1e62-441d-a39f-7d04ba0beee0","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"bc1ba9b9-b268-4243-99eb-d6f04c103eb4","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":200,"estimated_tokens_delta":50,"uuid":"bc170a59-d45a-4ca3-ad7e-a12cc479a2ac","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":300,"estimated_tokens_delta":100,"uuid":"dd2fabb9-ad6a-4b17-bbd1-a758a07b0307","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":450,"estimated_tokens_delta":150,"uuid":"3d86bb33-a5c9-4822-a9a4-5ffe594c0d57","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWeVNTQ8pVczKvYPBBT","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAIS8wwKpgEIERgCKkDStARHE9HErO9eUH7RflwPVy+b7gky9GriVqnKALVmWSLMpaulRQsWx4fbpT1KmA6nNtmLF5wki1r6dh9oWc3WMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAcSJudQGsAECEgxwPXVLKopNybDjq6UaDN/npUDMY7N6FX8TJSIws7erkAVkqCG8Z82tEeNg+flqC8WPxqgj+zgURbrImojalRFlvAQHTnol07WAcv8JKvkK2Myz7bDK1q4I+V2vKlCPTwhd6t8vuR8oKvzek1Alma77fKK/U6c4KDg0SaSr3zmyX5aNfDEbRCeK7YjGsLBiP0eNNUZCIWnpdC4LmqLsKuvf8XRClHeiHkSPNy270nwhrZo6nK4xiSMhjM5zrE1SaT070tZevtLNF2rUhqKiYdtO2kLnbk9cabXBKEC07AfNscN0WlitPT0RZKkIJn0QreRjNtcuFPbu2axbRU7rIsnntFSX9j+HQepjWek0NxeMdAHEWoDbIy7xVnRjGPWgcWgta4dLvX0cpXCvWVJDFmYU95ccz8d7Gwzst618C5JBbPQPVQLzYrDFLFenP2CCXz95cnfd6TiG/ZoouLG+admMMWsXY91mbe5gHjLrX5KephcG3WYiBwJSai/kOrJS3XbDbBDjC+hZlGKJ4Wj+7mDFUx+1nvNjPMqjHAHOQTj3bcG1HRYv50nvZT66OBD0Z4BDOmhAtnqitJ8zZKc+LTKHHdWDFRjMYQscCbSgXDg5MKz1RJGvU+6SMazOmvCDHaZpRcgY/hFxYRcPnCk5J9I55bMZqlhrTzSrsO5ZGsfgTRRs0lEo0BZI2smqV06UO5rHAbvzZu1g7M73W1f80ZYWRbPVUT8fEVtCSwR4xI7IVoDYqrcsvIhEyUY92JZP9bgIgujf6naNtSUgg+AmBHHD3SwltBTghJ94ofCbzcnCf7IQeZ1V/CLxAvPekIoEaoK0gbpGRS+xKoDAIOI6gvGhFvfgSS+EPDx+Oy0Kn5tPjQ1Ye/GMZw/w5DZlFaNMSxAq3xS4JQhh1vj/PayVzRrRdiplrQX+KIYC2Jcshn8rhh2GQ1wX9BByrY4ai6yz+fuGCDi7pG4/lEEy/jFQCqp6eEf0cZv2m7v4kBq3SIeyxhCg2UJEml1vckDvZ4lAz0BRTPIKp6bvZKUACiwLP5M2/hLuwSml07OTVNXhi6aPqCJ2ND9YnERMkg6Flia3sa7JjP/GltszTk0zsDLCX0iTz2fcCt9eMiAc40YdvzAjFjLEgyMRCgJVq4uhxp0iNWWGLbcIPQo2WG1561pJJgDHJYehGDv/+wOLzGWhbipG1hneSCFDLcy2DCI7/uEtWXORymF9XzlhAKNk9Sg4qzjAcm6rU/ruDR/olsZLzv2JpYm7sNr7rLa3G9ZKjCI5gmKnlN+CoWdWVbGK6P9R3bQzLQKmg6g0S4eZh/VZTwlanzCqBZs3PuUIIFZa1WNGCZpFBVUpKbUrk4EdDsBgiuk50p6rdjgoor6Kdu/xD2U4S7tL4FLcNtw6mOzI7BNN/dgORoryhwn0Jkzjgo6l87a5kg66a+g8WoRZyRtmG5rV7ztrXk06pLnzMwufdtYRnwW9Y6S8LZzYLQfiX4S0rllXPxjyIvo7a/ON4jOqb5G8/BYjA3eBZB+yqomkMzX6Oas7dl2hPzWe+D90fQd+ue6LBAFyUbXkMC1YIUdKq5CCyPi0nm/4sHSWAY1lZ69hpKe8xNii2DCYCawZMEBxCOcfABn57WWvxZg4Jdlivf1mRAfHxHbh1Mj8giTFUaCKYzTwM49cOvAxAeR49iiiEUyL4w5fF8R1Gk8J9XJo0z01vQrdEBGPo2xFO7u9WCLr8WgSwGmFXWF8xg+kdq3iZYOve9/BvBBojq2hCPHy+iLc5hanwxmspDmh4jamL1kBFrZzAU7AA7npUwNadveLOtzpoWKLOstdJsxk3X+Wu9qHqwPI918LqOabxqvFCYBDxhdQ/nFF1i+9FRM52rKr6Xq8CZZ9QGOjCKAQALhS77XMAtBZwQfManx+isf2LCciZCiI60En8AvcoPP9LZqTJGMUeF2NXYZ1heh58cW7sf7gv1d2tw+4yokLGAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":59344,"cache_read_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":59344},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"27b0425a-4b08-46f9-a9e3-4afc7d57bb03","timestamp":"2026-08-26T01:43:33.290Z","request_id":"req_011CeQWeTJSRi993WaGjkAGC"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWeVNTQ8pVczKvYPBBT","type":"message","role":"assistant","content":[{"type":"text","text":"我先按项目 onboarding 链路读必读文档,再拿真实 TVU token 出稿。"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":59344,"cache_read_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":59344},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"47a5f69e-2264-41f8-a837-6d24e9d3cbc8","timestamp":"2026-08-26T01:43:33.971Z","request_id":"req_011CeQWeTJSRi993WaGjkAGC"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWeVNTQ8pVczKvYPBBT","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01KXE5jMoPNRgbYqKwHtDsiE","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":59344,"cache_read_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":59344},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"bdbc7e90-428d-4fab-b1b2-9ebdaca385d6","timestamp":"2026-08-26T01:43:35.355Z","request_id":"req_011CeQWeTJSRi993WaGjkAGC"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWeVNTQ8pVczKvYPBBT","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01SKsRdLWK2H9v5TKHXRKtHr","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":59344,"cache_read_input_tokens":0,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":59344},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"86032b33-e9a1-4476-accc-4425c46e3c23","timestamp":"2026-08-26T01:43:35.359Z","request_id":"req_011CeQWeTJSRi993WaGjkAGC"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01SKsRdLWK2H9v5TKHXRKtHr","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":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"a49805f9-917b-42f7-b290-39cd471006ca","timestamp":"2026-08-26T01:43:35.361Z","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_01KXE5jMoPNRgbYqKwHtDsiE","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":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"6823cc22-8a13-4410-a0d7-b431f3cb5b80","timestamp":"2026-08-26T01:43:35.362Z","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":"rate_limit_event","rate_limit_info":{"status":"allowed","resetsAt":1787726400,"rateLimitType":"five_hour","overageStatus":"rejected","overageDisabledReason":"out_of_credits","isUsingOverage":false},"uuid":"ed4dc2fd-e8dd-4717-986f-4d9de6317117","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"e9a2cf50-29e3-4d3c-90c3-70b3999384ca","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":88,"estimated_tokens_delta":38,"uuid":"8a4b6217-08cc-44a5-a105-18ca415fea80","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWfPTHmeREbzekS7mWf","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAIS1wIKpgEIERgCKkAnrCeKL4TdZLzDWwbJ6nOj8wRd+mXt6/+0s27e1fAlrCMTCjtfMkljCpbnhnr+8gYrCA3OOnaKmCgJ82/0ZvkvMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAcqJudQGsAECEgxsssNE5UCoEH+pEzkaDDZgK8R/Goh7ksVflCIwvh9baEUpuUv2PAfZXVN5TUiYHlcwYvbtTfOKStAR8EOxgBC4oxPYBsr0mCHJXMxtKl6VfgcJmV89LAa/XC0MnYQjrVjqHRMzgxCZct+Kp4TeMPN5NTejibJwcEqco4TXo8mEjavKR0/n2Xecnv6/yeYsG5TCMCbGkKq951J2VntfQpd5jCD05xypzO4tEwNDGAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":11963,"cache_read_input_tokens":59344,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":11963},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"bfed3db8-2015-44fb-bf4b-80b86ee0e33e","timestamp":"2026-08-26T01:43:38.615Z","request_id":"req_011CeQWfMaRefQ41fsu2xzKh"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWfPTHmeREbzekS7mWf","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_015VQgudD8pwCXdxp1WEgqr7","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":11963,"cache_read_input_tokens":59344,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":11963},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"8956a147-b41b-49d6-8313-12e525e71497","timestamp":"2026-08-26T01:43:39.101Z","request_id":"req_011CeQWfMaRefQ41fsu2xzKh"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_015VQgudD8pwCXdxp1WEgqr7","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":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"373f937d-6143-4abc-a8b7-568276ffea8e","timestamp":"2026-08-26T01:43:40.304Z","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":"0b759018-194d-4fd0-9d7c-ac65b1b320f1","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":151,"estimated_tokens_delta":101,"uuid":"30bf4256-861a-430d-bead-15148d5cca05","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWfkLeJy1WH64JrjaWe","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAIS0wQKpgEIERgCKkA8gk2YdPGyG0cv0elBZvKAeJVA47icedf4JdEiOiI5jN8ZI8p9II/aZcylIiHhRmjTDzAJI6cu8z/VRWb7FwK7Mg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAdCJudQGsAECEgyigLvRx/8y2v9JtQsaDDtmn3eO79t8rBOLZCIwJk57gA+ErfVuXolu8Aes3TTNOL9VJBNzYN6MjXPeSCzdKP0R3hEbz4RI1ReF9IgaKtkCQbcf28UUVIhDIPFPpDidncH6KamDq2GTXfcXk58AhSm9WrBZ5g6GUh5voaj6HnXInKnjZ2uW3LH1+Avq4xgwijkjBmE0yfwreg5kbWMURlQ/uDfNQGUF2QO8kgodNfeBMPQj7LwNGbVwgV2Ivcot3z069CSyOEpvuWIMGgYBepmzjbfYZBO0b5UwYM7olmQGF9Mzmjmt4e+t64rHf0YNc+4d6XNo2CGy0+q82ydJuy/USHp/1zNw3NI+WY/6p/O6mfMPFn8BQQeniBREITVG/lAL6Rd1m7yaumJGK0hBDCJ/cnL3Bjn17isxBFnkwwZBG2Dc04Dd3eXFBTv/SIzWWexMOSS/i+m46deD3ZZt+B3L3W3pCkK/Q8fPREjLib3im5rs8rO6BI3b+10pO0x8XEqoQeFKEFXJZv3ZDKJDMmOjB/Hx2purGLANOiXVdMnwNqxm5ptBz6QFGAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":22684,"cache_read_input_tokens":71307,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":22684},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"48f0cf6b-444d-4b68-bdc2-c27e8ba6e0d3","timestamp":"2026-08-26T01:43:45.312Z","request_id":"req_011CeQWfhheGrsF6MYn8x1fP"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWfkLeJy1WH64JrjaWe","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_0113fYDy9ER5x7XXxAX6oDAG","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":22684,"cache_read_input_tokens":71307,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":22684},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"8e82383d-6539-4703-9612-7be3182b24a8","timestamp":"2026-08-26T01:43:46.557Z","request_id":"req_011CeQWfhheGrsF6MYn8x1fP"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWfkLeJy1WH64JrjaWe","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01P5Yq1MkPryLGuLLXxyU64B","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":22684,"cache_read_input_tokens":71307,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":22684},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"555892ef-bf2b-48e6-bde4-407beceae0ac","timestamp":"2026-08-26T01:43:46.560Z","request_id":"req_011CeQWfhheGrsF6MYn8x1fP"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_0113fYDy9ER5x7XXxAX6oDAG","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":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"e812e326-6830-43e0-91fe-304122d07a75","timestamp":"2026-08-26T01:43:46.566Z","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_01P5Yq1MkPryLGuLLXxyU64B","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":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"78e89199-7d8d-4a92-b1fd-77d37789d3e8","timestamp":"2026-08-26T01:43:47.610Z","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":"bdd53ff6-558e-4c7a-861c-b5aa56516565","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"3a6b39f1-e152-4c23-ad87-c8b8f9ee983b","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":350,"estimated_tokens_delta":200,"uuid":"74bdb2da-e716-47a3-9c1e-5e3936c69ca0","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWgGTsvA2tf7oH5a525","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAIS+gkKpgEIERgCKkAu6Xmm3yuptjILyS867XLDTFLcFoR/IFqkbpO5HsyiL9e2s3sNKtv6rNqZGVbSqEVTY8LszLs7SsmlB3Dl5MDFMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAduJudQGsAECEgxqzKxn+jPV80XV8OUaDKpwOjc9pYRg9wDtlyIwZ1LJNYEJhRIvOldKNgeiIxSTREJB4bzKvTTAAHp05pRMb8oxDVBzCLAbzpBr7v+DKoAID5l2UMKrb3X0jYnRlu6UAbhP+J12Wp72wDv9dzt95WZgbA80hjsFq35MC236s9vYDztCAH8rLeO2H+9KLGYuIt9uMf/H/VexqVzXp/y0AQuWJ5+qoflshFdWKwfR4jNDlEySOI0e/1v8ytxSXOsQ7VK7ZDdMZYVDD4SyCx9fNhCMZ1Qx9As525MjKiMMP2J4rWlj/lxxskX80+2fmRqEWBJmYUAViRI05mx7oA9FDyl/czqTpzdxS0jUttnGZdg59bwaOaszrw9xEc0GIQqfZJlRgeyLE1HnUnOv6ZuqN3d8POW4MWvDbwliaADCuRvbSaOB8xXMkNXMvlx+a3Y9PvwB8470RD8XcY+IbQ2KSDz/22FCAabbL0wDWkhs5VQd4f3fQl/NHMYaklABylbhRc+n5qd4v3D8JWwWHtIL64U5P4oXguo0rdHktf8bZsKccnnqRI/ZqE0wH0iPJaImeNUD5MUZjUsl68OGOM+7+nb0vSVtqbpatKzzDv3M+DBznzJLc4LF3WhAy6djj0Xkm/pTMN2otZh9SbnKCYwBt0zDo0M2q31e+mjL9VCN+nnLAFbzrd//OQpvcgbsVOfgy2IhzMQqR9arRikiUR2mK2AJipgELWauYQExOBcJgarFLMD/ePcT4DCAjsWxuVlKq/wX8fWbVYW+/zXN0oozJsF1VKCbP/Js7j/DS4GhcgOd1QG0S0SH1lnQAZ+wBjgVMqwlakhq9cSVY4plovuj1yw9oEpQHQrBU70udLgXMEi0swARIDheyYRnKz92+3uVVwH1ZghROjaaGM5fWTjUBigrKjpdgiVuGetP37+8PkSfU++cmM1RtSwRKNS8qWmFccwRfMKXG0dpWnvLDzeUYcdmhPewVdwm1SXw7iVRM1DW60NiB7eNQuC0+okNsMIhtuX+lOEQUwqot5/KCIcN3WwTU9sZetU6MCk3cayL/ueZxMIw+0V3Pc0+fEcuhb0AhuNYG51Vgmsm3e50jBkHZgYaJCfZgDJ4y+IMgmZED2KAM9Z8110m9cA5Sfkw95Xl/+Ppt7CUoLDaGl8EIgMd1x5c527UHJXLuSn225Dh86+SNgzvr23T1e4vcctsnhJcWbt8Y8TpYikud66n950npyrtYWUHx+yFHpXIFB1y7ujes5s71nDC8ZWO73VSWbJL/QymWhNB/hDTYYJJDpEEDGFMuSaA9CbhD+SqYvRPWLeC1/70o6NGXTsQ+bIJtyb7ETqR6FAgFoRLItHqeUGmKHX5yeVAXKL2vfhsquYv9+wc9n4z364CPJJdXzPryD1cJLhW+l5DMyKDJIyEGX5CXhQSmfUreLuTXkbzpw8ag/rpKiarSAZqDnQ+2hN0ic7+zhgB"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":28173,"cache_read_input_tokens":93991,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":28173},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"5d8dbe72-70ab-41e3-aadc-8ba044a04dc5","timestamp":"2026-08-26T01:43:55.939Z","request_id":"req_011CeQWgEEw69564wtZWpoZk"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWgGTsvA2tf7oH5a525","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01Kto3UKZPPKcMkx7MTcZ3Ai","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","limit":260},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":28173,"cache_read_input_tokens":93991,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":28173},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"efb04a7f-cbc7-4e44-a520-ad5533870434","timestamp":"2026-08-26T01:43:56.783Z","request_id":"req_011CeQWgEEw69564wtZWpoZk"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01Kto3UKZPPKcMkx7MTcZ3Ai","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` |\n201\t| **Build** | 具体落地点才 cat 文件内容 | `cat dist/icons/svg//__.svg`
`Read src/canonical/.vue` |\n202\t\n203\t### Why\n204\t\n205\teager 加载 ~50KB+ 库目录到 context 浪费 reasoning space。lazy 加载让 context 只保留当下任务相关的几十行。\n206\t\n207\t**额外收益**:lazy 模式下 AI 每次 grep query 都会显式输出 → 你能看到查询词是否系统性覆盖(catch \"Phase 0 查得不彻底\" 的 anti-pattern,正好和 ledger 异常启发式 `🟡→✅=0` 形成双重监控)。\n208\t\n209\t---\n210\t\n211\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"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"7099fff4-4602-4771-a080-285328cb7559","timestamp":"2026-08-26T01:43:56.788Z","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` |\n| **Build** | 具体落地点才 cat 文件内容 | `cat dist/icons/svg//__.svg`
`Read src/canonical/.vue` |\n\n### Why\n\neager 加载 ~50KB+ 库目录到 context 浪费 reasoning space。lazy 加载让 context 只保留当下任务相关的几十行。\n\n**额外收益**:lazy 模式下 AI 每次 grep query 都会显式输出 → 你能看到查询词是否系统性覆盖(catch \"Phase 0 查得不彻底\" 的 anti-pattern,正好和 ledger 异常启发式 `🟡→✅=0` 形成双重监控)。\n\n---\n\n## 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","numLines":260,"startLine":1,"totalLines":1528}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWgGTsvA2tf7oH5a525","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01B5e1oByLy6waccFPGsp3So","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/mockup-conventions.md","limit":160},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":28173,"cache_read_input_tokens":93991,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":28173},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"482a94cf-5f9f-43cc-9891-7800f768151d","timestamp":"2026-08-26T01:43:57.079Z","request_id":"req_011CeQWgEEw69564wtZWpoZk"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01B5e1oByLy6waccFPGsp3So","type":"tool_result","content":"1\t# Product Mockup Conventions(Path A — Figma)\n2\t\n3\t> 任何 AI 工具在 TVU 产品 Figma 文件里画 UX mockup 时**必须遵循的硬约束**。\n4\t> 项目级真源;不要在对话或工具私有 memory 里复刻规则。\n5\t>\n6\t> **作用域**:在 TVU 产品 Figma 文件(如 `Micro-Apps-20250923` 等)画产品页面 mockup。**不**作用于设计系统库本身的迭代。\n7\t>\n8\t> 🏗️ **本文件的结构不是随手长出来的** —— 分节顺序 / M-rule 编号归属 / 「写后必跑机检」为什么只在一处 / Legacy ID Map 为什么收拢 / 实证段为什么外移出规范体,是一次带审计(F1–F11 十一项发现)的整顿结果。**动结构前先读** [`docs/superpowers/specs/2026-06-25-mockup-conventions-restructure-design.md`](../superpowers/specs/2026-06-25-mockup-conventions-restructure-design.md),尤其 §0 owner 重定向那节(它定了「整顿」与「重写」的边界)。\n9\t\n10\t\n11\t> **本文件规则清单 —— 唯一真源**(机械核 `pnpm audit:rule-inventory`;scoped 与 lazy 加载按本清单挑,别处一律只放指针)\n12\t>\n13\t> M0 / M1 / M-COLOR / C1 / C2 / C3 / C4 / C5 / C6 / C7 / M23 / M23.0 / M23.12 / M23.14 / M23.16 / M23.17 / M23.18 / M23.8 / M24 / M-INTEGRITY / I1 / I2 / I3 / I4 / M29 / M23.6 / M23.9 / M23.10 / M23.11 / M23.7 / M31 / M-LIBRARY-HYGIENE / M32 / M32.1 / M32.2 / M32.3 / M32.4 / M32.5 / M32.6 / M33 / M35 / M36 / M36.1 / M37 / M38 / M-FONT / M-TXT-ICON-AUDIT / M39 / M40 / M41 / M45 / M45.1 / M44 / M43 / M43.2 / M42 / M42.2 / M42.3 / M46 / M47 / M47.2 / M-DISCIPLINE / M52 / M52.1 / M52.2 / M52.3 / M52.4\n14\t\n15\t\n16\t> ⚠️ **本清单从活源 rule heading 机械派生**(`scripts/lib/rule-ids.mjs` 的 `RULE_HEADING_RE`,与 `audit:rule-load-map` / `audit:rule-number-collision` / `rule:next` 同一份形态定义),⛔ 别手抄别处的版本、也别顺手排序(顺序 = 活源里的物理顺序,排序会当场触发闸)。它存在的理由不是给人读,而是给 `audit:rule-inventory` 的 S4「别处不得再枚举」一个分母 —— 2026-08-14 扩面当天就抓到**一个活源根本不存在的规则 id** 被两处文档当规则引用(字面留在 backlog / STATUS-CHANGELOG,不在规则文件里复述)。\n17\t>\n18\t> ⚠️ **已知盲区(共用正则的边界,如实登记)**:`## §M-LIFECYCLE`(`§` 开头,正则不抓)· `I5`/`I6`/`I7`(`#### M-INTEGRITY §I5…`,被折进 `M-INTEGRITY`)· H5 层的 `M23.18.1`/`M23.8.1`/`I1.1`。`audit:rule-load-map` 今天同样看不到它们。⛔ **扩正则或改这几处标题是独立子项,别顺手做** —— 改标题会动 `audit:stale-anchors` 的三百多条 rule-ref。\n19\t\n20\t---\n21\t\n22\t## 🤖 AI 读取指引(按需加载,避免全量吞)\n23\t\n24\t本文件 2600+ 行,**不要起手就全量 Read**。按下表只读起手必读段,具体 M-rule jump to 时再读:\n25\t\n26\t| 起手必读(任务前先吃这些) | 行段 |\n27\t|---|---|\n28\t| 本文件顶部 intro + §作用域 + §必读链路 + §真源 / 优先级 | §0–§2 |\n29\t| §Convention Priority Hierarchy + §Task Entry Modes + §Migrated Rules Pointer Index | §3–§5 |\n30\t| **§M48 Startup Rule-Coverage Self-Check(起手第一产出物,所有任务)** — 先列「本任务命中的 locked spec + active M-rule」清单再开建 | [`design-process.md` §M48](./design-process.md) |\n31\t| **§M49 Design Quality Contract(设计质量合同,所有产品设计任务)** — 先列 Baseline / Delta / Semantic / Feedback UI Inventory / UX / Simplicity / Content,再生成 deliverable | [`design-process.md` §M49](./design-process.md) |\n32\t| §M0 Phase 0 Element-to-Component Mapping(**所有任务前置**) | §M0 |\n33\t| **§M-DISCIPLINE Rule Execution(起手协议后必跑,所有任务)** — TodoWrite 把「读到的规则」物化成 checklist,防\"读了不执行\" | §M-DISCIPLINE |\n34\t| **§M-LIFECYCLE Mockup Edit Lifecycle Gate(任何 create/update/delete 任务)** — 操作前(I5/I6 probe)·后(conformance 机检)·走查 三时点必过 | §M-LIFECYCLE |\n35\t\n36\t| 触发后再读(按场景 jump,不预读) | 触发条件 |\n37\t|---|---|\n38\t| **加新规则前先要号:`pnpm rule:next <系列>`**(C / I / M / M32 等子系列 / Q / R)——号从 `origin/master` 算,**不看本地文件的最大号**。⚠️ 本地工作树是会过期的镜像:2026-08-11 PR #9 实证,分支分叉 62 天后按本地最大号编,把 master 上早已占用的 C5/C6·M32.2/M32.3·Q21–Q26 又用了一遍。拿号后三件事一起做:写正文 + 本表加触发行 + 核正文里引用的其它号。撞了由 `audit:rule-number-collision` 在 pre-commit/CI 拦并直接告诉你该改成几号。 | **要往任一规则真源(本文件 / `code-conventions.md` / `figma-technical-reference.md`)新增带编号的条目**时 |\n39\t| §M1 Top bar 公共基建 | 涉及产品顶栏时 |\n40\t| [`domain-tvu.md` §M17](./domain-tvu.md) **LCD 设置页 canonical 范式**(等高行 / 控件列右对齐 / 下向三角展开标记 / 底栏 `OK`+`Home`、返回上一级走左上角箭头;**取值与参考帧 id 在项目 repo** `TVU Pack/docs/specs/lcd-canonical-spec.md`)| **在背包设备 LCD(Touch Screen 文件)建或改任何设置页**时——起手先开 canonical 范式帧实测取值,禁照最近做过的某个 LCD 页凭印象仿写 |\n41\t| [`domain-tvu.md` §M17.1](./domain-tvu.md) **LCD 选项列表 canonical 范式**(绿框面板 + 当前值绿字 + 矢量选中标记 + **被编辑字段行加绿框、面板右对齐该行右缘并与之连成一体**;**取值与参考帧 id 同上,在项目 repo**)| **LCD 上任何「从枚举里选一个值」的交互**(下拉 / 选项列表 / 值选择器)时——禁自造下拉或让面板浮在半空无归属 |\n42\t| §M-COLOR (§C1/§C2/§C3/**§C4**/**§C5**/§C6/§C7) | 要填颜色 / icon fill / state color / **在某个产品文件里新建带颜色的元素**(§C6 先查该文件实际订阅的库)/ **新建文字节点**(§C7 文字样式 + 颜色双绑)/ **给注解 / 说明卡 / M23 类交付卡配色**(§C4:品牌色与 M23 annotation accent **不能混用**)时——**§C3 与 §C5 必须一起读**:§C3 只判命名空间合法性,§C5 判优先级,`UX/Grey/grey-N` 在 §C3 合法但在 §C5 只是 fallback,机检按 §C5 判 |\n43\t\n45\t| §M-INTEGRITY (§I1/§I2/§I3/§I4/§I5/§I6/§I7) | **任何编辑 confirmed 后(M-DISCIPLINE.SYNC)** / mockup 完成自检 / **section 重叠(I2:改 bounds 后 **+ 每次收尾固定跑一次**;含嵌套子 Section 逐层扫;须分报 `sectionInternalOverlap` / `sectionToSectionOverlap` 两个数)** / sibling 布局 / children wrap / element parent 归属 / 替换既有节点前 diff(I5) / **create·move·place 前 probe 目标位防叠加(I6)** / **照 canonical 尺寸建的容器加行·加内容·改尺寸后(I7:复测容器尺寸 + 兄弟碰撞 + 依附其几何的手画装饰与 `ABSOLUTE` 浮层——**一律实测间距并与基线比对、禁分类预判**;**上限=物理边界、非 canonical 数值**)** 时 |\n46\t| [`figma-technical-reference.md`](./figma-technical-reference.md) **Q15**(SECTION 子节点 x/y = section-relative 非画布绝对;`child_abs = section.x + child.x`,赋目标坐标前先减 section 原点、落点必 probe `absoluteBoundingBox` 验证,禁信 `.x/.y`)| **往 Section 内 create / move / 定位任何节点 / 设其坐标**时(高频复发坑,2026-06-04 立后已多次重踩)|\n47\t| §M23 + §M23.6 + §M33 | 要画 UX 交付注释 / 流程图 / annotation 字符串时 |\n48\t| §M23.10 + §M23.11(含 **§M23.11 (B) 终态优先**:禁按轮次组织的章节骨架 / 沿革句「取代此前…」/ mockup 施工记录 —— 卡的读者是 dev·QA,沿革归 handoff·spec)| 起草 UX 交付卡(Why / Changes / Data Contract / Interaction / Acceptance)时 · **卡被指\"内容太多 / 像给 AI 读的\"时** |\n49\t| §M23.0 〈canonical UX 卡结构〉(Why/Changes/Data Contract/Interaction/Acceptance + Section Header 正向模板;含 **判据单一归属** PRD=功能级 / UX 卡=界面级 + 一条 Acceptance 一个判据)| **起草 / 更新 UX 交付卡结构**时(含\"写/更新 UX 交付说明\"措辞)—— 禁自创临时段、禁两处铺同一判据 |\n50\t| **User Journey Map 卡**(5-stage canonical,→ [`design-process.md` § User Journey Map];Jira mockup 标准交付卡,2026-07-09 owner 回流)| **产出/更新 Jira mockup 交付集**时——必随 PRD / UX Delivery 卡产出、设计阶段即建、**禁漏 surface**(实证 V4-2335 LCD 有 / V4-2356 Config-T 漏)|\n51\t| §M23.14 卡内排版:双语堆叠行距(组内紧 / 组间松 / 段间最松 三档差异化)+ 模块段名层级(section heading = cyan `#33A4FD` + Medium 大号)| **UX 卡 / PRD 卡正文 ZH 译文堆在 EN 行下方(A-下 / A-逐行 / 多语堆叠),或卡内含模块段名(Source/Background/Why/Changes…)时**——统一行距致拥挤、段名淹没正文 |\n52\t| §M23.16 规则优先于范本(→ 已升 meta-rules §触发器 Q;mockup 域落地保留指针)| **开建 PRD / UX 卡前照抄最近同类范本时**——范本若 pre-规则须先用规则真源校验,勿照抄 lineHeight / itemSpacing / 层级 |\n53\t| §M23.12(卡 placement 紧邻 mockup + sizing 竖向 Auto Layout hug + 标准宽)| **放置 / 设定 UX·PRD 卡的位置与尺寸**时 |\n54\t| §M23.7 + §M23.9(state-label = what+why+invariants + state-preview 元素放产品 frame 外、连线指回触发元素)| **写状态标注 / 把边界态预览元素放到产品 frame 外**时 |\n55\t| §M23.8(Jira requirement annotation 必带 setRangeHyperlink)+ §M23.8.1(PRD 需求来源段列全 ticket + 全部可点击 + Slack 外链,create/update 都遵守)| **加 Jira annotation / FB-xxxx 编号 / 写改 PRD 需求来源段**时 |\n56\t| §M23.17(开发中发现的逻辑调整 = 标准 UX 交付卡,accent 蓝换橙 `#f68512`;旧内容划线不删、正文英主中降透、橙色仅 accent/标题)| **交付后开发/QA/测试发现既有交付逻辑需调整或补充、要在效果图上留痕**时 |\n57\t| §M23.18(浅色主题匹配变体:chip 用 `--blue-bg`,大段落卡用 `--bg-layer2` + 蓝色边框/标题,不整卡铺色;**默认自动探测**画布主题选版本,非用户显式触发)+ **§M23.18.1(page 画布底色同源跟随 mockup 主题:dark→`0.418` / light→`#F5F5F5` / 混合→默认深色,禁留 Figma 白画布)**| **建 / 改任一 PRD 卡·UX Delivery 卡·User Journey Map 卡前** + **新建 / 迭代 mockup page 设画布底色时**(起手 probe 所属 Section 内产品 frame 明暗 → 卡 light→本条/dark→navy/unknown→navy;画布 light→#F5F5F5/dark→0.418/混合→深色)|\n58\t| [`design-process.md`](./design-process.md) Pre-Phase 0 **Step B**(PRD 6 段固定结构:需求来源 / 背景 / 现状 / 功能需求 / 验收 / 优先级排期)| **起草 / 更新 PRD** 时(含\"按设计系统更新 PRD\"这类局部更新措辞)|\n59\t| §M24 | \"已有 code 还原效果图\"场景前置 |\n60\t| §M29 | 涉及表格 cell(copyable / empty placeholder)时 · **改任一 cell 的空值占位表现前**——先 `findAll` 取证该产品文件既有占位约定(字形 + 颜色),§C4 产品既有约定优先于本条的 em dash 默认 |\n61\t| §M31 | 决定 Auto Layout / Slot / Boolean / Absolute 时 |\n62\t| §M32 (含 M30 icon 扩展) | 要 instance 任何 product UI 元素前 |\n63\t| §M32.2 自建产品 UI 件起手三件套 | **自建 自定义卡 / 浮层 / 面板(非库直用 instance)起手**时 |\n64\t| §M32.4 禁用表达唯一口径(有禁用变体就切变体、无变体才降透明度,**两者不叠加**;判有无变体须 live 全枚举、禁凭印象)| **任何控件要表达\"不可用 / 已锁定 / 运行中不可改\"**时 |\n65\t| §M32.5 选源先判字段语义类别(不照抄\"看起来最像的邻居\")+ §M32.6 Spec-Value Fidelity(取原稿实测值、偏离前先确认)| **克隆 / mirror 既有 sibling 做新字段** 或 **照原稿填任何数值(间距 / 字号 / label)**时 |\n66\t| §M35 affordance 搜索 | 要找 chevron / sort / close 等\"基本语义元素\"前 |\n67\t| §M43 + §M43.2 | 涉及受限容器(cell / chip / tag)+ 调列宽 / 改 cell 内容时 |\n68\t| §M46 | 迭代既有 mockup(clone 上期 page 改本期)起手前必读 |\n69\t| §M47 | 改任何 text 节点的 fontName 前 |\n70\t| §M47.2(禁 `insertCharacters`,走「整段覆盖 → 赋 characters → 逐段重设」+ `getStyledTextSegments` 逐段复核)| **改多段样式文本节点的文案时**(注释 caption / UX 交付卡段 / PRD 段 —— 含只改一个序号字符、只追加一条 bullet 的场景)|\n71\t| §字体规范〈产品层字体〉(LCD=`Verdana` / 网页=`Roboto` / 注释层恒 `Roboto`+`Noto Sans SC`;**Verdana 本环境不可写 → 必产出待改节点清单交 owner**)| **在 LCD / Touch Screen 产品帧内新建或改动任何文字时** |\n72\t| §M-DISCIPLINE.SOURCE(一条新规则该进本真源、还是留在项目 repo —— 三问判据;**回流是三档不是二分**;「同一产品内可复用」≠「跨产品通用」)| **决定把任何新规则 / 规格 / 教训写进哪个文件之前**(用户说「回流」「沉淀」「记录一条规则」「提炼成可复用」时,先过三问再动笔)|\n73\t| §M-DISCIPLINE.SCOPE(scope 由「对象全集」推导,不由「我做了什么 / 用户指摘了什么 / 我预期哪个值」推导;含枚举维度全集 + 下钻 INSTANCE 子树 + 标题显式声明范围 + **扫查脚本的过滤条件须用探针自验不排除目标**)| **产出任何走查 / 审计 / 债务清单 / 待办清单前**(定 scope 的那一刻,不是写完再补声明)· **改任一字段的显示口径 / 取值规则前**(硬约束 7:对象全集含**产品帧本体** cell 值 / 列头 / 图层名,不止交付层——先 `findAll` 全页列清单,改完按同一清单机器复验残留 = 0)|\n74\t| §M-DISCIPLINE.VARIANT(变体切换后 compare-and-fix 复验文本,禁\"打印当复验\")| **调 `setProperties` 切任何 variant(导航状态 / tab / 按钮 / 字段状态)后** |\n75\t| §M-DISCIPLINE.SYNC(编辑 confirmed → 写后机检 `--report` 落盘 + 交付层同步 + §2a 扫查三轮:① 旧措辞正则 ② 新事实逐条 ③ 互斥对照)| **任何 mockup 编辑 confirmed 后**(状态转移触发,不靠\"我知道哪张卡受影响\";唤醒词「同步交付物」);**③ 轮另在**:本轮扩展了 feature 的 scope · 回流 / 改动了规则条文 · **把一个 surface 的口径复用到另一个 surface(须 `use_figma` probe 目标 surface 界面本体,禁照抄另一端)** 时 |\n76\t| [`figma-technical-reference.md`](./figma-technical-reference.md) **Q22**(instance 内 SLOT 一次结构性改动即让同 script 其余引用失效;复合 id `I;` 不可 `getNodeByIdAsync`)| **装配含 SLOT 的库组件(`Popup Box` / `Notification` / `Form Item` 等)、或要在 instance 内部 remove / 切变体**时 |\n77\t| [`figma-technical-reference.md`](./figma-technical-reference.md) **Q29**(判「文件是否订阅了某个库」只能用 `teamLibrary.getAvailableLibraryVariableCollectionsAsync()`;`getLocal*` 系列对订阅状态零信息量、产品文件恒返回 `[]`。另:订阅成立 ≠ 该属性可绑,要绑什么先用 `getVariablesInLibraryCollectionAsync` 列一遍库内变量实证)| **要判断当前文件能否绑 DS variable / 用 DS text style 时** · **要向 owner 声明「此文件未订阅库」或「某属性绑不上 token」之前**(这类断言必须有 `teamLibrary.*` 的实测支撑,不能拿 local 系列的空返回推断)|\n78\t| §M52 Library Fidelity Umbrella — §M52.1 库样式/变量 Fidelity + §C5 语义色优先 | 建节点要绑任何视觉属性 token(颜色 / 间距 / 圆角 / 字体 / 阴影)时 |\n79\t| §M52.2 + §M52.3 + §M52.4(字段级 parity 表 / 反馈控件同源 inventory / 卡片强调预算)| **重构·拆分组件 · 出现 ≥2 反馈类控件 · 评估卡片强调预算·视觉权重**时 |\n80\t| §M-FONT | 设 / 改 text 节点 fontSize(须落 textStyle grid)时 |\n81\t| §M-TXT-ICON-AUDIT(含**注释层例外 + Roboto 缺 glyph 清单**:`→ ▼ ▲ ①②③` 在 Roboto 段渲染为空白,须改绑 `Noto Sans SC`;缺 glyph 只有渲染图能发现)| 放任何 icon / 文字符号(防 Unicode glyph 充数)时 · **在 PRD·UX·Journey 卡正文写 `→` / `▼` / 圈号时** |\n82\t| §M-LIBRARY-HYGIENE | 新建 / 命名 component(`_` / `.` 前缀语义)时 |\n83\t| §M38 | 做 selected / active row·item 指示(3-layer rail)时 |\n84\t| §M41 | 做删除 / 破坏性确认弹窗时(**改造线上已有弹窗须一并读 §M41「例外 — retrofit」**:线上无 scrim 则以线上为准,不得按规则默认把 scrim 加回去)|\n85\t| §M42 + §M42.2 + §M42.3 | clone / 复制 节点或 frame 时(§M42.3:迭代既有物**优先就地改**、禁旁路克隆搭样板制造重复集)|\n86\t| §M44 | 写 UI label / 字段名(防暴露后端名)时 |\n87\t| §M45 + §M45.1 | **建 / 命名 / 新建 Figma page 时**(含 `createPage` / \"新建 page\" / \"加一个 page\" / \"新增页面\" / \"开一页\" / 决定**新 page 落点**时——即使当前主任务是画 PRD/mockup、只是顺手加页也命中);**任何 mockup 任务起手先过 §M45.1 分诊:全新需求 → 新建独立 page(放 `To be confirmed` 分类顶,落点见 §M45.1 §2068)· 迭代既有 → §M46 就地改** |\n88\t| §M36 / §M37 + [`design-process.md` §参考物落地](./design-process.md) | 同一组合跨 frame·page 重复 ≥2(M36 promote 提案)/ **有参考图·参考帧·截图输入**时——M37 出 5 行 probe 表,§参考物落地 管**把参考物贴进画布**(REFERENCE Section 置于交付 Section **左侧**,同 BEFORE;同文件 clone / 跨文件 upload_assets;必配逐项去向对照表)|\n89\t| §M39 / §M40 | 抽组件 variant 文本属性(M39)/ 用 #N 序号 vs 语义命名(M40)时 |\n90\t| §Legacy ID Map(文末)| 查旧数字 ID(M10/M25/M26/M27/M28/M30/M34)并入哪条现行 umbrella 时 |\n91\t\n92\t**红线**:跳过\"起手必读段\"直接进 M-rule = 协议违反(漏 M0 Phase 0 是历史最高频回归源)。\n93\t\n94\t---\n95\t\n96\t## 必读链路(起手按顺序读)\n97\t\n98\t| 文件 | 内容 | 必读时机 |\n99\t|---|---|---|\n100\t| [`design-process.md`](./design-process.md) | 通用 process 规则 —— **清单见该文件头 `rule-inventory` 块(唯一真源)**,此处不枚举 | **所有任务** |\n101\t| [`domain-tvu.md`](./domain-tvu.md) | TVU 业务规则 —— **清单见该文件头 `rule-inventory` 块** | **所有任务** |\n102\t| [`figma-technical-reference.md`](./figma-technical-reference.md) | Figma API quirks(Q1-Q4)| Path A 实现时 |\n103\t| [`tools/figma-quirks.md`](./tools/figma-quirks.md) | Figma quirks 快查表 | Path A 实现时 |\n104\t| 本文件 | Path A 专属:Figma 真源 / 组件优先级 / M0 / M1 / M10 / M23 | **所有 Path A 任务** |\n105\t\n106\t---\n107\t\n108\t## 真源 / 优先级(先读完这段再动手)\n109\t\n110\t### Figma 库源文件\n111\t\n112\t| 维度 | 值 |\n113\t|---|---|\n114\t| TVU 设计系统库源文件 fileKey | `YbsPRUVmNdsbN40NNwh1Gn` |\n115\t| Published library 名 | `TVU UX Design System` |\n116\t| Library key | `lk-057f6ba0f771bfa7f63a6a197502999462c2974f995488b381708ca5faadb7f9f6675e04aa442b3a5ffb31732150a7f5aa8ca3102073ab210edc684022fc6c21` |\n117\t| 源文件登记位置 | [`docs/site-review-manifest.json`](../site-review-manifest.json) `figmaFileKey` 字段 |\n118\t| 组件名 → code 映射 | [`figma-data/figma-to-code-mapping.json`](../../figma-data/figma-to-code-mapping.json) |\n119\t\n120\t**任何 mockup 任务起步必须先 `cat docs/site-review-manifest.json | jq .figmaFileKey` 拿到真源 key,再做 Figma 库探索**——不要靠扫产品文件 instance 反推库归属。\n121\t\n122\t### 组件取数优先级(默认顺序)\n123\t\n124\t**0. 第 0 步必查:[Figma Component Catalog](./figma-component-catalog.md)**\n125\t任何 mockup 任务起手第一件事是 grep 这个 catalog。它已 bootstrap 了库的全部 49 个 component_set + 647 icon 的骨架,**已实证过的组件还附带 Primary use / Extension scenarios / Don't use**。70% 的\"library 缺件/找不到\"判断在这里就有答案。\n126\t\n127\t1. **catalog 没命中 → published `TVU UX Design System` library**(用 library key 过滤搜索 + import sample 看 variants,结果回填 catalog)\n128\t2. **库里也没有 → file-local 组件集**(产品文件内的 component_set,少数特殊场景用,如 `APP Icons`)\n129\t3. **最后:自画 + 标 🟡 入库候选**(必须前两条都验证后无果,且把候选写回 catalog 让下次免坑)\n130\t\n131\t**默认假设:library 已覆盖大多数通用组件**(Button / Input / Badge / Tooltip / Top bar / Notification / Switch / Tab / Drop down List / Form Item / Pagination / Slider 等——具体清单见 catalog)。除非实证证明无对应物,否则不允许跳到第 2 / 第 3 条。\n132\t\n133\t### 库归属验证机制\n134\t\n135\t- ❌ 错误做法:扫某个既有 page 的 instance 来选 key——产品文件里可能同时存在多代库(旧 `TVU UX Library` + 新 `TVU UX Design System`),盲选会撞旧库。\n136\t- ✅ 正确做法:`search_design_system` 时通过 `includeLibraryKeys: [\"lk-057f6ba0...\"]` 显式过滤;返回结果中检查 `libraryName: \"TVU UX Design System\"`。\n137\t\n138\t---\n139\t\n140\t## Convention Priority Hierarchy\n141\t\n142\t→ [`design-process.md §Convention Priority Hierarchy`](./design-process.md#convention-priority-hierarchy)(完整优先级表 P0-P3 + 冲突解决规则)\n143\t\n144\t---\n145\t\n146\t## Task Entry Modes\n147\t\n148\tAI 接到任务后**先 classify** 再决定走哪条路径:\n149\t\n150\t| ID | 用户表达 | 流程 |\n151\t|---|---|---|\n152\t| **US-1** Greenfield 产品 | \"基于 TVU 设计一个 X 产品 mockup,功能大概 ABC...\" | Pre-Phase 0 → M0 → 画 frame |\n153\t| **US-2** Greenfield 单 frame | \"基于 TVU 给 X 产品画 dashboard frame\" | Pre-Phase 0(单 frame 版)→ M0 → 画 |\n154\t| **US-3** Existing product 增/改/删 | \"MicroApps Console mockup 加/改/删任意 frame 或元素\" | Read handoff → Pre-Phase 0(仅变化部分)→ M0 → 画(仅 update 变化部分)|\n155\t| **US-4** Figma frame → code mirror | \"把这个 frame 翻成代码\" | **不归本 conventions**(走 [`code-conventions.md`](./code-conventions.md) US-4 路径)|\n156\t| **US-5** 小调整(1-2 element)| \"改下按钮位置\" | 跳过 Pre-Phase 0 + M0 → 直接改 |\n157\t| **US-6** Review / Audit | \"帮我审 X frame 是否符合 TVU 规范\" | 跳过 Pre-Phase 0 + M0 → 对照规则逐条审 → 产 audit report |\n158\t| **US-7** Redesign legacy product | \"给 X 老产品出 redesign 提案 / 重新设计 X\" | 见下方 US-7 子流程(审 → gap → 提案 → 用户挑路径 → 才进 US-1/US-3) |\n159\t\n160\tClassification 不确定时 → AI **主动问用户**哪种入口。"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"7bf5619d-50fd-4fe0-991a-18d56e14ef3b","timestamp":"2026-08-26T01:43:57.101Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/mockup-conventions.md","content":"# Product Mockup Conventions(Path A — Figma)\n\n> 任何 AI 工具在 TVU 产品 Figma 文件里画 UX mockup 时**必须遵循的硬约束**。\n> 项目级真源;不要在对话或工具私有 memory 里复刻规则。\n>\n> **作用域**:在 TVU 产品 Figma 文件(如 `Micro-Apps-20250923` 等)画产品页面 mockup。**不**作用于设计系统库本身的迭代。\n>\n> 🏗️ **本文件的结构不是随手长出来的** —— 分节顺序 / M-rule 编号归属 / 「写后必跑机检」为什么只在一处 / Legacy ID Map 为什么收拢 / 实证段为什么外移出规范体,是一次带审计(F1–F11 十一项发现)的整顿结果。**动结构前先读** [`docs/superpowers/specs/2026-06-25-mockup-conventions-restructure-design.md`](../superpowers/specs/2026-06-25-mockup-conventions-restructure-design.md),尤其 §0 owner 重定向那节(它定了「整顿」与「重写」的边界)。\n\n\n> **本文件规则清单 —— 唯一真源**(机械核 `pnpm audit:rule-inventory`;scoped 与 lazy 加载按本清单挑,别处一律只放指针)\n>\n> M0 / M1 / M-COLOR / C1 / C2 / C3 / C4 / C5 / C6 / C7 / M23 / M23.0 / M23.12 / M23.14 / M23.16 / M23.17 / M23.18 / M23.8 / M24 / M-INTEGRITY / I1 / I2 / I3 / I4 / M29 / M23.6 / M23.9 / M23.10 / M23.11 / M23.7 / M31 / M-LIBRARY-HYGIENE / M32 / M32.1 / M32.2 / M32.3 / M32.4 / M32.5 / M32.6 / M33 / M35 / M36 / M36.1 / M37 / M38 / M-FONT / M-TXT-ICON-AUDIT / M39 / M40 / M41 / M45 / M45.1 / M44 / M43 / M43.2 / M42 / M42.2 / M42.3 / M46 / M47 / M47.2 / M-DISCIPLINE / M52 / M52.1 / M52.2 / M52.3 / M52.4\n\n\n> ⚠️ **本清单从活源 rule heading 机械派生**(`scripts/lib/rule-ids.mjs` 的 `RULE_HEADING_RE`,与 `audit:rule-load-map` / `audit:rule-number-collision` / `rule:next` 同一份形态定义),⛔ 别手抄别处的版本、也别顺手排序(顺序 = 活源里的物理顺序,排序会当场触发闸)。它存在的理由不是给人读,而是给 `audit:rule-inventory` 的 S4「别处不得再枚举」一个分母 —— 2026-08-14 扩面当天就抓到**一个活源根本不存在的规则 id** 被两处文档当规则引用(字面留在 backlog / STATUS-CHANGELOG,不在规则文件里复述)。\n>\n> ⚠️ **已知盲区(共用正则的边界,如实登记)**:`## §M-LIFECYCLE`(`§` 开头,正则不抓)· `I5`/`I6`/`I7`(`#### M-INTEGRITY §I5…`,被折进 `M-INTEGRITY`)· H5 层的 `M23.18.1`/`M23.8.1`/`I1.1`。`audit:rule-load-map` 今天同样看不到它们。⛔ **扩正则或改这几处标题是独立子项,别顺手做** —— 改标题会动 `audit:stale-anchors` 的三百多条 rule-ref。\n\n---\n\n## 🤖 AI 读取指引(按需加载,避免全量吞)\n\n本文件 2600+ 行,**不要起手就全量 Read**。按下表只读起手必读段,具体 M-rule jump to 时再读:\n\n| 起手必读(任务前先吃这些) | 行段 |\n|---|---|\n| 本文件顶部 intro + §作用域 + §必读链路 + §真源 / 优先级 | §0–§2 |\n| §Convention Priority Hierarchy + §Task Entry Modes + §Migrated Rules Pointer Index | §3–§5 |\n| **§M48 Startup Rule-Coverage Self-Check(起手第一产出物,所有任务)** — 先列「本任务命中的 locked spec + active M-rule」清单再开建 | [`design-process.md` §M48](./design-process.md) |\n| **§M49 Design Quality Contract(设计质量合同,所有产品设计任务)** — 先列 Baseline / Delta / Semantic / Feedback UI Inventory / UX / Simplicity / Content,再生成 deliverable | [`design-process.md` §M49](./design-process.md) |\n| §M0 Phase 0 Element-to-Component Mapping(**所有任务前置**) | §M0 |\n| **§M-DISCIPLINE Rule Execution(起手协议后必跑,所有任务)** — TodoWrite 把「读到的规则」物化成 checklist,防\"读了不执行\" | §M-DISCIPLINE |\n| **§M-LIFECYCLE Mockup Edit Lifecycle Gate(任何 create/update/delete 任务)** — 操作前(I5/I6 probe)·后(conformance 机检)·走查 三时点必过 | §M-LIFECYCLE |\n\n| 触发后再读(按场景 jump,不预读) | 触发条件 |\n|---|---|\n| **加新规则前先要号:`pnpm rule:next <系列>`**(C / I / M / M32 等子系列 / Q / R)——号从 `origin/master` 算,**不看本地文件的最大号**。⚠️ 本地工作树是会过期的镜像:2026-08-11 PR #9 实证,分支分叉 62 天后按本地最大号编,把 master 上早已占用的 C5/C6·M32.2/M32.3·Q21–Q26 又用了一遍。拿号后三件事一起做:写正文 + 本表加触发行 + 核正文里引用的其它号。撞了由 `audit:rule-number-collision` 在 pre-commit/CI 拦并直接告诉你该改成几号。 | **要往任一规则真源(本文件 / `code-conventions.md` / `figma-technical-reference.md`)新增带编号的条目**时 |\n| §M1 Top bar 公共基建 | 涉及产品顶栏时 |\n| [`domain-tvu.md` §M17](./domain-tvu.md) **LCD 设置页 canonical 范式**(等高行 / 控件列右对齐 / 下向三角展开标记 / 底栏 `OK`+`Home`、返回上一级走左上角箭头;**取值与参考帧 id 在项目 repo** `TVU Pack/docs/specs/lcd-canonical-spec.md`)| **在背包设备 LCD(Touch Screen 文件)建或改任何设置页**时——起手先开 canonical 范式帧实测取值,禁照最近做过的某个 LCD 页凭印象仿写 |\n| [`domain-tvu.md` §M17.1](./domain-tvu.md) **LCD 选项列表 canonical 范式**(绿框面板 + 当前值绿字 + 矢量选中标记 + **被编辑字段行加绿框、面板右对齐该行右缘并与之连成一体**;**取值与参考帧 id 同上,在项目 repo**)| **LCD 上任何「从枚举里选一个值」的交互**(下拉 / 选项列表 / 值选择器)时——禁自造下拉或让面板浮在半空无归属 |\n| §M-COLOR (§C1/§C2/§C3/**§C4**/**§C5**/§C6/§C7) | 要填颜色 / icon fill / state color / **在某个产品文件里新建带颜色的元素**(§C6 先查该文件实际订阅的库)/ **新建文字节点**(§C7 文字样式 + 颜色双绑)/ **给注解 / 说明卡 / M23 类交付卡配色**(§C4:品牌色与 M23 annotation accent **不能混用**)时——**§C3 与 §C5 必须一起读**:§C3 只判命名空间合法性,§C5 判优先级,`UX/Grey/grey-N` 在 §C3 合法但在 §C5 只是 fallback,机检按 §C5 判 |\n\n| §M-INTEGRITY (§I1/§I2/§I3/§I4/§I5/§I6/§I7) | **任何编辑 confirmed 后(M-DISCIPLINE.SYNC)** / mockup 完成自检 / **section 重叠(I2:改 bounds 后 **+ 每次收尾固定跑一次**;含嵌套子 Section 逐层扫;须分报 `sectionInternalOverlap` / `sectionToSectionOverlap` 两个数)** / sibling 布局 / children wrap / element parent 归属 / 替换既有节点前 diff(I5) / **create·move·place 前 probe 目标位防叠加(I6)** / **照 canonical 尺寸建的容器加行·加内容·改尺寸后(I7:复测容器尺寸 + 兄弟碰撞 + 依附其几何的手画装饰与 `ABSOLUTE` 浮层——**一律实测间距并与基线比对、禁分类预判**;**上限=物理边界、非 canonical 数值**)** 时 |\n| [`figma-technical-reference.md`](./figma-technical-reference.md) **Q15**(SECTION 子节点 x/y = section-relative 非画布绝对;`child_abs = section.x + child.x`,赋目标坐标前先减 section 原点、落点必 probe `absoluteBoundingBox` 验证,禁信 `.x/.y`)| **往 Section 内 create / move / 定位任何节点 / 设其坐标**时(高频复发坑,2026-06-04 立后已多次重踩)|\n| §M23 + §M23.6 + §M33 | 要画 UX 交付注释 / 流程图 / annotation 字符串时 |\n| §M23.10 + §M23.11(含 **§M23.11 (B) 终态优先**:禁按轮次组织的章节骨架 / 沿革句「取代此前…」/ mockup 施工记录 —— 卡的读者是 dev·QA,沿革归 handoff·spec)| 起草 UX 交付卡(Why / Changes / Data Contract / Interaction / Acceptance)时 · **卡被指\"内容太多 / 像给 AI 读的\"时** |\n| §M23.0 〈canonical UX 卡结构〉(Why/Changes/Data Contract/Interaction/Acceptance + Section Header 正向模板;含 **判据单一归属** PRD=功能级 / UX 卡=界面级 + 一条 Acceptance 一个判据)| **起草 / 更新 UX 交付卡结构**时(含\"写/更新 UX 交付说明\"措辞)—— 禁自创临时段、禁两处铺同一判据 |\n| **User Journey Map 卡**(5-stage canonical,→ [`design-process.md` § User Journey Map];Jira mockup 标准交付卡,2026-07-09 owner 回流)| **产出/更新 Jira mockup 交付集**时——必随 PRD / UX Delivery 卡产出、设计阶段即建、**禁漏 surface**(实证 V4-2335 LCD 有 / V4-2356 Config-T 漏)|\n| §M23.14 卡内排版:双语堆叠行距(组内紧 / 组间松 / 段间最松 三档差异化)+ 模块段名层级(section heading = cyan `#33A4FD` + Medium 大号)| **UX 卡 / PRD 卡正文 ZH 译文堆在 EN 行下方(A-下 / A-逐行 / 多语堆叠),或卡内含模块段名(Source/Background/Why/Changes…)时**——统一行距致拥挤、段名淹没正文 |\n| §M23.16 规则优先于范本(→ 已升 meta-rules §触发器 Q;mockup 域落地保留指针)| **开建 PRD / UX 卡前照抄最近同类范本时**——范本若 pre-规则须先用规则真源校验,勿照抄 lineHeight / itemSpacing / 层级 |\n| §M23.12(卡 placement 紧邻 mockup + sizing 竖向 Auto Layout hug + 标准宽)| **放置 / 设定 UX·PRD 卡的位置与尺寸**时 |\n| §M23.7 + §M23.9(state-label = what+why+invariants + state-preview 元素放产品 frame 外、连线指回触发元素)| **写状态标注 / 把边界态预览元素放到产品 frame 外**时 |\n| §M23.8(Jira requirement annotation 必带 setRangeHyperlink)+ §M23.8.1(PRD 需求来源段列全 ticket + 全部可点击 + Slack 外链,create/update 都遵守)| **加 Jira annotation / FB-xxxx 编号 / 写改 PRD 需求来源段**时 |\n| §M23.17(开发中发现的逻辑调整 = 标准 UX 交付卡,accent 蓝换橙 `#f68512`;旧内容划线不删、正文英主中降透、橙色仅 accent/标题)| **交付后开发/QA/测试发现既有交付逻辑需调整或补充、要在效果图上留痕**时 |\n| §M23.18(浅色主题匹配变体:chip 用 `--blue-bg`,大段落卡用 `--bg-layer2` + 蓝色边框/标题,不整卡铺色;**默认自动探测**画布主题选版本,非用户显式触发)+ **§M23.18.1(page 画布底色同源跟随 mockup 主题:dark→`0.418` / light→`#F5F5F5` / 混合→默认深色,禁留 Figma 白画布)**| **建 / 改任一 PRD 卡·UX Delivery 卡·User Journey Map 卡前** + **新建 / 迭代 mockup page 设画布底色时**(起手 probe 所属 Section 内产品 frame 明暗 → 卡 light→本条/dark→navy/unknown→navy;画布 light→#F5F5F5/dark→0.418/混合→深色)|\n| [`design-process.md`](./design-process.md) Pre-Phase 0 **Step B**(PRD 6 段固定结构:需求来源 / 背景 / 现状 / 功能需求 / 验收 / 优先级排期)| **起草 / 更新 PRD** 时(含\"按设计系统更新 PRD\"这类局部更新措辞)|\n| §M24 | \"已有 code 还原效果图\"场景前置 |\n| §M29 | 涉及表格 cell(copyable / empty placeholder)时 · **改任一 cell 的空值占位表现前**——先 `findAll` 取证该产品文件既有占位约定(字形 + 颜色),§C4 产品既有约定优先于本条的 em dash 默认 |\n| §M31 | 决定 Auto Layout / Slot / Boolean / Absolute 时 |\n| §M32 (含 M30 icon 扩展) | 要 instance 任何 product UI 元素前 |\n| §M32.2 自建产品 UI 件起手三件套 | **自建 自定义卡 / 浮层 / 面板(非库直用 instance)起手**时 |\n| §M32.4 禁用表达唯一口径(有禁用变体就切变体、无变体才降透明度,**两者不叠加**;判有无变体须 live 全枚举、禁凭印象)| **任何控件要表达\"不可用 / 已锁定 / 运行中不可改\"**时 |\n| §M32.5 选源先判字段语义类别(不照抄\"看起来最像的邻居\")+ §M32.6 Spec-Value Fidelity(取原稿实测值、偏离前先确认)| **克隆 / mirror 既有 sibling 做新字段** 或 **照原稿填任何数值(间距 / 字号 / label)**时 |\n| §M35 affordance 搜索 | 要找 chevron / sort / close 等\"基本语义元素\"前 |\n| §M43 + §M43.2 | 涉及受限容器(cell / chip / tag)+ 调列宽 / 改 cell 内容时 |\n| §M46 | 迭代既有 mockup(clone 上期 page 改本期)起手前必读 |\n| §M47 | 改任何 text 节点的 fontName 前 |\n| §M47.2(禁 `insertCharacters`,走「整段覆盖 → 赋 characters → 逐段重设」+ `getStyledTextSegments` 逐段复核)| **改多段样式文本节点的文案时**(注释 caption / UX 交付卡段 / PRD 段 —— 含只改一个序号字符、只追加一条 bullet 的场景)|\n| §字体规范〈产品层字体〉(LCD=`Verdana` / 网页=`Roboto` / 注释层恒 `Roboto`+`Noto Sans SC`;**Verdana 本环境不可写 → 必产出待改节点清单交 owner**)| **在 LCD / Touch Screen 产品帧内新建或改动任何文字时** |\n| §M-DISCIPLINE.SOURCE(一条新规则该进本真源、还是留在项目 repo —— 三问判据;**回流是三档不是二分**;「同一产品内可复用」≠「跨产品通用」)| **决定把任何新规则 / 规格 / 教训写进哪个文件之前**(用户说「回流」「沉淀」「记录一条规则」「提炼成可复用」时,先过三问再动笔)|\n| §M-DISCIPLINE.SCOPE(scope 由「对象全集」推导,不由「我做了什么 / 用户指摘了什么 / 我预期哪个值」推导;含枚举维度全集 + 下钻 INSTANCE 子树 + 标题显式声明范围 + **扫查脚本的过滤条件须用探针自验不排除目标**)| **产出任何走查 / 审计 / 债务清单 / 待办清单前**(定 scope 的那一刻,不是写完再补声明)· **改任一字段的显示口径 / 取值规则前**(硬约束 7:对象全集含**产品帧本体** cell 值 / 列头 / 图层名,不止交付层——先 `findAll` 全页列清单,改完按同一清单机器复验残留 = 0)|\n| §M-DISCIPLINE.VARIANT(变体切换后 compare-and-fix 复验文本,禁\"打印当复验\")| **调 `setProperties` 切任何 variant(导航状态 / tab / 按钮 / 字段状态)后** |\n| §M-DISCIPLINE.SYNC(编辑 confirmed → 写后机检 `--report` 落盘 + 交付层同步 + §2a 扫查三轮:① 旧措辞正则 ② 新事实逐条 ③ 互斥对照)| **任何 mockup 编辑 confirmed 后**(状态转移触发,不靠\"我知道哪张卡受影响\";唤醒词「同步交付物」);**③ 轮另在**:本轮扩展了 feature 的 scope · 回流 / 改动了规则条文 · **把一个 surface 的口径复用到另一个 surface(须 `use_figma` probe 目标 surface 界面本体,禁照抄另一端)** 时 |\n| [`figma-technical-reference.md`](./figma-technical-reference.md) **Q22**(instance 内 SLOT 一次结构性改动即让同 script 其余引用失效;复合 id `I;` 不可 `getNodeByIdAsync`)| **装配含 SLOT 的库组件(`Popup Box` / `Notification` / `Form Item` 等)、或要在 instance 内部 remove / 切变体**时 |\n| [`figma-technical-reference.md`](./figma-technical-reference.md) **Q29**(判「文件是否订阅了某个库」只能用 `teamLibrary.getAvailableLibraryVariableCollectionsAsync()`;`getLocal*` 系列对订阅状态零信息量、产品文件恒返回 `[]`。另:订阅成立 ≠ 该属性可绑,要绑什么先用 `getVariablesInLibraryCollectionAsync` 列一遍库内变量实证)| **要判断当前文件能否绑 DS variable / 用 DS text style 时** · **要向 owner 声明「此文件未订阅库」或「某属性绑不上 token」之前**(这类断言必须有 `teamLibrary.*` 的实测支撑,不能拿 local 系列的空返回推断)|\n| §M52 Library Fidelity Umbrella — §M52.1 库样式/变量 Fidelity + §C5 语义色优先 | 建节点要绑任何视觉属性 token(颜色 / 间距 / 圆角 / 字体 / 阴影)时 |\n| §M52.2 + §M52.3 + §M52.4(字段级 parity 表 / 反馈控件同源 inventory / 卡片强调预算)| **重构·拆分组件 · 出现 ≥2 反馈类控件 · 评估卡片强调预算·视觉权重**时 |\n| §M-FONT | 设 / 改 text 节点 fontSize(须落 textStyle grid)时 |\n| §M-TXT-ICON-AUDIT(含**注释层例外 + Roboto 缺 glyph 清单**:`→ ▼ ▲ ①②③` 在 Roboto 段渲染为空白,须改绑 `Noto Sans SC`;缺 glyph 只有渲染图能发现)| 放任何 icon / 文字符号(防 Unicode glyph 充数)时 · **在 PRD·UX·Journey 卡正文写 `→` / `▼` / 圈号时** |\n| §M-LIBRARY-HYGIENE | 新建 / 命名 component(`_` / `.` 前缀语义)时 |\n| §M38 | 做 selected / active row·item 指示(3-layer rail)时 |\n| §M41 | 做删除 / 破坏性确认弹窗时(**改造线上已有弹窗须一并读 §M41「例外 — retrofit」**:线上无 scrim 则以线上为准,不得按规则默认把 scrim 加回去)|\n| §M42 + §M42.2 + §M42.3 | clone / 复制 节点或 frame 时(§M42.3:迭代既有物**优先就地改**、禁旁路克隆搭样板制造重复集)|\n| §M44 | 写 UI label / 字段名(防暴露后端名)时 |\n| §M45 + §M45.1 | **建 / 命名 / 新建 Figma page 时**(含 `createPage` / \"新建 page\" / \"加一个 page\" / \"新增页面\" / \"开一页\" / 决定**新 page 落点**时——即使当前主任务是画 PRD/mockup、只是顺手加页也命中);**任何 mockup 任务起手先过 §M45.1 分诊:全新需求 → 新建独立 page(放 `To be confirmed` 分类顶,落点见 §M45.1 §2068)· 迭代既有 → §M46 就地改** |\n| §M36 / §M37 + [`design-process.md` §参考物落地](./design-process.md) | 同一组合跨 frame·page 重复 ≥2(M36 promote 提案)/ **有参考图·参考帧·截图输入**时——M37 出 5 行 probe 表,§参考物落地 管**把参考物贴进画布**(REFERENCE Section 置于交付 Section **左侧**,同 BEFORE;同文件 clone / 跨文件 upload_assets;必配逐项去向对照表)|\n| §M39 / §M40 | 抽组件 variant 文本属性(M39)/ 用 #N 序号 vs 语义命名(M40)时 |\n| §Legacy ID Map(文末)| 查旧数字 ID(M10/M25/M26/M27/M28/M30/M34)并入哪条现行 umbrella 时 |\n\n**红线**:跳过\"起手必读段\"直接进 M-rule = 协议违反(漏 M0 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| [`figma-technical-reference.md`](./figma-technical-reference.md) | Figma API quirks(Q1-Q4)| Path A 实现时 |\n| [`tools/figma-quirks.md`](./tools/figma-quirks.md) | Figma quirks 快查表 | Path A 实现时 |\n| 本文件 | Path A 专属:Figma 真源 / 组件优先级 / M0 / M1 / M10 / M23 | **所有 Path A 任务** |\n\n---\n\n## 真源 / 优先级(先读完这段再动手)\n\n### Figma 库源文件\n\n| 维度 | 值 |\n|---|---|\n| TVU 设计系统库源文件 fileKey | `YbsPRUVmNdsbN40NNwh1Gn` |\n| Published library 名 | `TVU UX Design System` |\n| Library key | `lk-057f6ba0f771bfa7f63a6a197502999462c2974f995488b381708ca5faadb7f9f6675e04aa442b3a5ffb31732150a7f5aa8ca3102073ab210edc684022fc6c21` |\n| 源文件登记位置 | [`docs/site-review-manifest.json`](../site-review-manifest.json) `figmaFileKey` 字段 |\n| 组件名 → code 映射 | [`figma-data/figma-to-code-mapping.json`](../../figma-data/figma-to-code-mapping.json) |\n\n**任何 mockup 任务起步必须先 `cat docs/site-review-manifest.json | jq .figmaFileKey` 拿到真源 key,再做 Figma 库探索**——不要靠扫产品文件 instance 反推库归属。\n\n### 组件取数优先级(默认顺序)\n\n**0. 第 0 步必查:[Figma Component Catalog](./figma-component-catalog.md)**\n任何 mockup 任务起手第一件事是 grep 这个 catalog。它已 bootstrap 了库的全部 49 个 component_set + 647 icon 的骨架,**已实证过的组件还附带 Primary use / Extension scenarios / Don't use**。70% 的\"library 缺件/找不到\"判断在这里就有答案。\n\n1. **catalog 没命中 → published `TVU UX Design System` library**(用 library key 过滤搜索 + import sample 看 variants,结果回填 catalog)\n2. **库里也没有 → file-local 组件集**(产品文件内的 component_set,少数特殊场景用,如 `APP Icons`)\n3. **最后:自画 + 标 🟡 入库候选**(必须前两条都验证后无果,且把候选写回 catalog 让下次免坑)\n\n**默认假设:library 已覆盖大多数通用组件**(Button / Input / Badge / Tooltip / Top bar / Notification / Switch / Tab / Drop down List / Form Item / Pagination / Slider 等——具体清单见 catalog)。除非实证证明无对应物,否则不允许跳到第 2 / 第 3 条。\n\n### 库归属验证机制\n\n- ❌ 错误做法:扫某个既有 page 的 instance 来选 key——产品文件里可能同时存在多代库(旧 `TVU UX Library` + 新 `TVU UX Design System`),盲选会撞旧库。\n- ✅ 正确做法:`search_design_system` 时通过 `includeLibraryKeys: [\"lk-057f6ba0...\"]` 显式过滤;返回结果中检查 `libraryName: \"TVU UX Design System\"`。\n\n---\n\n## Convention Priority Hierarchy\n\n→ [`design-process.md §Convention Priority Hierarchy`](./design-process.md#convention-priority-hierarchy)(完整优先级表 P0-P3 + 冲突解决规则)\n\n---\n\n## Task Entry Modes\n\nAI 接到任务后**先 classify** 再决定走哪条路径:\n\n| ID | 用户表达 | 流程 |\n|---|---|---|\n| **US-1** Greenfield 产品 | \"基于 TVU 设计一个 X 产品 mockup,功能大概 ABC...\" | Pre-Phase 0 → M0 → 画 frame |\n| **US-2** Greenfield 单 frame | \"基于 TVU 给 X 产品画 dashboard frame\" | Pre-Phase 0(单 frame 版)→ M0 → 画 |\n| **US-3** Existing product 增/改/删 | \"MicroApps Console mockup 加/改/删任意 frame 或元素\" | Read handoff → Pre-Phase 0(仅变化部分)→ M0 → 画(仅 update 变化部分)|\n| **US-4** Figma frame → code mirror | \"把这个 frame 翻成代码\" | **不归本 conventions**(走 [`code-conventions.md`](./code-conventions.md) US-4 路径)|\n| **US-5** 小调整(1-2 element)| \"改下按钮位置\" | 跳过 Pre-Phase 0 + M0 → 直接改 |\n| **US-6** Review / Audit | \"帮我审 X frame 是否符合 TVU 规范\" | 跳过 Pre-Phase 0 + M0 → 对照规则逐条审 → 产 audit report |\n| **US-7** Redesign legacy product | \"给 X 老产品出 redesign 提案 / 重新设计 X\" | 见下方 US-7 子流程(审 → gap → 提案 → 用户挑路径 → 才进 US-1/US-3) |\n\nClassification 不确定时 → AI **主动问用户**哪种入口。","numLines":160,"startLine":1,"totalLines":3243}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"b7e2789d-9215-461f-9be6-50a1fdbc0664","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":200,"estimated_tokens_delta":150,"uuid":"6d4f07b7-dfc7-45cc-82f0-1204dae0a62f","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":300,"estimated_tokens_delta":100,"uuid":"13f9edc5-8298-468f-9ead-b709722b0507","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":400,"estimated_tokens_delta":100,"uuid":"6e2e83d2-90cd-4645-8d19-d98a4857a8d6","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":500,"estimated_tokens_delta":100,"uuid":"1868f83d-1c9a-4fc8-b933-247919c60e1b","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":600,"estimated_tokens_delta":100,"uuid":"b8326b29-49c9-4ed9-b815-5309242320a8","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWh1WjVbMo5Yfqt9xCH","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAIS/Q0KpgEIERgCKkBrXb76M27RkwCJeDCmLLe71QQrN//rkImVXcq4Jl21r8SqY6d6GFBf+yF2GxTRJamjytEp+ONSDB9/JAbxQVNuMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAemJudQGsAECEgxd1A4RP9vPBtOemu0aDJg7ID/YM8IKSRKqwiIwxu2iqL8yf0K/tX+li6Cj5pkq2QKuXbZsfd+OUHhG4+/mPFv82rs/i7yPmvROsM4EKoMMJMAYvyglj6aT1wOXMsVzNaI34RU8Zio3MOZk2oXbaUNs+cJ/XfJk6VHXIIubEGKQF1+aK2z+GKC9+o6f/aR183pM+64hLR9nG48WY0c4lZzqP87BXqm7lD7MSdQy+vC+FJtcvJHUq1DescvFyUsmMjm203ZTWzLqonGtDT4XWb0yy165TTFfQlUfFRCr19G0E7um3jVyKjWZIsMo23jqrIIoCPTZ51AiQU/ueAFNxAq9TLxcPaFZHATWBc3QBX1i4wl3gY1e5ayh2lOuOsJtIi76JUamvUpIb38DppBGp/dtwYZ8WFr24G2UczAC5NK+U1ikmOBS+rYrmQuCGZcjSArWQhsj40GcHGZoHLejGdY5QcyLoRfL/KDSLIpHlR8/oJJmzndg2nmfv2upXkUB14kOg+MN4oDOX6L9sthbUF8cmvZ5MKOGatc3JJOU9zYBWRcYPksNPE0OiueL4hIJlGFf1qP2riewe8xmdVnBi76JEHQBdMrHbQF79BYTwUNbnqdu48XG23bwVWNZjdL6imXEjHz2c764nvnE1dpEez8Se1u3CiqYMCrfIyh5ZaCgv90hI72vObrEks6yADabFMnqh6EdUcm6tITW+Mg89Wx6pkzr2QXbF0AD7ZHvsdirA+PSv0VSz6JouvVQzIIEr/MrloOJirbC6Y5rrCUfhXFix6/zcziSDNMNZh85uWSz2RJuagHC6ms7p7sFJX7qX9C6eksnT9IqUXSNLoKS1LMgGp95o/npOeBQhtShZCrdWmVNd1AmTHLifOAvvAb2UfFIN0Zf0YP+6S7m0PQ0o0eZPOiAg6HC+Ij8kUB8rmE2y8b9Co+6bWLrgagWizZtb8lnCsleCIuR9+yQZ79mGqjBtWQZTj+kObPQ5vmXJpk5iK2tgDm2lQzkZtB/wlgIZOT+xT5WzxEbJIXVr8vCd4mKuUj+lDHMVMvxB3mQeY86pX/HlOJ9nELnd8/dMtvzf30EvBdkH5QDPUteLrZaCW/Bm9We1eT6VC6tBcyf7vpxXdtyhuatbxl98bIvcoCfAvztsJFecOp0RSqcj2ENVJSckroaa8k6GyU03ych6pt2k2AWBoft9QNL5kceTS4nDvpLaD+FU9Pvowk/UDOepKEwJ5gh4nj3B6/1vWz+JljTAHfdtK3h5EnBMWx7hCA4ZEjIyPFX/ZWTTCIpUUkAc/AtR6w6QK0Rh4/7b6Kv9NIT8TLo0QEVM21Awtr5jAVJWaxw3j769+XWQ9gc6uuBWnE/V+fVaURD5b6+qmHWySTlIvoFhhsqQ51/1wR++bAgpVISvA8n9+m6+nVglGGeX5rCdFQnIKX2bzr4Xf0AD5UkqiG5yF3wZ9FVm3RcaiyWxiE9gwIJbzs2+b6L2v+q57FOvHj5pk2ujU7vumz//9VWPaRNzPqBt5/eRM4QQn0qrzwYB49PbO8/Q7p9HPhvhR8+8D0VnoHsXke9GVChH53L7h4gwNrmIdgnIEN2E+anQ5oP1DrMJf55ewrElMwNAPEPLLz9rZ7AEXRgsvwrepegtFaXQ+SUYu4ubGNroM6AFCpAqLCk8hvBJj0l2JURWX5GhPPwzw9g3DgISQMd0lv3VPxKe6sJyPYKE1DEfAirkZwvFCYys60Pm7R24f7WkD7SYUhoFPpRuWXkwoOSKxp8WKAKzDbNkfT2gx2cYqO/EIgXhsP4lZZ4Hed++9opmMsLstfwVkmCk8t0UIEnLOOpYOfFeikv5oFUz7XWpXL7UVb50eQWdC3pIuQNtpj5t2DROS8XS1B+Kv/3AWGpEOid7yoKOp31RMKkkX2N31MvgW4qELHWPqZi2zxuu04e2uMQjWfD+mhHuk0yLVuHgeKMJf0UdS4yyrIVK0+hKj3snRc9NQmy3BSK4a0C/NK0tilBsuyDk141PIM2jpBIbezsIwehzu2yVdddtEL53qZbXiXPiJDFs7LiYgxurWckn9CNavWbiF2Eyv7xOJ8PPS571scxQfGUP+B/4SnprhgAaoBIQ6cZ/fYZVBJQujf9hiO7jck9yqjl5h3C+onrEzBKkbArGAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":21315,"cache_read_input_tokens":122164,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":21315},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"13f88aac-1f0a-4eda-9db9-6321a1e47a72","timestamp":"2026-08-26T01:44:10.079Z","request_id":"req_011CeQWgwwRzxgG3TXmS7mmd"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWh1WjVbMo5Yfqt9xCH","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01XVxrPP4B6bP8sHiodfjjna","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":21315,"cache_read_input_tokens":122164,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":21315},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"744b55db-e715-4410-8310-a8b90764c747","timestamp":"2026-08-26T01:44:10.824Z","request_id":"req_011CeQWgwwRzxgG3TXmS7mmd"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01XVxrPP4B6bP8sHiodfjjna","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":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"0b8c7c7b-d877-4a83-a8ca-fb9156ed34b4","timestamp":"2026-08-26T01:44:10.833Z","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":"a927cfd0-8f3c-40fa-b249-a477a8e9db4e","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"8e73d03f-08a4-4252-b0cc-587d998f90d6","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":300,"estimated_tokens_delta":150,"uuid":"3f7e27ba-840c-4719-9594-b25dd08acb35","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWi1iArrSYoCRnEW3jW","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISyQcKpgEIERgCKkDuyJ0gGHtWjobqW1VUAnZm1GR4V2/qI1AIqKWwmCMAF+vbmwCCqZXltSm5NdJMXRPPHyKe1kxsN/NY7Us4GS5wMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAfGJudQGsAECEgxbyQoHizG2ViWPuH0aDAC/JpD7ctzrFOfDvyIwd4DDQ0aMGBqiO6H4W1MCWqb+bOf7eAnm2srfKHyaL1r6ROLwmVkSjkI8UMPU4TkHKs8FsK2uJAaqkYi8JK9AsEzPyC7l2w82lGriZV2A92dcBViNAARjs/7nX2pJHMmKaH663OE71dMR4oxug/AwhDBp3EllOpcx5mu4o0eCSp7GrMsmdZF4/waXCJJTVjNdwPY9HIIz3qWtAiS1iff/et9hEFO6PLtYFfja4b93jORct6RzMWkQKHNUiWsOiCZ9JReWGkLNzrxq84nR9XEVwhvK8epaYQrTuKBHt8RsH80Me1ihs+QR6WPQrW/VPjcFMAoKea4VMzSsBLgo1J74W7lWLI4sQDT3DbfKN3LshGQQZFYhIbp43JGukiTRR2WSb0ckCRd/bz2FKCDkDqO9dsyYnZha0RLWZ37AwGr0NVaBrjA+0cEQV8VVZqCHMOfqGRztsUfZ8Zj/OfIZkyjXjzxH3WNGund9Slks8ZVA2jsTd7Y14IWlmDWUxPGybEP+4dG2JnrPs7ZRjTn4P0mxIDN2ULaR9hD7jum1N9RGxaRkeVMLofZqSfyIw8/62cxuNi8G/6jFcgYlJUZUDh5R7RAyCu0S314R+IpK+cU5r9nJdxa9OCDY0KSpYSq2rdT7OABUEhEqV7YCKPRGUH6ifbaSjdE3axtPM6QoWR9KA0cwPrPRkgHUrXfmqyRoUnrJUylvf4BPfWi9EFHtcXh3+dXi6I90X+ZtjOzlHR10qxYcB74nJCC2LsCUBxVR4Utd2+P9/ufyWb+80xJTuJclRmrXHcn1OPRKcO5ZFBbNtVU1uraCfUMuuS1mkbbT+b3AJifnu7I36AaFv/LOGOEjCqqvg9FjKagof9RnXCKVw8tVAasn/Hm0ubHFJvp6BzQzHYaxmIh8gZoqoNzce6SWV3E7P34qyxRWe+Gpyv/GI3EI+NkWdgnJp/Jwfb5gqDFlQoRJeYfs78I2Gna2vqj2OA+BeT+oLrYM6+1PjmPsQsiULzFZnk3BRSxLJhiJzequIZsYAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":14024,"cache_read_input_tokens":143479,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":14024},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"33f1aff8-ed41-48f8-92f8-348797155ccc","timestamp":"2026-08-26T01:44:17.914Z","request_id":"req_011CeQWhxZR2KTCP7xfGwTFa"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWi1iArrSYoCRnEW3jW","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_0161U562FCV1if7VVhWMZ74N","name":"Grep","input":{"pattern":"^### ","path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/figma-component-catalog.md","output_mode":"content","head_limit":120},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":14024,"cache_read_input_tokens":143479,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":14024},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"5febb283-f012-48f1-8418-5916768e13e4","timestamp":"2026-08-26T01:44:19.932Z","request_id":"req_011CeQWhxZR2KTCP7xfGwTFa"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWi1iArrSYoCRnEW3jW","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01DfQadhEZYeHZ2a4ichZMZ8","name":"Glob","input":{"pattern":"src/icons/**/*.svg"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":14024,"cache_read_input_tokens":143479,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":14024},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"32cef151-aedf-44f0-b7d1-6f6a9eb1b320","timestamp":"2026-08-26T01:44:19.937Z","request_id":"req_011CeQWhxZR2KTCP7xfGwTFa"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_0161U562FCV1if7VVhWMZ74N","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":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"9824e9bf-a2ae-4e6c-8883-f46bd5d7fb67","timestamp":"2026-08-26T01:44:19.958Z","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":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01DfQadhEZYeHZ2a4ichZMZ8","type":"tool_result","content":"No files found"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"748aba9c-40ae-45fc-9ed2-835800f8a492","timestamp":"2026-08-26T01:44:20.161Z","tool_use_result":{"filenames":[],"durationMs":218,"numFiles":0,"truncated":false,"totalMatches":0,"countIsComplete":true}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"bad3558b-7943-4996-bdd9-ee2f1b667afc","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"0ed2f52d-c2c8-4b41-aeda-336579b6c75c","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWihYZDNYjNtYjDKGkf","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISjQQKpgEIERgCKkDnFrTGWbvanJdbuGH+fz3Ojl3u391H0viu3kOwb5zMwA5ARLAdgIY8ej5KIwUT+dpxSMfwd8jTw060FA25R99iMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAfiJudQGsAECEgwgLKhcgA4NPtLvDKwaDBM3Px5d9QBMRWwxYyIwCNgQDekJJS1nK745vUwbUzFhQyez7Qiqujeses4Doy9IUzdTZRzF8yVXa23Sn3LAKpMCj8QQqX5OT5SIePiVGBQ/zEsnTFv07NVOwA5JfDIj9Tb7ZWHVd0ks9ifGYw0OyZhS6v63EEUpam0sbn7sSA3MXmnjm63JJ92zl8jf6p8MSlQ7YK0lvWnqJkyazo2lqIq9ywhHuwjLH1Z4QO/rlz9yb56NoT6QSSivTW9yzU4i89GtBnF0WIzwDl5TGANbye4kYu/RYQo+23e/A5hsRhmLwFsc7QBu78EGk6ggpdRhWMOcl17NOzYrejHv2euLwv0/wzm7Slc8a7+r6KNP1+0uDwcy6UGcWM/1kwHzc2qZ9V8baXzJLbv9D8wP7LkmIvBF+7nsBpKkwS7FfQShIkU9D2XVlW+a2/gjW5QXGDivA1XJWesYAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1002,"cache_read_input_tokens":157503,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1002},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"0cd28ca3-dd68-4e45-a9e3-8fba4750287b","timestamp":"2026-08-26T01:44:24.865Z","request_id":"req_011CeQWieMZtr5EQJ3iNM58s"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWihYZDNYjNtYjDKGkf","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_017wbSKWHoiHnPVyE5ypoLNv","name":"Glob","input":{"pattern":"**/icons/svg/**/*.svg"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1002,"cache_read_input_tokens":157503,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1002},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"176fa564-3861-41eb-af82-3982d2c97a20","timestamp":"2026-08-26T01:44:25.589Z","request_id":"req_011CeQWieMZtr5EQJ3iNM58s"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_017wbSKWHoiHnPVyE5ypoLNv","type":"tool_result","content":"figma-data/published/icons/svg/Arrow/Double-down__1149_23106.svg\nfigma-data/published/icons/svg/Arrow/Double-up__1149_23074.svg\nfigma-data/published/icons/svg/Arrow/Down__1149_23407.svg\nfigma-data/published/icons/svg/Arrow/Dropdown__1150_23504.svg\nfigma-data/published/icons/svg/Arrow/Left-1__1149_23313.svg\nfigma-data/published/icons/svg/Arrow/Next__1149_23171.svg\nfigma-data/published/icons/svg/Arrow/Previous__1149_23143.svg\nfigma-data/published/icons/svg/Arrow/Right-1__1149_23262.svg\nfigma-data/published/icons/svg/Arrow/Sorting__1150_23469.svg\nfigma-data/published/icons/svg/Arrow/Switch__1149_23207.svg\nfigma-data/published/icons/svg/Arrow/Up__1149_23391.svg\nfigma-data/published/icons/svg/Arrow/Updown__1153_23438.svg\nfigma-data/published/icons/svg/Arrow/left-2__2645_28000.svg\nfigma-data/published/icons/svg/Arrow/right-2__2645_28001.svg\nfigma-data/published/icons/svg/Arrow/to-first-page__2645_28002.svg\nfigma-data/published/icons/svg/Arrow/to-last-page__2645_28003.svg\nfigma-data/published/icons/svg/Cut/Dissolve__1408_16823.svg\nfigma-data/published/icons/svg/Cut/Hard-cut__1400_16693.svg\nfigma-data/published/icons/svg/Cut/Iris-in__1408_16824.svg\nfigma-data/published/icons/svg/Cut/Iris-out__1408_16825.svg\nfigma-data/published/icons/svg/Cut/L-band-1__1408_16827.svg\nfigma-data/published/icons/svg/Cut/L-band-2__1408_16828.svg\nfigma-data/published/icons/svg/Cut/L-band-3__1408_16829.svg\nfigma-data/published/icons/svg/Cut/L-band-4__1408_16830.svg\nfigma-data/published/icons/svg/Cut/Singular-cut__1408_16826.svg\nfigma-data/published/icons/svg/Cut/Stinger__1956_8656.svg\nfigma-data/published/icons/svg/Edit/Add-1__1155_24160.svg\nfigma-data/published/icons/svg/Edit/Add-2__1155_24225.svg\nfigma-data/published/icons/svg/Edit/Add-3__1155_24428.svg\nfigma-data/published/icons/svg/Edit/Add-list__1352_27690.svg\nfigma-data/published/icons/svg/Edit/Clear-1__1155_24588.svg\nfigma-data/published/icons/svg/Edit/Clear-2__1155_24638.svg\nfigma-data/published/icons/svg/Edit/Clear-3__1155_24773.svg\nfigma-data/published/icons/svg/Edit/Clip__1155_25006.svg\nfigma-data/published/icons/svg/Edit/Close__1155_24553.svg\nfigma-data/published/icons/svg/Edit/Copy-link__1169_24404.svg\nfigma-data/published/icons/svg/Edit/Copy__1155_25119.svg\nfigma-data/published/icons/svg/Edit/Delete__1155_24517.svg\nfigma-data/published/icons/svg/Edit/Edit__1155_24846.svg\nfigma-data/published/icons/svg/Edit/Edited__1351_26648.svg\nfigma-data/published/icons/svg/Edit/Minus-2__1155_24267.svg\nfigma-data/published/icons/svg/Edit/Minus__1155_24184.svg\nfigma-data/published/icons/svg/Edit/Multi-select__1131_23285.svg\nfigma-data/published/icons/svg/Edit/Rename__1324_26949.svg\nfigma-data/published/icons/svg/Edit/Save__1155_24938.svg\nfigma-data/published/icons/svg/Edit/Selected__1128_23193.svg\nfigma-data/published/icons/svg/Edit/accreditation-edit__2004_18252.svg\nfigma-data/published/icons/svg/Edit/align-left__3280_135.svg\nfigma-data/published/icons/svg/Edit/align-middle__3280_136.svg\nfigma-data/published/icons/svg/Edit/align-right__3280_137.svg\nfigma-data/published/icons/svg/Edit/bold__2145_181.svg\nfigma-data/published/icons/svg/Edit/calculate__2352_15654.svg\nfigma-data/published/icons/svg/Edit/description__2105_185.svg\nfigma-data/published/icons/svg/Edit/disabled__2107_240.svg\nfigma-data/published/icons/svg/Edit/insert__1214_3572.svg\nfigma-data/published/icons/svg/Edit/italic__2145_182.svg\nfigma-data/published/icons/svg/Edit/merge-words__1293_176.svg\nfigma-data/published/icons/svg/Edit/redo__2481_15549.svg\nfigma-data/published/icons/svg/Edit/split-words__1293_177.svg\nfigma-data/published/icons/svg/Edit/text__1251_64205.svg\nfigma-data/published/icons/svg/Edit/underline__2145_183.svg\nfigma-data/published/icons/svg/Edit/undo__2481_15548.svg\nfigma-data/published/icons/svg/Feature/AI-frame-interpolation__1352_27437.svg\nfigma-data/published/icons/svg/Feature/AI-setting__1352_27305.svg\nfigma-data/published/icons/svg/Feature/Auto-failover__1352_27156.svg\nfigma-data/published/icons/svg/Feature/Auto-response__1352_27472.svg\nfigma-data/published/icons/svg/Feature/Demo__1355_28811.svg\nfigma-data/published/icons/svg/Feature/Glacier__1355_28735.svg\nfigma-data/published/icons/svg/Feature/PTZ-control__1352_27089.svg\nfigma-data/published/icons/svg/Feature/PTZ-home__1355_27982.svg\nfigma-data/published/icons/svg/Feature/Recently-used__1355_27755.svg\nfigma-data/published/icons/svg/Feature/Restore__1355_28751.svg\nfigma-data/published/icons/svg/Feature/insync__4721_1772.svg\nfigma-data/published/icons/svg/Filter/Filter-add__1248_23550.svg\nfigma-data/published/icons/svg/Filter/Filter-offline__1352_27663.svg\nfigma-data/published/icons/svg/Filter/Filter-online__1352_27611.svg\nfigma-data/published/icons/svg/Filter/Filter__1243_23935.svg\nfigma-data/published/icons/svg/Filter/Move-top__1249_23933.svg\nfigma-data/published/icons/svg/Filter/Restore-Filter__1415_118.svg\nfigma-data/published/icons/svg/Filter/Sort-ascending__2106_228.svg\nfigma-data/published/icons/svg/Filter/Sort-descending__1981_14817.svg\nfigma-data/published/icons/svg/Filter/Sorting-Time-ascending__1249_23891.svg\nfigma-data/published/icons/svg/Filter/Sorting-Time-descending__1249_23833.svg\nfigma-data/published/icons/svg/Filter/Sorting-a-z__1249_23664.svg\nfigma-data/published/icons/svg/Filter/Sorting-dynamic__1249_23759.svg\nfigma-data/published/icons/svg/Filter/Sorting-z-a__2706_135.svg\nfigma-data/published/icons/svg/Filter/move-to-bottom__1249_23967.svg\nfigma-data/published/icons/svg/Filter/untop__2845_135.svg\nfigma-data/published/icons/svg/Meeting/1vN-VoIP-1__1336_40834.svg\nfigma-data/published/icons/svg/Meeting/1vN-VoIP-2__1336_40857.svg\nfigma-data/published/icons/svg/Meeting/AI-helper__1356_71779.svg\nfigma-data/published/icons/svg/Meeting/Calling-1__1336_40623.svg\nfigma-data/published/icons/svg/Meeting/Calling-2__1336_40530.svg\nfigma-data/published/icons/svg/Meeting/Chat-1__1336_40710.svg\nfigma-data/published/icons/svg/Meeting/Chat-2__1336_40683.svg\nfigma-data/published/icons/svg/Meeting/Connecting-1__1336_40413.svg\nfigma-data/published/icons/svg/Meeting/Connecting-2__1329_27107.svg\nfigma-data/published/icons/svg/Meeting/Echo-off__1356_70472.svg\nfigma-data/published/icons/svg/Meeting/Echo-on__1356_70182.svg\nfigma-data/published/icons/svg/Meeting/Intercom-In__1356_71411.svg\n(Showing 100 of 1288 matching files; 1188 more are not listed. Narrow the pattern or path to see the rest.)"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"ead61fe2-c42b-4ec9-aad9-29b8bb13dd54","timestamp":"2026-08-26T01:44:25.682Z","tool_use_result":{"filenames":["figma-data/published/icons/svg/Arrow/Double-down__1149_23106.svg","figma-data/published/icons/svg/Arrow/Double-up__1149_23074.svg","figma-data/published/icons/svg/Arrow/Down__1149_23407.svg","figma-data/published/icons/svg/Arrow/Dropdown__1150_23504.svg","figma-data/published/icons/svg/Arrow/Left-1__1149_23313.svg","figma-data/published/icons/svg/Arrow/Next__1149_23171.svg","figma-data/published/icons/svg/Arrow/Previous__1149_23143.svg","figma-data/published/icons/svg/Arrow/Right-1__1149_23262.svg","figma-data/published/icons/svg/Arrow/Sorting__1150_23469.svg","figma-data/published/icons/svg/Arrow/Switch__1149_23207.svg","figma-data/published/icons/svg/Arrow/Up__1149_23391.svg","figma-data/published/icons/svg/Arrow/Updown__1153_23438.svg","figma-data/published/icons/svg/Arrow/left-2__2645_28000.svg","figma-data/published/icons/svg/Arrow/right-2__2645_28001.svg","figma-data/published/icons/svg/Arrow/to-first-page__2645_28002.svg","figma-data/published/icons/svg/Arrow/to-last-page__2645_28003.svg","figma-data/published/icons/svg/Cut/Dissolve__1408_16823.svg","figma-data/published/icons/svg/Cut/Hard-cut__1400_16693.svg","figma-data/published/icons/svg/Cut/Iris-in__1408_16824.svg","figma-data/published/icons/svg/Cut/Iris-out__1408_16825.svg","figma-data/published/icons/svg/Cut/L-band-1__1408_16827.svg","figma-data/published/icons/svg/Cut/L-band-2__1408_16828.svg","figma-data/published/icons/svg/Cut/L-band-3__1408_16829.svg","figma-data/published/icons/svg/Cut/L-band-4__1408_16830.svg","figma-data/published/icons/svg/Cut/Singular-cut__1408_16826.svg","figma-data/published/icons/svg/Cut/Stinger__1956_8656.svg","figma-data/published/icons/svg/Edit/Add-1__1155_24160.svg","figma-data/published/icons/svg/Edit/Add-2__1155_24225.svg","figma-data/published/icons/svg/Edit/Add-3__1155_24428.svg","figma-data/published/icons/svg/Edit/Add-list__1352_27690.svg","figma-data/published/icons/svg/Edit/Clear-1__1155_24588.svg","figma-data/published/icons/svg/Edit/Clear-2__1155_24638.svg","figma-data/published/icons/svg/Edit/Clear-3__1155_24773.svg","figma-data/published/icons/svg/Edit/Clip__1155_25006.svg","figma-data/published/icons/svg/Edit/Close__1155_24553.svg","figma-data/published/icons/svg/Edit/Copy-link__1169_24404.svg","figma-data/published/icons/svg/Edit/Copy__1155_25119.svg","figma-data/published/icons/svg/Edit/Delete__1155_24517.svg","figma-data/published/icons/svg/Edit/Edit__1155_24846.svg","figma-data/published/icons/svg/Edit/Edited__1351_26648.svg","figma-data/published/icons/svg/Edit/Minus-2__1155_24267.svg","figma-data/published/icons/svg/Edit/Minus__1155_24184.svg","figma-data/published/icons/svg/Edit/Multi-select__1131_23285.svg","figma-data/published/icons/svg/Edit/Rename__1324_26949.svg","figma-data/published/icons/svg/Edit/Save__1155_24938.svg","figma-data/published/icons/svg/Edit/Selected__1128_23193.svg","figma-data/published/icons/svg/Edit/accreditation-edit__2004_18252.svg","figma-data/published/icons/svg/Edit/align-left__3280_135.svg","figma-data/published/icons/svg/Edit/align-middle__3280_136.svg","figma-data/published/icons/svg/Edit/align-right__3280_137.svg","figma-data/published/icons/svg/Edit/bold__2145_181.svg","figma-data/published/icons/svg/Edit/calculate__2352_15654.svg","figma-data/published/icons/svg/Edit/description__2105_185.svg","figma-data/published/icons/svg/Edit/disabled__2107_240.svg","figma-data/published/icons/svg/Edit/insert__1214_3572.svg","figma-data/published/icons/svg/Edit/italic__2145_182.svg","figma-data/published/icons/svg/Edit/merge-words__1293_176.svg","figma-data/published/icons/svg/Edit/redo__2481_15549.svg","figma-data/published/icons/svg/Edit/split-words__1293_177.svg","figma-data/published/icons/svg/Edit/text__1251_64205.svg","figma-data/published/icons/svg/Edit/underline__2145_183.svg","figma-data/published/icons/svg/Edit/undo__2481_15548.svg","figma-data/published/icons/svg/Feature/AI-frame-interpolation__1352_27437.svg","figma-data/published/icons/svg/Feature/AI-setting__1352_27305.svg","figma-data/published/icons/svg/Feature/Auto-failover__1352_27156.svg","figma-data/published/icons/svg/Feature/Auto-response__1352_27472.svg","figma-data/published/icons/svg/Feature/Demo__1355_28811.svg","figma-data/published/icons/svg/Feature/Glacier__1355_28735.svg","figma-data/published/icons/svg/Feature/PTZ-control__1352_27089.svg","figma-data/published/icons/svg/Feature/PTZ-home__1355_27982.svg","figma-data/published/icons/svg/Feature/Recently-used__1355_27755.svg","figma-data/published/icons/svg/Feature/Restore__1355_28751.svg","figma-data/published/icons/svg/Feature/insync__4721_1772.svg","figma-data/published/icons/svg/Filter/Filter-add__1248_23550.svg","figma-data/published/icons/svg/Filter/Filter-offline__1352_27663.svg","figma-data/published/icons/svg/Filter/Filter-online__1352_27611.svg","figma-data/published/icons/svg/Filter/Filter__1243_23935.svg","figma-data/published/icons/svg/Filter/Move-top__1249_23933.svg","figma-data/published/icons/svg/Filter/Restore-Filter__1415_118.svg","figma-data/published/icons/svg/Filter/Sort-ascending__2106_228.svg","figma-data/published/icons/svg/Filter/Sort-descending__1981_14817.svg","figma-data/published/icons/svg/Filter/Sorting-Time-ascending__1249_23891.svg","figma-data/published/icons/svg/Filter/Sorting-Time-descending__1249_23833.svg","figma-data/published/icons/svg/Filter/Sorting-a-z__1249_23664.svg","figma-data/published/icons/svg/Filter/Sorting-dynamic__1249_23759.svg","figma-data/published/icons/svg/Filter/Sorting-z-a__2706_135.svg","figma-data/published/icons/svg/Filter/move-to-bottom__1249_23967.svg","figma-data/published/icons/svg/Filter/untop__2845_135.svg","figma-data/published/icons/svg/Meeting/1vN-VoIP-1__1336_40834.svg","figma-data/published/icons/svg/Meeting/1vN-VoIP-2__1336_40857.svg","figma-data/published/icons/svg/Meeting/AI-helper__1356_71779.svg","figma-data/published/icons/svg/Meeting/Calling-1__1336_40623.svg","figma-data/published/icons/svg/Meeting/Calling-2__1336_40530.svg","figma-data/published/icons/svg/Meeting/Chat-1__1336_40710.svg","figma-data/published/icons/svg/Meeting/Chat-2__1336_40683.svg","figma-data/published/icons/svg/Meeting/Connecting-1__1336_40413.svg","figma-data/published/icons/svg/Meeting/Connecting-2__1329_27107.svg","figma-data/published/icons/svg/Meeting/Echo-off__1356_70472.svg","figma-data/published/icons/svg/Meeting/Echo-on__1356_70182.svg","figma-data/published/icons/svg/Meeting/Intercom-In__1356_71411.svg"],"durationMs":89,"numFiles":100,"truncated":true,"totalMatches":1288,"countIsComplete":true}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWihYZDNYjNtYjDKGkf","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01D6EBK2TRTvsvL8fJWH3Zpx","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/figma-component-catalog.md","offset":40,"limit":200},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1002,"cache_read_input_tokens":157503,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1002},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"5d9b10c0-c709-4c92-a20e-c3b467883d78","timestamp":"2026-08-26T01:44:26.036Z","request_id":"req_011CeQWieMZtr5EQJ3iNM58s"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01D6EBK2TRTvsvL8fJWH3Zpx","type":"tool_result","content":"40\t| Library key | `lk-057f6ba0f771bfa7f63a6a197502999462c2974f995488b381708ca5faadb7f9f6675e04aa442b3a5ffb31732150a7f5aa8ca3102073ab210edc684022fc6c21` |\n41\t| Library file key | `YbsPRUVmNdsbN40NNwh1Gn` |\n42\t| Manifest source | `figma-data/normalized/components.manifest.json`(运行 `node figma-sync/generate-manifest.mjs` 重建) |\n43\t| Code mapping | `figma-data/figma-to-code-mapping.json` |\n44\t\n45\t---\n46\t\n47\t## 📐 Styles & Variables(库样式 / 变量目录)— 2026-06-12 新增\n48\t\n49\t> mockup 绑样式/变量前**查这里或直读库源文件**(`getLocalTextStylesAsync` / `getLocalVariableCollectionsAsync`),**禁止**扫产品文件\"使用中\"的 id 反推库有什么(M52.1;2026-06-12 BM-1047 实证:扫现场误报\"库无 20/24 字号与 spacing 变量\")。\n50\t\n51\t- **Text Styles(14)**:`Roboto/12 tips`(lh16) · `14 body` · `16 pop title` · `18 headline 2` · `20 headline 1` · `22 large title` · `24 large title`(14+ lh150%;16-24 SemiBold)+ `Roboto/PingFang SC/*` 双语系列同档 ×7\n52\t- **Effect Styles(4)**:`L1/L2/L3 shadow`(**popup 卡基线 = L3**,Notification 自带实证)+ `Mask blur8 #000-60%`\n53\t- **Variables(TVU Design System collection · 98 个)**:色彩(`UX/*` · `Color Type/*`)· `Spacing/XXS-M` · `Basic Size/#2-#80`(2/4/8/12/16/20/24/32/36/40/48/56/64/80)· `Radius/XS-XXL` · `Size/*` · `Module Width/*`\n54\t- **间距纪律**:mockup 取值必须落在档位上并 `setBoundVariable`;非档位值起手吸附到最近档(M52.1),库缺档不默认触发新增\n55\t\n56\t---\n57\t\n58\t## ✅ Verified Components\n59\t\n60\t### Badge\n61\t- **Library key**: `4db5246d0782fe13bcc01747a7a2578c2da77b2a`\n62\t- **Axes**: `Type` (Circle / Rectangle) × `Color` (Green / Blue / Orange / Red / Black) × `Tag` (Filled / Line)\n63\t- **Variants**: 20\n64\t- **Code mapping**: `Badge` (status: approved)\n65\t\n66\t#### Primary use\n67\t状态/计数指示器 (status pill)。最常用于 row-level INPUT/OUTPUT 状态显示。\n68\t\n69\t#### Extension scenarios\n70\t- **Status pill**(INPUT/OUTPUT 列):`Type=Rectangle, Color=Red/Green/Black, Tag=Filled` —— Live=Red, Preview=Green, Inactive=Black\n71\t- **N/A pill**(input-only/output-only app 的对应空列):`Type=Rectangle, Color=Black, Tag=Line` —— outline 表达\"该位置不存在\"\n72\t- **CapabilityTag**(`input-only` / `output-only` metadata):`Type=Rectangle, Color=Black, Tag=Line` + 文本覆盖 —— outline 矩形是只读信息标签的标准 primitive\n73\t- **Active count badge**(卡片头 \"X active\"):`Type=Rectangle, Color=Green, Tag=Filled` + 文本覆盖\n74\t- **Sessions count badge**(折叠卡片 \"X sessions\"):`Type=Rectangle, Color=Black, Tag=Filled` + 文本覆盖\n75\t- **Top-bar status counters**(\"8 Live\" / \"12 Previewing\" / \"19 Total Sessions\"):同状态色 mapping,文本覆盖为 \"数字 + 标签\"\n76\t- **Session ON state pill**(Video Sync Multi-Session 等\"running 中\"指示):`Type=Rectangle, Color=Green, Tag=Line` —— **BRAND Green outline pill**(不是 Filled),区别于 Live=Red filled 的广播 on-air 语义;ON=BRAND 表达\"已配置在运行\",是品牌身份延伸而非 broadcast on-air。**2026-05-20 实证**:Video Sync v3 用 Blue Filled (BLUE=#3892F3) 当 ON 被用户判错 → 改 BRAND Green + Tag=Line outline,与 selected indicator 4px BRAND rail 同源视觉。\n77\t- **Session OFF state pill**(同上\"未运行\"指示):`Type=Rectangle, Color=Black, Tag=Line` —— Neutral outline,跟 N/A pill / CapabilityTag 共用 outline 风格\n78\t\n79\t#### Don't use for\n80\t- 大块 callout / inline message —— 用 `Notification` 或 `Message`\n81\t- 可点击的 selector / chip —— 用 `Tab/Item`(Badge 是只读 indicator,不是 interactive primitive)\n82\t\n83\t#### Used by\n84\t- Session Dashboard (Frame 1, node `2969:85`, 2026-05-06)\n85\t\n86\t---\n87\t\n88\t### Button/dark M\n89\t- **Library key**: `12b38c8b68cd67dd3978e0d68712bc646f1e97c1`\n90\t- **Axes**: `icon` (right / left / loading / no) × `style` (filling / ghost / rimless) × `color` (gray 1 / green / orange / red) × `status` (default / loading / hover / disable) × `radius` × `fixed width`\n91\t- **Variants**: 400\n92\t- **Code mapping**: `Button` (status: approved)\n93\t\n94\t#### Primary use\n95\tDark theme 中等尺寸按钮 (32px 高)。**所有 row-level / header-level / modal action 按钮的默认选择**。\n96\t\n97\t#### Extension scenarios\n98\t- **Action buttons in table rows** (operator console):`style=ghost`,颜色由 row state 决定 —— `gray 1` (Open GUI 中性), `red` (Stop / Remove destructive), `green` (Start)\n99\t- **Modal destructive button**:`style=filling, color=red, status=default`\n100\t- **Modal cancel button**:`style=ghost, color=gray 1, status=default`\n101\t- **Header CTA**:`style=filling, color=green` (positive primary action)\n102\t\n103\t#### Don't use for\n104\t- **不要自画 XS chip 替代它**(M7 + M2 双重违反)。column 不够宽就让 column 变宽\n105\t- 行内极小按钮:虽然有 `Button/dark XS`,但 operator console **必须**用 M 维持 Fitts 命中率(M7)\n106\t- Filter chip:用 `Tab/Item Type=Filled` 而非 Button\n107\t\n108\t#### Known gap — `color` 轴无 blue,但库里有 `UX/Blue/*` token(2026-08-03 实测)\n109\t\n110\t`dark M` / `dark L` / `dark S` / `light M` 四个组件集各 400 变体,`color` 轴**一律只有 `gray 1 / green / orange / red`**。而库里**有**蓝色 token(`UX/Blue/Default` Dark `#3892f3` · `UX/Blue/Hover 1` Dark `#62a9f6`),且 RPS One LCD 的 `Stop Test` 按钮实测填充正是 `grad #62a9f6 → #3892f3` —— **蓝色早已在产品里承载「停止 / 正在运行」语义,只是 Button 组件不暴露这一档**。需要这类「非破坏性但要与主操作区分」的动作时,red 语义过重、green 与「开始」撞色、gray 读不出是主动作,消费方只能在 instance 上覆写填充。**修法:给 `color` 轴增 `blue`,绑既有 token 即可,无需新增 token**。见 backlog [[CANONICAL-F94]];案例决策见 TVU Pack `docs/specs/2026-07-28-v4-2333-test-signal-parameters-design.md` **D20**。\n111\t\n112\t#### Used by\n113\t- Session Dashboard (Frame 1, 2026-05-06) — 27 instances\n114\t\n115\t---\n116\t\n117\t### Tab/Item\n118\t- **Library key**: `2267405386cb3186ba920b0d0b790d54e65a1529`\n119\t- **Axes**: `Property 1` (Active / Normal) × `Property 2` (Green / White) × `Type` (Line / Filled / Text)\n120\t- **Variants**: 6\n121\t\n122\t#### Primary use\n123\t单选导航 tab(切换内容面板)。\n124\t\n125\t#### Extension scenarios\n126\t- **FilterChip — 单选过滤器**(如 Filter Bar 的 All / Live / Previewing / Inactive Only):\n127\t - Selected: `Property 1=Active, Property 2=Green, Type=Filled`\n128\t - Default: `Property 1=Normal, Property 2=White, Type=Filled`\n129\t - 视觉差异:tab 是矩形小圆角而非 cornerRadius=999 的 pill;语义匹配(单选 + 缩范围)。\n130\t\n131\t#### Don't use for\n132\t- 多选 filter(Tab 是单选语义;多选用 checkbox 或 chip-with-checkmark pattern)\n133\t- 静态信息标签(用 `Badge` Type=Rectangle, Tag=Line)\n134\t\n135\t#### Known gap — 无 disabled 态(2026-08-03 实测)\n136\t实存组合只有 **6 个变体**,**没有 disabled / enable 轴**(同族的 `select box/filled` / `input box/filled` / `switch` / `radio` 都有)。表单整体禁用而其中含 tab 时,Figma 侧无变体可切 —— mockup 只能整组降透明度示意。⚠️ **2026-08-14 订正:「code 侧必须实现真禁用态」这句读起来像待做,实际 DS 侧早已实现** —— `TabItem` 有 `disabled` prop(非交互 + `aria-disabled` + `tabindex=-1` + `--text-disabled`),消费产品直接用它即可、**不要自己降透明度**;Figma 侧缺口仍在,归 [`design-review-queue.md`](./design-review-queue.md) §3 第 4 个成员(原 backlog `CANONICAL-F92` 已同日删档)。案例决策见 TVU Pack `docs/specs/2026-07-28-v4-2333-test-signal-parameters-design.md` **D18 ⑤**。\n137\t\n138\t#### Known gap — 未选态填充不随模块背景(2026-08-03 实测)\n139\t`Type=Filled` 的未选态原生 fill = `#262626`(**已绑定变量**),隐含「容器底色显著深于 #262626」这个假设。实测 V4-2333 Config-T 内容区底色为 `#252525` → 对比度 **1.013**,未选分段与底色**不可辨**(owner 改用 `#353535` = 1.25;同底色下选中绿 `#2fb54e` = 5.723)。**结论不是换成另一个固定色值,而是未选态必须与所在模块底色保持可辨差异**,故该值应随模块背景取值。消费方目前只能逐文件覆写 fill,代价是脱离变量绑定。**关键线索**:`#262626` = `--bg-layer3`、`#353535` = `--bg-layer4`(同族 `input box/filled` 的填充底就用 layer4)—— 即未选态很可能只是**绑错了档位**,而非缺 token。见 backlog [[CANONICAL-F93]];案例决策见 TVU Pack `docs/specs/2026-07-28-v4-2333-test-signal-parameters-design.md` **D19**。\n140\t\n141\t#### 分段控件(segmented control)就用它,别用 Button\n142\t「在一组里选一个」的互斥控件语义是 tab,不是触发动作的 button —— 选中 `Property 1=Active, Property 2=Green, Type=Filled`、未选 `Property 1=Normal, Property 2=White, Type=Filled`。实证:V4-2333 Config-T 的 Position / Text Size 分段与 Tx 选择器曾误用旧库 `TVU UX Library` 的 `button/no icon`,2026-08-03 归正(D18)。\n143\t\n144\t---\n145\t\n146\t### Tab List\n147\t- **Library key**: `47efe04ff35b46602f0827f24c87af9dca3bae4b`\n148\t- **Axes**: `Type` (Line / Filled / Text)\n149\t- **Variants**: 3\n150\t- **Slot**: `List#4605:0` —— preferredValue 直接绑定 `Tab/Item` component_set\n151\t\n152\t#### Primary use\n153\t`Tab/Item` 的容器组件,处理多 tab 排版。\n154\t\n155\t#### Extension scenarios\n156\t- **Filter Bar 容器**:搭配 `Tab/Item` 当 FilterChip 用时,用 `Tab List Type=Filled` 作 wrapper,自动管理间距\n157\t\n158\t---\n159\t\n160\t### Top bar\n161\t- **Library key**: `918b928e4541f1573de5c98c32b408af663d7f2f`\n162\t- **Axes**: `Tag` (After Login / Before Login)\n163\t- **Variants**: 2\n164\t- **Properties**: `Show Menu` (BOOLEAN) / `Show Search box` (BOOLEAN) / `Menu` (SLOT) / `Right_content` (SLOT)\n165\t\n166\t#### Primary use\n167\tTVU 全产品页面顶部 bar(1920×56 After Login / 1920×64 Before Login)。**M1 硬规则**:任何 TVU 产品页面**必须** instance 此组件,不允许自画。\n168\t\n169\t#### Extension scenarios\n170\t- **Product 标题**:用自带 product-name slot(默认 placeholder \"Product Name\"),手动覆写为实际产品名(如 \"MicroApps Sessions\")。**不要**在 top bar 下方加重复 page-title strip\n171\t- **Right side custom content** (notifications / user / settings):用 `Right_content` SLOT\n172\t\n173\t#### Don't use for\n174\t- 把 page-level 元素塞进 slot —— **不允许**:counters / filter chips / 批量操作按钮。这些必须放在 top bar **下方**独立 strip\n175\t- 修改 top bar 结构本身(菜单数量 / Tokens 段 / Network Delay 等只能开关显示)\n176\t- 旧库 `TVU UX Library` 里有同名 `Top bar` (key `2f36c51a...`),**不要用**\n177\t\n178\t#### Used by\n179\t- 所有 TVU 产品 mockup(强制硬规则 M1)\n180\t\n181\t---\n182\t\n183\t### Notification ⟨confirm dialog / prompt / popconfirm / 确认弹窗 / 警告 / toast / alert / 信息条⟩\n184\t> **2026-06-04 修正**:本条原把一个 `prompt`-类幻影别名(key `e9574b39…` 实测 `importComponentByKeyAsync` **not found**)错挂到 Notification 上(并错把 Notification 描述成\"inline message bar 不是 modal\")。本条真源 = **`Notification` component-set**。关键词别名列在标题,确保 grep `confirm`/`popover`/`dialog`/`弹窗` 都命中本条。**注**:真正的轻量提示消息组件是独立的 **`Message`** set(node `1408:17153`,见上方 Message 条目),与 Notification 不是同一个。\n185\t- **Library key (SET)**: `23535120dbdc93bf90af9a118b5091e58b590dc6`\n186\t- **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`\n187\t- **Variants**: 32 — `slide` = 320×89 无按钮 toast(success/error/info/warning 全有)/ `alert` = 480 单按钮 / `dialog` = 480 双按钮+close。**反馈类 UI 一律从本 set 取 variant,不自画**(M52.3)\n188\t- ⚠️ 2026-06-12 Figma↔code 原子同步进行中(type 改名 secondary warning→danger / none→default,见 STATUS v0.10.0)——用前以 live probe `componentPropertyDefinitions` 为准\n189\t\n190\t#### Primary use\n191\t多用途反馈面:toast / side-pop / alert / info banner / **AND 确认弹窗**。\n192\t- **`pop confirm` / `quick confirm` = 设计系统的确认对话框**(含 X close + Title + Description + Cancel + destructive 按钮,destructive 默认 \"Delete\",按场景改 label 如 \"Remove\")。\n193\t\n194\t#### Extension scenarios\n195\t- **Destructive 二次确认 modal**(Remove on-air layer / Stop In-Out / 删除 session 等):用 `theme=dark, status=pop confirm`。\n196\t- 注:作 mockup 里的\"确认弹窗状态预览\" → 必 frame 外 + 连线(M23.9,**不可叠在产品 frame 上**)。\n197\t\n198\t#### Don't use for\n199\t- 自画 modal(M2 / M32 重灾区)。\n200\t- 大量内容 / 多 step 表单 → Drawer / 全屏 view。\n201\t\n202\t#### How to instance(file-local import-by-key 会 fail,走 set)\n203\t- `importComponentByKeyAsync('23535120…')` 取的是 **SET** → 用 **`importComponentSetByKeyAsync`** 拿 set,再从 `set.children` 按名 `theme=dark, status=pop confirm` `createInstance()`。\n204\t- **Title / Description 在嵌套 content SLOT(`Notification_content#…` 是 SLOT property),无 TEXT component-property** → 改文本必走下方精化协议(2026-06-05 BM-1047 S5 实证补全)。\n205\t- **SLOT 默认 text 编辑精化协议(实证机制)**:SLOT 默认内容里的 leaf TEXT 一旦 `node.characters = '…'` 即被 override **替换、原 ref 失效**。连带踩坑:\n206\t 1. `getNodeByIdAsync('I…;…')` **解析不了** SLOT 内部复合 ID → 必须从 instance **遍历**拿 ref,不能按 ID 直取。\n207\t 2. `await loadFontAsync` 会让已拿到的 SLOT-text ref 失效(\"node not found\")→ **必须先 load 字体(所有 await 放最前),再同步遍历拿 fresh ref,再 set**。\n208\t 3. set 之后**不可读回**(`done = node.characters`)、**不可继续遍历**(ref 已死)→ 找到目标就 set 完立刻 return。\n209\t 4. 故 **一个文本一个 `use_figma` 脚本**(标题/描述/按钮各一)。字体先用同步 probe(`getRangeFontName`,一次 await 内)拿到,实测 = `Roboto SemiBold`(标题) / `Roboto Regular`(描述/按钮)。\n210\t - 按钮 label 在嵌套 `Button/dark M` 实例内,同样走\"遍历→set→return\"。\n211\t\n212\t#### Compare with\n213\t- `Popup Box` (2 variants Theme) —— **大型自定义内容模态壳**(全屏遮罩 + 任意 slot 正文),**不是** 确认框:一个只是「确认某操作」的弹窗要走本条(`Notification form=dialog / pop confirm`),不是 Popup Box。⚠️ 此处原写「简单弹窗,纯 informational 场景」与该判据矛盾,2026-08-13 订正(同轮订正的还有本文件 §Message Don't-use-for 与 `component-affordances.json` 两条 `when_to_use`;真源判据 = `docs/CLAUDE_DESIGN_RULES.md` §3)。\n214\t\n215\t#### Gotcha:footer 按钮行不是 slot,改自定义 action 组合前必须 `detachInstance()`\n216\t默认 footer(Cancel + Confirm 两按钮行,layer 名 `comfirm`)是**普通嵌套 INSTANCE 结构**,不是 SLOT——`footer.children.forEach(c => c.remove())` 会直接抛 `Removing this node is not allowed`(instance 内容结构锁定,不允许增删子节点)。若要做非标准 footer(如超过 2 个 action、混排按钮+文字链接),先在**顶层** instance 上调用 `card.detachInstance()`(返回新的可编辑 FrameNode,替换原位置),再对 detach 后的 frame 做 remove/append——嵌套图标/按钮仍保留各自的 INSTANCE 引用,只是外层容器结构变可编辑。**实证**:2026-07-16 MH-3263 浏览器警告 interstitial,footer 需要 [Copy Link 按钮] + [Download 链接] + [Continue anyway 链接] 三元素组合,直接 remove 两默认按钮报错,`detachInstance()` 后恢复正常。\n217\t\n218\t---\n219\t\n220\t### Message ⟨prompt / 提示消息 / status line / 顶部瞬时消息⟩\n221\t> **2026-06-12**:Figma component-set 从 \"prompt message\" 改名为 **\"Message\"** 并重发布(node `1408:17153` 未变);代码侧公共组件 `PromptMessage` 同步改名为 **`Message`**。早期把它当 Notification 幻影别名(见下方 Notification 修正注)已纠正——`Message` 是独立 first-class 组件集,不是 Notification。\n222\t- **Figma node**: `1408:17153`(component-set)\n223\t- **Code export**: `Message`(canonical `src/canonical/Message.vue` → base `src/components/Message/Message.vue`)\n224\t- **Axes**: `status` (success / info / error / warning) × `size` (L / M)\n225\t- **Variants**: 8\n226\t\n227\t#### Primary use\n228\t顶部瞬时消息:最轻量的非阻塞反馈,无操作按钮,只是会消失的状态行。L = 点击关闭,M = 自动消失。\n229\t\n230\t#### Don't use for\n231\t- 需用户决策 / 阻塞流程 → 用 `Notification`(`form=dialog` / `pop confirm` / `alert`)。**⛔ 别选 `Popup Box`** —— 它只承载 Notification 固定结构装不下的大型自定义内容(表单 / 设置 / 向导 / 详情),纯确认用它 = 选错(判据见 `CLAUDE_DESIGN_RULES.md` §3 + `component-affordances.json` 两条 `when_to_use`)。\n232\t\n233\t#### Owner ruling — **无 theme 轴是有意为之,不是缺口**(2026-08-03 拍板,勿再提案加 dark theme)\n234\t- **owner 原话**:「不用(立缺口),这个是设计库的真源,只维持一个主题就行,不用两个主题。」\n235\t- **背景**:`Message` 只有 `status × size` 两轴(同族 `Notification` 才有 theme 轴),所以它落在深色界面上会呈浅色。V4-2333 Config-T 走查连续两轮把这条列为「待裁定的疑似缺口」,轮十五 owner 拍板 **不立**。\n236\t- ⇒ **不要给本组件立 backlog、不要提案增 theme 轴、不要在消费文件里改它的色**。改色即断变量绑定、违反 binding-fidelity;交付卡须写明「dev 不要自行改色」。\n237\t- **实证两端同源(2026-08-03 逐端 probe,非照抄前轮记录)**:Config-T `rJJjWWs51n2iFOlCIC7aYG` page `8075:2` 运行态 toast(`status=success` × `size=L`,深色内容区上呈浅色,按发布原样使用)· LCD `0054ib0nLmt27bC3QlGDl7` page `9343:2` 节点 `9472:84`(同一 key `e9574b39…`,实测 `{status:\"info\", size:\"L\"}`,文案 `Video input detected — Stop Test to switch`,显示正常)。两端用的是同一个组件集,差异只在 `status`。案例决策见 TVU Pack `docs/specs/2026-07-28-v4-2333-test-signal-parameters-design.md` **D21**。\n238\t\n239\t---"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"cfb22cac-110b-4938-99a6-b9d153598abf","timestamp":"2026-08-26T01:44:26.042Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/figma-component-catalog.md","content":"| Library key | `lk-057f6ba0f771bfa7f63a6a197502999462c2974f995488b381708ca5faadb7f9f6675e04aa442b3a5ffb31732150a7f5aa8ca3102073ab210edc684022fc6c21` |\n| Library file key | `YbsPRUVmNdsbN40NNwh1Gn` |\n| Manifest source | `figma-data/normalized/components.manifest.json`(运行 `node figma-sync/generate-manifest.mjs` 重建) |\n| Code mapping | `figma-data/figma-to-code-mapping.json` |\n\n---\n\n## 📐 Styles & Variables(库样式 / 变量目录)— 2026-06-12 新增\n\n> mockup 绑样式/变量前**查这里或直读库源文件**(`getLocalTextStylesAsync` / `getLocalVariableCollectionsAsync`),**禁止**扫产品文件\"使用中\"的 id 反推库有什么(M52.1;2026-06-12 BM-1047 实证:扫现场误报\"库无 20/24 字号与 spacing 变量\")。\n\n- **Text Styles(14)**:`Roboto/12 tips`(lh16) · `14 body` · `16 pop title` · `18 headline 2` · `20 headline 1` · `22 large title` · `24 large title`(14+ lh150%;16-24 SemiBold)+ `Roboto/PingFang SC/*` 双语系列同档 ×7\n- **Effect Styles(4)**:`L1/L2/L3 shadow`(**popup 卡基线 = L3**,Notification 自带实证)+ `Mask blur8 #000-60%`\n- **Variables(TVU Design System collection · 98 个)**:色彩(`UX/*` · `Color Type/*`)· `Spacing/XXS-M` · `Basic Size/#2-#80`(2/4/8/12/16/20/24/32/36/40/48/56/64/80)· `Radius/XS-XXL` · `Size/*` · `Module Width/*`\n- **间距纪律**:mockup 取值必须落在档位上并 `setBoundVariable`;非档位值起手吸附到最近档(M52.1),库缺档不默认触发新增\n\n---\n\n## ✅ Verified Components\n\n### Badge\n- **Library key**: `4db5246d0782fe13bcc01747a7a2578c2da77b2a`\n- **Axes**: `Type` (Circle / Rectangle) × `Color` (Green / Blue / Orange / Red / Black) × `Tag` (Filled / Line)\n- **Variants**: 20\n- **Code mapping**: `Badge` (status: approved)\n\n#### Primary use\n状态/计数指示器 (status pill)。最常用于 row-level INPUT/OUTPUT 状态显示。\n\n#### Extension scenarios\n- **Status pill**(INPUT/OUTPUT 列):`Type=Rectangle, Color=Red/Green/Black, Tag=Filled` —— Live=Red, Preview=Green, Inactive=Black\n- **N/A pill**(input-only/output-only app 的对应空列):`Type=Rectangle, Color=Black, Tag=Line` —— outline 表达\"该位置不存在\"\n- **CapabilityTag**(`input-only` / `output-only` metadata):`Type=Rectangle, Color=Black, Tag=Line` + 文本覆盖 —— outline 矩形是只读信息标签的标准 primitive\n- **Active count badge**(卡片头 \"X active\"):`Type=Rectangle, Color=Green, Tag=Filled` + 文本覆盖\n- **Sessions count badge**(折叠卡片 \"X sessions\"):`Type=Rectangle, Color=Black, Tag=Filled` + 文本覆盖\n- **Top-bar status counters**(\"8 Live\" / \"12 Previewing\" / \"19 Total Sessions\"):同状态色 mapping,文本覆盖为 \"数字 + 标签\"\n- **Session ON state pill**(Video Sync Multi-Session 等\"running 中\"指示):`Type=Rectangle, Color=Green, Tag=Line` —— **BRAND Green outline pill**(不是 Filled),区别于 Live=Red filled 的广播 on-air 语义;ON=BRAND 表达\"已配置在运行\",是品牌身份延伸而非 broadcast on-air。**2026-05-20 实证**:Video Sync v3 用 Blue Filled (BLUE=#3892F3) 当 ON 被用户判错 → 改 BRAND Green + Tag=Line outline,与 selected indicator 4px BRAND rail 同源视觉。\n- **Session OFF state pill**(同上\"未运行\"指示):`Type=Rectangle, Color=Black, Tag=Line` —— Neutral outline,跟 N/A pill / CapabilityTag 共用 outline 风格\n\n#### Don't use for\n- 大块 callout / inline message —— 用 `Notification` 或 `Message`\n- 可点击的 selector / chip —— 用 `Tab/Item`(Badge 是只读 indicator,不是 interactive primitive)\n\n#### Used by\n- Session Dashboard (Frame 1, node `2969:85`, 2026-05-06)\n\n---\n\n### Button/dark M\n- **Library key**: `12b38c8b68cd67dd3978e0d68712bc646f1e97c1`\n- **Axes**: `icon` (right / left / loading / no) × `style` (filling / ghost / rimless) × `color` (gray 1 / green / orange / red) × `status` (default / loading / hover / disable) × `radius` × `fixed width`\n- **Variants**: 400\n- **Code mapping**: `Button` (status: approved)\n\n#### Primary use\nDark theme 中等尺寸按钮 (32px 高)。**所有 row-level / header-level / modal action 按钮的默认选择**。\n\n#### Extension scenarios\n- **Action buttons in table rows** (operator console):`style=ghost`,颜色由 row state 决定 —— `gray 1` (Open GUI 中性), `red` (Stop / Remove destructive), `green` (Start)\n- **Modal destructive button**:`style=filling, color=red, status=default`\n- **Modal cancel button**:`style=ghost, color=gray 1, status=default`\n- **Header CTA**:`style=filling, color=green` (positive primary action)\n\n#### Don't use for\n- **不要自画 XS chip 替代它**(M7 + M2 双重违反)。column 不够宽就让 column 变宽\n- 行内极小按钮:虽然有 `Button/dark XS`,但 operator console **必须**用 M 维持 Fitts 命中率(M7)\n- Filter chip:用 `Tab/Item Type=Filled` 而非 Button\n\n#### Known gap — `color` 轴无 blue,但库里有 `UX/Blue/*` token(2026-08-03 实测)\n\n`dark M` / `dark L` / `dark S` / `light M` 四个组件集各 400 变体,`color` 轴**一律只有 `gray 1 / green / orange / red`**。而库里**有**蓝色 token(`UX/Blue/Default` Dark `#3892f3` · `UX/Blue/Hover 1` Dark `#62a9f6`),且 RPS One LCD 的 `Stop Test` 按钮实测填充正是 `grad #62a9f6 → #3892f3` —— **蓝色早已在产品里承载「停止 / 正在运行」语义,只是 Button 组件不暴露这一档**。需要这类「非破坏性但要与主操作区分」的动作时,red 语义过重、green 与「开始」撞色、gray 读不出是主动作,消费方只能在 instance 上覆写填充。**修法:给 `color` 轴增 `blue`,绑既有 token 即可,无需新增 token**。见 backlog [[CANONICAL-F94]];案例决策见 TVU Pack `docs/specs/2026-07-28-v4-2333-test-signal-parameters-design.md` **D20**。\n\n#### Used by\n- Session Dashboard (Frame 1, 2026-05-06) — 27 instances\n\n---\n\n### Tab/Item\n- **Library key**: `2267405386cb3186ba920b0d0b790d54e65a1529`\n- **Axes**: `Property 1` (Active / Normal) × `Property 2` (Green / White) × `Type` (Line / Filled / Text)\n- **Variants**: 6\n\n#### Primary use\n单选导航 tab(切换内容面板)。\n\n#### Extension scenarios\n- **FilterChip — 单选过滤器**(如 Filter Bar 的 All / Live / Previewing / Inactive Only):\n - Selected: `Property 1=Active, Property 2=Green, Type=Filled`\n - Default: `Property 1=Normal, Property 2=White, Type=Filled`\n - 视觉差异:tab 是矩形小圆角而非 cornerRadius=999 的 pill;语义匹配(单选 + 缩范围)。\n\n#### Don't use for\n- 多选 filter(Tab 是单选语义;多选用 checkbox 或 chip-with-checkmark pattern)\n- 静态信息标签(用 `Badge` Type=Rectangle, Tag=Line)\n\n#### Known gap — 无 disabled 态(2026-08-03 实测)\n实存组合只有 **6 个变体**,**没有 disabled / enable 轴**(同族的 `select box/filled` / `input box/filled` / `switch` / `radio` 都有)。表单整体禁用而其中含 tab 时,Figma 侧无变体可切 —— mockup 只能整组降透明度示意。⚠️ **2026-08-14 订正:「code 侧必须实现真禁用态」这句读起来像待做,实际 DS 侧早已实现** —— `TabItem` 有 `disabled` prop(非交互 + `aria-disabled` + `tabindex=-1` + `--text-disabled`),消费产品直接用它即可、**不要自己降透明度**;Figma 侧缺口仍在,归 [`design-review-queue.md`](./design-review-queue.md) §3 第 4 个成员(原 backlog `CANONICAL-F92` 已同日删档)。案例决策见 TVU Pack `docs/specs/2026-07-28-v4-2333-test-signal-parameters-design.md` **D18 ⑤**。\n\n#### Known gap — 未选态填充不随模块背景(2026-08-03 实测)\n`Type=Filled` 的未选态原生 fill = `#262626`(**已绑定变量**),隐含「容器底色显著深于 #262626」这个假设。实测 V4-2333 Config-T 内容区底色为 `#252525` → 对比度 **1.013**,未选分段与底色**不可辨**(owner 改用 `#353535` = 1.25;同底色下选中绿 `#2fb54e` = 5.723)。**结论不是换成另一个固定色值,而是未选态必须与所在模块底色保持可辨差异**,故该值应随模块背景取值。消费方目前只能逐文件覆写 fill,代价是脱离变量绑定。**关键线索**:`#262626` = `--bg-layer3`、`#353535` = `--bg-layer4`(同族 `input box/filled` 的填充底就用 layer4)—— 即未选态很可能只是**绑错了档位**,而非缺 token。见 backlog [[CANONICAL-F93]];案例决策见 TVU Pack `docs/specs/2026-07-28-v4-2333-test-signal-parameters-design.md` **D19**。\n\n#### 分段控件(segmented control)就用它,别用 Button\n「在一组里选一个」的互斥控件语义是 tab,不是触发动作的 button —— 选中 `Property 1=Active, Property 2=Green, Type=Filled`、未选 `Property 1=Normal, Property 2=White, Type=Filled`。实证:V4-2333 Config-T 的 Position / Text Size 分段与 Tx 选择器曾误用旧库 `TVU UX Library` 的 `button/no icon`,2026-08-03 归正(D18)。\n\n---\n\n### Tab List\n- **Library key**: `47efe04ff35b46602f0827f24c87af9dca3bae4b`\n- **Axes**: `Type` (Line / Filled / Text)\n- **Variants**: 3\n- **Slot**: `List#4605:0` —— preferredValue 直接绑定 `Tab/Item` component_set\n\n#### Primary use\n`Tab/Item` 的容器组件,处理多 tab 排版。\n\n#### Extension scenarios\n- **Filter Bar 容器**:搭配 `Tab/Item` 当 FilterChip 用时,用 `Tab List Type=Filled` 作 wrapper,自动管理间距\n\n---\n\n### Top bar\n- **Library key**: `918b928e4541f1573de5c98c32b408af663d7f2f`\n- **Axes**: `Tag` (After Login / Before Login)\n- **Variants**: 2\n- **Properties**: `Show Menu` (BOOLEAN) / `Show Search box` (BOOLEAN) / `Menu` (SLOT) / `Right_content` (SLOT)\n\n#### Primary use\nTVU 全产品页面顶部 bar(1920×56 After Login / 1920×64 Before Login)。**M1 硬规则**:任何 TVU 产品页面**必须** instance 此组件,不允许自画。\n\n#### Extension scenarios\n- **Product 标题**:用自带 product-name slot(默认 placeholder \"Product Name\"),手动覆写为实际产品名(如 \"MicroApps Sessions\")。**不要**在 top bar 下方加重复 page-title strip\n- **Right side custom content** (notifications / user / settings):用 `Right_content` SLOT\n\n#### Don't use for\n- 把 page-level 元素塞进 slot —— **不允许**:counters / filter chips / 批量操作按钮。这些必须放在 top bar **下方**独立 strip\n- 修改 top bar 结构本身(菜单数量 / Tokens 段 / Network Delay 等只能开关显示)\n- 旧库 `TVU UX Library` 里有同名 `Top bar` (key `2f36c51a...`),**不要用**\n\n#### Used by\n- 所有 TVU 产品 mockup(强制硬规则 M1)\n\n---\n\n### Notification ⟨confirm dialog / prompt / popconfirm / 确认弹窗 / 警告 / toast / alert / 信息条⟩\n> **2026-06-04 修正**:本条原把一个 `prompt`-类幻影别名(key `e9574b39…` 实测 `importComponentByKeyAsync` **not found**)错挂到 Notification 上(并错把 Notification 描述成\"inline message bar 不是 modal\")。本条真源 = **`Notification` component-set**。关键词别名列在标题,确保 grep `confirm`/`popover`/`dialog`/`弹窗` 都命中本条。**注**:真正的轻量提示消息组件是独立的 **`Message`** set(node `1408:17153`,见上方 Message 条目),与 Notification 不是同一个。\n- **Library key (SET)**: `23535120dbdc93bf90af9a118b5091e58b590dc6`\n- **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`\n- **Variants**: 32 — `slide` = 320×89 无按钮 toast(success/error/info/warning 全有)/ `alert` = 480 单按钮 / `dialog` = 480 双按钮+close。**反馈类 UI 一律从本 set 取 variant,不自画**(M52.3)\n- ⚠️ 2026-06-12 Figma↔code 原子同步进行中(type 改名 secondary warning→danger / none→default,见 STATUS v0.10.0)——用前以 live probe `componentPropertyDefinitions` 为准\n\n#### Primary use\n多用途反馈面:toast / side-pop / alert / info banner / **AND 确认弹窗**。\n- **`pop confirm` / `quick confirm` = 设计系统的确认对话框**(含 X close + Title + Description + Cancel + destructive 按钮,destructive 默认 \"Delete\",按场景改 label 如 \"Remove\")。\n\n#### Extension scenarios\n- **Destructive 二次确认 modal**(Remove on-air layer / Stop In-Out / 删除 session 等):用 `theme=dark, status=pop confirm`。\n- 注:作 mockup 里的\"确认弹窗状态预览\" → 必 frame 外 + 连线(M23.9,**不可叠在产品 frame 上**)。\n\n#### Don't use for\n- 自画 modal(M2 / M32 重灾区)。\n- 大量内容 / 多 step 表单 → Drawer / 全屏 view。\n\n#### How to instance(file-local import-by-key 会 fail,走 set)\n- `importComponentByKeyAsync('23535120…')` 取的是 **SET** → 用 **`importComponentSetByKeyAsync`** 拿 set,再从 `set.children` 按名 `theme=dark, status=pop confirm` `createInstance()`。\n- **Title / Description 在嵌套 content SLOT(`Notification_content#…` 是 SLOT property),无 TEXT component-property** → 改文本必走下方精化协议(2026-06-05 BM-1047 S5 实证补全)。\n- **SLOT 默认 text 编辑精化协议(实证机制)**:SLOT 默认内容里的 leaf TEXT 一旦 `node.characters = '…'` 即被 override **替换、原 ref 失效**。连带踩坑:\n 1. `getNodeByIdAsync('I…;…')` **解析不了** SLOT 内部复合 ID → 必须从 instance **遍历**拿 ref,不能按 ID 直取。\n 2. `await loadFontAsync` 会让已拿到的 SLOT-text ref 失效(\"node not found\")→ **必须先 load 字体(所有 await 放最前),再同步遍历拿 fresh ref,再 set**。\n 3. set 之后**不可读回**(`done = node.characters`)、**不可继续遍历**(ref 已死)→ 找到目标就 set 完立刻 return。\n 4. 故 **一个文本一个 `use_figma` 脚本**(标题/描述/按钮各一)。字体先用同步 probe(`getRangeFontName`,一次 await 内)拿到,实测 = `Roboto SemiBold`(标题) / `Roboto Regular`(描述/按钮)。\n - 按钮 label 在嵌套 `Button/dark M` 实例内,同样走\"遍历→set→return\"。\n\n#### Compare with\n- `Popup Box` (2 variants Theme) —— **大型自定义内容模态壳**(全屏遮罩 + 任意 slot 正文),**不是** 确认框:一个只是「确认某操作」的弹窗要走本条(`Notification form=dialog / pop confirm`),不是 Popup Box。⚠️ 此处原写「简单弹窗,纯 informational 场景」与该判据矛盾,2026-08-13 订正(同轮订正的还有本文件 §Message Don't-use-for 与 `component-affordances.json` 两条 `when_to_use`;真源判据 = `docs/CLAUDE_DESIGN_RULES.md` §3)。\n\n#### Gotcha:footer 按钮行不是 slot,改自定义 action 组合前必须 `detachInstance()`\n默认 footer(Cancel + Confirm 两按钮行,layer 名 `comfirm`)是**普通嵌套 INSTANCE 结构**,不是 SLOT——`footer.children.forEach(c => c.remove())` 会直接抛 `Removing this node is not allowed`(instance 内容结构锁定,不允许增删子节点)。若要做非标准 footer(如超过 2 个 action、混排按钮+文字链接),先在**顶层** instance 上调用 `card.detachInstance()`(返回新的可编辑 FrameNode,替换原位置),再对 detach 后的 frame 做 remove/append——嵌套图标/按钮仍保留各自的 INSTANCE 引用,只是外层容器结构变可编辑。**实证**:2026-07-16 MH-3263 浏览器警告 interstitial,footer 需要 [Copy Link 按钮] + [Download 链接] + [Continue anyway 链接] 三元素组合,直接 remove 两默认按钮报错,`detachInstance()` 后恢复正常。\n\n---\n\n### Message ⟨prompt / 提示消息 / status line / 顶部瞬时消息⟩\n> **2026-06-12**:Figma component-set 从 \"prompt message\" 改名为 **\"Message\"** 并重发布(node `1408:17153` 未变);代码侧公共组件 `PromptMessage` 同步改名为 **`Message`**。早期把它当 Notification 幻影别名(见下方 Notification 修正注)已纠正——`Message` 是独立 first-class 组件集,不是 Notification。\n- **Figma node**: `1408:17153`(component-set)\n- **Code export**: `Message`(canonical `src/canonical/Message.vue` → base `src/components/Message/Message.vue`)\n- **Axes**: `status` (success / info / error / warning) × `size` (L / M)\n- **Variants**: 8\n\n#### Primary use\n顶部瞬时消息:最轻量的非阻塞反馈,无操作按钮,只是会消失的状态行。L = 点击关闭,M = 自动消失。\n\n#### Don't use for\n- 需用户决策 / 阻塞流程 → 用 `Notification`(`form=dialog` / `pop confirm` / `alert`)。**⛔ 别选 `Popup Box`** —— 它只承载 Notification 固定结构装不下的大型自定义内容(表单 / 设置 / 向导 / 详情),纯确认用它 = 选错(判据见 `CLAUDE_DESIGN_RULES.md` §3 + `component-affordances.json` 两条 `when_to_use`)。\n\n#### Owner ruling — **无 theme 轴是有意为之,不是缺口**(2026-08-03 拍板,勿再提案加 dark theme)\n- **owner 原话**:「不用(立缺口),这个是设计库的真源,只维持一个主题就行,不用两个主题。」\n- **背景**:`Message` 只有 `status × size` 两轴(同族 `Notification` 才有 theme 轴),所以它落在深色界面上会呈浅色。V4-2333 Config-T 走查连续两轮把这条列为「待裁定的疑似缺口」,轮十五 owner 拍板 **不立**。\n- ⇒ **不要给本组件立 backlog、不要提案增 theme 轴、不要在消费文件里改它的色**。改色即断变量绑定、违反 binding-fidelity;交付卡须写明「dev 不要自行改色」。\n- **实证两端同源(2026-08-03 逐端 probe,非照抄前轮记录)**:Config-T `rJJjWWs51n2iFOlCIC7aYG` page `8075:2` 运行态 toast(`status=success` × `size=L`,深色内容区上呈浅色,按发布原样使用)· LCD `0054ib0nLmt27bC3QlGDl7` page `9343:2` 节点 `9472:84`(同一 key `e9574b39…`,实测 `{status:\"info\", size:\"L\"}`,文案 `Video input detected — Stop Test to switch`,显示正常)。两端用的是同一个组件集,差异只在 `status`。案例决策见 TVU Pack `docs/specs/2026-07-28-v4-2333-test-signal-parameters-design.md` **D21**。\n\n---","numLines":200,"startLine":40,"totalLines":763}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":100,"estimated_tokens_delta":100,"uuid":"a765baa4-4f94-4efb-9e31-f71518ff4b6a","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":200,"estimated_tokens_delta":100,"uuid":"6ec48d47-6d5b-413c-b120-570068ab1591","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWj9Mpj9kjW9nmgtT9L","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISkgYKpgEIERgCKkDMZ54fi76vIWvDP2sB4+80Apjo8xmuTTq1tXqBW/IcOt8/w4vr2uUg1AhvRBIlDPNRKTr42s8TN8oH188Gyb5BMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAYCKudQGsAECEgzoJDSwqfSiO28bX1QaDP1Cy2ep3/UCga859SIwk93Vvsuzb92UFIX/+uWeg9fLDbVSmBTt0cLDvk0ykGpmYoRLDsSbvRgWL4It1qPzKpgEk/fT+7rbhWZrtve8ZTDWGy+s7eS1FjewwQWhrggfXjXEethcg4+M51X1qIsDm781DH3SeD8w2UMNRrT/2QFUQidU9gf9YX8YXHyH5yFok80IH1l/iidZ3EKCojcXIOJ/MU+B0oM0iFDltohqwkL75wRMIzTy1I68q/mFm7gnEXooxGxOfb438PZZxdNbnykH/DhwrDebVa0s5Gq66RXmVuxK1wF/x5j/P9mIzULyAkincXWeKjl18V6h+uOP545J+FtM/U0m/nGIWMYzbrz1eTAPXES5qBDS5fzfGS83Jv5Vx2F6puIlKtMv0vcCcSOq9HvOzsnlynJuM8fQxaB53w9cLvpBFEhdG0Kygh/VaratMDOsKoIN78lJJ5VrC/gNlbwZb/15xQ1X6hjvk4SsGTbrQa3mMPAMDAKD5VWP+Yuk2iK0qH5ENV0xAEJXQursB14+FxDaQ5rnodFpfBWuMXbCNUZ8NT0k/7/YTTkoS7qB4EjXhEoU8S5CpG4Jy1jxs3u1iG511Byj3bheKWn0PMsT6M9qWINQ1s4Fsjkehd/yRoVQSnTn+hTMqg3lbLL4NwuDDfVe6kowFSGarwK2V2ooP1RMJKBuI0baWmIQ98orrT2uERJDufGz8mpnUYI394u1d+pyIcoYWeMfBDKP1GloEKwUR2wa4ZWWSv+CpuMPvwgs8h7NjKsZaCuL7+rnEH9Z7Bw9hXMYAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":12385,"cache_read_input_tokens":158505,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":12385},"output_tokens":8,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"8c51e3ed-173c-4ca5-bfe7-6ca4dda7dcbf","timestamp":"2026-08-26T01:44:32.403Z","request_id":"req_011CeQWj5zv7FLZ41vBF4CoX"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWj9Mpj9kjW9nmgtT9L","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01BibkzyzFMoTxtvQ78Fwc5K","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/figma-component-catalog.md","offset":516,"limit":190},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":12385,"cache_read_input_tokens":158505,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":12385},"output_tokens":8,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"6e2a08bb-7467-4eda-9d1b-135e33628df6","timestamp":"2026-08-26T01:44:33.996Z","request_id":"req_011CeQWj5zv7FLZ41vBF4CoX"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01BibkzyzFMoTxtvQ78Fwc5K","type":"tool_result","content":"516\t### Drop down List/Select\n517\t- **Library key**: `12602e73b9682f9a9c45ec1e9373e8ac80bb489a` \n518\t- **Axes**: `Dark Theme` (on / off) × `Type` (Radio / Multi / Operation List / Sort By)\n519\t- **Variants**: 8\n520\t- **Code mapping**: `DropDownListSelect` (status: approved)\n521\t\n522\t#### Primary use\n523\t下拉展开后的**选项列表面板本体**——渲染一组可选行,支持单选/多选/操作/排序四种列表语义,内置键盘 roving focus 与 aria-activedescendant。被 `select box/filled` / `select box/line` 包裹;本组件是\"下拉里的那张列表\",不是触发它的输入框。\n524\t\n525\t#### Extension scenarios\n526\t- **单选列表**:`Type=Radio` —— 从一组互斥行选一项\n527\t- **多选列表**:`Type=Multi` —— 带勾选标记的多选(CANONICAL-012),禁用项走 `items[].disabled`\n528\t- **操作菜单**:`Type=Operation List` —— 行级动作下拉(Duplicate / Rename / Delete),即右键/更多菜单类命令列表\n529\t- **排序菜单**:`Type=Sort By` —— 列表/表格排序选项\n530\t\n531\t#### Don't use for\n532\t- 整体\"输入框 + 下拉\"选择器 —— 用 `select box/line` / `select box/filled`;本组件只是它们展开后的面板\n533\t- 别用 `
  • ` + 自撸勾选拼下拉列表、给每行自管 tabindex —— 用 `DropDownListSelect`,多选走 `type=Multi`、禁用走 `items[].disabled`(roving focus 已内置)\n534\t\n535\t---\n536\t\n537\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 |\n667\t| `icon/Edit/Add 1` | `b55b65cce73c6dc552b44769025770d4025d6056` | 添加 |\n668\t| `icon/Video/go to` | `07b3d6414821094250313062d0d9977b09d0ed14` | 跳转外链/UI(Open GUI 用此 icon) |\n669\t| `icon/MMA/search` | `c9e2e51836547104114154c73bf10ce33e697386` | search field 内嵌 |\n670\t| `icon/MMA/filter` | `8cde6a706478268b9b42642809c65ed8913d4d4a` | filter trigger |\n671\t| `icon/menu/3` | `f5852eafa50b905e86dee2d20dd611dcdcf1b876` | top bar menu |\n672\t| `icon/message/notification 1` | `c05b1ead2bf860ada6d3c18170e5a24647b8658a` | top bar notification |\n673\t| `icon/Setting/Setting 1` | `3233ac2db519e7221673c4bd5e5f3c1e8bda4a53` | 设置入口 |\n674\t| `icon/Setting/Switch` | `9a6fdd6764d62d08a7a542e0bc3a229de8742503` | 设置切换 |\n675\t| `icon/file/log` | `70da3e2612f1c7c8f78ad83d380946986ba24f74` | 日志/记录 |\n676\t| `icon/user/ID` | `bddcef5f3dc2e868db753f0969d52174932ff22e` | 用户 ID |\n677\t| `icon/Preview/Hide` | `d969a9441f5e442b1fbee6eba42c403a4ecc55c1` | 预览隐藏切换 |\n678\t| `icon/Preview/4` | `b2cb6ce9757ffd2b91fd86ca78d6497890d3c2c9` | 2×2 grid / 4-tile layout —— **Overview / Dashboard / All Apps 入口的标准图标**(MicroApps Console Plan B 2026-05-14 实证:sidebar Overview row) |\n679\t| `icon/Preview/9` | `8f129b19b7eaf74bbae82c381df51a846310cb82` | 3×3 grid / 9-tile layout |\n680\t| `icon/Preview/6` | `fe01f4f75abacb88bcbc4ad6c593a2f9ccba1128` | 2×3 grid / 6-tile layout |\n681\t| `icon/Preview/1` | `3aa90987939670e1ca44de6edc7eee22ce3ea570` | single tile |\n682\t| `icon/Preview/25` | `93447a33188148bdf4debe1d78330fbab7627b9f` | 5×5 grid / 25-tile layout |\n683\t| `icon/Preview/grid view` | `301206fa43b380236df529891c60088446721f7d` | 通用 grid view 视图切换 |\n684\t| `icon/Preview/List` | `0ee7e3971009799b2b6666d78f9a95f971c626b9` | 列表视图切换(与 grid view 配对) |\n685\t| `icon/Preview/Layout` | `76f23233c100f9d2ffd941859ed2619ea3cc8b78` | 布局切换 |\n686\t| `icon/Preview/sidebar` | `2edf26729d98acafec5a981f73f2861e00662def` | 侧栏切换 |\n687\t| `icon/PL/more` | `c07fc7400241ef39ebef5ed0742bfec5f8cbd533` | 更多操作 (...) |\n688\t| `icon/Message/Success 2` | `f1381cc205f43a192403875eae357e0f520bbc74` | 成功 / 覆盖充足(绿)—— BM-1047 token 充足态 coverage 标识 |\n689\t| `icon/Message/warning 1` | `cefe48b9e79a32f8386939be5febb9c2c983e91d` | 警告(橙 `UX/Orange/Default` #f68512)—— BM-1047 余额不足 coverage 标识 |\n690\t| `icon/Message/Error 4` | `de34565e…`(severe)| 严重错误(红)—— `Notification status=warning` 变体内置 icon(库默认,勿 override;BM-1047 S5 减席位告警实证) |\n691\t| `icon/Arrow/Right_1` | `a135a5138dda4900963d0c6c69823c5523d96f80` | 右向箭头(feature line / CTA 指示) |\n692\t\n693\t---\n694\t\n695\t## Variables (color / spacing / radius / size)\n696\t\n697\t参考 [`figma-data/normalized/variables.json`](../../figma-data/normalized/variables.json) 拿全集。**已知常用**:\n698\t\n699\t### Status colors (broadcast convention M3)\n700\t- `UX/Red/Default` (key `a3f82a4b...`) — Live = on-air\n701\t- `UX/Brand/Brand` (key `ea8c2383...`) — Preview / standby / **primary brand identity (Active states' left border / badge primary fill)**\n702\t- `UX/Brand/Hover` (key `eab4ef3b...`) — **Hover affordance** for brand-colored interactive elements(sidebar item hover bg / button hover bg / etc.)。**禁止用 `UX/Brand/Brand` 给 hover 状态**——hover 有专门 token\n703\t- `UX/Brand/Disable` (key `9166c747...`) — disabled state of brand action\n704\t- `UX/Red/Hover 1` (key `fc189c23...`) — red hover variant\n705\t- `UX/Blue/Hover 1` (key `c4aedbd6...`) — blue hover variant"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"6d8a255f-0a7b-4719-920f-da09a76cf6f1","timestamp":"2026-08-26T01:44:34.005Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/figma-component-catalog.md","content":"### Drop down List/Select\n- **Library key**: `12602e73b9682f9a9c45ec1e9373e8ac80bb489a` \n- **Axes**: `Dark Theme` (on / off) × `Type` (Radio / Multi / Operation List / Sort By)\n- **Variants**: 8\n- **Code mapping**: `DropDownListSelect` (status: approved)\n\n#### Primary use\n下拉展开后的**选项列表面板本体**——渲染一组可选行,支持单选/多选/操作/排序四种列表语义,内置键盘 roving focus 与 aria-activedescendant。被 `select box/filled` / `select box/line` 包裹;本组件是\"下拉里的那张列表\",不是触发它的输入框。\n\n#### Extension scenarios\n- **单选列表**:`Type=Radio` —— 从一组互斥行选一项\n- **多选列表**:`Type=Multi` —— 带勾选标记的多选(CANONICAL-012),禁用项走 `items[].disabled`\n- **操作菜单**:`Type=Operation List` —— 行级动作下拉(Duplicate / Rename / Delete),即右键/更多菜单类命令列表\n- **排序菜单**:`Type=Sort By` —— 列表/表格排序选项\n\n#### Don't use for\n- 整体\"输入框 + 下拉\"选择器 —— 用 `select box/line` / `select box/filled`;本组件只是它们展开后的面板\n- 别用 `
    • ` + 自撸勾选拼下拉列表、给每行自管 tabindex —— 用 `DropDownListSelect`,多选走 `type=Multi`、禁用走 `items[].disabled`(roving focus 已内置)\n\n---\n\n### 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 |\n| `icon/Edit/Add 1` | `b55b65cce73c6dc552b44769025770d4025d6056` | 添加 |\n| `icon/Video/go to` | `07b3d6414821094250313062d0d9977b09d0ed14` | 跳转外链/UI(Open GUI 用此 icon) |\n| `icon/MMA/search` | `c9e2e51836547104114154c73bf10ce33e697386` | search field 内嵌 |\n| `icon/MMA/filter` | `8cde6a706478268b9b42642809c65ed8913d4d4a` | filter trigger |\n| `icon/menu/3` | `f5852eafa50b905e86dee2d20dd611dcdcf1b876` | top bar menu |\n| `icon/message/notification 1` | `c05b1ead2bf860ada6d3c18170e5a24647b8658a` | top bar notification |\n| `icon/Setting/Setting 1` | `3233ac2db519e7221673c4bd5e5f3c1e8bda4a53` | 设置入口 |\n| `icon/Setting/Switch` | `9a6fdd6764d62d08a7a542e0bc3a229de8742503` | 设置切换 |\n| `icon/file/log` | `70da3e2612f1c7c8f78ad83d380946986ba24f74` | 日志/记录 |\n| `icon/user/ID` | `bddcef5f3dc2e868db753f0969d52174932ff22e` | 用户 ID |\n| `icon/Preview/Hide` | `d969a9441f5e442b1fbee6eba42c403a4ecc55c1` | 预览隐藏切换 |\n| `icon/Preview/4` | `b2cb6ce9757ffd2b91fd86ca78d6497890d3c2c9` | 2×2 grid / 4-tile layout —— **Overview / Dashboard / All Apps 入口的标准图标**(MicroApps Console Plan B 2026-05-14 实证:sidebar Overview row) |\n| `icon/Preview/9` | `8f129b19b7eaf74bbae82c381df51a846310cb82` | 3×3 grid / 9-tile layout |\n| `icon/Preview/6` | `fe01f4f75abacb88bcbc4ad6c593a2f9ccba1128` | 2×3 grid / 6-tile layout |\n| `icon/Preview/1` | `3aa90987939670e1ca44de6edc7eee22ce3ea570` | single tile |\n| `icon/Preview/25` | `93447a33188148bdf4debe1d78330fbab7627b9f` | 5×5 grid / 25-tile layout |\n| `icon/Preview/grid view` | `301206fa43b380236df529891c60088446721f7d` | 通用 grid view 视图切换 |\n| `icon/Preview/List` | `0ee7e3971009799b2b6666d78f9a95f971c626b9` | 列表视图切换(与 grid view 配对) |\n| `icon/Preview/Layout` | `76f23233c100f9d2ffd941859ed2619ea3cc8b78` | 布局切换 |\n| `icon/Preview/sidebar` | `2edf26729d98acafec5a981f73f2861e00662def` | 侧栏切换 |\n| `icon/PL/more` | `c07fc7400241ef39ebef5ed0742bfec5f8cbd533` | 更多操作 (...) |\n| `icon/Message/Success 2` | `f1381cc205f43a192403875eae357e0f520bbc74` | 成功 / 覆盖充足(绿)—— BM-1047 token 充足态 coverage 标识 |\n| `icon/Message/warning 1` | `cefe48b9e79a32f8386939be5febb9c2c983e91d` | 警告(橙 `UX/Orange/Default` #f68512)—— BM-1047 余额不足 coverage 标识 |\n| `icon/Message/Error 4` | `de34565e…`(severe)| 严重错误(红)—— `Notification status=warning` 变体内置 icon(库默认,勿 override;BM-1047 S5 减席位告警实证) |\n| `icon/Arrow/Right_1` | `a135a5138dda4900963d0c6c69823c5523d96f80` | 右向箭头(feature line / CTA 指示) |\n\n---\n\n## Variables (color / spacing / radius / size)\n\n参考 [`figma-data/normalized/variables.json`](../../figma-data/normalized/variables.json) 拿全集。**已知常用**:\n\n### Status colors (broadcast convention M3)\n- `UX/Red/Default` (key `a3f82a4b...`) — Live = on-air\n- `UX/Brand/Brand` (key `ea8c2383...`) — Preview / standby / **primary brand identity (Active states' left border / badge primary fill)**\n- `UX/Brand/Hover` (key `eab4ef3b...`) — **Hover affordance** for brand-colored interactive elements(sidebar item hover bg / button hover bg / etc.)。**禁止用 `UX/Brand/Brand` 给 hover 状态**——hover 有专门 token\n- `UX/Brand/Disable` (key `9166c747...`) — disabled state of brand action\n- `UX/Red/Hover 1` (key `fc189c23...`) — red hover variant\n- `UX/Blue/Hover 1` (key `c4aedbd6...`) — blue hover variant","numLines":190,"startLine":516,"totalLines":763}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWj9Mpj9kjW9nmgtT9L","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01LcGw8xLUW8aGnyjWv6P5yT","name":"Glob","input":{"pattern":"figma-data/published/icons/svg/{Status,Basic,Time,General,Info,Setting,Data}/*.svg"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":12385,"cache_read_input_tokens":158505,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":12385},"output_tokens":8,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"1ea76802-473b-41d7-bc4b-a5163f0002c9","timestamp":"2026-08-26T01:44:34.567Z","request_id":"req_011CeQWj5zv7FLZ41vBF4CoX"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01LcGw8xLUW8aGnyjWv6P5yT","type":"tool_result","content":"figma-data/published/icons/svg/Setting/Adv-Setting__1114_23838.svg\nfigma-data/published/icons/svg/Setting/Chinese__1268_286.svg\nfigma-data/published/icons/svg/Setting/English__1268_287.svg\nfigma-data/published/icons/svg/Setting/Offline-Setting__1367_25966.svg\nfigma-data/published/icons/svg/Setting/SCTE-setting__2056_262.svg\nfigma-data/published/icons/svg/Setting/Setting-1__1228_3993.svg\nfigma-data/published/icons/svg/Setting/Setting-2__1228_3994.svg\nfigma-data/published/icons/svg/Setting/Skin__1235_3292.svg\nfigma-data/published/icons/svg/Setting/Switch__1114_24139.svg\nfigma-data/published/icons/svg/Setting/custom__1251_64572.svg\nfigma-data/published/icons/svg/Setting/quite__1228_4138.svg\nfigma-data/published/icons/svg/Setting/standby__1228_4091.svg\nfigma-data/published/icons/svg/Time/Add-time__1170_25026.svg\nfigma-data/published/icons/svg/Time/Buffer__1243_23353.svg\nfigma-data/published/icons/svg/Time/Calendar-event__1243_23630.svg\nfigma-data/published/icons/svg/Time/Calendar__1243_23532.svg\nfigma-data/published/icons/svg/Time/Clock__1169_24282.svg\nfigma-data/published/icons/svg/Time/Coming-up__1243_23723.svg\nfigma-data/published/icons/svg/Time/NTP__1170_25106.svg\nfigma-data/published/icons/svg/Time/Timelock-client-occupied__1278_41529.svg\nfigma-data/published/icons/svg/Time/Timelock-client__1170_24959.svg\nfigma-data/published/icons/svg/Time/Timelocker-server-occupied__1278_41528.svg\nfigma-data/published/icons/svg/Time/Timelocker-server__1170_24731.svg\nfigma-data/published/icons/svg/Time/Timer__1243_23470.svg\nfigma-data/published/icons/svg/Time/Warning__1170_24589.svg"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"e11099d6-6e29-4709-9fda-99237d9db64f","timestamp":"2026-08-26T01:44:34.645Z","tool_use_result":{"filenames":["figma-data/published/icons/svg/Setting/Adv-Setting__1114_23838.svg","figma-data/published/icons/svg/Setting/Chinese__1268_286.svg","figma-data/published/icons/svg/Setting/English__1268_287.svg","figma-data/published/icons/svg/Setting/Offline-Setting__1367_25966.svg","figma-data/published/icons/svg/Setting/SCTE-setting__2056_262.svg","figma-data/published/icons/svg/Setting/Setting-1__1228_3993.svg","figma-data/published/icons/svg/Setting/Setting-2__1228_3994.svg","figma-data/published/icons/svg/Setting/Skin__1235_3292.svg","figma-data/published/icons/svg/Setting/Switch__1114_24139.svg","figma-data/published/icons/svg/Setting/custom__1251_64572.svg","figma-data/published/icons/svg/Setting/quite__1228_4138.svg","figma-data/published/icons/svg/Setting/standby__1228_4091.svg","figma-data/published/icons/svg/Time/Add-time__1170_25026.svg","figma-data/published/icons/svg/Time/Buffer__1243_23353.svg","figma-data/published/icons/svg/Time/Calendar-event__1243_23630.svg","figma-data/published/icons/svg/Time/Calendar__1243_23532.svg","figma-data/published/icons/svg/Time/Clock__1169_24282.svg","figma-data/published/icons/svg/Time/Coming-up__1243_23723.svg","figma-data/published/icons/svg/Time/NTP__1170_25106.svg","figma-data/published/icons/svg/Time/Timelock-client-occupied__1278_41529.svg","figma-data/published/icons/svg/Time/Timelock-client__1170_24959.svg","figma-data/published/icons/svg/Time/Timelocker-server-occupied__1278_41528.svg","figma-data/published/icons/svg/Time/Timelocker-server__1170_24731.svg","figma-data/published/icons/svg/Time/Timer__1243_23470.svg","figma-data/published/icons/svg/Time/Warning__1170_24589.svg"],"durationMs":75,"numFiles":25,"truncated":false,"totalMatches":25,"countIsComplete":true}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"aca7f2a4-3ff6-4bc5-bbbc-f1ddee1db393","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":200,"estimated_tokens_delta":150,"uuid":"1ee69984-a047-4a89-9cfe-a96cff6ed64b","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":300,"estimated_tokens_delta":100,"uuid":"2386d345-9177-4166-a676-5894ba878c82","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":400,"estimated_tokens_delta":100,"uuid":"1fb2507f-adda-433f-acf9-c8673737985b","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":500,"estimated_tokens_delta":100,"uuid":"14c38bc6-c2f9-4bdb-843f-bc30cd13db7a","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":550,"estimated_tokens_delta":50,"uuid":"78ddec78-5218-4ff3-a7bd-0846f7733dbf","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":650,"estimated_tokens_delta":100,"uuid":"82c3368c-0a2d-408f-a02c-962c7694300e","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":750,"estimated_tokens_delta":100,"uuid":"5cd02d18-8d68-4dab-8f79-10a46526c179","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":900,"estimated_tokens_delta":150,"uuid":"7da448bb-a82b-4b8c-9812-40d62c21cdfa","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1000,"estimated_tokens_delta":100,"uuid":"09562173-a28f-4228-b3ec-27f8a321377c","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1100,"estimated_tokens_delta":100,"uuid":"fd2be728-db68-401f-9009-a1d917e47611","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1200,"estimated_tokens_delta":100,"uuid":"4ceee450-7c5f-485e-8bae-c3c2a7454c57","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1300,"estimated_tokens_delta":100,"uuid":"716fb505-a823-4515-ba64-9fc2bca1067d","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1400,"estimated_tokens_delta":100,"uuid":"b9a840c5-2921-4d5e-a897-4148e0bc737d","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWjnJprdbDPVYer8qY3","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISvx4KpgEIERgCKkCSgPjHdOdvH31fD7q5CW8clCMsQvBKl2IBg3/jfYCeIkS93zEEOgdO4pDA2OhaDejOGnjXj4jGtPa2w3YSKH+lMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAZmKudQGsAECEgzkFMMMJLk4yCSBC4IaDAxig92n4j+fR08sqiIwgG1G6m+mXb4pkdYvA8EkRy08YKc62+Tq2YDXops7+KHhgY3Ayrn37n5PsYGQAaFHKsUczFmYZtCOqpsWeIDbdkuMYWN4jB062vPqVJs0I9gBiZoqWsR90fc9LbKFHCEZeBiKHvN8Lzt/+oPVwNAqI4niHCpxbui3SSEOePKPd6GMLPJNECCHmsVtyg0cJLwiFo1CyuqkEtll1YYwm9FThN/demkB/Pv3PgSdbjUL6z0lfSRh4HgmWOM7Amlqlq6vbr1+h+FK8ptvMlihluLlcmXl3u/yHCH3L8Ddk1ejyTJE0kBM4MsvHVjhNS+jlfUaL4ViNKoF8XdRoV6088RDwPo0GhuvJodEtIT2T7bvFkcq8tVVtzJJd2zjsC6fuPF85FrDvbdo0dRKEFT3RkbC298CMiqSWR1FPE2BEJ0aWjEm6LsBIeXxy+7RwWjwMJwKB73ULBTbUfwCBRq5pyNeoXKB290/HafsJ5FRPj/I6rf/OXoLEdGDiYRuPAxprbHI8Fn0/bfCmNpXUQsvxP2QHK7FXs8xtXQ/J/TOjEFWzmkJFZA+gnax6XCaLX+tfSl25+IUcuOkjHzloHl7Gm2a6Vme5pnNnaxiI5V7zDOpq1wBxC23xx/momuXBiZ7vY5+WGahI8OtHlbH6OLD/nNVJmm/djUdQA2RVJVzcXHOmsI914oNHeWwCgH+9/PjesT1UpY11BiSTu9AufJavSzeKSWeesLI0S60xbsORMnZjkNvjzOEt6WJROSdAO92wDh5VpK3E+HhpSRtdB4PsvmRP7GLM1naqXGnoSGSVEmPHlLT2K067WR0fT1f6TeEhkVPxHoKprET8x39aGN9dKSyiuOIJX6MZQqnS0kqTizq3c9S6WVY8DiVklyrXfjilD6kevsJyT3V+dVyCiV1lwNPhEpJJzBTH0Rx7uGY4UM0A3kim7/xu0MTiyjwoxBdrYFlKK/O30OCvTsl6CujcKPBSB8ACQWK087O1rJkUHL5cCO5ITDWh6yp9H5SFZJQdl61sGdVus4sl0wTbx6n7AHhS76okiwqepN6ytwL/+MRfoQgEl8w/Ny5N4AUy2R5eWDTj9hPO2rUIsL6+Wvq9f1KJH9tXiuJmAPc7eKW70qIPIKpkhL2bUemkxCfqmdIQIiOXXmC/dVYmsMxC8XZCAoqoR/NvNjUVtOuo6GA5xnoS8xL/GcU4pPACH6D48PDgZu+K3nskn5nZ85M3f5+9VEHs7AP3k9xWZnbiiWvUSVTrPBOsJcwb8K2tdyeLAJf69cO/UDfwE0px2zFBGSk3IB+cBzGhgpFZvxD/hTKCwKrNEKtezTtg7uGf0d+qGKsqe2cC7tBfGezXV3ukZ2w1q3gVtzuHtn7ReNHXN5Jykng0/vMEdYoNqV0eGbewuQSRruv4zt3Uo4R9xkqCiDDguiqkxL4VsZwHnSghz2iq/w5eZRG9MDoIKvpL/W91+vt3g8DfXFF7A2BY2jN1dpasHRm96y1+WRzParSw1WGRjf0n+EFyAr7vhaaBsbP2fKPknOiminL9qD0oHUjYLDOzam77TrUa7EikZENaaD+0NKf2uw4Cad4UXAP6mlysumITUPJd045abL1PB+MJ8Zn9DpXl8k+uhS1tjFOf8WAQPWJntLBZIhZPWg9aDUMnBK9y4cCXRkYeScEtzgIfC/jZx2uLcYs9POuZ82/HmYZEtukYJdgFxOMPMDx2JnenBOepC3lHlTeAO13jyXJMa0ykwEH0VyDM93LwDlLY6E+ii7lgJH544ODCes0wEx+7llCZY35fsyZFstYXir4ho3nKRu7nLxG8iivJiOodBVGX+i0bkXU+hnaoleQ+OsDc7XtERin89CQht7UurnS/QHcdl1YUX5NCi1zyalLAtI/0mvCy95QAQo+hIGpElzxWukCjELJ+OC9kiVBi/3IaahgGZzhk+S/Yl2wwEKOIk7mOWiGUahg5rXn5Dv1YnoBui1KhevJ4VSojbW98KLpFgtfxdC5lJDC3ZM1VqCjTeQzszQx691ciYvo4LYosRgkH39hHbwXR1lDFN7lTI96SuNdM/WzCpAlYq0y9NrEnCCuGb9L+sse/rahOWcapylM4kS5V80AgRo+rLCvsS1lxkd0ebeAqH/CJH4KX0U225iJlg4q1wvjg/QMWssv5Hjt9ysScnum9/2mzNnANuOnDmf2YC9+mlSfoOOgVA9h95gx8YfR/THbzeZheEE95n9817TEuSZnmk4fG+c7556eyz4drzLJ1jM2JKzZx7llYH413KAUAR+yCz1UUppFi19YWHzDhWdVRw6wtSsYtpVwUafgGSZN2oLXgFlssZzrev5b3FmLb4fbnYmT7xsHsbZb80udVkGlhTje3KaTLxq+rUqDLK7WoM+cgolRf0Ck4g6KFVfL375og0T+FjHZOwtch8FiNmHq3qtKYbPzAV36GqNqKcgyuMgi0T7iHJfM+4MMVsDoBpx2m9zS0aGc2dXyajhS9CacmEeX/SJguF9/afdNVsz3RSHe+hEbgqQg+fyEwwCF30iKTE68klPncz4i4C8yqknButBkITrjI9naxzIiA0lmC8pKDWOmrHtUUi0Kwj0qqtHlFKaK/OobCMsp7CY/vAtCgS+5OkQQKFAWDuCJq9zlFi331RES1eYbnT/q8WMMn313dSnT/oJL6OiamsmMaj7faJ+IVcj2pyLz597GEaevPdhKT0XzH9pVs4gFo/f6meXL+7O7R6l+krRnqkK32YRqNBdIRnQZ3KsufWhiwyD/4tAlQwTHSIeJDGtA12OxHwCzQb8W9QglvF6j8itaeyQ3M12uu9Wn8v3oIBi+el+OeCpjzL3dVsptb3p4DqI4L3DabxLhockiiUA3kP4Pk6ujn/O0tfmAF9fD1E9YEJNzXjTFIgIuzRTlRZFmyev+rBoIQrwuqxBZysIkx8Z7xpk4vKGvCdy/ryEv4HyWKL5sgVkVqI0Ja/7k7TG84a8GwVBtHVFOVGivfSE2w/9LZrwQzbuiImS8xNbbH5K07pXuBFpmzJg6wGKOSsDMkZ129EPP2queyIHVtDTuodaQyGaLFhmQwTfVPncRu3SO7k6kNhE4Vg1kj03CRPSJg4FqaeWk8JMsvEiGb1hpQQHWceSP6mC0rXO3zOK/rFUSimgYslLlWXQ2d7h4iXAGI422MmGUgVgalo3ZBGYFHRKiVFSnrFA2Tvq5a10zNCWlEmXuTKxDFw+m25YLo1KHt6shaRoUqrCcF6NbP9qtIz+NwEfjklqIWrXtXztj+Hyvk94mpEEo5JWEVgpXxA6cX0jvUuoL3EQuqillgDNDx0b4rHhmBxHAwZNhTWkH2stUEx45a6Gx13AhzfHEc6zbmf8+xJDDOojXDsWObsuavk6BcxMUV+gOUlObFSh0WaOQfkP+aOgOpMqFDsYa3hOHYooiHiWDFgJ1cMw4xqRb5OZECIpdiOgHZMu1bjJKJiCZUErXO3+NkDrhqehL8BQ9KtLpgGMGqDiNrc2MO21g/1wGrrJwuMISArS0XJS9kzMGlHK4D/EyAyV58J9A+pGosrMkeRySWUc9eqwwXSnbvczh9ckqMrIfRnMnMnXGLDpm+MfzHiqmFgl4Ut7Jj6dUwKePSSPl4AmjBDhdFGD3jlNnf5tH/M07jeqtjcNZEEDzVsWi/tnxAEomKFLH1xpIZOWRxP3KlM2Zlz2D9exFXAs+uuyhBFebqYC45Ft9dZHnQJpTqZMCYLqWpk94gbLXrXruiG9YtTawOwn6sUIbOX7dcCk5XdtpUfA51dpS8ll69mhuwp/I2Yf8mOOmepQJ4oBOpDxQKJtQPgKyEy8pkYcY0gHeE0WpiJQLRjrSx2SbGOoqAFsvv+DVFDPAcPNbnuTgU6C06L3U40lIhK4ugYaHoYMD21Gv3/I312dXV9tdLKfrZZlWI+ew8R/oXAMA/8Vv+ALgRMYl+IuVr5nrAGnB3ZF0DjIi8omqtOd83Dm9eC4yO4iZ613PpKVOXZHmlQ+RIYM/g8RMgSlzucdtNsnHUQDcQTeDqBZL6RBpXEkbAe+TuyPPVsF2PGiNQRCanwNDFb+COp4rHYNaiSOzxwd4ksj8Y22/pR9ZvoaAM1xZODivpxdlS3q/bGFLoCzsU0GqEPiS1GxSXKNSRCnf3ioAn340Xsy66ZlwQFjMBolDrfP2bb0sz3TU8kpaN4MioBePzLIOSgNjYQXgF4D2WbHV+KWdvDPwLAMpv1BviM9BfB7hFbQWMQzm5BFAprgr+1jSwEon3NTsv+/OMF+T5bWRbCdb7HJnyu6ei0i2MK7DuJ8U9O79t2NjLwRWPBiypGIsLhkyJEaLO0tVc+94AtQHGzUQQLnuy40wSqCN8sw9+w4kEu89/sOoPcAcz3KXyp39+YlrUJ3cQOpohKNJzZ2uy3CjSE6jLpgSra9b/KpsP1VXFqtUsyYz+HwZeM+vgCgMByPzFcV6QpmU4Ipu/dpCuIJY5ABHb0othReZTtoflKvfFigbPJf4v2NPADswnEp92RniMElOtut31LjWN1Juq9fz+6s0i8iIGdclDWuwdoEDRScKAR/X42JJm+LvGnuyT8FGiWwAal2fRNKzxVVdw5dMtnd7PjXbdtG5WD3PiJVpfgj0bre+Ie0DQFCJKC87d7Qi51wmcnRuMbXiHrNdVVkeoVsHJBCwzhIbmOcgvxTg/BdADys3A4shH1qn6oMTRVNqgt7f1LqC0BtZiaTvoVrtxQc3PeqQ2YN+IhfZOoC81Ba+uZj1loIvG5jyU61ybx2YlkAvjmyR3PyR1nGBLuqI7izJ+sud4d5qo8V7VKVju6Ldod4wglBJDrg21Kh1hncDXTw3ixr10ppHqPrUKkSpgg7txWXfSJkKcPKoxriIYHggemS25z2xX3dSoIQE6urHiZJJBfzwVgppCr/EsK4iFZ2y0TINDRQYAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":8440,"cache_read_input_tokens":170890,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":8440},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"566cfe04-c63d-4b78-89dc-563a69804971","timestamp":"2026-08-26T01:44:57.597Z","request_id":"req_011CeQWjiPS8uQDNy8cK5vjt"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWjnJprdbDPVYer8qY3","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_017qMsWGhaPYdfjxmPrhtifE","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/figma-data/published/icons/svg/Arrow/Up__1149_23391.svg"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":8440,"cache_read_input_tokens":170890,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":8440},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"60a0ae6f-1dba-48ba-93c1-2b62b5db0518","timestamp":"2026-08-26T01:44:58.963Z","request_id":"req_011CeQWjiPS8uQDNy8cK5vjt"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_017qMsWGhaPYdfjxmPrhtifE","type":"tool_result","content":"1\t\n2\t\n3\t\n4\t"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"eb435be4-b29d-4e9e-b07a-5a2d1a2c10c8","timestamp":"2026-08-26T01:44:58.972Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/figma-data/published/icons/svg/Arrow/Up__1149_23391.svg","content":"\n\n\n","numLines":4,"startLine":1,"totalLines":4}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWjnJprdbDPVYer8qY3","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01SBMk3CkzssD3C8RZJtXb5L","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/figma-data/published/icons/svg/Arrow/Down__1149_23407.svg"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":8440,"cache_read_input_tokens":170890,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":8440},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"e240c106-2396-4366-988b-0fe6c9ed5eb5","timestamp":"2026-08-26T01:44:59.693Z","request_id":"req_011CeQWjiPS8uQDNy8cK5vjt"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01SBMk3CkzssD3C8RZJtXb5L","type":"tool_result","content":"1\t\n2\t\n3\t\n4\t"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"fa1254ff-bc83-4059-9823-5e17482e6cc8","timestamp":"2026-08-26T01:44:59.701Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/figma-data/published/icons/svg/Arrow/Down__1149_23407.svg","content":"\n\n\n","numLines":4,"startLine":1,"totalLines":4}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWjnJprdbDPVYer8qY3","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_017ujF69GNszmjvRYqZxLp6y","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/figma-data/published/icons/svg/Arrow/Double-up__1149_23074.svg"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":8440,"cache_read_input_tokens":170890,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":8440},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"5c8ab9f0-aa51-4083-9d49-0fbcdc4b37f0","timestamp":"2026-08-26T01:45:00.484Z","request_id":"req_011CeQWjiPS8uQDNy8cK5vjt"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_017ujF69GNszmjvRYqZxLp6y","type":"tool_result","content":"1\t\n2\t\n3\t\n4\t"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"22dd54ff-00fe-445c-bd28-36349dcc3d16","timestamp":"2026-08-26T01:45:00.495Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/figma-data/published/icons/svg/Arrow/Double-up__1149_23074.svg","content":"\n\n\n","numLines":4,"startLine":1,"totalLines":4}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWjnJprdbDPVYer8qY3","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_014SYXbb1ycHgumMzH3Q27wt","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/figma-data/published/icons/svg/Arrow/Double-down__1149_23106.svg"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":8440,"cache_read_input_tokens":170890,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":8440},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"63288d7c-e1be-4125-8731-26c4a2c48eff","timestamp":"2026-08-26T01:45:01.125Z","request_id":"req_011CeQWjiPS8uQDNy8cK5vjt"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_014SYXbb1ycHgumMzH3Q27wt","type":"tool_result","content":"1\t\n2\t\n3\t\n4\t"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"5f3defd6-124d-46e2-a828-321f71c66184","timestamp":"2026-08-26T01:45:01.134Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/figma-data/published/icons/svg/Arrow/Double-down__1149_23106.svg","content":"\n\n\n","numLines":4,"startLine":1,"totalLines":4}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWjnJprdbDPVYer8qY3","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01ESX6syTtwxNLjrBcFUYQyL","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/figma-data/published/icons/svg/Arrow/Dropdown__1150_23504.svg"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":8440,"cache_read_input_tokens":170890,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":8440},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"0e33771d-7236-4820-a60b-12cae55c7e76","timestamp":"2026-08-26T01:45:01.815Z","request_id":"req_011CeQWjiPS8uQDNy8cK5vjt"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01ESX6syTtwxNLjrBcFUYQyL","type":"tool_result","content":"1\t\n2\t\n3\t\n4\t"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"a0398df9-7028-4a01-844f-9da983898638","timestamp":"2026-08-26T01:45:01.823Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/figma-data/published/icons/svg/Arrow/Dropdown__1150_23504.svg","content":"\n\n\n","numLines":4,"startLine":1,"totalLines":4}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWjnJprdbDPVYer8qY3","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_0165P7iBG8dCGn6gg2sSeEyH","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/figma-data/published/icons/svg/Time/Calendar__1243_23532.svg"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":8440,"cache_read_input_tokens":170890,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":8440},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"07a95ad9-176c-4ea5-b3b7-f0b3033bf04c","timestamp":"2026-08-26T01:45:02.505Z","request_id":"req_011CeQWjiPS8uQDNy8cK5vjt"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_0165P7iBG8dCGn6gg2sSeEyH","type":"tool_result","content":"1\t\n2\t\n3\t\n4\t"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"94d63d08-b2a2-487c-b3bb-e177bc4c7d2e","timestamp":"2026-08-26T01:45:02.518Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/figma-data/published/icons/svg/Time/Calendar__1243_23532.svg","content":"\n\n\n","numLines":4,"startLine":1,"totalLines":4}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"bbe05208-9840-4af8-be1e-46db3770847f","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"ad14777c-7e6a-43e0-b8cf-322cb36a56d9","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWmqLCVkbYsTJxEBi98","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISzgQKpgEIERgCKkBDBkX+RRgPcFZ5sHwYUu5Bn0Fx57P/6bTedMI1AV+ctQoAVEtzBXMeBO1SwLEmdRyMF0d0+EPfz99rh4gKsYXUMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAaOKudQGsAECEgxQ3zOLfmzbglI8awwaDLJbXeyKtznLb94l0SIw2ss33Uh53dLBTeQ1b+jK6TLO6u2CR+Opx1u8QzQEIQA/IqX7WXz8yN+6EjgG/liQKtQC1juEsgp+LuFr0bhK4qll42NUVJlk70M6LyC1m9tENICv0+g8lKSzFzvSfeAYIUVyap1wL0F7kDmEwEYezCvaEkMacrZp+q+0fkwjCzhMa+uo3AwXPW7/DVaxjtcJiqnCyLKmPBmr3ezYPmx9pkhnac1USkfkuV9G5sp6uiuIm0pzNMwel5A1O8fESzDAQAPK+H1jdn6ZvfUjkj2t7lWxQ9T5GRmFCtk9HTfixk4pmcqo7hYiE3FMuIJOpOLnJSMxoGLylajQhkgIcsquxqdQhu0T+6drVaM+Bx2AkgebEQ3ksmDm7/losju402AIbOdqxCCYf18AcZO5pjQamSuC/IkqvGu6XxKX5pjBNQU72HFMp3WcR9emEP65v4E+T3GqM14Pv8JWdN9eRNA9nuIw3b4WXqOQK8bWzgCo6f+ozQ8XqvYdeIv2m7CM/GR26EPuh5IeoRgB"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":5897,"cache_read_input_tokens":179330,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":5897},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"abf076b7-0c58-4e52-8b03-811a90096985","timestamp":"2026-08-26T01:45:07.693Z","request_id":"req_011CeQWmmZjGJ29GUM9ci2P5"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWmqLCVkbYsTJxEBi98","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01379NEgQbZz2qaJg8TfCGqN","name":"Glob","input":{"pattern":"src/components/Chart/*"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":5897,"cache_read_input_tokens":179330,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":5897},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"c2902e40-01e5-4c5b-a0b6-525c6ef30c55","timestamp":"2026-08-26T01:45:08.375Z","request_id":"req_011CeQWmmZjGJ29GUM9ci2P5"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01379NEgQbZz2qaJg8TfCGqN","type":"tool_result","content":"src/components/Chart/Chart.vue\nsrc/components/Chart/build-chart-option.ts\nsrc/components/Chart/use-chart-tokens.ts"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"b3961414-7852-4ac7-a658-2a3c0f580a0c","timestamp":"2026-08-26T01:45:08.465Z","tool_use_result":{"filenames":["src/components/Chart/Chart.vue","src/components/Chart/build-chart-option.ts","src/components/Chart/use-chart-tokens.ts"],"durationMs":85,"numFiles":3,"truncated":false,"totalMatches":3,"countIsComplete":true}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWmqLCVkbYsTJxEBi98","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01W7G9r8Dz8VVghoErwQL6Eh","name":"Grep","input":{"pattern":"^## R(2|9|14|15|19|23) ","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":5897,"cache_read_input_tokens":179330,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":5897},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"a0faee5f-b364-45d7-a54b-c8029e02e7d8","timestamp":"2026-08-26T01:45:09.744Z","request_id":"req_011CeQWmmZjGJ29GUM9ci2P5"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01W7G9r8Dz8VVghoErwQL6Eh","type":"tool_result","content":"259:## R2 — 颜色必须用 TVU token,不写 hex literal\n741:## R9 — Static-to-Interactive Augmentation Protocol(场景 1 / 3 强制;enforcement L1,v2 待升 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 扩展)\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 新增"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"9043433d-1f64-4eea-8fe3-a4f25a46d1f7","timestamp":"2026-08-26T01:45:09.765Z","tool_use_result":{"mode":"content","numFiles":0,"filenames":[],"content":"259:## R2 — 颜色必须用 TVU token,不写 hex literal\n741:## R9 — Static-to-Interactive Augmentation Protocol(场景 1 / 3 强制;enforcement L1,v2 待升 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 扩展)\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 新增","numLines":6,"totalLines":6}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWnNVwKwD3wa4L7K3SA","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01TdU7QereuQ3W7fMALmzYGM","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":715,"cache_read_input_tokens":185227,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":715},"output_tokens":17,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"4ac75eff-cf6d-49f7-b80b-601112cf0c87","timestamp":"2026-08-26T01:45:13.587Z","request_id":"req_011CeQWnJhEfaSZLEvoSuhAA"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01TdU7QereuQ3W7fMALmzYGM","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":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"0bfede5d-e953-4beb-9d53-02474d5be10b","timestamp":"2026-08-26T01:45:13.599Z","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":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWnNVwKwD3wa4L7K3SA","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01GmhdVcXgC7VMa9ZYoSQxsz","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":715,"cache_read_input_tokens":185227,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":715},"output_tokens":17,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"bc4bdfce-9624-4077-9d70-a24e1ee1c242","timestamp":"2026-08-26T01:45:14.050Z","request_id":"req_011CeQWnJhEfaSZLEvoSuhAA"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01GmhdVcXgC7VMa9ZYoSQxsz","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":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"e87442da-e4b8-4321-9e0f-cd9c5432e15b","timestamp":"2026-08-26T01:45:14.052Z","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":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"be110905-20bc-46a7-9049-d22e08afc939","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":200,"estimated_tokens_delta":150,"uuid":"0d86728a-3706-4411-8ed2-080784513122","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWngmXevpCMKrVovDiq","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISugUKpgEIERgCKkA+xYC36hkDfLwTlEMwMaA58ZHSyu9iZorQ3ddcg3kN+1RaB0ZjzcPaGVXU3qKrHAoG7StHbvmbqu80YQ2InkoaMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAa+KudQGsAECEgw0jiD0xASlVmlwGUgaDCPNHgE6ViZaVQrwviIwshaAZZxg/xr95WkbqS6xLb+dPxnnkBjCjouet2t7WYycLbLTlK3SAPYDPji4sMqUKsADbucvrcYUJ2XE0rYjgTITB0QX76oLgROmwd5CvLYeDBcR6tZk+PaETvVLGSU2P2kwAhv9rse6szeSZCagSIWaCxiYFgWCoMi3uQ7M2mzIT9eBucGQwowSdMCn5w87VSA76fFhbfV/oXJWYnejcCjS6yF7K71fc8RueMYpqu0Vl6zSAHVz+Q3DKjzy0zsbFf5g32P77CKAO9QPIdVcmOQTWI9I9CuKYFL3UXkEQATRCWbFeOUUaF1tnlEW19blchvZU7Zr28pM+HKW6KKJ/8uJtOklOlKdcG0SRJ4WzvxCZVsACDKTG2iG7WxIFKaK7g5k9ntpYlDmD5ii9PqjyocmbEpik1eV5rZsS9yVYgmH3ZqAf9GlNEYEkG6RcypzgiyM92i6EyNo5QioCQY3NS6d1kLyDtjwlOJ4yJt8pONLQiEu9XPPcNclNYPKwZtpHwbsO+5UmmrJP9PA31+QAB8kHJIKDG+U28a7EXNIlYagRhqby2SJ83+drZZ7/2PYCsCo5CFzKkTrMU/aHSgRNM67aAk1xSzc8ec+m8JIBpC1BozN6i+U03v74xNZJBG8x7EtpGDkYtDEuP2CbeP7OODFZhgB"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":2901,"cache_read_input_tokens":185942,"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":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"ceff55d2-d28b-4859-9b86-a8b3af1d54d0","timestamp":"2026-08-26T01:45:19.726Z","request_id":"req_011CeQWncjSu72ybumuUwL3U"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWngmXevpCMKrVovDiq","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01BRESKZK7w35zMcihpP1AzS","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","offset":259,"limit":120},"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":185942,"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":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"792f8942-818c-4d45-a3c4-57c000e901fd","timestamp":"2026-08-26T01:45:21.873Z","request_id":"req_011CeQWncjSu72ybumuUwL3U"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01BRESKZK7w35zMcihpP1AzS","type":"tool_result","content":"259\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\n331\t任何在 TVU sibling consumer product(如 `MicroApps Console`)上的代码 / 设计工作 wrap up 时,必须在产品根目录 `docs/` 下留一份 handoff 文档,命名格式 **`YYYY-MM-DD-handoff.md`**。新 session 通过这份文档冷启动接力,不需要 user 重新解释上下文。\n332\t\n333\t### Handoff 文档必备 5 段\n334\t\n335\t```markdown\n336\t# — Session Handoff (YYYY-MM-DD)\n337\t\n338\t## 1. Context\n339\t(1-3 句话)这个产品是什么,consumer of TVU。\n340\t\n341\t## 2. 必读 onboarding 顺序\n342\t1. `../tvu-design-system/AGENTS.md`\n343\t2. `../tvu-design-system/docs/internal/code-conventions.md`(R1-R5)\n344\t3. `../tvu-design-system/docs/internal/mockup-conventions.md`(如做 Figma 任务)\n345\t4. `./docs/_PRODUCT_CONTEXT.md` 全文 + 重点段(如 §10.5 当前状态)\n346\t5. 本 handoff 文档\n347\t\n348\t## 3. Current State\n349\t- 当前产物路径(文件 / 目录)\n350\t- 已落实功能清单\n351\t- 已确认 working 的依赖 / 链路\n352\t\n353\t### Iteration log(mockup / code 版本迭代追踪)\n354\t| 版本 | 产物 path / frame node-id | 主要决策 | 复盘指针 |\n355\t|---|---|---|---|\n356\t| v1 | ... | ... | ... |\n357\t\n358\t## 4. 已知 gap(按严重度排序)\n359\t| Gap | 严重度 🔴🟡🟢 | 解决路径 |\n360\t\n361\t## 5. 下一步优先级\n362\t按顺序列 3 个最高优先级任务,每个标\"是否需要 user 决策\"。\n363\t\n364\t## 6. Quick-start prompt(可直接 copy 到新 session)\n365\t```(嵌套代码块)\n366\t继续 工作。\n367\t工作目录:\n368\t按 docs/-handoff.md §2 onboarding 顺序读完,然后从 §5 选一个任务起步。\n369\t```(嵌套结束)\n370\t\n371\t## 7. Phase 0 ledger entry(Wrap-up checklist)\n372\t- [ ] 本任务执行了 Phase 0 mapping(element ≥ 3)→ 已 append 一行到 `tvu-design-system/docs/internal/_metrics/phase0-ledger.md`\n373\t- [ ] Trivial 任务跳过了 Phase 0(element < 3)→ 标 `N/A — trivial`,不 append\n374\t- [ ] US-4 (Figma → code mirror) 走了 Phase 0 → 同样 append\n375\t- [ ] **Release 类任务(含 changeset:version + tag push)wrap-up 必含 Packages 页实物 verify link 或 screenshot 作为 evidence**(2026-05-11 落实 — v0.1.0/v0.1.1 silent fail 盲点修复;tag pushed + CI green ≠ publish 成功,必看 registry 实物。详见 [`STATUS.md`](../STATUS.md) §Release wrap-up 必改项)\n376\t```\n377\t\n378\t### Handoff 文档保存位置(红线)"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"3564bdf3-dbb5-4897-8189-4565b256a9ca","timestamp":"2026-08-26T01:45:21.875Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","content":"## 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\n任何在 TVU sibling consumer product(如 `MicroApps Console`)上的代码 / 设计工作 wrap up 时,必须在产品根目录 `docs/` 下留一份 handoff 文档,命名格式 **`YYYY-MM-DD-handoff.md`**。新 session 通过这份文档冷启动接力,不需要 user 重新解释上下文。\n\n### Handoff 文档必备 5 段\n\n```markdown\n# — Session Handoff (YYYY-MM-DD)\n\n## 1. Context\n(1-3 句话)这个产品是什么,consumer of TVU。\n\n## 2. 必读 onboarding 顺序\n1. `../tvu-design-system/AGENTS.md`\n2. `../tvu-design-system/docs/internal/code-conventions.md`(R1-R5)\n3. `../tvu-design-system/docs/internal/mockup-conventions.md`(如做 Figma 任务)\n4. `./docs/_PRODUCT_CONTEXT.md` 全文 + 重点段(如 §10.5 当前状态)\n5. 本 handoff 文档\n\n## 3. Current State\n- 当前产物路径(文件 / 目录)\n- 已落实功能清单\n- 已确认 working 的依赖 / 链路\n\n### Iteration log(mockup / code 版本迭代追踪)\n| 版本 | 产物 path / frame node-id | 主要决策 | 复盘指针 |\n|---|---|---|---|\n| v1 | ... | ... | ... |\n\n## 4. 已知 gap(按严重度排序)\n| Gap | 严重度 🔴🟡🟢 | 解决路径 |\n\n## 5. 下一步优先级\n按顺序列 3 个最高优先级任务,每个标\"是否需要 user 决策\"。\n\n## 6. Quick-start prompt(可直接 copy 到新 session)\n```(嵌套代码块)\n继续 工作。\n工作目录:\n按 docs/-handoff.md §2 onboarding 顺序读完,然后从 §5 选一个任务起步。\n```(嵌套结束)\n\n## 7. Phase 0 ledger entry(Wrap-up checklist)\n- [ ] 本任务执行了 Phase 0 mapping(element ≥ 3)→ 已 append 一行到 `tvu-design-system/docs/internal/_metrics/phase0-ledger.md`\n- [ ] Trivial 任务跳过了 Phase 0(element < 3)→ 标 `N/A — trivial`,不 append\n- [ ] US-4 (Figma → code mirror) 走了 Phase 0 → 同样 append\n- [ ] **Release 类任务(含 changeset:version + tag push)wrap-up 必含 Packages 页实物 verify link 或 screenshot 作为 evidence**(2026-05-11 落实 — v0.1.0/v0.1.1 silent fail 盲点修复;tag pushed + CI green ≠ publish 成功,必看 registry 实物。详见 [`STATUS.md`](../STATUS.md) §Release wrap-up 必改项)\n```\n\n### Handoff 文档保存位置(红线)","numLines":120,"startLine":259,"totalLines":1528}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWngmXevpCMKrVovDiq","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_016SQ6faaUP4rd9GPkqnwCur","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/code-conventions.md","offset":995,"limit":130},"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":185942,"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":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"f48d90ae-142c-4eea-bd01-e66b3c9e2520","timestamp":"2026-08-26T01:45:22.283Z","request_id":"req_011CeQWncjSu72ybumuUwL3U"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_016SQ6faaUP4rd9GPkqnwCur","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;`\n103\t"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"38a6ac50-80bd-45b9-acf2-1fdef2eb7349","timestamp":"2026-08-26T01:45:55.550Z","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":"system","subtype":"thinking_tokens","estimated_tokens":100,"estimated_tokens_delta":100,"uuid":"c842c7ba-8c4d-48c2-a8e3-e57a1a37e3f3","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":200,"estimated_tokens_delta":100,"uuid":"a0e1f7a0-58c8-4a2f-b025-a9984d734174","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWqkv9s72W3yHuxHAJh","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISuQUKpgEIERgCKkD2Wy9Ld0qtZfgwrswgmoppyLqKfIopBUTRjVoyFz9JZxbcVpfW19JCE76HYomwdP9GMoB46UrGjEHxz5fLY1BDMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAdmKudQGsAECEgznQzPWiho1BP4gurgaDK0yRt4LQ5wpEOp9QCIwjAFqRCnwflQuryTQQOMIX5Hqgmu9opDqL7EGQDg34IEAwoUITP8NU5YKUb5OaiMZKr8DPIzz3YbwXDJaYoh0m/GIdB3eVsUf+pWRT1Qh9HOqaAT2YAek8MjPBNnv37uw3GpD+3nxHw/APZT+/PxohP0SBh/zJEzkuPJs/YVDR2RlCdiTkRzrTBOFzjhtXY9fN5sx0T8OG8r8xPb+gvdVDmbSQvjGimvc7ZcveRJHrWNKS2aULVfTZ8+S8Z60w+VxwyV+Wne/0yuTzT6eE3gqmKM/8C77aug+4bMIBDeMKCCgi2YsZB3Fr20OsmSWZhKkjtEo5GHj+6r6iDPuC2TsK1HXrmA7FSRjv+Swr5X9yYPtrXmmPj0utMh1CAWZP30g1swbIpImSQM6iiWGyeQnWynyGSxTtF49lB2tOuwrykRHJtrfUEGhdgUBIT7UqEWA5DVebZdv5PEgpcmQaFvPEo7aNQWgRYZksmVM0vZnZ1bLp///wQUHxqq23LEP7JojVDg/gTTlobcmwSLct+njFCQ9MaaKWhExtO+pntQvfi7BJF8ngl1ESfRTKG1bS7ftamgoSBu65NCik+4D82rTc9HIf29bNq0R9BR9tMinqVPjTqQy8IIdD2LJQGmJ8W+IyRhW9KE2psIA2C2B8eSlEO2XGAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":4071,"cache_read_input_tokens":205038,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":4071},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"db2fd87e-82a0-432f-a2a8-ccf35be335cc","timestamp":"2026-08-26T01:46:01.417Z","request_id":"req_011CeQWqgo6oeXLPMWsTFWkv"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWqkv9s72W3yHuxHAJh","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01A4RrYCRSWdFrxFUwEXfBVy","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":4071,"cache_read_input_tokens":205038,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":4071},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"97778e60-2548-4e57-952b-2f4c8e0021cd","timestamp":"2026-08-26T01:46:02.949Z","request_id":"req_011CeQWqgo6oeXLPMWsTFWkv"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01A4RrYCRSWdFrxFUwEXfBVy","type":"tool_result","content":"1\t\n33\t\n34\t\n46\t"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"315b2edc-e9a2-4236-9a01-667715be6b43","timestamp":"2026-08-26T01:46:02.951Z","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":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWqkv9s72W3yHuxHAJh","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_018r5rbJocRKHNyTytKWt3eX","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":4071,"cache_read_input_tokens":205038,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":4071},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"9ac1f394-bc99-4237-b30f-91375a94241a","timestamp":"2026-08-26T01:46:02.992Z","request_id":"req_011CeQWqgo6oeXLPMWsTFWkv"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_018r5rbJocRKHNyTytKWt3eX","type":"tool_result","content":"1\t\n62\t\n63\t\n77\t\n78\t\n101\t"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"cf69be97-c399-4e88-b0b8-6d682a168f37","timestamp":"2026-08-26T01:46:02.994Z","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":"13e5e56f-667a-4e9f-bfd0-93fb7b6c2d78","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":121,"estimated_tokens_delta":71,"uuid":"8d8ef697-562a-4858-8ae5-6a4b40a405da","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWrJJ31RqgMynmnzakF","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAIS2wMKpgEIERgCKkAucdMx7GyEG1seKrwlG130nDuXfueyKEEh2a0vQ9KVDdn/Aqo0IUvgKw1UrYFcY7HG+IcPgarDnOPDXeelENOoMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAd+KudQGsAECEgz5DJFyP68I9p8iJsEaDDf4TOSHfREuAO1XHSIw8sOBYmsOhIhIhmA+Mflraoum0hIzJly5NzNoNuDDwQ3lw0VPiL3ncUObXyMr2labKuEBKT3lV/jsepjLz4jetsFbfowJwb6DkxuYgxg1w4JPQ/1nkx+YZvuBLGY4arC5CftNIWApFE6nj+jiL6TSXtZzZo9ErTeaQM828ULQjFcEkbHS6lHrlNi+vQWsucAKzDGuhzyW2YZibZSlPWhaiP2OBTLb12IS3+bl4j9GOs0zal8HQNrGEurkqCKrDyPUUvcZajwEof+CnG5oitzW5fneaPWcdFs+nxZZ1oimhhmjs/ZwYKhQbFOkHSZQ6MVQalDR1qe0FqWpizKmSLU+PUlmsI26C6xLP3PH8d2vwYubiJ8JGAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":2957,"cache_read_input_tokens":209109,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2957},"output_tokens":5,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"2c6cd29e-9b71-480b-befd-2acccabe7f15","timestamp":"2026-08-26T01:46:07.339Z","request_id":"req_011CeQWrDxqjLbUeBFTP9R49"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWrJJ31RqgMynmnzakF","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_012baEMGMbVrsJCpgqVczHjD","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Button/Button.vue"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":2957,"cache_read_input_tokens":209109,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2957},"output_tokens":5,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"18d57e2b-6cc7-4ad5-bda9-238353c9e924","timestamp":"2026-08-26T01:46:08.674Z","request_id":"req_011CeQWrDxqjLbUeBFTP9R49"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_012baEMGMbVrsJCpgqVczHjD","type":"tool_result","content":"1\t\n2\t\n360\t\n361\t\n396\t\n397\t\n505\t"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"1e3a1b39-bfeb-4da8-9227-b1a51cf7118a","timestamp":"2026-08-26T01:46:08.680Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Button/Button.vue","content":"\n\n\n\n\n\n","numLines":505,"startLine":1,"totalLines":505}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"e1c2e326-ad35-456b-b445-90ec8c29c1f9","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"8a27c7c6-42f4-4a7b-977c-9f3c3d4dbb8c","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":300,"estimated_tokens_delta":150,"uuid":"d93e3b09-7255-4d58-a02a-5b25954dae04","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":400,"estimated_tokens_delta":100,"uuid":"035dfb13-00b3-4b10-8360-38854c19c171","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWriYJYMR5xyW1wzG6H","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAIS7AgKpgEIERgCKkDOPMAueipS0RlWY2KnQ8/VL4SEOqMg7p9wqEA0DV0HDThy34Ng49ovJD9HwNnPx1RlHuAPCstw6WvrDSRBJwqpMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAeiKudQGsAECEgzjdAahkca3en9tkOoaDJeWg+2u5amqBsIDYyIwOqFY7qyTGnieVMfyCvTAheLvqqjmr1+uKHwY/MpN7YBAx3CuO8Q+illMhcLnjMJQKvIGKFJmlbWll81IEfQ/rgI65F4t/zzePHpbBKEcKPipB/PDGpF53FOmLlQqEi8cXHCXhvIEQatvVcSXhrO9CYP/HyMXR+QciBMzOpAEGwFEnOKFcsG6mPNlqw0xwd5dLtK/KMjik0YQaeRczWbJ2ZRFOs9qE0817X4nPKOwOsV6yVP1Qs8R8b2oaCxCOCyP0+iRlsuCnB66oMleo+qlqyc9h65Hmcgm6oGi07w3gmGkNn1d2euYFbH68SUQvlDBo6hFkb+X74RokR1U8bPJd4uj2dveQVkKycwSS6P31JwzdoJVYsTjHGeTL5GIJwxCObq66AiKTgqN+8JyYUAMckkff3Rb6X0oTexc/+EUg/8OB9i+PnvDS6R/LvQ/sihxFfOJuJxHvWXJWis5fXtGV3TG2OIRLSnTXYrzbe5lHFhQRqQgRgVjX8jLCgh+PPZFS7Aj8z7Wl+6dPp0kpjiouhvugRcSN3NmADXZk1dd1GVKt7M3nG5DSJxemPnKgZkIxvv+SJ2DXkI6CT5kYGMT/1JkECrVbKlNIZTETrTIN2fef1DIou76f7KR2o7bekhfFXArCHVNp3NS7BfU8iIsJBar6/7KOQK80yIeNE0id6IZVdexO3khh4QoiJTGHAtW/8d0FxKWm5Eko1bhg2HxOcfPCHGBkL+ZHPxTGPil3gMJfGg/OLok6kxZfZOgw3/CzcrKXeoUZ6OUdEMUF3l/iP5n4XxgBt2klml7iLtHPQ2VbXUboa7swT8Iw6hEdjbe1anoRIjgIEXNIe5UTOlCuBXyElE2TCHBXnsN2vYvz04cGkslLzKRLWsxWzviKRK/aK4yJY9v8u2MkfbN/0luMebS/9Swpp9yTIPk+f7NHxAZTS0QHb9WnviokCh//JF1v21dkv0rYNXnmJX+MeNcQZQT4zx3/ZThTrobm3jM2Ycw0fOMHptvVwqU6l0DDb0lGenfOnkntxHt5udeLV/sKa7VPXRgvAxQtTY9/qzkPEEqSc8oxWFFSGAOQuaOvVXkqg4kPxAN0n3An71zJga8ctHHo/0dPXlNQ1Blxvxu2itQEVs3lNwkcP2nP8Us/lFds2cAx057ClVFsdVzVW6AoY0jD0qfRIQIXSSs4Ww+A5z3VQ3qjwqfPYsi/OinoVeMWOhucjE0p5m5MNTlbx9A8tXHx4qVGAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":8785,"cache_read_input_tokens":212066,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":8785},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"66daff18-b172-4f42-85a7-0b174e461f4d","timestamp":"2026-08-26T01:46:17.355Z","request_id":"req_011CeQWreMYHTVSJR45MUvKf"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWriYJYMR5xyW1wzG6H","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01Pi4M8SmCuvRT9iGby8eGwB","name":"Glob","input":{"pattern":"src/components/TopBar/*"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":8785,"cache_read_input_tokens":212066,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":8785},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"d993362d-d834-4eda-a8ab-7bcbcdcf9e29","timestamp":"2026-08-26T01:46:17.357Z","request_id":"req_011CeQWreMYHTVSJR45MUvKf"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01Pi4M8SmCuvRT9iGby8eGwB","type":"tool_result","content":"src/components/TopBar/TopBar.vue\nsrc/components/TopBar/index.ts"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"695b3a7f-1a80-422d-9401-1cdc1f9b79cd","timestamp":"2026-08-26T01:46:17.450Z","tool_use_result":{"filenames":["src/components/TopBar/TopBar.vue","src/components/TopBar/index.ts"],"durationMs":91,"numFiles":2,"truncated":false,"totalMatches":2,"countIsComplete":true}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWriYJYMR5xyW1wzG6H","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01AyqHKBM4gYJTrZ3Trh8gr8","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/canonical/Tooltip.vue"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":8785,"cache_read_input_tokens":212066,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":8785},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"0b104fc3-f69a-4b3f-86a1-9eeceac709fb","timestamp":"2026-08-26T01:46:18.664Z","request_id":"req_011CeQWreMYHTVSJR45MUvKf"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01AyqHKBM4gYJTrZ3Trh8gr8","type":"tool_result","content":"1\t\n49\t\n50\t\n65\t"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"0902f502-f165-4dfe-8ec8-785a56bfe97a","timestamp":"2026-08-26T01:46:18.673Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/canonical/Tooltip.vue","content":"\n\n\n","numLines":65,"startLine":1,"totalLines":65}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWsTZBcct7B8HRc6uo7","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_013QF4yJHBySCUCcf6w3qTtt","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/TopBar/TopBar.vue"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1532,"cache_read_input_tokens":220851,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1532},"output_tokens":17,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"2209a0c2-3567-46ba-b6ea-c68d1ee05b47","timestamp":"2026-08-26T01:46:22.390Z","request_id":"req_011CeQWsP25L8WM4rMQEU4oE"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_013QF4yJHBySCUCcf6w3qTtt","type":"tool_result","content":"1\t\n19\t\n20\t\n36\t\n37\t\n85\t"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"264a64f2-b2a0-4f26-9dcf-e509acf3eb65","timestamp":"2026-08-26T01:46:22.398Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/TopBar/TopBar.vue","content":"\n\n\n\n\n","numLines":85,"startLine":1,"totalLines":85}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"782a0bbe-0e34-4aeb-997c-d1a1e9716959","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"5cfef450-13e4-447c-8566-cbf770411adb","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":177,"estimated_tokens_delta":27,"uuid":"3be1b0e5-411b-4fb3-8100-f385778a9175","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWskA4uk5AaRccKmk15","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISugUKpgEIERgCKkBkl0fCbddVIyYewilUu+EF9CT9tCNEF47dKZFFgBEQVSU2EOT/57N/frs0zscW8ps+H70ZvCsRxCwyNstcVjZeMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAfSKudQGsAECEgxnnN5Qoc1AZd0CFE8aDM30VDqzOeyDE+ecAyIwmSUF/dj0krx6USxOpyVfD+TWwwZm5hm0QB6jrzZmUUOZrkJmNsv27++asEcF+ndnKsAD2mcp7TzZ5eD6JKgfD3EEWoif8d3cdAoPunYWCNXdx4LgRbHWKIgEtC3DY3n+dvXPTSaN2aGZCmYhUeMr4g2as4UhY7uJwQtehiIfKlzB04JfHVo0e3Emdxp3MNDFFtV3t04ahY/YEg/6xlYytmu/M+80GJboUBkmLt+sKs50VjxbuDLZSLn1u+saU2hQQ0RB2BeECsAp0IJ+RrDVGs55B3SqhPaoiNzBL/XVnSG6gvqinBpA+IP4934DyEx69algQmIxPA3q4IgA8AkRbWD5hA2yKCp2cOyQJ7OgLXbAcfjmvlcoj7fo2c9RSptNPcKr47u+hDW6ovNrTGrSwWo1GiY8xZ4jb7qh9m4wwKzQoCaWeQz3X88mZhrw3LihvggbxVutdVlCRHhf9IXvIDzDFMZeB9vgSNysc4zH2NBoCjI6aXR9yAXHcJoEYYf6qCU49VWn9YczEzpK9i0VP5TxCaNRmdxQKnOYzEjFhxEs+iahYqo0UTxfbegN0o04OK80oXIjCODtzFnEStuxbqKgfD3mJqsQADkRUZHxYUiucVZmCjLHmRK+/dA0v9b/EfZoITKagN4X7fB+UtlmV4v5OxgB"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1256,"cache_read_input_tokens":222383,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1256},"output_tokens":6,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"2a8e9e5a-a37e-45dd-ba79-17e0b601367e","timestamp":"2026-08-26T01:46:28.322Z","request_id":"req_011CeQWsewHxnh3s6PMwtY57"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWskA4uk5AaRccKmk15","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01BeLRLEDL4L8FBVWHZB8Zra","name":"Grep","input":{"pattern":"LogoTVU","path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src","output_mode":"files_with_matches"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1256,"cache_read_input_tokens":222383,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1256},"output_tokens":6,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"0c83d265-f065-4db2-b847-bc66a70d4d18","timestamp":"2026-08-26T01:46:29.748Z","request_id":"req_011CeQWsewHxnh3s6PMwtY57"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWskA4uk5AaRccKmk15","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01MJDYQYnUqVVTE3BF3eyh7c","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/components/Tooltip/Tooltip.vue"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1256,"cache_read_input_tokens":222383,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1256},"output_tokens":6,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"0f787fc3-16a2-43e0-a624-932379fc22c7","timestamp":"2026-08-26T01:46:29.752Z","request_id":"req_011CeQWsewHxnh3s6PMwtY57"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01MJDYQYnUqVVTE3BF3eyh7c","type":"tool_result","content":"1\t\n32\t\n33\t\n59\t\n60\t\n264\t"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"aaaa41d5-062c-4372-835a-1542ea41baa5","timestamp":"2026-08-26T01:46:29.754Z","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":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01BeLRLEDL4L8FBVWHZB8Zra","type":"tool_result","content":"Found 5 files\nsrc/index.ts\nsrc/icons/raw.ts\nsrc/icons/index.ts\nsrc/icons/generated/brand.ts\nsrc/components/Logo/Logo.vue"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"4b9c6aab-18ab-4ea5-93d9-ca8ed77c169b","timestamp":"2026-08-26T01:46:29.764Z","tool_use_result":{"mode":"files_with_matches","filenames":["src/index.ts","src/icons/raw.ts","src/icons/index.ts","src/icons/generated/brand.ts","src/components/Logo/Logo.vue"],"numFiles":5,"totalFiles":5}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"ed79a3b8-3958-400c-b2af-ec8659d7ff64","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":105,"estimated_tokens_delta":55,"uuid":"bee873fa-6d6b-4675-85ca-d7badca7b0e9","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWtH6QpyayE9TcHHV39","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISmAMKpgEIERgCKkCHQ8GTQFWFcP/4Cbe26fUzlHmtLpYiy1JcFPuAMw2HyYrLOaHX2F9H9kenCuhGj3WBLl9uNO8tWAUUQqMx8k1aMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAfmKudQGsAECEgwhwAXQ2ObPsQptj5IaDFjLtyYBhqUA+7qt8CIwUxnuXshGPNCVRwLPnen35R0ciWUBGQLAX5X6ECVmhz046ziOnkQu3W9J/XZiUfiRKp4Bg/qtJBUuRVJIRld4RoPt/yx0VnRhxs95QAQHEJVlQhWK+fr/yhiYzNtsB3fFzMbOa43I3xybk8SW/2OiaCfhmiXKW5DM2BmjG8dix18P4ZE8IhIXW60NBKpwh9xgPUPJ8bD6vi1Ry9gp+Gov78I/rCwK7gYAjR924eTpa2a6nQuxOLV+5bBvJygEKrirQxCwaJg8q0+EHyfspdemnMQYAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3736,"cache_read_input_tokens":223639,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3736},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"50100778-ed2e-43c8-a14b-91308a0aeaf0","timestamp":"2026-08-26T01:46:34.261Z","request_id":"req_011CeQWtCTcEK9QRn9RgKSSx"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWtH6QpyayE9TcHHV39","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01FGVX74MePiTMENkK1zrGmd","name":"Grep","input":{"pattern":"LogoTVU","path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src/icons/generated/brand.ts","output_mode":"content","-A":3},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3736,"cache_read_input_tokens":223639,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3736},"output_tokens":4,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"3a1992e0-8c70-4bee-a7ce-42eb7e19e627","timestamp":"2026-08-26T01:46:35.417Z","request_id":"req_011CeQWtCTcEK9QRn9RgKSSx"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01FGVX74MePiTMENkK1zrGmd","type":"tool_result","content":"2: LogoTVU,\n3- LogoTS,\n4- IconBrandAndroid,\n5- IconBrandApple,\n--\n11: LogoTVU,\n12- LogoTS,\n13- IconBrandAndroid,\n14- IconBrandApple,\n--\n19: 'brand/logo-tvu': LogoTVU,\n20- 'brand/logo-ts': LogoTS,\n21- 'brand/android': IconBrandAndroid,\n22- 'brand/apple': IconBrandApple,\n--\n30: exportName: 'LogoTVU',\n31- aliases: ['logo-tvu'],\n32- tags: ['logo', 'brand'],\n33- },"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"bd471946-65a6-4a16-aaba-53ee7b620251","timestamp":"2026-08-26T01:46:35.425Z","tool_use_result":{"mode":"content","numFiles":0,"filenames":[],"content":"2: LogoTVU,\n3- LogoTS,\n4- IconBrandAndroid,\n5- IconBrandApple,\n--\n11: LogoTVU,\n12- LogoTS,\n13- IconBrandAndroid,\n14- IconBrandApple,\n--\n19: 'brand/logo-tvu': LogoTVU,\n20- 'brand/logo-ts': LogoTS,\n21- 'brand/android': IconBrandAndroid,\n22- 'brand/apple': IconBrandApple,\n--\n30: exportName: 'LogoTVU',\n31- aliases: ['logo-tvu'],\n32- tags: ['logo', 'brand'],\n33- },","numLines":19,"totalLines":19}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWthCzMwQYths8C1LiE","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_018sYFTYGMp51ApYmFw47NdY","name":"Glob","input":{"pattern":"figma-data/published/icons/svg/{brand,logo,Logo}/*.svg"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":496,"cache_read_input_tokens":227375,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":496},"output_tokens":17,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"83f50a9c-9360-40fc-b9e4-7d25a6f53dbd","timestamp":"2026-08-26T01:46:39.210Z","request_id":"req_011CeQWtcVE1pWUcWAZthb3j"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_018sYFTYGMp51ApYmFw47NdY","type":"tool_result","content":"figma-data/published/icons/svg/logo/TVU__1136_3266.svg\nfigma-data/published/icons/svg/logo/ts__1136_3267.svg"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"6c3da54e-df9c-4a30-9a1b-5f5eed8c672f","timestamp":"2026-08-26T01:46:39.307Z","tool_use_result":{"filenames":["figma-data/published/icons/svg/logo/TVU__1136_3266.svg","figma-data/published/icons/svg/logo/ts__1136_3267.svg"],"durationMs":94,"numFiles":2,"truncated":false,"totalMatches":2,"countIsComplete":true}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWtydi1fwr5rSUx3gmo","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01FAZURcJBzPZ7m9gCmBhpkC","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/figma-data/published/icons/svg/logo/TVU__1136_3266.svg"},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":162,"cache_read_input_tokens":227871,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":162},"output_tokens":16,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"a0c442ed-0d14-48de-a88b-31b44aea76cf","timestamp":"2026-08-26T01:46:43.051Z","request_id":"req_011CeQWtu967coqB4sXzyNco"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01FAZURcJBzPZ7m9gCmBhpkC","type":"tool_result","content":"1\t\n2\t\n3\t\n4\t"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"3688796c-6232-4ddd-9c42-b3e818be53a8","timestamp":"2026-08-26T01:46:43.063Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/figma-data/published/icons/svg/logo/TVU__1136_3266.svg","content":"\n\n\n","numLines":4,"startLine":1,"totalLines":4}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"c913e376-eaf1-4597-bf43-1ce3f0788ce5","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"fb4af3c3-5eb0-46d5-9a6a-91d5f9052521","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":250,"estimated_tokens_delta":100,"uuid":"bc196dfa-35b6-4a2c-ab28-8ac3bec4937e","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":300,"estimated_tokens_delta":50,"uuid":"1f9fba7a-015d-4079-be8c-b6754dda0038","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":450,"estimated_tokens_delta":150,"uuid":"72ea37e1-875d-43f1-ab85-54f2aead8871","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":600,"estimated_tokens_delta":150,"uuid":"db0fb873-755d-4a60-979a-a5070f236d32","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":750,"estimated_tokens_delta":150,"uuid":"51af7dec-1bf8-4ddf-a95c-e2a94d9b65bb","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":850,"estimated_tokens_delta":100,"uuid":"c8cf3451-a64b-4647-bbc8-9d0054d7a681","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":950,"estimated_tokens_delta":100,"uuid":"1c3ee732-0c50-4577-be4c-c885b0e33d14","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":1100,"estimated_tokens_delta":150,"uuid":"3ec39b33-b072-4187-b939-ae3e17575929","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWuGLJHpLL6neoHWTr4","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISihgKpgEIERgCKkBrv7GgU6A6AfLnkDvhq03IVRTl7XusQvnmPzL3n1ZuFDAtV8yjUdf3fN8uwKESuH8esd45h+CcrrbMJ0xCTSv5Mg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAZSLudQGsAECEgyE+FYlXxzsgJuRnocaDIyCCoClP1i+H1RElyIwMDlrs2sJzYKQfdifOYQu1MO9rYsPTs1I9IesaXWdoBmSsaE5dentr3OzaFHQOaYgKpAWN0k5ebZNJWx1/x8mNqjA+pRsBVhgHat2A6BP+E+XZP43Qo5WlU02WCk5iaLJtT+2Wz0p2hSxEtdks9G5/m6fM0drmk/8gJCZWoeI4nNRV92ZkAuFzFkZ3fyZLaZVQGh6wj5BBIjqM+WwA3F4xkyKMVTbPYVQC5ak0hJ2QymYy/o8CQkDQWM3UQCQTWZgSkvudsO5OTHe6MwOu9POJ5gtSmS9ucvzOHoGsBCbz2HZWm5bZhE6WWF7ZnX8t8eCcELIK8cE8/9Hkt1Yx5sB46MxDi5UOLCO7rs3jTL5BFYlIZJZ5whkLbZhiQjwWhNFgvmowJLLpdUP83uBjiJTJiztJrwk+s2Wr+gHSnr0oYanir8zU2p13CUV66aTvvoLxCUNFliGPIQQd907Cy4/5Ge2CN4UEVT4FumujvRYSA3vrmW5JyBzqo03183VQoCQs+8tSME2+3LplSFiprqYgBluzNLG5Rbvr0yqGk2vZSf9MU3j5Ot5oR2vUN0UxFmM/4mwnurXJQRhc+aX9vMz+pRVCMlr8fXcxTkeC0HygRtOYERoGXTFVzRhVRPXvkkR9QS3BDPD2WfJti9E5MyA5tGlS+jnrMyyN6RjkodrQuh/LlxOs3E3eJ6wWVWy3SvSvp4pGzvoJUcPritQw7iIaWgBMsKxOoNeBgcuJnSga4FbwXQNUR8bYLJCwjecJAZU8YtNUTorEiXHMdSy2YBlH4ziIw9p+AIrNkoFI8IAXrQfpwoCZBZvujawijwr26b8dSulm/6p5YoI1FXt9+/jWTeBeg8FMKz/f+289fANS//a12IW9vGm/P4ekNx+V/yoZLOXiLdo3+MGWoV0SkkuRn5VhGlA1DOZojwIBjsr8kjcGz/aI1XdWPtO2hImkvaXSs0rOMrW6tAIE9WREcIhUw3s2nL20Uge0i2iPjcKrLz7OwGmHzPtsQWGDBWipMg5cjEtZDbh8t13M6PoBIQhsCrK+NcuqVQTV1CcdMruuouYWn2828hQ9CXpUPkNHGhvVNF3ZQPX4GxNUssYzW4J79ISQW+oz/OfaH8OI2wsStKczookzcDjxYSoMIH2RkPAdSd82+udL5pDAB//cfsYukhDRp7Vp0fXVty1KKFnnkIPKL5SBOa4HOPjNkdhUhxWWEr1xfDslbTSb+l9qgVZuAE6EjlPii/RK+fKv/evroKrtr4KlGn9FiLfWqmnSN6948nb3HWrDQvFsIf24PAvuF7Z4+E53ho/ssPmagL6qACDLHCPk2D0OxlcOVBrQUdo29p9K4Mahay3KsOIcMT8WFsrHJLRvwPBDYAdo89a2/PWbBQ3m2W9v5PLylbkfiXgUPvJOvV8MxZwO8YFhViNxQjuhLBmYbUYIHqj8bu6fl0vZZjK0F652TsT8ItdsX4gOIfsLLzrNRtrkouX5bM9xkN3DwS1j1h6WrZSV70ozMKv5qeHukF83y0EB2j9quNVg+5Bn3Bswy/LOKA42xoXMnZx+DcVN2MSz1U1xaA93ZSoQS+B2W7/TqQodA2lxdkFF/YBOC0fy+hbdIs4bsdErQmnPNKC0O/9DDuIwqrR0SJgEpXgwvJGmtiIZHcJKcrRbirIEksHAzrrNkNZO7XRkHpa9sRX34oWxfzYTXsAAIWN/G5ZraG2rHtB75oOuq99vIE31zEwTqi9VMvw0supXcgi9H0RSZIBYqnjF3/7mpv/dlNtUIHtcbuphhcXl9ijiUAjcHUgxv9/wYHFXvd9lfyAQDqyxdHsPDo/6tQ6Mmi0mCSKcVV1jDnVqfTpaNI25fWOI8y7grKSChggmPhFrDU3ZMzlmB9mXRNiGDTDvL+wX7Cg6nhDFf/7rsciLsDfdmQ2vRTG56l3mxUGIwyCqginQMB0l+5Q/tZrya2T0bAOXZpxVmL2EfenRa6czsJi/5UtHWl9HMm8yOyCsAUCDgxSewUcyDVpaWyOKnDswqWqwfs32sVpsj8rTT+69VNyTTiGb1FeyEdVssoXoo9wMz57FRCJgwjaaK8lwyqlP3M1P/c8NxL+E32FveV7fZuM6h2TJE5WrvLzp808DdTuUd+tqZYnhKSV/O5WfMeE7JLefUj5tNa8MWwFSOcjLtdxzD/sSRAJGqCzVWb6Wpf0TorZqQyrI6rCLi9xesYfY7CTktUABXshshoSEqOTTiBWk3jT0cNZfwIjxPJAJZAPFSgrGYLvM2JQzLJXBB55zQhz5YTACrVrBPvvQc2pUHmE9LrxG70/UzTPsiJVHsypEAV2YxF484kE3KRkJtZdP9c+kZOvqTIpeMEhcH7qj3sphzjyaWvdEjN8JG+vjmOjvGAIrc3CMcw4LXz9sDdq+1ze8mGn1VfShYDhfFFtxQZ6VB96KXwyrJc4RQbaubQM/0QOxzxmrszMyZnIlChjcGUNS3g4TDtFYMmAKGA/Fz4kmNF7pniQ8IgK2pA0DHZVnRlNNz8KgHECp0Hw+DePdf7kmsjFoV0tKHjMFrEJh7XDeakG1/3RIuxr+0Ni033dS5lnc/GXPGTlS+Vb8vpVkR0ZZG9JwXRHG1sFGwgCIRAXS17duk9RIJ+UTJHsJMBrXYhyh3re8jDiYPYyzJrCq1j+AGqdBfWC5o8L3Nr/8icf0vmfRfcHCsikLOJU/6vU1HpIxhg7tnwHmZnoqdd+W9S3bSnZsclLyXdZT6Mku85DqcF5of9PTRSAicZsXnELug8v18fG4EwX7ML43jwoGwZTzftm5jV/9+HyfMzwbQ7K7Ub2pgIpcaGgFKtz1Kh/qwx2pvN/CgQTLlqEvH9fjUL2ADbvTGG7QPRLeMrwcDfG2IMqyj/ikovvF3FDVfz0casb/yB1jeL3PxPi6cujWDNQb5RaaZFC91gTsZqD75fPrJU/oB/DE7J5WHZiMXGSrpvgRJ/emfdcr83/rMuQdlbpI6IX6lbG79JvzcTssD069rgHa5FZ3o4w7fXb3lR6IE4454OeG4uaBseXpaHfxudkiC0aFCs57KYltT54YAOox7Y6Mj6qadhxLYJcPmE2yGJ+KXXiV8vio2K3VKMLLuqfLqhQqo6q3GCADQWOawXyHvUoPhzrJRuVIrVuINBZhoQXKYzxy7VmzEg/76BhDnHYS4bwsxgY+xa8FPW1ffAUEDZKYu/tBXECUD/+0LEAvIaTUKCXhkYb0pZEpOn8feoAb+BLptISES5JnXT+gOOUP6ygQiOldZ274cL7d6gKfw5narZ5VCRuVm6OizSE1+h/ndHfG6Zp2OkeYm/mnzuA1PIq82GJbJdOdT78EBIzI7Sd5fdE9orxXansOCl53t/E1L7g4ganvvHIjeXeJ2Ed+FMQcJ5070l+EvfgYc9StCcFURGq8MvQouu5PqwaRjndE8C/4XTRij5yiQn31wKreqLuBVreQFJGjvPrc13eziSsTBACZ4psSSw/oN9/Z8UJ4dFeCAeF2ZNVBpAGxI2snSZG8sEEs5dOjVrrTfEI1GaSLdyErZ7R1NCpBm/BkgCg4+PFMZ+xi3as9MC9aNUuEQUmuDAZmWTErPoZOfCCwHLedt4JQcyhG6yVLWxumnmqEv65+LGJytknlpkYpiHYg/iADOsFQYBdGfuOvGFbYrzOKlMeTefx2GYa6FIzFWIRCW2aFQdzSpH+wRnhugXbT5nl+9B18ks664ZJ7y+FNBXWUNPsrPc2to8fVE09pjHJWqMNjIOGKqMsk+z7Tfkoa5jyI407o4wSc8j53Zj87fpLOrPB3ZgUon628dDWesOFSMBuxi+YPAejnhT88z3GbkIoGAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3780,"cache_read_input_tokens":228033,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3780},"output_tokens":5,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"36be6eca-a110-4eb7-9d53-365a0180ce0c","timestamp":"2026-08-26T01:47:01.217Z","request_id":"req_011CeQWuBDyKGZWKKg54xzh8"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWuGLJHpLL6neoHWTr4","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01AuGqAtCwjEmAHYZo6ckQUy","name":"Grep","input":{"pattern":"[Tt]oken","path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/domain-tvu.md","output_mode":"content","-C":3,"head_limit":80},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":3780,"cache_read_input_tokens":228033,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":3780},"output_tokens":5,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"270deda9-b28b-421a-b035-8bb1ca667c82","timestamp":"2026-08-26T01:47:02.962Z","request_id":"req_011CeQWuBDyKGZWKKg54xzh8"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01AuGqAtCwjEmAHYZo6ckQUy","type":"tool_result","content":"36-\n37-TVU 产品 session / stream 状态色:\n38-\n39:| 状态 | 颜色 | Token (dark) |\n40-|---|---|---|\n41-| **Live** (output on air) | 🔴 红 | `--red` (#ea4233) → library var `UX/Red/Default` |\n42-| **Previewing / Standby** | 🟢 绿 | `--brand` (#2fb54e) → library var `UX/Brand/Brand` |\n--\n137-\n138-Delta / latency / metric trend 可视化用 ↑↓ icon 时,**仅 icon 不够**——**数值本身也要染色**,icon + 数值色构成双层视觉信号:\n139-\n140:| 状态 | Icon | 数值颜色 | Token (dark) |\n141-|---|---|---|---|\n142-| **Converging** (delta 收敛 / metric 改善) | ↓ | 绿 | `UX/Brand/Brand` (`--brand`) |\n143-| **Diverging** (delta 发散 / metric 恶化) | ↑ | 橙红 | `Color/Text/Warning` (`--text-warning`) |\n--\n147-\n148-**Why:** icon 小(通常 16×16)+ dark theme 下易被忽略;数值大字号染色让 user 一眼 grasp 方向。仅 icon 漏掉 = monitoring console 高频信息密度场景下信号弱。\n149-\n150:**任何 trend rule 必须同时描述:** (1) icon 触发阈值 (2) 数值颜色映射 (3) Token 引用。漏写颜色规则 = 不完整 spec。\n151-\n152-**反例**(2026-05-26 Video Sync Phase B walkthrough):Design Rules card 原 trend rule 仅描述 icon 阈值 `±2 ms`,漏数值颜色映射(mockup 中 84ms↓ 已用绿、320ms↑ 已用橙红,但规则未文档化)→ audit 时补。\n153-\n154-**Acceptance:**\n155:- Trend rule 文档必含三层信号映射表(icon + 数值色 + token)\n156-- Mockup 中相同 trend 状态视觉一致(不同帧不允许颜色不一)\n157-- 颜色必绑 TVU Variable,不写 raw hex(与 M-COLOR C1 / 原则 4 一致)\n158-"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"15fa79bf-2cb1-49c3-95c1-be04028549fc","timestamp":"2026-08-26T01:47:02.984Z","tool_use_result":{"mode":"content","numFiles":0,"filenames":[],"content":"36-\n37-TVU 产品 session / stream 状态色:\n38-\n39:| 状态 | 颜色 | Token (dark) |\n40-|---|---|---|\n41-| **Live** (output on air) | 🔴 红 | `--red` (#ea4233) → library var `UX/Red/Default` |\n42-| **Previewing / Standby** | 🟢 绿 | `--brand` (#2fb54e) → library var `UX/Brand/Brand` |\n--\n137-\n138-Delta / latency / metric trend 可视化用 ↑↓ icon 时,**仅 icon 不够**——**数值本身也要染色**,icon + 数值色构成双层视觉信号:\n139-\n140:| 状态 | Icon | 数值颜色 | Token (dark) |\n141-|---|---|---|---|\n142-| **Converging** (delta 收敛 / metric 改善) | ↓ | 绿 | `UX/Brand/Brand` (`--brand`) |\n143-| **Diverging** (delta 发散 / metric 恶化) | ↑ | 橙红 | `Color/Text/Warning` (`--text-warning`) |\n--\n147-\n148-**Why:** icon 小(通常 16×16)+ dark theme 下易被忽略;数值大字号染色让 user 一眼 grasp 方向。仅 icon 漏掉 = monitoring console 高频信息密度场景下信号弱。\n149-\n150:**任何 trend rule 必须同时描述:** (1) icon 触发阈值 (2) 数值颜色映射 (3) Token 引用。漏写颜色规则 = 不完整 spec。\n151-\n152-**反例**(2026-05-26 Video Sync Phase B walkthrough):Design Rules card 原 trend rule 仅描述 icon 阈值 `±2 ms`,漏数值颜色映射(mockup 中 84ms↓ 已用绿、320ms↑ 已用橙红,但规则未文档化)→ audit 时补。\n153-\n154-**Acceptance:**\n155:- Trend rule 文档必含三层信号映射表(icon + 数值色 + token)\n156-- Mockup 中相同 trend 状态视觉一致(不同帧不允许颜色不一)\n157-- 颜色必绑 TVU Variable,不写 raw hex(与 M-COLOR C1 / 原则 4 一致)\n158-","numLines":28,"totalLines":28}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"74ff76a3-88f1-4745-8479-75312f915092","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":200,"estimated_tokens_delta":150,"uuid":"7f0b845f-1593-4479-adc8-33b19808def3","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":300,"estimated_tokens_delta":100,"uuid":"e0414282-fcee-4678-a001-fd6de6077c29","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":400,"estimated_tokens_delta":100,"uuid":"12ef037e-f961-494b-af4d-13169a939d6f","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWvjYC3Nx39czZmacoz","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISzAsKpgEIERgCKkDm6D+itsKM3uMAm6ALRAZPp18XPkg8gVOqVfVOAP20QFiF+rJgNgQhTACmKIer1Bcn2Q7kZpbxMqtjolr7xyVPMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAaCLudQGsAECEgzuGB5x8aitaBSb9GIaDHb6sWa0XYLBEUC9eCIwuHA4vMAFrT2fWyT0F2svoFGuvYvH35Cl94bEWpe64lE9/Xucozvr+098cJoFrS44KtIJ110oHngtSzA6461f2VscWC/5je/rnAq4T9YsDUMrEGAUyQqqRYN9UplC2+2BaWxVDE2R1glHmrhYgZgdUK+MYDLA1pq2Stt9k0YRBko+vq+dOepiYP7x8xMsrET/h7WqzOBlIQrmsn2J3iXT0LAnnnpPco0UEzmsuMWIR0ZkmSlMlIvWDvkc1Nw5ujyp/NCfSatmjVNCEGvuuJW/ZqiLxbQgz6nsYk2G+WPLbFrxxKXu8aG9Hexg5tFuGGwBe+TM58ogbq0RzjHXfRJs5EznRDrX7DFzwy2p8hxhhBfWg97ZsVisSQMlFz1PtNYHwQ/P9iRwLItNvu0OpLLI1gLANfqgSKzEETH0IVJCftC6AsVpmrNQfyDtQKIfidTRHS8ZqXSM9zo3E4SRXv0gTWOhYWYrDIIFA9Qam5Av5TKoZSxS3jEJ4VqzsDmF405v5aZrlfD211nePm8OugHrqNRg9zqyKeyp+w52k9PMfNYFauXBHs5i3YkVVDUDzwWGczUTmaJWMQttdi4UMKvUeWkgdGYYBdVCJmGoVfL3ODsxqOpr3NDp+QW9hnGqaiDi5zexsK1GMEbDjB83DSWhkoqEdjIRIthgMndILiF2xQZhoBCuQpeQbmuU3zW6Toli6afLkOp1P5vyR5Ng1PKIMPKUbTCAQDImwt8Hxpl1j58o5YwAJWff2+ZULE6XGK84tQACvkdq5FPWhjy55HXsIyScIXkT4WKc//J3BlmJy+oeg6n5gPIV4+ae8atufGHatuyawYX3A52ekYZvyYMRRZeYoCCb+L2zga5CjMNzepKujlp/wcH1FwVAErQsQj3iYaLdQWobgGgWJdgyIRct21ok6HlPT1e5yS1vNBLjQMVzYaH/dcFaBYbPu7ibwCiYPnjQUl13t3ZHPKYxm2mIV2GTZYwZXDqNlAG1tvY9OOaJSsFsM0z8MBz9ABKlblc2YQUzPZXE2w5HsLcNBjzavPH/XMBr7NUBZJY5QyhCyMGE0lFd/mffGWYT/09142B2pSd2Bbdc1QfZHquo4qWFIsGf0c6giam2QYJYi29Hniz91BuTMR26QEOTT8yjZEtA3OLHXP1VDAn+M5sZ/WylwrxpzZf0chUh2CKXRnL1rQbNJzWVQsd5iAotuvBlv2eCHy0wZIj2pMTOda45iOFLQhdbWtO/80Yx54UTq9hgc3ltIQXp8r/PAj/IEy3oCNmOY6+O3V6pWidaQ7acpypbVJYI1PX8e6yvQoqKgJm/FUirrMdXozfpbPPfNoifsTmo8WZS19r6TyZHo1BKtrxYPv4lqtHT9peHUXGHya75phzx6jzGbDUNnwiQz6Sct2ZDZfmdi6l8QKowacWqnZkHLTuIGLG6W22W1g+YdCQT6yF8pTyBMMiFDzgJ2cIyGDUJXR1BW7kym1Bn3pbNyof1Y0Sb1BzwPmk/4mOV8vp8rAkaQyIqPGrX1LPoENzqEa5G6WqCV+AwXVf7mVL2oknSHtTuT64dOD47ce99d3teJc+qLkc04nilabGRtGUhLrUwKQNaOaaDyO5LseNUr6SslkDXKt219SU5L4hQZisgDlXlzazZMfXpjAPOmZoIwKDxF02XmAWPOiI47PyKRrnOfDWeSYK7BYVfUGwoGIu+BlLTb2zCCBgB"}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":2154,"cache_read_input_tokens":231813,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2154},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"9d707728-0e2b-4522-93f0-af862dbdd57d","timestamp":"2026-08-26T01:47:13.124Z","request_id":"req_011CeQWveoC5EDVWj2MmCQmX"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWvjYC3Nx39czZmacoz","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_011x3DoSSqSMS2qshVVasjaY","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/domain-tvu.md","offset":1,"limit":135},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":2154,"cache_read_input_tokens":231813,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2154},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"d7ffa8a2-c8ee-4d26-b0e1-238f96a821b4","timestamp":"2026-08-26T01:47:13.778Z","request_id":"req_011CeQWveoC5EDVWj2MmCQmX"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_011x3DoSSqSMS2qshVVasjaY","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"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"c435c246-b7c5-41db-83b4-e344f9c62f6c","timestamp":"2026-08-26T01:47:13.781Z","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","numLines":135,"startLine":1,"totalLines":263}}} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWvjYC3Nx39czZmacoz","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_011wM2NndE6ZVDFq74YT1zPT","name":"Grep","input":{"pattern":"text-warning","path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/src","output_mode":"content","head_limit":10},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":2154,"cache_read_input_tokens":231813,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":2154},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"3449dd0b-9468-4993-8f60-ad1a116aa28e","timestamp":"2026-08-26T01:47:14.625Z","request_id":"req_011CeQWveoC5EDVWj2MmCQmX"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_011wM2NndE6ZVDFq74YT1zPT","type":"tool_result","content":"No matches found"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"c5863ffa-ddbb-4a7d-ac3b-d7941a709ee7","timestamp":"2026-08-26T01:47:14.646Z","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":"febe43c4-cd4a-454c-8c13-70c61faddd7c","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"fde3c93c-bf38-4297-8fcb-a12d5f9a59cb","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":204,"estimated_tokens_delta":54,"uuid":"4cd322e2-d24b-4a71-9998-e28dc008b633","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWwb8x35nBtsT1Xkn7n","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISpwYKpgEIERgCKkA/7P+IJBEPAndxS/b/AAHiBH/3gsH4sc8RerYray3ePtqHJhUWyETEzNq/danC1wPr/5YNJV2pKjYgSve91JGMMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAaiLudQGsAECEgxWgwrTM0MXc9XKds8aDB0FXiRroYjD993FVyIw4MXZMnSiWJtNFk31Gd/FPtK02BETGihPD9aOeN9ybRd33TnmD6/PfaVvus5Z30ZAKq0Eq3ia3Np/NCRezSDk0Q+pJzLvQtVQu6U0uHgTanl6TTockDPBwKjrfI8vnberJkTsF4dgYw1isIOk3S58lto16GfHhQCDq7QZXeGe11CrqTkTbX/Y+dE5YQeron+nSe+vVeU5abaf4Ghvt2xXxD8RmnWJ2Si7Tm/BJBpMUnGO5TXkhniNumn/KC3+eCpTpqmRVb97bvVW3zS+jS4uM4fvc001rhI9khkjQ9bBo71z/bQEkccRAZEbbI08maUgoZh7P0cRVSauCZQCPfIhBcS0SjlpvOSsS3NWwPuo9EerJosgFvvw1JzG3zUyjF8nK4SYgy7ViQf85Sp9n1b4gqahOBGK1UxajXbL84jTAKosCXs5Olmnw4ElJBPSElNnPbAY28UlBxRrTFpgQe8DsiMTjrICWbj2UBNfQnbD62wcSYdBJBUgyu3ZlVxbFMoMb3a0U80IjIphMB58odxXNpePkJ5ZDMwBi07raFnPK93F3NjTojj3A2Ie9HvHv7qB5zWcIoNcrWqhHsOeMX4CHCTrP3poFmxrA5b3sCwEk6SDcArttcpU1VlIiAHjMxDUqwRSzeRBJdAJo5aBJv/Vw3xwp11GIp+edX+LANe2iskOtyi04RTP/yAy6a5Dh0ryCOWeUQnXtG1qTWfqEKFW1P8UCrUCI2diKykRjyvfRVqFjg/CQkm8R0MxK62mM3lM7D+rSd262JTZ8mSTtMoLIy+c5q4z/w830hEgbijLLFkYAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":4461,"cache_read_input_tokens":233967,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":4461},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"4e6d0513-49d9-43ba-a603-440bc4c7d32e","timestamp":"2026-08-26T01:47:21.286Z","request_id":"req_011CeQWwWSRrSYKrzTjvdhef"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWwb8x35nBtsT1Xkn7n","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01NA7oFSf5t169sf55VEswsP","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/domain-tvu.md","offset":158,"limit":130},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":4461,"cache_read_input_tokens":233967,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":4461},"output_tokens":3,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"fc138661-82a4-4e4f-b362-7e80c0be80eb","timestamp":"2026-08-26T01:47:22.954Z","request_id":"req_011CeQWwWSRrSYKrzTjvdhef"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01NA7oFSf5t169sf55VEswsP","type":"tool_result","content":"158\t\n159\t---\n160\t\n161\t## M12 — 外部/异步事件不得静默 no-op:检测 → 告知 → 给前进路径\n162\t\n163\t产品处于某一模式/状态时(测试中 / 录制中 / 推流中 / 监控中…),发生**用户未在当前 UI 主动触发的外部/异步事件**(信源插拔·格式变化 / 网络波动 / 电源 / 温度 / 存储;云推流侧同理:源流·推流目的地·配额·服务维护·会话掉线),**默认不允许静默 no-op**(画面无变化、无任何反馈)。必须三段式:\n164\t\n165\t1. **检测 Detect** — 识别到事件\n166\t2. **告知 Notify** — 可见反馈:发生了什么 + 当前为何没自动变化\n167\t3. **给前进路径 Path forward** — 能一键操作的优先给可操作提示,不要只留被动文案让用户自己找入口\n168\t\n169\t**反馈载体(交叉引用真源,勿在本规则复刻组件细节)**:反馈控件一律取库 variant 不自画(同源原则见 M52.3 / design-process §M49#3 Feedback UI Inventory;组件谱系见 figma-component-catalog `Message`·`Notification` 条)。两条硬约束:\n170\t- **谱系隔离**:设备侧(LCD/Config-T)顶部通知走 **`Message` set**(status×size,**无按钮**;L=手动关 / M=自动消失;实证 v4-2335 / V4-2312);web/SaaS 侧走 **`Notification` set**(slide toast / alert / dialog)。**勿混用两套库。**\n171\t- **需操作则升级组件**:`Message` 无按钮、只能被动告知;若前进路径需一键动作或用户决策(如“检测到视频输入 → [Stop Test 切到摄像头]”),须升级到带按钮的 `Notification`(alert / dialog / pop confirm)或 `Popup Box`。\n172\t\n173\t**默认须反馈,豁免须显式**:若 owner 判定某事件确不需反馈(如“无可用资源=既有逻辑、不新增态”),**必须就单写明 rationale**(与 F1 §5.7 D9“故意无须写 rationale”一致),不得默认静默略过。\n174\t\n175\t**Why**:外部事件静默 no-op → 用户把“无变化”误读为“操作失败 / 没接上”,在上镜等高压时刻反复排查、错失直播窗口。设备/服务本就该显式可控(不擅自切信源 / 推流以避免误播),但“不自动切”**必须配“明确告知 + 前进路径”**,否则可控性变成信息黑洞。\n176\t\n177\t**反例 — 2026-07-13 RPS One LCD Transmission Test(V4-2333 关联)**:测试信号运行中插入摄像头,设计为“静默不切、需先 Stop Test 才见视频”,插入时无任何提示 → 用户可能误判摄像头接入失败。根因:State-Completeness Enumeration 缺“状态 × 外部事件”维(本规则同步回流 design-process 枚举第 6 项 + M13 恢复态 + F1 §5.7 D9)。\n178\t\n179\t**Acceptance:**\n180\t- 每个“进行中”模式,枚举其可能遭遇的外部/异步事件(参 design-process 枚举第 6 项),逐一确认有 检测→告知→前进路径,**或 owner 显式豁免 + rationale**,无静默 no-op\n181\t- 反馈按谱系取对应库 variant(设备 `Message` / web `Notification`),需操作则用带按钮组件,不自画\n182\t- 广播域安全默认成立:不擅自自动切换信源 / 推流\n183\t\n184\t---\n185\t\n186\t## M13 — 突发中断后必须有恢复态(reboot / 会话恢复)\n187\t\n188\t设备异常断电·崩溃·强制重启,或(云/web)会话掉线·服务中断后,重新可用时**不允许直接回到初始态、当无事发生**。必须有**恢复态**回答三问:① 刚才发生了什么(断电 / 崩溃 / 掉线)② 中断前的关键任务状态如何(上次在推流 / 录制 → 是否自动恢复、要不要手动重连)③ 数据 / 文件完整性(录制文件是否完整、存到哪)。\n189\t\n190\t**与 M12 的分工**:M12 管“事件发生时的实时告知”(设备仍在工作);M13 管“突发中断(事发时设备/页面可能根本没法告知)之后、恢复可用时的事后补偿告知”。二者互补。\n191\t\n192\t**Why**:突发中断时无法当场反馈(都断了),用户重新开机 / 重连后若一片茫然,无法判断刚才的直播 / 录制成没成——这是直播事故的次生伤害。\n193\t\n194\t**Acceptance:**\n195\t- 每个“可被突发中断打断的进行中任务”(推流 / 录制 / 传输)定义 中断 → 恢复 的状态还原 + 完整性告知\n196\t- 恢复态告知用对应谱系反馈组件(设备 `Message` / web `Notification`)\n197\t- 不允许中断后静默回初始态;确无需恢复态者须写 rationale\n198\t\n199\t---\n200\t\n201\t## M17 — 新页面一律照该 surface 既有 canonical 范式(布局 + 控件几何 + 图标 + 按键行为)\n202\t\n203\t> **2026-08-05 泛化(owner 拍板)**:本条原标题为「**LCD 设置页**一律照既有设置页 canonical 范式」,scope 写死在 LCD 一端。实证表明**同一条病灶在另一个 surface(Config-T web 端)整轮复现、且连续多轮走查都没抓到** —— 根因不是缺规则,而是**规则的 surface 覆盖不对称**:LCD 有本条、另一端没有对应条文,于是同一个 feature 的两端一边合规、一边完全没对齐宿主页面。现泛化为**所有 surface 通则**。\n204\t>\n205\t> **边界(owner 明确)**:各 surface 的 canonical 帧 id、控件宽度 / 间距 / 对齐的**具体取值**,以及某个产品的表单布局与按钮布局规格,**都属项目资料,不进本真源** —— 由各产品在自己 repo 的 handoff / design spec 维护。本条只管**做法**(先 probe 宿主范式再建)与**核查项类别**。\n206\t>\n207\t> **2026-08-06 补齐(`CANONICAL-F103` 搬迁)**:本条原先在下方 §M17.1 保留了两张 LCD 规格表(行高 / 面板尺寸 / 帧 id / file-local 组件 key),按 §M-DISCIPLINE.SOURCE 三问②属取值 ⇒ **已搬至 `TVU Pack/docs/specs/lcd-canonical-spec.md`**,本真源只留做法与核查项类别。原「LCD 范式属 TVU 设备通用交互范式故保留规格表」的说法作废 —— 通用的是**交互语义**(下方注记),不是像素取值。\n208\t\n209\t**通则**:在既有产品里新增任何页面 / tab / 面板,起手先打开**该 surface 自己的 canonical 范式帧**实测取值,再照它建;**禁止照最近一次做过的某个页凭印象仿写**(范本可能本身就是 pre-规则的,见 §M23.16 规则优先于范本),**也禁止拿另一个产品的参考图代替宿主产品的范式** —— 参考图定的是「要哪些参数 / 什么信息架构」,宿主范式定的是「控件多宽、在哪对齐」,**两者不可互相替代**。这是本条泛化的直接动因:只 probe 前者时,参数集是对的、几何全错,且因为「我确实按用户给的参考做了」而自我感觉合规。\n210\t\n211\t**Acceptance(通则层,不含具体取值)**:\n212\t\n213\t- [ ] 新页面开建前,**项目 repo** 的 handoff / design-record 写明「宿主范式来源 = <文件 + 帧 id>」+ 本轮实测取值表\n214\t- [ ] 几何一致性至少核到这几类:**同类控件是否同宽** · **同一控件在各状态帧之间是否同宽** · **动作按钮右缘是否对齐控件右缘** · 行高与分隔线间距\n215\t- [ ] 上述核查**贴实测数字**,目测不算通过(见 [`mockup-conventions.md` §M-DISCIPLINE.SCOPE 硬约束 6](./mockup-conventions.md))\n216\t- [ ] 按钮宽度按文字 hug + 统一 padding,**不为「看起来一样宽」写死宽度或改字体** —— 跨字体族字宽差异不构成偏差(见本节字体注记)\n217\t\n218\t**LCD surface 注记(做法层;取值见项目 repo)**\n219\t\n220\tLCD 设置页的**逐层实测规格表**(底色 / 导航条 / 内容容器 / 行高 / 行内控件对齐 / 各类值控件 / 底栏按钮尺寸与 file-local 组件 key)**不在本真源**,在 **`TVU Pack/docs/specs/lcd-canonical-spec.md` §1**(含 canonical 范式帧登记)。开建前照 M17 通则打开该帧实测,勿信任何文档里的过期值。\n221\t\n222\t本真源只留跨页成立的**做法与语义**:\n223\t\n224\t- **双背景色**:页 / 导航 / 底栏一色,内容区另一色 —— 两色具体取值见项目 spec\n225\t- **底栏三按钮语义(owner 2026-07-29 拍板,适用 LCD 后续所有需求)**\n226\t - `OK` = 提交本页改动并返回(**LCD 侧的提交动词就是 `OK`**,不是 `Save` / `Apply` / `Update`;`Update` 是 Config-T web 侧的词)\n227\t - **「返回上一级」= 左上角返回箭头**,底栏**不再放 `Back` 按钮**(旧 canonical 帧底栏里的 `Back` 是旧做法,勿照抄)\n228\t - `Home` = 回待机首页\n229\t - 页面处于「不可改」态(如测试运行中)时,**参数控件与 `OK` 一起置灰**,`Home` 保持可用\n230\t- **底栏按钮谱系**:一律用该文件的 file-local `LCD Button` component set;**禁从别的页 clone 远端库的 `OK`/`Back` 组件** —— LCD 底栏按钮与 web 侧按钮不同谱系。禁用态用 `Status=Disabled` **真变体**,不用 opacity 凑\n231\t- **展开标记**:枚举下钻行用**下向三角 vector**,**不是**右尖括号 `›`、不是圆圈按钮、不是 Unicode 字符\n232\t- **超长 label**:降字号走双行,不截断、不挤压右侧控件列\n233\t\n234\t### M17.1 — 枚举值选择一律用 LCD 选项列表 canonical 范式\n235\t\n236\t设置行要从枚举里选一个值时,**不新造下拉/弹窗**,一律照该 surface 的 canonical 选项列表参考帧建。**面板 / 行 / 选中标记 / 被编辑字段框的逐项实测规格与参考帧 id 见 `TVU Pack/docs/specs/lcd-canonical-spec.md` §2**;本条只留做法:\n237\t\n238\t- **面板高度按内容行数 × 行高算,不照抄 canonical 帧的高度** —— canonical 的高度只反映它那份内容的行数;**上限 = 物理边界**(底缘不压底栏、不出内容区),装不下的行靠 `▼▲` 翻页。详见 [`mockup-conventions.md` §M-INTEGRITY §I7](./mockup-conventions.md)(含\"关键档位必须进首屏\"的例外条件与授权记录要求)\n239\t- **面板落位**:**右对齐被编辑行的右边缘**、**顶边与内容区顶端齐**,使被编辑行与面板的绿描边连成一条连续轮廓\n240\t- **被编辑字段行本身要加框**,表示「列表属于这一行」—— 只 clone 面板、漏掉字段框,列表会浮在半空看不出归属\n241\t- **选中标记用矢量三角**(marker 在前、文字让位),当前值行文字走强调色\n242\t- ⚠️ **连体绿框的实现**:canonical 实测**不是靠遮挡自然形成的,是一个手画阶梯形 VECTOR**(描边被 outline 成填充;**canonical 面板自身的 stroke 反而是 `visible:false`**)。沿用此手法时:① 改面板尺寸必须**同步改这个 VECTOR 的几何**([§I7](./mockup-conventions.md) 第 ③ 项);② probe 它时 `fills` / `strokes` / `vectorPaths` **必须一起读** —— 它常是 `fills[0].visible=false` + 彩色 `strokes` 可见,**只读 `fills` 会误判成\"Figma 默认灰残留\"而删掉,那会让该帧的绿框整体消失**(实证 2026-07-29 V4-2333 差点删掉一个 `Rectangle`)\n243\t- **翻页**:用底栏既有 `down` / `up`(▼▲)滚动长列表,面板不加滚动条\n244\t\n245\t**禁**:Unicode `▶`/`▼` 字符充当选中标记或展开标记(用矢量);面板浮在半空、与被编辑行无视觉归属;面板顶边切过另一行的文字中部。\n246\t\n247\t**实证(2026-07-29 V4-2333)**:上一轮只 clone 了面板本体、漏掉字段绿框,列表浮在半空看不出属于哪一行;同轮还出现面板顶边横切上一行值文本的切割痕。owner 指定 canonical 帧为默认范式后补齐(涉及的具体帧 id 见项目 spec §3 登记)。\n248\t\n249\t**与 §M32「库优先」的关系(重要,别反向纠错)**:M32 的取数优先级是给 web / SaaS 侧 UI 定的。**LCD 设备端 UI 走 file-local 组件集**(`LCD Button` / `Item/active`·`Item/normal` / `TouchScreen/Icon/*` 等),这是 M32 优先级第 2 条「库里没有 → file-local 组件集」的正常落点,不是违规。看到 LCD 帧里 `remote:false` 的按钮/图标 **不要**当成 M32 findings 去「改成库组件」。\n250\t\n251\t**Why**:LCD 是物理按键 + 小屏设备,操作者靠肌肉记忆跨页面操作;行高、控件列位置、展开标记形状、按键落点每页不同会直接造成误操作。设置页范式统一的收益远大于单页视觉最优。\n252\t\n253\t**Acceptance:**\n254\t- 新 LCD 设置页开建前,handoff / design-record 里写明「范式来源 = 该 surface 的 canonical 范式帧」(帧 id 见项目 repo 登记:`TVU Pack/docs/specs/lcd-canonical-spec.md` §3)+ 本轮实测取值\n255\t- 行高 / 控件列右对齐 / 下向三角展开标记 / 底栏 `OK`+`Home` 四项逐条可核(行高等取值以项目 spec §1 登记值为准,**贴实测数字**,目测不算通过)\n256\t- 底栏没有 `Back` 按钮;左上角有返回箭头\n257\t- 底栏每个按钮 `getMainComponentAsync().remote === false`(本文件 `LCD Button`),无远端库按钮混入;禁用态查到的是 `Status=Disabled` 而非 opacity\n258\t- 不可改态下 `OK` 与参数控件同步置灰\n259\t\n260\t**实证(2026-07-29 V4-2333 衍生轮)**:LCD 设置页 clone 了**最近做过的一个页**而非 canonical 范式帧,交付后 owner 走查一次性指出 7 项偏差(字体 / 行高偏大 / 圆圈 `›` 代替下向三角 / 底栏按钮 / 选中标记压字 / hint 样式 / 标题命名;被 clone 的帧 id 与逐项实测数字见 TVU Pack handoff)。根因是「照最近做过的页仿写」而不是「照 canonical 范式实测」,且**交付前跳过了 F1 design-walkthrough**(当轮把走查列成「可选待办」)。\n261\t\n262\t**字体注记**:LCD 产品帧既有文字为 Verdana,但 `use_figma` 环境 `listAvailableFontsAsync` 不返回 Verdana(同 Helvetica / Helvetica Neue / PingFang),**无法写入**。新建文字用 Roboto(DS 的 EN 字体、可移植),并在 handoff「已知偏差」显式记同帧字体族不一致,**禁止表述为「字体已统一」**。同理注释文字里勿用 `▶`(U+25B6,Roboto 无字形,渲染成豆腐块);`▼▲` 可用。\n263\t"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"94c79d50-57d2-4ac6-ae55-ec69e9ad77c8","timestamp":"2026-08-26T01:47:22.957Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/domain-tvu.md","content":"\n---\n\n## M12 — 外部/异步事件不得静默 no-op:检测 → 告知 → 给前进路径\n\n产品处于某一模式/状态时(测试中 / 录制中 / 推流中 / 监控中…),发生**用户未在当前 UI 主动触发的外部/异步事件**(信源插拔·格式变化 / 网络波动 / 电源 / 温度 / 存储;云推流侧同理:源流·推流目的地·配额·服务维护·会话掉线),**默认不允许静默 no-op**(画面无变化、无任何反馈)。必须三段式:\n\n1. **检测 Detect** — 识别到事件\n2. **告知 Notify** — 可见反馈:发生了什么 + 当前为何没自动变化\n3. **给前进路径 Path forward** — 能一键操作的优先给可操作提示,不要只留被动文案让用户自己找入口\n\n**反馈载体(交叉引用真源,勿在本规则复刻组件细节)**:反馈控件一律取库 variant 不自画(同源原则见 M52.3 / design-process §M49#3 Feedback UI Inventory;组件谱系见 figma-component-catalog `Message`·`Notification` 条)。两条硬约束:\n- **谱系隔离**:设备侧(LCD/Config-T)顶部通知走 **`Message` set**(status×size,**无按钮**;L=手动关 / M=自动消失;实证 v4-2335 / V4-2312);web/SaaS 侧走 **`Notification` set**(slide toast / alert / dialog)。**勿混用两套库。**\n- **需操作则升级组件**:`Message` 无按钮、只能被动告知;若前进路径需一键动作或用户决策(如“检测到视频输入 → [Stop Test 切到摄像头]”),须升级到带按钮的 `Notification`(alert / dialog / pop confirm)或 `Popup Box`。\n\n**默认须反馈,豁免须显式**:若 owner 判定某事件确不需反馈(如“无可用资源=既有逻辑、不新增态”),**必须就单写明 rationale**(与 F1 §5.7 D9“故意无须写 rationale”一致),不得默认静默略过。\n\n**Why**:外部事件静默 no-op → 用户把“无变化”误读为“操作失败 / 没接上”,在上镜等高压时刻反复排查、错失直播窗口。设备/服务本就该显式可控(不擅自切信源 / 推流以避免误播),但“不自动切”**必须配“明确告知 + 前进路径”**,否则可控性变成信息黑洞。\n\n**反例 — 2026-07-13 RPS One LCD Transmission Test(V4-2333 关联)**:测试信号运行中插入摄像头,设计为“静默不切、需先 Stop Test 才见视频”,插入时无任何提示 → 用户可能误判摄像头接入失败。根因:State-Completeness Enumeration 缺“状态 × 外部事件”维(本规则同步回流 design-process 枚举第 6 项 + M13 恢复态 + F1 §5.7 D9)。\n\n**Acceptance:**\n- 每个“进行中”模式,枚举其可能遭遇的外部/异步事件(参 design-process 枚举第 6 项),逐一确认有 检测→告知→前进路径,**或 owner 显式豁免 + rationale**,无静默 no-op\n- 反馈按谱系取对应库 variant(设备 `Message` / web `Notification`),需操作则用带按钮组件,不自画\n- 广播域安全默认成立:不擅自自动切换信源 / 推流\n\n---\n\n## M13 — 突发中断后必须有恢复态(reboot / 会话恢复)\n\n设备异常断电·崩溃·强制重启,或(云/web)会话掉线·服务中断后,重新可用时**不允许直接回到初始态、当无事发生**。必须有**恢复态**回答三问:① 刚才发生了什么(断电 / 崩溃 / 掉线)② 中断前的关键任务状态如何(上次在推流 / 录制 → 是否自动恢复、要不要手动重连)③ 数据 / 文件完整性(录制文件是否完整、存到哪)。\n\n**与 M12 的分工**:M12 管“事件发生时的实时告知”(设备仍在工作);M13 管“突发中断(事发时设备/页面可能根本没法告知)之后、恢复可用时的事后补偿告知”。二者互补。\n\n**Why**:突发中断时无法当场反馈(都断了),用户重新开机 / 重连后若一片茫然,无法判断刚才的直播 / 录制成没成——这是直播事故的次生伤害。\n\n**Acceptance:**\n- 每个“可被突发中断打断的进行中任务”(推流 / 录制 / 传输)定义 中断 → 恢复 的状态还原 + 完整性告知\n- 恢复态告知用对应谱系反馈组件(设备 `Message` / web `Notification`)\n- 不允许中断后静默回初始态;确无需恢复态者须写 rationale\n\n---\n\n## M17 — 新页面一律照该 surface 既有 canonical 范式(布局 + 控件几何 + 图标 + 按键行为)\n\n> **2026-08-05 泛化(owner 拍板)**:本条原标题为「**LCD 设置页**一律照既有设置页 canonical 范式」,scope 写死在 LCD 一端。实证表明**同一条病灶在另一个 surface(Config-T web 端)整轮复现、且连续多轮走查都没抓到** —— 根因不是缺规则,而是**规则的 surface 覆盖不对称**:LCD 有本条、另一端没有对应条文,于是同一个 feature 的两端一边合规、一边完全没对齐宿主页面。现泛化为**所有 surface 通则**。\n>\n> **边界(owner 明确)**:各 surface 的 canonical 帧 id、控件宽度 / 间距 / 对齐的**具体取值**,以及某个产品的表单布局与按钮布局规格,**都属项目资料,不进本真源** —— 由各产品在自己 repo 的 handoff / design spec 维护。本条只管**做法**(先 probe 宿主范式再建)与**核查项类别**。\n>\n> **2026-08-06 补齐(`CANONICAL-F103` 搬迁)**:本条原先在下方 §M17.1 保留了两张 LCD 规格表(行高 / 面板尺寸 / 帧 id / file-local 组件 key),按 §M-DISCIPLINE.SOURCE 三问②属取值 ⇒ **已搬至 `TVU Pack/docs/specs/lcd-canonical-spec.md`**,本真源只留做法与核查项类别。原「LCD 范式属 TVU 设备通用交互范式故保留规格表」的说法作废 —— 通用的是**交互语义**(下方注记),不是像素取值。\n\n**通则**:在既有产品里新增任何页面 / tab / 面板,起手先打开**该 surface 自己的 canonical 范式帧**实测取值,再照它建;**禁止照最近一次做过的某个页凭印象仿写**(范本可能本身就是 pre-规则的,见 §M23.16 规则优先于范本),**也禁止拿另一个产品的参考图代替宿主产品的范式** —— 参考图定的是「要哪些参数 / 什么信息架构」,宿主范式定的是「控件多宽、在哪对齐」,**两者不可互相替代**。这是本条泛化的直接动因:只 probe 前者时,参数集是对的、几何全错,且因为「我确实按用户给的参考做了」而自我感觉合规。\n\n**Acceptance(通则层,不含具体取值)**:\n\n- [ ] 新页面开建前,**项目 repo** 的 handoff / design-record 写明「宿主范式来源 = <文件 + 帧 id>」+ 本轮实测取值表\n- [ ] 几何一致性至少核到这几类:**同类控件是否同宽** · **同一控件在各状态帧之间是否同宽** · **动作按钮右缘是否对齐控件右缘** · 行高与分隔线间距\n- [ ] 上述核查**贴实测数字**,目测不算通过(见 [`mockup-conventions.md` §M-DISCIPLINE.SCOPE 硬约束 6](./mockup-conventions.md))\n- [ ] 按钮宽度按文字 hug + 统一 padding,**不为「看起来一样宽」写死宽度或改字体** —— 跨字体族字宽差异不构成偏差(见本节字体注记)\n\n**LCD surface 注记(做法层;取值见项目 repo)**\n\nLCD 设置页的**逐层实测规格表**(底色 / 导航条 / 内容容器 / 行高 / 行内控件对齐 / 各类值控件 / 底栏按钮尺寸与 file-local 组件 key)**不在本真源**,在 **`TVU Pack/docs/specs/lcd-canonical-spec.md` §1**(含 canonical 范式帧登记)。开建前照 M17 通则打开该帧实测,勿信任何文档里的过期值。\n\n本真源只留跨页成立的**做法与语义**:\n\n- **双背景色**:页 / 导航 / 底栏一色,内容区另一色 —— 两色具体取值见项目 spec\n- **底栏三按钮语义(owner 2026-07-29 拍板,适用 LCD 后续所有需求)**\n - `OK` = 提交本页改动并返回(**LCD 侧的提交动词就是 `OK`**,不是 `Save` / `Apply` / `Update`;`Update` 是 Config-T web 侧的词)\n - **「返回上一级」= 左上角返回箭头**,底栏**不再放 `Back` 按钮**(旧 canonical 帧底栏里的 `Back` 是旧做法,勿照抄)\n - `Home` = 回待机首页\n - 页面处于「不可改」态(如测试运行中)时,**参数控件与 `OK` 一起置灰**,`Home` 保持可用\n- **底栏按钮谱系**:一律用该文件的 file-local `LCD Button` component set;**禁从别的页 clone 远端库的 `OK`/`Back` 组件** —— LCD 底栏按钮与 web 侧按钮不同谱系。禁用态用 `Status=Disabled` **真变体**,不用 opacity 凑\n- **展开标记**:枚举下钻行用**下向三角 vector**,**不是**右尖括号 `›`、不是圆圈按钮、不是 Unicode 字符\n- **超长 label**:降字号走双行,不截断、不挤压右侧控件列\n\n### M17.1 — 枚举值选择一律用 LCD 选项列表 canonical 范式\n\n设置行要从枚举里选一个值时,**不新造下拉/弹窗**,一律照该 surface 的 canonical 选项列表参考帧建。**面板 / 行 / 选中标记 / 被编辑字段框的逐项实测规格与参考帧 id 见 `TVU Pack/docs/specs/lcd-canonical-spec.md` §2**;本条只留做法:\n\n- **面板高度按内容行数 × 行高算,不照抄 canonical 帧的高度** —— canonical 的高度只反映它那份内容的行数;**上限 = 物理边界**(底缘不压底栏、不出内容区),装不下的行靠 `▼▲` 翻页。详见 [`mockup-conventions.md` §M-INTEGRITY §I7](./mockup-conventions.md)(含\"关键档位必须进首屏\"的例外条件与授权记录要求)\n- **面板落位**:**右对齐被编辑行的右边缘**、**顶边与内容区顶端齐**,使被编辑行与面板的绿描边连成一条连续轮廓\n- **被编辑字段行本身要加框**,表示「列表属于这一行」—— 只 clone 面板、漏掉字段框,列表会浮在半空看不出归属\n- **选中标记用矢量三角**(marker 在前、文字让位),当前值行文字走强调色\n- ⚠️ **连体绿框的实现**:canonical 实测**不是靠遮挡自然形成的,是一个手画阶梯形 VECTOR**(描边被 outline 成填充;**canonical 面板自身的 stroke 反而是 `visible:false`**)。沿用此手法时:① 改面板尺寸必须**同步改这个 VECTOR 的几何**([§I7](./mockup-conventions.md) 第 ③ 项);② probe 它时 `fills` / `strokes` / `vectorPaths` **必须一起读** —— 它常是 `fills[0].visible=false` + 彩色 `strokes` 可见,**只读 `fills` 会误判成\"Figma 默认灰残留\"而删掉,那会让该帧的绿框整体消失**(实证 2026-07-29 V4-2333 差点删掉一个 `Rectangle`)\n- **翻页**:用底栏既有 `down` / `up`(▼▲)滚动长列表,面板不加滚动条\n\n**禁**:Unicode `▶`/`▼` 字符充当选中标记或展开标记(用矢量);面板浮在半空、与被编辑行无视觉归属;面板顶边切过另一行的文字中部。\n\n**实证(2026-07-29 V4-2333)**:上一轮只 clone 了面板本体、漏掉字段绿框,列表浮在半空看不出属于哪一行;同轮还出现面板顶边横切上一行值文本的切割痕。owner 指定 canonical 帧为默认范式后补齐(涉及的具体帧 id 见项目 spec §3 登记)。\n\n**与 §M32「库优先」的关系(重要,别反向纠错)**:M32 的取数优先级是给 web / SaaS 侧 UI 定的。**LCD 设备端 UI 走 file-local 组件集**(`LCD Button` / `Item/active`·`Item/normal` / `TouchScreen/Icon/*` 等),这是 M32 优先级第 2 条「库里没有 → file-local 组件集」的正常落点,不是违规。看到 LCD 帧里 `remote:false` 的按钮/图标 **不要**当成 M32 findings 去「改成库组件」。\n\n**Why**:LCD 是物理按键 + 小屏设备,操作者靠肌肉记忆跨页面操作;行高、控件列位置、展开标记形状、按键落点每页不同会直接造成误操作。设置页范式统一的收益远大于单页视觉最优。\n\n**Acceptance:**\n- 新 LCD 设置页开建前,handoff / design-record 里写明「范式来源 = 该 surface 的 canonical 范式帧」(帧 id 见项目 repo 登记:`TVU Pack/docs/specs/lcd-canonical-spec.md` §3)+ 本轮实测取值\n- 行高 / 控件列右对齐 / 下向三角展开标记 / 底栏 `OK`+`Home` 四项逐条可核(行高等取值以项目 spec §1 登记值为准,**贴实测数字**,目测不算通过)\n- 底栏没有 `Back` 按钮;左上角有返回箭头\n- 底栏每个按钮 `getMainComponentAsync().remote === false`(本文件 `LCD Button`),无远端库按钮混入;禁用态查到的是 `Status=Disabled` 而非 opacity\n- 不可改态下 `OK` 与参数控件同步置灰\n\n**实证(2026-07-29 V4-2333 衍生轮)**:LCD 设置页 clone 了**最近做过的一个页**而非 canonical 范式帧,交付后 owner 走查一次性指出 7 项偏差(字体 / 行高偏大 / 圆圈 `›` 代替下向三角 / 底栏按钮 / 选中标记压字 / hint 样式 / 标题命名;被 clone 的帧 id 与逐项实测数字见 TVU Pack handoff)。根因是「照最近做过的页仿写」而不是「照 canonical 范式实测」,且**交付前跳过了 F1 design-walkthrough**(当轮把走查列成「可选待办」)。\n\n**字体注记**:LCD 产品帧既有文字为 Verdana,但 `use_figma` 环境 `listAvailableFontsAsync` 不返回 Verdana(同 Helvetica / Helvetica Neue / PingFang),**无法写入**。新建文字用 Roboto(DS 的 EN 字体、可移植),并在 handoff「已知偏差」显式记同帧字体族不一致,**禁止表述为「字体已统一」**。同理注释文字里勿用 `▶`(U+25B6,Roboto 无字形,渲染成豆腐块);`▼▲` 可用。\n","numLines":106,"startLine":158,"totalLines":263}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"cd5aabd8-9115-4cf5-a4fc-7a6a3a803405","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":150,"estimated_tokens_delta":100,"uuid":"aa313e7d-5b25-4bf1-a739-3ad7510f907b","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWxDN3RbBxK32HJVSWf","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISzAQKpgEIERgCKkAx1YhDGH41LhU8IXdighv5k+NsW+T1q7oCSTraJVbTkoXfWfvYOciu/lSMaw/lRILHQpbdKEykcwN8/WRssYGzMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAbCLudQGsAECEgwDgBAF6BeUeJHQ4DcaDEtE4shsr8uDr9NeWSIw7A/3mgUBFRycNwDn2cZxUTP8ysOTsIUrogoSRdTC3Y6j9p8Pmemj50xguqPiZC9EKtICIxJT7Ny1G1kzM+vydmp3ovWBuqTn6Y+GpKhxrurQE8tFI3ABddO90PSOQxSqEnKhOmRNJuwzxYkT8KzKHpdqKlek4Yz8uLwLD4aroxV1aEbcz6IY9/Qer2TZtCV6lLwJn3tCAGVyVEmUTROuSKWbkFDei/81Sa4bUIznGvMp1KA+ODSfeg2DNjrgLsK2s/5guPtVkydPsfqqMiI8beFXKHFPOuHYDp9mxOxJVCbWHrNTqJGMkSXCtFRezzhg3GP3WbPO7a7PUK2GlJq6sV+tdt/Ai2q72iD1OWqfNW4yaINEqIBhWHPtEh3LifMpyr5Ealr+7QfR6cW/Y+ItjLlr8cHn8efcTyhSnRZrfCvvkxIIsA710M08n8vPcRWl5Sfr+A6QboPxKW6tKeTegvIPTiVEeRa6iajhzy1APYbCt1NLwIo79wJU0L0r/ChYlOy8OQQYAQ=="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":6496,"cache_read_input_tokens":238428,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":6496},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"53f6ea69-1e47-461e-80aa-0b94f50443f9","timestamp":"2026-08-26T01:47:28.577Z","request_id":"req_011CeQWx7xrSfhrGaq6fBDmq"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWxDN3RbBxK32HJVSWf","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01BPRoHTboKpr53UcZ7StBw9","name":"Read","input":{"file_path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/domain-tvu.md","offset":134,"limit":26},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":6496,"cache_read_input_tokens":238428,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":6496},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"7f28f001-81da-4aba-8d6e-0113e7b2f2a1","timestamp":"2026-08-26T01:47:30.485Z","request_id":"req_011CeQWx7xrSfhrGaq6fBDmq"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01BPRoHTboKpr53UcZ7StBw9","type":"tool_result","content":"134\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。\n151\t\n152\t**反例**(2026-05-26 Video Sync Phase B walkthrough):Design Rules card 原 trend rule 仅描述 icon 阈值 `±2 ms`,漏数值颜色映射(mockup 中 84ms↓ 已用绿、320ms↑ 已用橙红,但规则未文档化)→ audit 时补。\n153\t\n154\t**Acceptance:**\n155\t- Trend rule 文档必含三层信号映射表(icon + 数值色 + token)\n156\t- Mockup 中相同 trend 状态视觉一致(不同帧不允许颜色不一)\n157\t- 颜色必绑 TVU Variable,不写 raw hex(与 M-COLOR C1 / 原则 4 一致)\n158\t\n159\t---"}]},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"728cb370-79ac-4bba-ad66-a2748011fe7e","timestamp":"2026-08-26T01:47:30.487Z","tool_use_result":{"type":"text","file":{"filePath":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs/internal/domain-tvu.md","content":"---\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。\n\n**反例**(2026-05-26 Video Sync Phase B walkthrough):Design Rules card 原 trend rule 仅描述 icon 阈值 `±2 ms`,漏数值颜色映射(mockup 中 84ms↓ 已用绿、320ms↑ 已用橙红,但规则未文档化)→ audit 时补。\n\n**Acceptance:**\n- Trend rule 文档必含三层信号映射表(icon + 数值色 + token)\n- Mockup 中相同 trend 状态视觉一致(不同帧不允许颜色不一)\n- 颜色必绑 TVU Variable,不写 raw hex(与 M-COLOR C1 / 原则 4 一致)\n\n---","numLines":26,"startLine":134,"totalLines":263}}} {"type":"system","subtype":"thinking_tokens","estimated_tokens":50,"estimated_tokens_delta":50,"uuid":"faa5675e-a0f8-495a-be52-543be5ff5328","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":100,"estimated_tokens_delta":50,"uuid":"617e0e82-4748-425e-8171-6becc7affbe1","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":200,"estimated_tokens_delta":100,"uuid":"4860719a-a6b1-4d9a-80e9-86a0826804c1","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":350,"estimated_tokens_delta":150,"uuid":"53e7f71f-34ea-44f9-9d18-ef63e2ec2778","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":450,"estimated_tokens_delta":100,"uuid":"2e4a7fff-968d-478b-95dd-a590bd890fd0","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":550,"estimated_tokens_delta":100,"uuid":"a600e584-2d8c-4ce1-b6e4-7843e01e6342","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":650,"estimated_tokens_delta":100,"uuid":"f95c510d-37d6-4a9a-b970-55972ab48857","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"system","subtype":"thinking_tokens","estimated_tokens":750,"estimated_tokens_delta":100,"uuid":"bcd09713-cc4c-4e83-8ad9-818eaf689cbc","session_id":"9d9a4203-766d-4177-a3db-def00914db27"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWxmmhGMMDGw74CVZp6","type":"message","role":"assistant","content":[{"type":"thinking","thinking":"","signature":"CAISlxMKpgEIERgCKkCwVkEC113C4r7TcGHUPCVou6F+wEsKBCwdXvlGUvvNLAj7DayVa+veP8eSZJ/QIskkFFmVo+Kd5zxKwemWGxAnMg1jbGF1ZGUtb3B1cy01OAFCCHRoaW5raW5nWiRjODEyM2U4YS04YWI1LTRjMTAtOTI0NS03NzE5NWYwMDFmNWNyEBfgeyIqdf44HDNid5nifo2IAQGoAcGLudQGsAECEgzO9dEtja89m6gTfw4aDA9k+eoSwt5UhP1/9SIwz162nLlgAeSPGE2OXATNOdIln05HKr7MrDe5WrE+m/WoA2udY+JlTj2hEc1sw4ljKp0RtV5g77mYn00A4a9xCuEv6ojIMncKxmRNdrujcZnVdRdJycx5lH69nrwcSBVjfIacPgeSfTauC7fn3BppJA2l0XNle/dCK3RAGOKWqco0FX34DTLWdoJt/czaGoGItZ5lZjZ1Yr+h8qmRul0o4R5hCbBJ7Q90rr5O315c2kLFmLqDmTApQfkBpBMRV9HcIRm4dzZHOdUW6DiJ4aSX8O7FkcuZC2RnQvRUEgDCg3yL/38o2L0scKtjTDlHVqRqXhViesaZfA2qXA7f2RoTloaBBLVru7jV253d50w2aVWjYZ7ZIyQcFsmcpHgvMs288zUg+J4MPSCiiu2DJsErIu9fv/p2zAsF1ZmSleFUksqBq5nvLwaQwukGHbvBzeCu2XkqG0ql2oYeGbpxAj+wEtZxSDomAXVgQQj1KCsHHFZI9ZMAMMze5biVNwS3QII05Mt04nNQPFv0cPGKdY6d92Of5ygjt2uU50kRTRByboBIs4eNORxPsoaLsOSFd0QxszTfncVpy7PNAVOodiKd6sDQ/+TdirQmjXAagbYaOIQWKt+M2tsxSHJiflIDbDDZ/tE4JADehbWDix0D9K57BY6nnxHuuSNi843Rsn+YGMUM7/KP9djQl/5KtdgdsGMhJPQV3gtvjFYIs3Y01C+jlPy8pMYMmWXjUs4dinC7+QswyYY02RIxutMl+wuew0N6JA9Bj6TbaGFCFjhDwOrnkdzLcrpaM739+DcvG0gP0+HvYgPkMcIAuD5xC3XQt4VMLt9DQbSlqcVYU+Pl2Ggp1lv1B9YjIwEcHSVLaN4q3ji6maVZ9fZ7HGevtvYYdqbAGND6E6sEj85p5jhAo+4oGDyqeXLFFvnziEM97cDfxg1l9EPhz2qubPIiBeBFVnErAXexrGicbR0MXtS/t62ECWLMq/bKVqxbpWT3GZyCb7yOAkz6Gz8u3FGg+tySCmM6NgF4o8LQFRKF35Knw14ltj8eIAW1KpKOekdpmM/5FVjHBwIx4QyAjinnhZUkpWbEKPZIIsvlzkkR0id002el9OEZAy0fvNHqp0J/2lvoxSGNZoKj/blFY1y9296Ipj+50oMwx+LJw9vLiQX/0pzEojbuRteqsliZyX/S7ampz9IgnQC7o16hGdJVjdqkgmU73ZSG+DKguaheV3Zr4nGMAxSxg03hy1C/9RVbR/sjRF1QoYGB4C3QetskmL8whLcMZjl1zP1EEcoyuPh1/RO3o+5fHA+81gGNkRqdGEUuWLOeB0UFwJJE92d/QZcHwe+lqsrKg9jNDNNZfROe8O4Ze6cRV6WBKfMf+9wy4rUFlkls/V70k4Q8u2ceXCgC469UYcvq9RpvSEnxY12Y8mzei2Oe6fbG3oH/gg4+HU8wkba84E4e8KMDgMKRl3tSjVvN6LEkwU8Beysih869ROv0Z2D+DvuYJj2pg1zZsWAxNhkg0RR8brIA4kwzlp+nYTCyDhWPAr5y2wmlfTl5tQ/2EU7b+IASF6fZ8VsmD1Cit2ltCPhET31CmlaXZvg4FkMWq/k4DovyOr0ryBLmLpeZ1HCKaDKAU+ZUeiifP4pe+0IPm56CQXXmSOD4RpAP78FqW1LRGklOIICtNd2B0F7i2rCLMf04c586Wj+cJ1C+fasodFVnUZTyq3QLACD5E5AzGEvoa2x4eEa5M/+V/IjvL3CZ9Z8VE9iartbXfoCAhDuzKjLIe1fxs6Auwlq3iXuyn/+mSarXvBbnKdtOjjmO1TyaqLBg+f2diIapU68cFUYMj6xsnjEHxfOMgzgmYKm0iXL822sC0AYE3tm0pEPE5RjJPPP8wLOkUWz4ZcqqtPSxjjuxDEItPjZaBYZbw/80ZgLcRjgV73MMJ0awuqxHFb86gt9HYORGQ6O98F4DBwvsRYrbmTd4yjCFI/lCBKV8a1YzbAQmpDg+apeXWmt+Ze3Ig4AW8ulRQEuVzmomV7N8TRGag3wL+8ZtAFJ9O3CmvbLPnetFqcL8423OGgykuhKP4bR7PM2FtZCF9VVYaXSUnh19ZSYm/AeIytOxdkJ6oqF0w7U2NkHsjxJgl4/9Iu++htQbqbq3Lq3x/ALttwC+CLKpjBRlDTfQeTKw/d+kKgVJm3I0MFA0b4w7agmUnaGa2cmCACEQSyGdgcmrZNIxkSimojHeLOtjlOUk6zyyAMNVZtmzc6sF27zomnnZyLy+2EiLbQ/HjoJmLZPtbjCP8eMRV6F4ZbWObBkzGOAAtvoh/YRHDaYxNv9ef11493o2Cycvbw8XM7g52Cobh+mIEBzK4CGPUo1Z+jL1yli/Y/sGWxoEkr816U9q8eTBXDrwe4Hize9jIpUuABejdqAn73UBJWzLlDGwOKL4fN1PZtBvihCuRY8F7Wnr5EF9FsvQaJD2JBw3OOUs0bK/HR7ox1YnjAUrUJ07UygwpW4OOXpyZB3/PednKsmYcDueqscobU8ELlnBDcZhe9kcywCPKgOKnp6W2006RYbcqzibv28KNBRwckP8pR2tXsSzaRrjo0dMR1AHFcS7YNrgL1WYUWH/DzADizJdHk6lgJ4XwiC2vzfS6xUZK8+ZPetAB/GkwPp8kPHZ7jwDYX+EivJZPxFCYBnVOAiR1mMWnxqYpnsaO59YdqE0QEMnFmGe4eupprhRPB5HvSptELjyySh3NBx4cLhUeAuViyf49FBUYEJegNsMZaGyJ0s4bJoZd15fU7M9yiDx2epp6zr4dUQxqtu0TIuMAPVbmtH7mWL4K/v+DXlWAPr1MWrUSU6STr2rO+YzYTdFWD2mI7eBI8qrDLow8u4HfXKH19TBqozVT1zG9c9cHGOp2G2wEAD1mOkviszErFsoWhEbRsVo7cNG+U377/DUk4KkaK3b8fohV9kigz7jtJaRlhrdKiSVBl+XJ3/abSJEk4as7oSkvXLBlOdpfXyuE0Z0M0TCYryvGAE="}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1141,"cache_read_input_tokens":244924,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1141},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"aee9d70c-7882-49de-a024-389432773b4a","timestamp":"2026-08-26T01:47:45.888Z","request_id":"req_011CeQWxgkKVKhzoffWxUrMY"} {"type":"assistant","message":{"model":"claude-opus-5","id":"msg_011CeQWxmmhGMMDGw74CVZp6","type":"message","role":"assistant","content":[{"type":"tool_use","id":"toolu_01Mt2uKdBzYy3jxptcaFDdJj","name":"Grep","input":{"pattern":"Usage Service|SaaS Dashboard|cost per|Cost per|margin","path":"/Users/nancy/.ai-ds-lab/pins/tvu-ds-4a68e02d/docs","output_mode":"content","-n":true,"head_limit":40},"caller":{"type":"direct"}}],"stop_reason":null,"stop_sequence":null,"stop_details":null,"usage":{"input_tokens":2,"cache_creation_input_tokens":1141,"cache_read_input_tokens":244924,"cache_creation":{"ephemeral_5m_input_tokens":0,"ephemeral_1h_input_tokens":1141},"output_tokens":2,"service_tier":"standard","inference_geo":"not_available"},"diagnostics":null,"context_management":null},"parent_tool_use_id":null,"session_id":"9d9a4203-766d-4177-a3db-def00914db27","uuid":"628483ce-5bfc-499f-ad71-979b9daab05d","timestamp":"2026-08-26T01:47:46.871Z","request_id":"req_011CeQWxgkKVKhzoffWxUrMY"} {"type":"user","message":{"role":"user","content":[{"tool_use_id":"toolu_01Mt2uKdBzYy3jxptcaFDdJj","type":"tool_result","content":"docs/figma-conformance-first.md:109:`html / body / #app` 的默认 margin 必须在入口层清零。\ndocs/docs-site-dx-parity-spec.md:236:

      enabled = {{ enabled }}

      \ndocs/conformance-issue-log.md:1393: - 实际根因是入口 HTML 没有清掉浏览器默认 `body` margin\ndocs/conformance-issue-log.md:1396: - `html, body, #app { margin: 0; min-height: 100%; background: ... }`\ndocs/_archive/superpowers/plans/2026-07-23-ds-rule-consumption-L5-enforcement.md:17:[Omitted long matching line]\ndocs/_archive/superpowers/plans/2026-07-03-infra-f45-slot-boolean-demo-enforcement.md:355: