# Phase 03: Legacy Visual Alignment Pass - Context

**Gathered:** 2026-04-07
**Status:** Ready for planning

<domain>
## Phase Boundary

本阶段仅做视觉对齐：将 workspace 的排版、间距、层级与旧版视觉基线对齐。
不改变已在 Phase 2 固化的线程与 skills 逻辑行为。

</domain>

<decisions>
## Implementation Decisions

### 视觉优先，不改行为
- **D-01:** 仅调整样式与展示层结构，禁止引入新的业务逻辑分支。

### 变更粒度
- **D-02:** 优先在 layout/component/style 层做最小改动，减少对 core 逻辑文件的触碰。

### 回归原则
- **D-03:** 视觉对齐必须保证 chat/thread/artifact 交互不回归（对应 UI-02）。

### Claude's Discretion
- 可自行选择分层改造顺序（全局样式 -> 页面骨架 -> 组件细节），前提是每步可验证且可回退。

</decisions>

<canonical_refs>
## Canonical References

### 里程碑与需求
- `.planning/ROADMAP.md` — Phase 3 目标（UI-01, UI-02, UI-03）
- `.planning/REQUIREMENTS.md` — 视觉一致性与交互不回归要求
- `.planning/PROJECT.md` — 项目核心原则（旧视觉 + 新逻辑）

### 上游阶段输出
- `.planning/phases/02-thread-and-skills-logic-reconciliation/02-SUMMARY.md` — 已固定的逻辑边界与回归关注点
- `.planning/phases/02-thread-and-skills-logic-reconciliation/02-UAT.md` — 已验证通过的用户行为清单

### 关键实现入口
- `frontend/src/components/workspace/` — 工作区核心视觉组件
- `frontend/src/app/workspace/chats/[thread_id]/page.tsx` — 聊天页面骨架入口
- `frontend/src/styles` 或对应全局样式入口（按仓库实际）

</canonical_refs>

<code_context>
## Existing Code Insights

### Reusable Assets
- 已有 chat/thread 流程在 Phase 2 已通过 UAT，可作为行为回归基线。

### Established Patterns
- 行为逻辑集中在 `core/*`，视觉改造应优先停留在组件与样式层。

### Integration Points
- 页面布局层影响全局观感。
- 组件样式层影响局部一致性。
- E2E 场景用于确认视觉改造未破坏关键交互。

</code_context>

<specifics>
## Specific Ideas

- 先对齐 typography/spacing/component hierarchy，再逐步统一 workspace 关键页面样式语义。

</specifics>

<deferred>
## Deferred Ideas

- 设计系统重构、主题体系重建、与恢复目标无关的视觉创新均延后。

</deferred>

---
*Phase: 03-legacy-visual-alignment-pass*
*Context gathered: 2026-04-07*
