qzl
87 lines
3.2 KiB
Markdown
87 lines
3.2 KiB
Markdown
# 账户页与主页工具渲染统一表面语言 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
|