@<需求文档> 生成测试用例

├── docs/
│   ├── qa/
│   │   ├── requirements/           # PRD 需求文档
│   │   ├── testcases/cases/        # 手工测试用例（按模块分类）
│   │   │                           # account/ browser/ defi/ hardware/ market/ perps/
│   │   │                           # prime/ referral/ swap/ transfer/ utility/ wallet/
│   │   ├── rules/                  # QA 规则库（14 个模块规则文件）
│   │   ├── qa-rules.md             # 规则总览
│   │   └── 用例生成链路介绍.md       # 用例生成流程说明
│   ├── skills/                     # 辅助技能
│   │   ├── apifox-testcase-generator/  #   API 用例生成
│   │   ├── checklist-generator/    #   Checklist 生成
│   │   ├── smoke-test/             #   冒烟测试 + WS 数据验证
│   │   ├── playwright-generator/   #   E2E Playwright 脚本生成
│   │   ├── android-recorder/       #   Android 录制
│   │   └── app-checklist-issue/    #   APP 回归 checklist
│   └── plans/                      # 实施计划
├── src/
│   ├── tests/                      # 自动化测试脚本（按平台分层）
│   │   ├── run.mjs                 #   CLI Runner 入口（统一）
│   │   ├── desktop/                #   桌面端（TF/MAS 包）
│   │   │   ├── market/             #     Market 行情
│   │   │   ├── perps/              #     Perps 合约
│   │   │   ├── swap/               #     Swap 兑换
│   │   │   ├── transfer/           #     Transfer 转账
│   │   │   ├── wallet/             #     Wallet 钱包
│   │   │   ├── settings/           #     Settings 设置
│   │   │   ├── referral/           #     Referral 推荐
│   │   │   └── utility/            #     地址簿等通用工具
│   │   ├── extension/              #   浏览器插件端
│   │   ├── web/                    #   Web 端（app.onekey.so）
│   │   ├── mobile/                 #   Mobile（部分通用）
│   │   ├── android/                #   Android（Midscene + UIAutomator）
│   │   └── helpers/                #   公共工具（CDP 连接、导航、断言、转账、运行时配置）
│   ├── dashboard/                  # 测试执行面板 (port 5050)
│   ├── recorder/                   # 录制器：桌面 (3210) / Web (3211) / Extension / Android
│   ├── knowledge/                  # 三阶段记忆管线（MemCells → MemScenes → Recall）
│   ├── cli/                        # CLI 命令（status/init/preflight/report 等）
│   ├── converters/                 # 数据格式转换
│   ├── core/                       # 核心逻辑
│   ├── schemas/                    # JSON Schema 定义
│   ├── types/                      # TypeScript 类型
│   └── utils/                      # 通用工具
├── shared/
│   ├── test_cases.json             # 测试用例定义（Test Designer 写入）
│   ├── preconditions.json          # 前置条件数据库
│   ├── ui-map.json                 # 执行期选择器映射（三层：primary/fallback/emergency）
│   ├── ui-semantic-map.json        # 公共语义定位层（生成/维护优先引用）
│   ├── knowledge.json              # 经验沉淀（K-NNN 编号）
│   ├── mem_cells.json              # 记忆单元（原始事件）
│   ├── mem_scenes.json             # 聚类场景
│   ├── profile.json                # Agent 能力画像
│   ├── diagnosis.json              # QA Manager 失败诊断
│   ├── runtime-config.json         # Dashboard 钱包账户配置（gitignored，每人本地配）
│   ├── checklists.json             # Dashboard 回归 Checklist 集合
│   ├── tasks.json                  # 任务队列
│   ├── generated/                  # app-monorepo x 分支同步产物（testID 索引等）
│   ├── results/                    # 执行结果（<TEST-ID>.json）
│   └── reports/                    # Reporter 输出报告 + Review 报告
├── scripts/
│   ├── clean.mjs                   # 项目产物清理（npm run clean）
│   ├── build-locator-map.mjs       # 构建定位器映射
│   ├── sync-app-monorepo-selectors.mjs  # 同步 app-monorepo testID
│   └── start-chrome-debug.sh       # 带 CDP 启动 Chrome
├── .claude/
│   ├── CLAUDE.md                   # Claude Code 项目规则（**唯一真源**）
│   └── skills/                     # 12 个 Agent 技能定义
├── AGENTS.md                       # → symlink → .claude/CLAUDE.md（Codex/Zed/通用 agent 入口）
└── .cursorrules                    # → symlink → .claude/CLAUDE.md（Cursor AI 入口）

新功能用例：PRD → Test Designer 设计 → Record From File 录制 → 生成 .test.mjs
            → Knowledge Builder 更新 ui-map + knowledge → /qa-review 审查 → 提交
日常回归：  /qatest → 勾选用例 → Dashboard 执行 → Reporter 报告
失败修复：  QA Manager 诊断 → 根因路由 → Knowledge Builder 修选择器 → 重跑验证