From b4fe531a0c0b2e45032ee1229f60e32eb83ff868 Mon Sep 17 00:00:00 2001
From: MT-Mint <798521692@qq.com>
Date: Wed, 15 Apr 2026 10:09:20 +0800
Subject: [PATCH] docs(06): UI design contract

---
 .planning/phases/06-/06-UI-SPEC.md | 15 +++++++++++----
 1 file changed, 11 insertions(+), 4 deletions(-)

diff --git a/.planning/phases/06-/06-UI-SPEC.md b/.planning/phases/06-/06-UI-SPEC.md
index 56fdc23d..1ce1914b 100644
--- a/.planning/phases/06-/06-UI-SPEC.md
+++ b/.planning/phases/06-/06-UI-SPEC.md
@@ -1,10 +1,11 @@
 ---
 phase: 06
 slug: at-file-reference
-status: draft
+status: approved
 shadcn_initialized: true
 preset: new-york
 created: 2026-04-15
+reviewed_at: 2026-04-15T10:08:50+08:00
 ---
 
 # Phase 06 — UI Design Contract
@@ -69,6 +70,15 @@ Accent reserved for: `@` 触发后候选高亮行、已选引用 chip 背景、
 
 ---
 
+## Visual Anchors & Hierarchy
+
+1) 主焦点：`@` 候选 dropdown 的高亮首项（默认聚焦项，承担“下一步可执行动作”视觉引导）。  
+2) 次焦点：输入框内已选 chip 列表（持续反馈当前引用上下文）。  
+3) 第三层：辅助提示（引用上限提示、软失败 toast）。  
+4) 交互可达性补充：chip `×` 必须提供文字 fallback（`tooltip` 或 `aria-label="移除引用"`）。
+
+---
+
 ## Copywriting Contract
 
 | Element | Copy |
@@ -91,9 +101,6 @@ Accent reserved for: `@` 触发后候选高亮行、已选引用 chip 背景、
 | Registry | Blocks Used | Safety Gate |
 |----------|-------------|-------------|
 | shadcn official | `dropdown-menu`, `badge`, `button`, `tooltip`（沿用已安装） | not required |
-| `@ai-elements` | none（本 phase 未声明新增 block） | not in scope — no third-party block declared — 2026-04-15 |
-| `@magicui` | none（本 phase 未声明新增 block） | not in scope — no third-party block declared — 2026-04-15 |
-| `@react-bits` | none（本 phase 未声明新增 block） | not in scope — no third-party block declared — 2026-04-15 |
 
 ---