From 6fdbc345264f27d45ac62c03b89bd9af2a500d4f Mon Sep 17 00:00:00 2001
From: qzl <qzl@example.com>
Date: Mon, 2 Mar 2026 16:49:45 +0800
Subject: [PATCH] docs(backlog): update TRIGGER-001 and TOKEN-001 status to
 resolved

---
 docs/bugs/backlog.md | 64 ++++++++++++++++++++++++++++----------------
 1 file changed, 41 insertions(+), 23 deletions(-)

diff --git a/docs/bugs/backlog.md b/docs/bugs/backlog.md
index 9c669dd..21400b3 100644
--- a/docs/bugs/backlog.md
+++ b/docs/bugs/backlog.md
@@ -4,9 +4,10 @@
 
 ### [TRIGGER-001] user_agents 自动创建
 
-**Status**: Pending  
+**Status**: ✅ Resolved  
 **Priority**: Medium  
-**Created**: 2026-02-27
+**Created**: 2026-02-27  
+**Resolved**: 2026-03-02
 
 **Description**:
 当新用户注册时，`user_agents` 表未自动创建默认 Agent 配置记录。
@@ -22,15 +23,25 @@
 - 用户首次使用 Agent Chat 功能时可能失败
 - 需要应用层手动初始化或前端引导配置
 
-**Implementation Notes**:
-- 需要先确定 `user_agents` 的默认配置设计
-- 可通过 `on_auth_user_created` trigger 扩展
-- 或在 `profiles` trigger 中调用
+**Solution**:
+1. 创建 `user_agent_catalog.yaml` 配置文件定义 3 种 agent 类型
+2. 创建 `user_agent_catalog` 表存储配置（持久化）
+3. 修改 `user_agents` 表唯一约束：`user_id` → `(user_id, agent_type)` 允许每个用户有多个 agents
+4. 扩展 `create_profile_for_new_user()` trigger 从 catalog 批量插入 user_agents
+5. 实现配置动态更新：修改 YAML → 重启应用 → 自动同步到数据库
+6. 为已存在用户补充 user_agents 记录
+
+**Verification**:
+- ✅ 新用户注册自动创建 3 个 agents
+- ✅ Catalog 表已填充（INTENT_RECOGNITION, TASK_EXECUTION, RESULT_REPORTING）
+- ✅ 已为 1 个存在用户补充 3 个 agents
+- ✅ Backend tests: 247 passed
 
 **Related Files**:
-- `backend/alembic/versions/20260226_0001_initial_schema.py` (现有 trigger)
-- `backend/src/models/user_agents.py`
-- `backend/src/models/profile.py`
+- `backend/src/core/config/static/database/user_agent_catalog.yaml`
+- `backend/src/models/user_agent_catalog.py`
+- `backend/alembic/versions/50ae013ce530_add_user_agent_catalog.py`
+- `backend/src/core/config/initial/init_data.py`
 
 ---
 
@@ -38,22 +49,17 @@
 
 ### [TOKEN-001] 大量硬编码颜色违反 AGENTS.md 规则
 
-**Status**: Pending  
+**Status**: ✅ Resolved (Partial)  
 **Priority**: Medium  
-**Created**: 2026-03-02
+**Created**: 2026-03-02  
+**Resolved**: 2026-03-02
 
 **Description**:
 `apps/AGENTS.md` 规则要求禁止硬编码颜色，必须使用 `design_tokens.dart` 中的 `AppColors`。但实际代码中存在大量硬编码。
 
 **Current Behavior**:
 - `apps/AGENTS.md` 规定："NEVER hardcode colors, sizes, or spacing values"
-- 代码中有 **109 处**硬编码 `Color(0xFF...)` 分布在：
-  - `register_screen.dart`, `register_verification_screen.dart`
-  - `settings_screen.dart`, `account_screen.dart`
-  - `contacts_screen.dart`, `calendar_event_detail_screen.dart`
-  - `add_contact_screen.dart`, `features_screen.dart`
-  - `memory_screen.dart`, `home_screen.dart`
-  - `todo_detail_screen.dart`
+- 代码中有 **126 处**硬编码 `Color(0xFF...)`（扫描发现比预期多 17 处）
 
 **Expected Behavior**:
 所有颜色应使用 `AppColors` 中定义的值。
@@ -63,12 +69,24 @@
 - 后续 theme 统一修改困难
 - 代码审查难以发现
 
-**Implementation Options****:
-1. **保守方案**：将常用硬编码颜色添加到 `AppColors`，逐步迁移
-2. **激进方案**：重构所有页面使用 tokens
-3. **规则调整**：如果某些场景确实需要硬编码（如动态颜色），修改 AGENTS.md 明确允许场景
+**Solution** (渐进式迁移):
+1. **扫描分析**: 发现 126 个硬编码颜色，Top 3: `FFF8FAFC` (11), `FFF8FAFF` (9), `FFE2E8F0` (5)
+2. **扩展 AppColors**: 添加 11 个语义化 token（surfaceSecondary, borderSecondary, success, warning 等）
+3. **优先迁移**: 8 个高频文件（settings, contacts, calendar_event_detail 等）
+4. **批量替换**: 37 个硬编码颜色已替换为 tokens
+5. **测试验证**: 140/140 Flutter tests 通过
+
+**Migration Results**:
+- ✅ 新增 token: 11 个（覆盖 57 次使用）
+- ✅ 已迁移: 37 个硬编码颜色
+- ⚠️ 剩余: 90 个（建议后续迭代继续迁移）
+
+**Recommendations**:
+1. 继续迁移剩余 90 个硬编码颜色
+2. 优先处理 `contacts_screen.dart`, `settings_screen.dart`, `features_screen.dart` (46% of remaining)
+3. 考虑添加 lint rule 防止新增硬编码颜色
 
 **Related Files**:
 - `apps/lib/core/theme/design_tokens.dart`
+- `apps/lib/features/*/ui/screens/*.dart` (8 files migrated)
 - `apps/AGENTS.md`
-- 各 feature 页面