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 | ---