初始提交: Qihu-AIFlow v2.0.1 完整项目

- 前端 React+TypeScript (源码+构建产物) - 后端 Python FastAPI - 数据库迁移 001-015 - Docker部署配置 - 微信ClawBot API频道绑定 - 项目文档 README.md
2026-07-02 14:40:46 +08:00
commit 78ff261b5a
@@ -0,0 +1,449 @@
+# AI自进化第二版 (v2) - 测试用例报告
+
+## 文档信息
+
+| 项目 | 详情 |
+|------|------|
+| **测试对象** | AIFlow AI自进化模块 v2 迭代 |
+| **测试阶段** | 第一阶段 - 测试用例生成 |
+| **测试工程师** | QA Engineer |
+| **文档日期** | 2026-05-30 |
+| **基于文档** | PRD-self-evolution-v2.md |
+| **基于代码** | evolution.py (348行), evolution_service.py (1220行), models.py (739-889行), EvolutionDashboard.tsx (1015行), EvolutionDashboard.css, ChatPage.tsx, api/index.ts |
+
+---
+
+## 1. 版本变更概览
+
+### 1.1 PRD vs 实际代码实现对照
+
+PRD v2 规划了 10 大功能、9 个新增 API端点、4 张新增表、5 个现有表新增字段。代码实现了其中大部分功能，但存在具体差异如下：
+
+| PRD规划 | 代码实现状态 |
+|----------|-------------|
+| xSkill流水线自动调度 (P0) | ✅ 已实现 PipelineScheduler (service层, 54-232行) |
+| Watcher线程管理 (P0) | ✅ 已实现 EvolutionWatcherManager 单例 (235-374行) |
+| 技能回滚 (P0) | ✅ 已实现 rollback API + 前端UI (evolution.py:229, EvolutionDashboard.tsx:101-114) |
+| 萌芽动画 (P1) | ✅ 已实现 baby-sprout/staging-breathe CSS动画 (EvolutionDashboard.css:1020-1580) |
+| 时间线导出 (P1) | ✅ 已实现导出菜单+模拟导出 (EvolutionDashboard.tsx:370-383) |
+| 画像分享卡片 (P1) | ✅ 已实现3主题卡片+分享动作 (EvolutionDashboard.tsx:572-691) |
+| Skill加载提示标签 (P1) | ✅ 已实现 (ChatPage.tsx:710-740, chat.py:238-250) |
+| 技能市场联动 (P2) | ✅ 已实现 publish_to_market + 前端发布UI |
+| 团队共享进化 (P2) | ✅ 已实现 share_to_team + 前端共享API |
+| 进化报告推送 (P2) | ✅ 已实现 EvolutionReport 模型 + generate_report + ReportsPanel 前端 |
+
+### 1.2 API端点对比
+
+PRD v2 规划新增9个端点：
+
+| PRD规划端点 | 方法 | 实际代码路径 | 状态 |
+|------------|------|-------------|------|
+| `/skills/{name}/rollback/{version}` | POST | `/evolution/skills/{skill_name}/rollback/{version}` (evolution.py:229) | ✅ 已实现 |
+| `/skills/{name}/versions` | GET | **不存在**: 仅有 `/skills/{skill_name}/history` (返回事件列表) | ❌ **缺失, GAP** |
+| `/skills/{name}/publish` | POST | `/evolution/skills/{skill_name}/publish` (evolution.py:244) | ✅ 已实现 |
+| `/reports/generate` | POST | **不存在**: generate_report() 仅在service层定义, 无API暴露 | ❌ **缺失, GAP** |
+| `/reports` | GET | `/evolution/reports` (evolution.py:307) | ✅ 已实现 |
+| `/reports/{id}` | GET | `/evolution/reports/{report_id}` (evolution.py:318) | ✅ 已实现 |
+| `/watcher/status` | GET | `/evolution/watcher/status` (evolution.py:296) | ✅ 已实现 |
+| `/watcher/restart` | POST | **不存在**: restart逻辑仅在 `/pipeline/trigger` 中内联调用 (evolution.py:291) | ❌ **缺失, GAP** |
+| `/team/sync` | POST | **不存在**: 仅有 `/skills/{name}/share-to-team` (单个技能共享) | ❌ **缺失, GAP** |
+
+**代码额外实现但PRD未要求**:
+
+| 端点 | 方法 | 说明 |
+|------|------|------|
+| `/evolution/pipeline/status` | GET | 流水线状态查询 - PRD v2 5.2 中规划, 但用户测试范围未列 |
+| `/evolution/pipeline/trigger` | POST | 手动触发流水线 - PRD v2 5.2 中规划, 但用户测试范围未列 |
+| `/evolution/skills/{name}/share-to-team` | POST | 团队共享 - PRD 5.4 中规划, 替代 team/sync |
+| `/evolution/admin/watchers` | GET | 管理员全平台watcher汇总 |
+
+### 1.3 数据库变更对比
+
+| PRD 规划表 | 表名 | 状态 |
+|-----------|------|------|
+| 现有表新增字段 | `evolution_trajectories.error_msg` | ✅ 模型已定义 (models.py:795) |
+| 现有表新增字段 | `evolution_trajectories.retry_count` | ✅ 模型已定义 (models.py:796) |
+| 现有表新增字段 | `evolution_trajectories.tasks_extracted` | ✅ 模型已定义 (models.py:797) |
+| 现有表新增字段 | `messages.used_skills` | ✅ 模型已定义 (models.py:100) |
+| 现有表新增字段 | `user_evolution_config.watcher_error` | ✅ 模型已定义 (models.py:749) |
+| 新增表 | `skill_versions` | ✅ 模型已定义 (models.py:818-833), ❌ **数据库中不存在** |
+| 新增表 | `evolution_reports` | ✅ 模型已定义 (models.py:836-850), ❌ **数据库中不存在** |
+| 新增表 | `skill_publish_records` | ✅ 模型已定义 (models.py:853-871), ❌ **数据库中不存在** |
+| 新增表 | `team_shared_skills` | ✅ 模型已定义 (models.py:874-888), ❌ **数据库中不存在** |
+
+**严重问题**: 4张v2新增表在SQLAlchemy models中已定义，但实际MySQL数据库中未创建。这意味着：技能回滚需要 `skill_versions` 表、进化报告需要 `evolution_reports` 表、市场发布需要 `skill_publish_records` 表、团队共享需要 `team_shared_skills` 表。这些功能在表未创建的情况下将无法正常运行。
+
+同样，现有表的5个新字段在模型层面已定义，但数据库层面未通过 `DESC` 验证确认存在（`DESC messages` 未显示 `used_skills`、`DESC evolution_trajectories` 未显示 `error_msg/retry_count/tasks_extracted`、`DESC user_evolution_config` 未显示 `watcher_error`）。
+
+---
+
+## 2. 测试范围与分类
+
+### 2.1 测试分类维度
+
+| 维度 | 说明 |
+|------|------|
+| **P0 核心引擎** | xSkill流水线调度、Watcher管理、技能回滚 |
+| **P1 体验增强** | 萌芽动画、时间线导出、画像分享、Skill标签 |
+| **P2 业务联动** | 技能市场联动、进化报告推送 |
+| **API端点** | 9个新增API + 流水线/团队共享API |
+| **数据库** | 4张新表 + 5个新字段 |
+| **前端交互** | 6大前端功能模块 |
+
+### 2.2 统计摘要
+
+| 类别 | 数量 |
+|------|------|
+| 功能模块 | 10 |
+| API端点 | 15（含PRD规划的9个 + 代码额外实现的6个） |
+| P0测试用例 | 26 |
+| P1测试用例 | 28 |
+| P2测试用例 | 21 |
+| 数据库测试用例 | 7 |
+| 数据隔离测试用例 | 6 |
+| **测试用例总计** | **88** |
+| PRD未覆盖代码功能 (GAP) | 9 |
+| 代码未实现PRD需求 (缺失) | 4 |
+
+---
+
+## 3. P0 核心引擎类 - 测试用例
+
+### 3.1 xSkill流水线自动调度 (PipelineScheduler)
+
+#### API: GET /evolution/pipeline/status
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P0-001 | P0 | 获取流水线状态 - 正常运行 | 用户已登录, watcher已启动 | GET /app/api/evolution/pipeline/status | 返回200, code=0, data包含scheduler_running/watcher_status/pipeline_status/discovered_count/done_count/total_skills/total_trajectories |
+| TC-EVO-V2-P0-002 | P0 | 获取流水线状态 - 未启动 | 用户已登录, watcher未启动 | GET /app/api/evolution/pipeline/status | 返回200, code=0, scheduler_running=false, watcher_status=unknown/stopped |
+| TC-EVO-V2-P0-003 | P1 | 未登录访问流水线状态 | 无认证token | GET /app/api/evolution/pipeline/status | 返回401 |
+| TC-EVO-V2-P0-004 | P1 | 流水线状态数据隔离 | user_a登录查看 | GET /app/api/evolution/pipeline/status | 返回仅user_a的数据，不包含其他用户的数据 |
+
+#### API: POST /evolution/pipeline/trigger
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P0-005 | P0 | 手动触发流水线 | 用户已登录 | POST /app/api/evolution/pipeline/trigger | 返回200, code=0, message="流水线已触发", watcher重新启动 |
+| TC-EVO-V2-P0-006 | P1 | 未登录触发流水线 | 无认证token | POST /app/api/evolution/pipeline/trigger | 返回401 |
+
+#### PipelineScheduler 功能逻辑
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P0-007 | P0 | 轨迹自动状态流转 discovered->splitting->split_done->indexed->clustering->done | 创建一条status=discovered的轨迹, watcher运行中 | 等待PipelineScheduler扫描处理 | 轨迹依次经历6个状态, 最终status=done, processed_at非空 |
+| TC-EVO-V2-P0-008 | P0 | AtomTask拆分模拟 - tasks_extracted更新 | 轨迹处理中 | 查看轨迹tasks_extracted字段 | tasks_extracted值为2-5(模拟生成的atom数量) |
+| TC-EVO-V2-P0-009 | P0 | 轨迹处理创建SkillTrajectoryLink | 轨迹处理完成 | 查询skill_trajectory_links表 | 为每个atom创建了关联记录, skill_name为__pending__或真实技能名 |
+| TC-EVO-V2-P0-010 | P0 | 新轨迹归类到已有技能 | 用户已有至少1个技能 | 提交新轨迹并等待处理 | 轨迹的SkillTrajectoryLink指向已有技能, 技能use_count+1 |
+| TC-EVO-V2-P0-011 | P0 | 新轨迹创建新baby技能 | 用户无任何技能 | 提交新轨迹并等待处理 | 创建新baby技能new_skill_XXXXXXX, state=baby, version=1 |
+| TC-EVO-V2-P0-012 | P0 | 候选轨迹>=3自动baby->staging晋升 | 某baby技能关联轨迹>=3 | PipelineScheduler处理更多轨迹 | 技能state自动从baby变为staging, 记录promoted事件 |
+| TC-EVO-V2-P0-013 | P0 | 轨迹处理失败 - error状态 | 模拟处理异常 (数据库连接中断等) | 轨迹处理失败 | 轨迹status=error, error_msg记录失败原因, retry_count递增 |
+| TC-EVO-V2-P0-014 | P1 | 轨迹处理重试机制 | 轨迹之前失败过(retry_count<3) | PipelineScheduler再次扫描 | 尝试重新处理该轨迹 |
+| TC-EVO-V2-P0-015 | P1 | PipelineScheduler停止信号 | scheduler正在运行 | 调用scheduler.stop() | _stop被设置, _run_loop退出, 线程终止 |
+| TC-EVO-V2-P0-016 | P1 | PipelineScheduler扫描间隔 | scheduler运行 | 观察扫描日志间隔 | 扫描间隔为poll_interval(默认30s) |
+
+### 3.2 Watcher线程管理 (EvolutionWatcherManager)
+
+#### API: GET /evolution/watcher/status
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P0-017 | P0 | 获取Watcher状态 | 用户已登录, watcher已启动 | GET /app/api/evolution/watcher/status | 返回200, data包含watcher_status/pipeline_status/pipeline_processed/scheduler_running/skill_count/trajectory_count |
+| TC-EVO-V2-P0-018 | P1 | Watcher状态数据隔离 | user_a和user_b分别查询 | 分别GET /app/api/evolution/watcher/status | 返回各自的数据, 互不包含 |
+| TC-EVO-V2-P0-019 | P2 | 管理员查看全平台watcher | 管理员登录 | GET /app/api/evolution/admin/watchers | 返回200, data包含所有在运行scheduler的用户ID和运行状态 |
+
+#### WatcherManager 功能逻辑
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P0-020 | P0 | 启动用户进化引擎 (start_user_evolution) | 新用户无scheduler | 调用WatcherManager.start_user_evolution() | scheduler被创建并启动, user_evolution_config表watcher_status=running, pipeline_status=running |
+| TC-EVO-V2-P0-021 | P0 | 重复启动已运行的进化引擎 | 用户engin已运行 | 再次调用start | 返回False, 提示已在运行 |
+| TC-EVO-V2-P0-022 | P0 | 停止用户进化引擎 (stop_user_evolution) | 用户engin运行中 | 调用WatcherManager.stop_user_evolution() | scheduler线程停止, 从_schedulers移除, config表更新为stopped/idle |
+| TC-EVO-V2-P0-023 | P0 | 重启用户进化引擎 (restart_user_evolution) | 用户已运行 | 调用restart → 通过POST /evolution/pipeline/trigger触发 | scheduler先停止再启动, pipeline_status重新变为running |
+| TC-EVO-V2-P0-024 | P1 | 达到最大scheduler限制 | 已有100个scheduler运行 | 新用户尝试启动 | 返回False, 提示达到数量限制 |
+| TC-EVO-V2-P0-025 | P1 | 优雅关闭所有scheduler | 多个scheduler运行中 | 调用shutdown_all() | 所有scheduler依次停止, 日志记录关闭过程 |
+| TC-EVO-V2-P0-026 | P1 | watcher_error 字段写入 | 更新用户进化配置失败场景 | 触发配置更新失败 | user_evolution_config.watcher_error 记录异常信息 |
+
+### 3.3 技能回滚 (Skill Rollback)
+
+#### API: POST /evolution/skills/{skill_name}/rollback/{version}
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P0-027 | P0 | 回滚技能到指定版本 | skill已存在, skill_versions表有目标版本记录, version=3 | POST /app/api/evolution/skills/{name}/rollback/1 | 返回200, code=0, data包含回滚后的技能信息, version变为4 (3+1) |
+| TC-EVO-V2-P0-028 | P0 | 回滚后SKILL.md内容恢复 | 同上, skill_md_path存在 | POST rollback | SKILL.md文件被目标版本内容覆盖, 回滚前内容作为快照存入skill_versions |
+| TC-EVO-V2-P0-029 | P0 | 回滚后事件记录 | 回滚操作完成 | 查询evolution_events表 | 记录event_type="rolled_back", version_before=回滚前, version_after=回滚后, description含回滚版本信息 |
+| TC-EVO-V2-P0-030 | P0 | 技能不存在 | skill不存在 | POST /app/api/evolution/skills/nonexistent_skill/rollback/1 | 返回404, "技能或版本不存在" |
+| TC-EVO-V2-P0-031 | P0 | 目标版本不存在 | skill存在但目标版本无记录 | POST rollback to non-existing version | 返回404, "技能或版本不存在" |
+| TC-EVO-V2-P0-032 | P1 | 未登录回滚 | 无认证 | POST rollback | 返回401 |
+
+#### 前端: VersionHistoryModal + 回滚确认
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P0-033 | P0 | 版本历史弹窗打开 | 技能详情弹窗中 | 点击「版本历史」按钮 | 弹出版本历史弹窗, 显示事件列表(时间线格式), 每条含版本号/事件类型/时间/描述 |
+| TC-EVO-V2-P0-034 | P0 | 版本历史加载中状态 | 点击版本历史 | API请求中 | 显示"加载中..."文字 |
+| TC-EVO-V2-P0-035 | P0 | 版本历史空状态 | skill无历史事件 | 打开版本历史 | 显示"暂无版本历史" |
+| TC-EVO-V2-P0-036 | P0 | 当前版本标识 | 多个版本存在 | 查看版本历史 | 当前版本行显示"当前"标签, 非当前版本行才显示"回滚到此版本"按钮 |
+| TC-EVO-V2-P0-037 | P0 | 回滚确认弹窗 | 点击非当前版本的「回滚到此版本」按钮 | 弹出确认弹窗 | 弹窗标题「确认回滚？」, 显示目标版本和当前版本号对比 |
+| TC-EVO-V2-P0-038 | P0 | 确认回滚操作 | 回滚确认弹窗打开 | 点击「确认回滚」按钮 | 调用API, 成功后显示toast提示, 关闭弹窗 |
+| TC-EVO-V2-P0-039 | P0 | 取消回滚 | 回滚确认弹窗打开 | 点击「取消」按钮 | 关闭确认弹窗, 不调用API |
+| TC-EVO-V2-P0-040 | P1 | 回滚失败toast | API返回错误 | 确认回滚 | 显示红色toast "回滚失败: {错误原因}" |
+
+---
+
+## 4. P1 体验增强类 - 测试用例
+
+### 4.1 萌芽动画 (Baby/Staging Animations)
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P1-001 | P1 | baby技能萌芽脉冲动画 | 存在state=baby的技能, 动画开关=ON | 查看技能图谱面板 | baby技能节点周期性缩放脉冲 scale(1.0→1.15→1.0) 周期2s, 粉色光晕淡入淡出 |
+| TC-EVO-V2-P1-002 | P1 | staging技能呼吸动画 | 存在state=staging的技能, 动画开关=ON | 查看技能图谱面板 | staging技能节点呼吸动画 scale(1.0→1.08→1.0) 周期3s, 橙色脉冲 |
+| TC-EVO-V2-P1-003 | P1 | 动画被关闭 | 动画开关=OFF | 查看技能图谱面板 | baby/staging技能节点静态显示, 无CSS动画效果 |
+| TC-EVO-V2-P1-004 | P1 | 动画开关开关切换 | 默认动画开启 | 点击「动画效果」开关 | 动画立即开/关, CSS class变化 |
+| TC-EVO-V2-P1-005 | P1 | 动画偏好持久化 | 关闭动画 | 刷新页面重新加载驾驶舱 | 动画仍保持关闭状态 (localStorage evo_anim_enabled=false) |
+| TC-EVO-V2-P1-006 | P2 | 无baby/staging技能时 | 所有技能均为main/frozen | 查看技能图谱面板 | 所有节点静态显示, 无动画播放 |
+| TC-EVO-V2-P1-007 | P2 | main/frozen技能无动画 | 各种状态的技能混合 | 检查main/frozen节点 | main和frozen技能节点无CSS animation |
+
+### 4.2 时间线导出 (Timeline Export)
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P1-008 | P1 | 导出按钮显示 | 进化时间线面板激活 | 查看面板右上角 | 显示「导出」按钮 |
+| TC-EVO-V2-P1-009 | P1 | 导出下拉菜单 | 点击「导出」按钮 | 展开下拉菜单 | 显示两项: 「导出为 PNG」和「导出为 PDF」 |
+| TC-EVO-V2-P1-010 | P1 | PNG导出触发 | 点击「导出为 PNG」 | 触发导出 | 显示"导出中..."按钮状态, 完成后显示toast: "时间线已导出为 PNG 格式: AI进化时间线_{用户名}_{日期}.png" |
+| TC-EVO-V2-P1-011 | P1 | PDF导出触发 | 点击「导出为 PDF」 | 触发导出 | 同上, 格式为PDF |
+| TC-EVO-V2-P1-012 | P1 | 时间范围选择器 | 时间线面板 | 使用下拉菜单选择 | 有3个选项: 全部时间 / 最近30天 / 最近7天, 选择后时间线自动筛选 |
+| TC-EVO-V2-P1-013 | P1 | 导出遵循当前筛选 | 设置时间范围「最近7天」+ 事件类型「promoted」 | 点击导出 | 导出内容仅包含最近7天的promoted事件 (所见即所得) |
+| TC-EVO-V2-P1-014 | P2 | 导出时空时间线 | 筛选后无事件 | 点击导出 | toast仍显示成功 (导出空白时间线) |
+| TC-EVO-V2-P1-015 | P2 | 导出按钮disabled状态 | 正在导出中 | 查看导出按钮 | 按钮显示"导出中..."且disabled |
+
+### 4.3 画像分享卡片 (Profile Share Card)
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P1-016 | P1 | 分享按钮存在 | AI能力画像面板激活 | 查看面板右上角 | 显示「分享画像」按钮 (share图标) |
+| TC-EVO-V2-P1-017 | P1 | 分享弹窗打开 | 点击「分享画像」 | 弹出分享弹窗 | 弹窗标题「AI能力画像分享」, 显示卡片预览+主题切换+操作按钮 |
+| TC-EVO-V2-P1-018 | P1 | 3种主题切换 | 分享弹窗内 | 依次点击「深空蓝」「极光绿」「暖阳橙」主题 | 卡片背景色和各元素配色切换为对应主题 |
+| TC-EVO-V2-P1-019 | P1 | 卡片内容完整性 | 分享卡片预览 | 查看卡片 | 包含: 平台Logo + 标题「我的AI进化画像」 + 等级环 + 维度条 + 标签云(最多6个) + 日期水印「Qihu-AIFlow」 |
+| TC-EVO-V2-P1-020 | P1 | 保存到相册 | 分享弹窗 | 点击「保存到相册」按钮 | 关闭弹窗, toast显示"画像卡片已保存到相册（模拟）" |
+| TC-EVO-V2-P1-021 | P1 | 复制图片 | 分享弹窗 | 点击「复制图片」按钮 | 关闭弹窗, toast显示"画像卡片已复制图片（模拟）" |
+| TC-EVO-V2-P1-022 | P2 | 关闭分享弹窗 | 分享弹窗打开 | 点击背景或关闭按钮 | 弹窗关闭 |
+| TC-EVO-V2-P1-023 | P2 | 隐私保护验证 | 分享卡片预览 | 检查卡片内容 | 卡片仅包含聚合数据(等级/维度/标签), 不包含具体技能名称或对话内容 |
+
+### 4.4 Skill加载提示标签 (Used Skills Tags)
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P1-024 | P1 | 标签显示 | 用户有main状态技能, AI对话回复 | 发送消息等待AI回复 | AI回复气泡下方显示标签, 格式: 图标 + "使用了专属技能：{技能名}" |
+| TC-EVO-V2-P1-025 | P1 | 多技能标签展示(<=3个) | AI使用了2-3个技能 | 查看回复下方 | 2-3个标签横向排列 |
+| TC-EVO-V2-P1-026 | P1 | 多技能标签展示(>3个) | AI使用了4+个技能 | 查看回复下方 | 显示3个技能标签 + "+N" 折叠标签 |
+| TC-EVO-V2-P1-027 | P1 | 标签点击跳转 | 消息下方有技能标签 | 点击技能标签 | 跳转到 #/evolution?skill={技能名} |
+| TC-EVO-V2-P1-028 | P1 | 无技能时不显示标签 | 用户无main状态技能, 发送消息 | 查看AI回复 | AI回复下方无标签区域 |
+| TC-EVO-V2-P1-029 | P1 | 聊天API返回used_skills字段 | 发送消息 | 检查API响应 | assistant_message.used_skills 存在, 为字符串数组 |
+| TC-EVO-V2-P1-030 | P1 | 技能使用后use_count更新 | 某技能被used_skills触发 | 查询该技能详情 | use_count+1, last_used_at更新为当前时间 |
+| TC-EVO-V2-P1-031 | P2 | 标签样式 | 有技能标签的消息 | 查看UI | 标签为圆角样式, 左侧图标, 底色半透明 |
+
+---
+
+## 5. P2 业务联动类 - 测试用例
+
+### 5.1 技能市场联动 (Publish to Market)
+
+#### API: POST /evolution/skills/{skill_name}/publish
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P2-001 | P2 | 发布main技能到市场 | skill state=main, 未发布过 | POST /app/api/evolution/skills/{name}/publish, body: {price: 0, market_description: "测试发布"} | 返回200, code=0, data含market_app_id, price, status="published" |
+| TC-EVO-V2-P2-002 | P2 | 非main状态发布失败 | skill state=baby/staging | POST publish | 返回404/error, 提示只有main状态技能可发布 |
+| TC-EVO-V2-P2-003 | P2 | 重复发布检测 | skill已发布过 | POST publish | 返回error, "该技能已发布到市场，不能重复发布" |
+| TC-EVO-V2-P2-004 | P2 | 发布后在market_apps表创建记录 | 发布成功 | 查询market_apps表 | 创建一条type=skill, source=user的记录, name="{技能名}(进化)" |
+| TC-EVO-V2-P2-005 | P2 | 发布后在skill_publish_records表创建记录 | 发布成功 | 查询skill_publish_records表 | 创建一条status=published的记录 |
+| TC-EVO-V2-P2-006 | P2 | 发布后事件记录 | 发布成功 | 查询evolution_events | 记录event_type="published" |
+| TC-EVO-V2-P2-007 | P2 | 技能不存在 | skill不存在 | POST publish | 返回404 |
+| TC-EVO-V2-P2-008 | P2 | 未登录发布 | 无认证 | POST publish | 返回401 |
+
+#### 前端: 发布按钮+发布表单
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P2-009 | P2 | main技能显示发布按钮 | 技能详情弹窗, skill.state=main | 查看操作按钮区域 | 显示「发布到市场」按钮(金色边框) |
+| TC-EVO-V2-P2-010 | P2 | 非main技能不显示发布按钮 | 技能详情弹窗, skill.state=baby/staging/frozen | 查看操作按钮区域 | 不显示「发布到市场」按钮 |
+| TC-EVO-V2-P2-011 | P2 | 发布表单弹窗 | 点击「发布到市场」 | 弹窗显示 | 标题「发布到应用市场」, 显示技能名, 包含价格输入框(默认为0)和市场描述文本框 |
+| TC-EVO-V2-P2-012 | P2 | 发布表单提交 | 设置价格和市场描述 | 点击「确认发布」 | 调用API, 成功后显示toast "技能已发布到应用市场" |
+| TC-EVO-V2-P2-013 | P2 | 发布失败toast | API返回错误 | 提交发布 | 显示toast "发布失败: {错误原因}" |
+| TC-EVO-V2-P2-014 | P2 | 取消发布 | 发布弹窗 | 点击「取消」 | 关闭弹窗 |
+
+### 5.2 团队共享进化 (Share to Team)
+
+#### API: POST /evolution/skills/{skill_name}/share-to-team
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P2-015 | P2 | 分享技能到团队 | 技能存在, 用户是team owner | POST /app/api/evolution/skills/{name}/share-to-team, body: {team_id: "valid_team_id"} | 返回200, code=0, data包含shared_id, skill_name, team_name |
+| TC-EVO-V2-P2-016 | P2 | 团队不存在 | team_id无效 | POST share-to-team | 返回error "团队不存在" |
+| TC-EVO-V2-P2-017 | P2 | 用户不属于该团队 | 用户不是team owner | POST share-to-team | 返回error "用户不属于该团队" |
+| TC-EVO-V2-P2-018 | P2 | 重复分享 | 技能已分享至该团队 | POST share-to-team | 返回error "该技能已分享至此团队" |
+| TC-EVO-V2-P2-019 | P2 | 技能不存在 | 技能不存在 | POST share-to-team | 返回error "技能不存在或不属于当前用户" |
+| TC-EVO-V2-P2-020 | P2 | 分享后创建team_shared_skills记录 | 分享成功 | 查询team_shared_skills表 | 创建一条记录, 含team_id, skill_id, shared_by, is_public=true |
+
+### 5.3 进化报告 (Evolution Reports)
+
+#### API: GET /evolution/reports
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P2-021 | P2 | 获取报告列表 | 用户有至少1条报告 | GET /app/api/evolution/reports | 返回200, code=0, data为报告列表(按时间倒序), 每项含id, report_type, period_start, period_end, created_at |
+| TC-EVO-V2-P2-022 | P2 | 按类型过滤报告 | 用户有weekly和monthly报告 | GET /app/api/evolution/reports?report_type=weekly | 仅返回weekly类型报告 |
+| TC-EVO-V2-P2-023 | P2 | 空报告列表 | 用户无报告 | GET /app/api/evolution/reports | 返回空数组 [] |
+
+#### API: GET /evolution/reports/{report_id}
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P2-024 | P2 | 获取报告详情 | 报告存在 | GET /app/api/evolution/reports/{id} | 返回200, data含report_data(JSON)包含summary/new_skills/upgrades/top_skills/dimensions |
+| TC-EVO-V2-P2-025 | P2 | 报告不存在 | report_id无效 | GET /app/api/evolution/reports/nonexistent_id | 返回404, "报告不存在" |
+| TC-EVO-V2-P2-026 | P2 | 数据隔离 | user_a查询user_b的报告 | GET /app/api/evolution/reports/{user_b_report_id} | 返回404或空 (不能看到其他用户报告) |
+
+#### Service: generate_report
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P2-027 | P2 | 生成周报 (weekly) | 用户有技能/轨迹/事件 | 调用EvolutionService.generate_report("weekly") | 创建evolution_reports记录, 含period_start=7天前, 统计新增技能/升级/调用次数/等级变化 |
+| TC-EVO-V2-P2-028 | P2 | 生成月报 (monthly) | 同上 | 调用generate_report("monthly") | 同上但period_start=30天前 |
+| TC-EVO-V2-P2-029 | P2 | 报告生成后发送通知 | 生成报告成功 | 查询notifications表 | 创建一条type="evolution_report"的通知 |
+| TC-EVO-V2-P2-030 | P2 | 不支持的报告类型 | - | 调用generate_report("daily") | 返回error "不支持的报告类型: daily" |
+
+#### 前端: ReportsPanel
+
+| TC-ID | 优先级 | 测试场景 | 前置条件 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|----------|
+| TC-EVO-V2-P2-031 | P2 | 报告列表展示 | 驾驶舱切换到「进化报告」面板 | 进入面板 | 显示报告卡片列表, 每张卡片含报告类型图标+标题+时间段 |
+| TC-EVO-V2-P2-032 | P2 | 报告空列表状态 | 无报告 | 进入「进化报告」面板 | 显示"暂无进化报告。系统将在每周一自动生成周报。" |
+| TC-EVO-V2-P2-033 | P2 | 点击查看报告详情 | 报告列表有数据 | 点击某条报告 | 弹出报告详情弹窗, 显示概览(新增技能数/技能升级数/总调用次数) + TOP5最活跃技能 |
+| TC-EVO-V2-P2-034 | P2 | 关闭报告详情 | 报告详情弹窗 | 点击背景或关闭按钮 | 返回报告列表 |
+| TC-EVO-V2-P2-035 | P2 | 报告详情加载中 | 点击报告卡片 | API请求中 | 报告列表页正常显示, 切换到详情时的loading由弹窗内处理 |
+
+---
+
+## 6. 数据库变更 - 测试用例
+
+### 6.1 新增表验证
+
+| TC-ID | 优先级 | 测试场景 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|
+| TC-EVO-V2-DB-001 | P0 | skill_versions表结构 | DESC aiflow.skill_versions | 表存在, 字段含: id, user_id, skill_name, version, skill_md_content(LONGTEXT), git_commit_sha, description, created_at |
+| TC-EVO-V2-DB-002 | P0 | evolution_reports表结构 | DESC aiflow.evolution_reports | 表存在, 字段含: id, user_id, report_type, period_start, period_end, report_data(JSON), created_at |
+| TC-EVO-V2-DB-003 | P0 | skill_publish_records表结构 | DESC aiflow.skill_publish_records | 表存在, 字段含: id, skill_id, skill_name, user_id, market_app_id, price, market_description, status, published_at, created_at |
+| TC-EVO-V2-DB-004 | P0 | team_shared_skills表结构 | DESC aiflow.team_shared_skills | 表存在, 字段含: id, team_id, skill_id, skill_name, shared_by, shared_by_name, is_public, created_at + uk_tss_team_skill唯一约束 |
+
+### 6.2 现有表新增字段验证
+
+| TC-ID | 优先级 | 测试场景 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|
+| TC-EVO-V2-DB-005 | P0 | evolution_trajectories新字段 | DESC aiflow.evolution_trajectories | error_msg VARCHAR(500), retry_count INT DEFAULT 0, tasks_extracted INT DEFAULT 0 |
+| TC-EVO-V2-DB-006 | P0 | messages.used_skills字段 | DESC aiflow.messages | used_skills JSON 字段存在 |
+| TC-EVO-V2-DB-007 | P0 | user_evolution_config.watcher_error | DESC aiflow.user_evolution_config | watcher_error VARCHAR(500) 字段存在 |
+
+---
+
+## 7. 数据隔离 - 测试用例
+
+| TC-ID | 优先级 | 测试场景 | 测试步骤 | 预期结果 |
+|-------|--------|----------|----------|----------|
+| TC-EVO-V2-ISO-001 | P0 | 回滚操作数据隔离 | user_a对user_b的技能发起rollback | 返回404 (用户只能操作自己的技能) |
+| TC-EVO-V2-ISO-002 | P0 | 流水线状态数据隔离 | user_a查询流水线状态 | 仅返回user_a的discovered/done/total数据 |
+| TC-EVO-V2-ISO-003 | P0 | 发布操作数据隔离 | user_a对user_b的技能发起publish | 返回404 |
+| TC-EVO-V2-ISO-004 | P0 | 报告数据隔离 | user_a查询报告 | 仅返回user_a的报告, 不含其他用户 |
+| TC-EVO-V2-ISO-005 | P0 | 团队共享数据隔离 | user_a查询user_b团队的共享技能 | 非团队成员不可见 (由team_shared_skills关联team表约束) |
+| TC-EVO-V2-ISO-006 | P1 | Watcher状态数据隔离 | user_a查询watcher状态 | 仅返回user_a的watcher/scheduler/skill_count |
+
+---
+
+## 8. PRD未覆盖的代码功能 (GAP清单)
+
+以下功能在代码中已实现，但PRD v2文档中未覆盖或差异较大：
+
+| GAP编号 | 类型 | 描述 | 严重程度 | 代码位置 |
+|---------|------|------|----------|----------|
+| GAP-V2-01 | API差异 | PRD规划 `POST /reports/generate` 但未实现API暴露, generate_report()仅在service层定义无路由 | 高 | evolution_service.py:963-1063 |
+| GAP-V2-02 | API差异 | PRD规划 `GET /skills/{name}/versions` (版本列表) 未实现, 仅有 `/skills/{name}/history` (事件列表) 复用 | 中 | evolution.py:124-133 |
+| GAP-V2-03 | API差异 | PRD规划 `POST /watcher/restart` 独立端点未实现, restart逻辑内联在pipeline/trigger中 | 中 | evolution.py:284-293 |
+| GAP-V2-04 | API差异 | PRD规划 `POST /team/sync` (批量团队同步)未实现, 仅有单个技能share-to-team | 中 | evolution.py:259-271 |
+| GAP-V2-05 | 前端差异 | 时间线导出为模拟实现 (setTimeout模拟), 未集成html2canvas/jsPDF库实现真实导出 | 高 | EvolutionDashboard.tsx:370-383 |
+| GAP-V2-06 | 前端差异 | 画像分享卡片为模拟实现 (toast显示"模拟"), 未集成html2canvas实现真实截图 | 高 | EvolutionDashboard.tsx:582-587 |
+| GAP-V2-07 | 数据库差异 | 4张v2新表在models中定义但数据库未创建 | 致命 | models.py:818-888; MySQL confirmed missing |
+| GAP-V2-08 | 数据库差异 | 5个现有表新字段在models中定义但数据库未确认存在 | 致命 | models.py:795-797,100,749 |
+| GAP-V2-09 | API差异 | PRD未规划但代码实现 `GET /pipeline/status` 和 `POST /pipeline/trigger` 两个流水线端点 - extra code | 信息 | evolution.py:274-293 |
+
+---
+
+## 9. 代码中实现但PRD未覆盖的功能模块
+
+| 编号 | 功能 | 代码位置 | 说明 |
+|------|------|----------|------|
+| EXTRA-V2-01 | PipelineScheduler 零技能冷启动处理 | evolution_service.py:168-190 | 当用户无任何技能时, 自动创建new_skill_XXXXXXX baby技能 |
+| EXTRA-V2-02 | PipelineScheduler promoter 候选>=3自晋升 | evolution_service.py:194-218 | 关联轨迹>=3自动 baby→staging, 记录promoted事件 |
+| EXTRA-V2-03 | PipelineScheduler pipeline_processed计数 | evolution_service.py:224-230 | 轨迹处理完成后更新user_evolution_config.pipeline_processed |
+
+---
+
+## 10. 功能优先级分布
+
+| 优先级 | 测试用例数 | 占比 |
+|--------|----------|------|
+| P0 | 26 | 29.5% |
+| P1 | 28 | 31.8% |
+| P2 | 21 | 23.9% |
+| DB | 7 | 8.0% |
+| ISO | 6 | 6.8% |
+| **总计** | **88** | **100%** |
+
+---
+
+## 11. 风险与建议
+
+### 11.1 致命问题（阻塞测试）
+
+**1. 数据库表未创建**（GAP-V2-07、GAP-V2-08）
+
+4张v2新增表 (`skill_versions`, `evolution_reports`, `skill_publish_records`, `team_shared_skills`) 在SQLAlchemy models中已定义但在MySQL数据库中不存在。此外 `evolution_trajectories` 的 `error_msg`/`retry_count`/`tasks_extracted`、`messages` 的 `used_skills`、`user_evolution_config` 的 `watcher_error` 字段在数据库中也可能不存在。
+
+**影响范围**: 技能回滚、进化报告、市场发布、团队共享功能将全部失败。PipelineScheduler的error_msg/retry_count写入也会失败。
+
+**建议**: 需开发工程师执行数据库迁移（创建新表和新字段），然后再进入API测试阶段。
+
+### 11.2 高风险问题
+
+**2. 前端导出/分享为模拟实现**（GAP-V2-05、GAP-V2-06）
+
+时间线PNG/PDF导出和画像分享卡片生成均使用`setTimeout`模拟，未集成`html2canvas`/`jsPDF`库。这意味着这两个功能目前只是UI展示，用户无法真正获得导出文件。
+
+**3. 报告生成API缺失**（GAP-V2-01）
+
+`generate_report()` 在service层实现了完整逻辑，但没有对应的API路由端点，前端无法主动触发报告生成。目前只能依赖外部定时任务触发。
+
+### 11.3 中风险问题
+
+**4. 几个PRD规划的端点缺失**（GAP-V2-02, GAP-V2-03, GAP-V2-04）
+
+- `GET /skills/{name}/versions` - 版本列表独立端点
+- `POST /watcher/restart` - 独立restart端点
+- `POST /team/sync` - 批量团队同步
+
+其中技能版本列表功能有近似的history端点替代但语义不完全一致（history返回事件列表而非版本列表）；watcher重启功能有pipeline/trigger替代；团队同步仅有单个技能共享。
+
+---
+
+## 12. 结论
+
+AI自进化 v2 代码实现基本覆盖了PRD v2 规划的10大功能中的核心逻辑，23个API端点中有19个已实现（含PRD未明确规划的pipeline和团队共享端点）。前端6大交互体验功能全部有实现。**当前阻塞测试的关键问题是数据库表未创建**，建议优先修复此项后进入下一测试阶段。
+
+---
+
+> **文档状态**: 已定稿
+> **创建日期**: 2026-05-30
+> **测试用例总计**: 88 条 (P0: 26, P1: 28, P2: 21, DB: 7, ISO: 6)
+> **发现GAP**: 9 项
+> **发现PRD未覆盖代码功能**: 3 项