# 账户页与主页工具渲染统一表面语言 Implementation Plan

> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.

**Goal:** 统一 `我的账户` 页面与主页 `ui_schema` 渲染的视觉语言，修正 STEP 协议映射并将等待文案从“正在思考”切换为协议阶段语义。

**Architecture:** 设置域继续复用 `AccountSurfaceScaffold + AccountSectionCard`；聊天域在 `UiSchemaRenderer` 中重做 surface 层级与按钮/徽章/KV 呈现，保持协议字段不变。将 stage 映射改为 `router/worker` 协议值，在 UI 显示为“意图识别中/任务执行中/任务处理中”。

**Tech Stack:** Flutter, flutter_bloc, design tokens (`AppColors/AppSpacing/AppRadius`), AG-UI SSE protocol mapping

---

### Task 1: 先补失败测试（Stage 文案与 UI Schema 呈现）

**Files:**
- Create: `apps/test/features/chat/presentation/agent_stage_mapping_test.dart`
- Modify: `apps/test/features/chat/ui_schema_renderer_test.dart`

**Step 1: 写失败测试**
- 新增 stage 映射测试，断言 `router -> intentLabel`、`worker -> executionLabel`、未知 -> processingLabel
- 扩展 `ui_schema_renderer_test.dart`，断言 card surface、按钮文案、badge 仍可渲染

**Step 2: 跑测试确认失败**

Run: `flutter test test/features/chat/presentation/agent_stage_mapping_test.dart test/features/chat/ui_schema_renderer_test.dart`
Expected: FAIL（映射函数/新视觉结构尚未实现）

**Step 3: 最小实现使测试通过**
- 新增 stage 映射文件并接入 chat/home
- 重构 `UiSchemaRenderer` 的 surface 风格并保持现有 schema 兼容

**Step 4: 再跑测试确认通过**

Run: `flutter test test/features/chat/presentation/agent_stage_mapping_test.dart test/features/chat/ui_schema_renderer_test.dart`
Expected: PASS

### Task 2: 重构我的账户页面为统一表面语言

**Files:**
- Modify: `apps/lib/features/settings/ui/screens/account_screen.dart`

**Step 1: 写失败测试（轻量）**
- 可选新增页面结构测试，断言标题/分组/退出按钮存在

**Step 2: 运行测试确认失败（若新增测试）**

Run: `flutter test test/features/settings/ui/screens/...`
Expected: FAIL

**Step 3: 最小实现**
- 用 `AccountSurfaceScaffold` 承载页面
- 用 `AccountSectionCard` 承载账户菜单与安全操作分组
- 退出登录按钮改为统一 token 风格

**Step 4: 测试通过**

Run: `flutter test test/features/settings/ui/screens/...`
Expected: PASS

### Task 3: 协议对齐与主页等待文案修正

**Files:**
- Modify: `apps/lib/features/chat/presentation/bloc/chat_bloc.dart`
- Modify: `apps/lib/features/home/ui/screens/home_screen.dart`
- Create: `apps/lib/features/chat/presentation/bloc/agent_stage.dart`

**Step 1: 保持协议语义**
- 将 step 映射改为文档约定：`router`、`worker`
- 显示文案：`意图识别中`、`任务执行中`、`任务处理中`

**Step 2: 运行相关测试**

Run: `flutter test test/features/chat/presentation/agent_stage_mapping_test.dart test/features/home/ui/widgets/home_screen_layout_test.dart`
Expected: PASS

### Task 4: 全量验证

**Step 1: 静态检查**

Run: `flutter analyze`
Expected: 无新增错误

**Step 2: 回归测试**

Run: `flutter test`
Expected: PASS