cmroubao/docs/00-ai-start-here.md

AI 开发入口

一句话定位

本项目验证管理后台创建的图片和文字采购任务，能否由 Android App 领取并借助 VLM 在拼多多中找到合理候选商品，同时安全地停在人工确认位置并回传证据。

当前 MVP

只做：

• 管理 Web 创建和查看采购任务。
• 一台 Android 设备由采购人员手动领取下一条任务。
• AI 把图片和文字解析为结构化检索条件。
• App 在拼多多搜索、检查少量结果并选择候选。
• App 停在候选确认或订单确认页，由人判断是否通过。
• 回传任务状态、候选摘要、截图和失败原因。

不做：

• 推送到达后无人确认地立即执行。
• 最终提交订单、自动付款或处理退款。
• 绕过验证码、风控或登录校验。
• 多电商平台、多设备并发调度和生产级 RBAC。

首次读取顺序

1. ../AGENTS.md
2. 01-vision.md
3. 02-requirements.md
4. 03-tech-stack.md
5. 04-architecture.md
6. 05-coding-rules.md
7. 06-tasks.md
8. tasks/README.md
9. current-state.md

有界面任务时再读 07-user-stories.md、08-interaction-checklist.md、routes.md 和关联原型；API 任务读 api.md。

固定开工流程

1. 确认工作目录是仓库根目录。
2. 读取 agent-context.json、current-state.md 和当前任务文件。
3. 仓库已启用 Git 时查看最近五条提交；当前未启用时，以 current-state.md 为准。
4. 运行 ./init.ps1（Windows）或 ./init.sh（WSL/Linux）。
5. 如果脚本失败，先记录并修复基线；不要在失败状态领取依赖它的后续任务。
6. 有真实基线后先跑 smoke；基线失败时先修基线。
7. 领取编号最小、依赖已完成的一个 TODO 任务并改成 DOING。
8. 完成实现、验证、任务执行记录和当前状态同步后再结束。

当前阶段与优先路径

当前处于“Android 可运行基线完成、设备和 workflow 验证准备”阶段。

严格按以下顺序推进：

1. 接入并构建 Roubao Android 基线。
2. 用本机蝦皮订单样本生成固定探针任务，验证拼多多搜索和页面操作。
3. 接入 VLM，验证结构化需求提取和候选判断。
4. 建立最小后端和管理页面。
5. 接入手动领取、租约、状态和结果回传。
6. 用真实样本完成 20 条任务试验。

不允许先建设完整后台、消息推送或多设备调度来代替第 2 步的高风险验证。

事实来源

• 产品范围：02-requirements.md
• 角色目标：07-user-stories.md
• 交互行为：08-interaction-checklist.md
• 技术和模块边界：03-tech-stack.md、04-architecture.md
• API：api.md
• 当前现实：current-state.md、当前代码和实际命令输出
• 任务：docs/tasks/T-<编号>.md
• 原始讨论摘要：../deepseek总结.txt，仅作背景；与正式文档冲突时不作为权威

Roubao、拼多多页面、Android 包名、上游分支和依赖版本必须从接入的源码和测试设备 核实，不能仅凭讨论摘要推断。

常见任务路由

• Android 自动化：需求 -> 架构“自动化边界” -> 编码规则 -> 当前任务。
• VLM：需求约束 -> 架构“AI 决策边界” -> API/模块合约 -> 当前任务。
• 管理 Web：用户故事 -> 交互清单 -> 路由 -> API -> 架构。
• 后端/数据：API -> 架构数据模型和状态机 -> 编码规则。
• 安全相关：需求风险 -> 架构安全边界 -> 编码规则，无法满足时停止。

当前验证命令

Windows 默认验证：

.\init.ps1

连接并授权真机后执行安装和冷启动：

$env:RUN_START_COMMAND = "1"
.\init.ps1

脚本执行 test assembleDebug；上游当前没有单元测试源，因此 test 的测试任务为 NO-SOURCE，但编译与 APK 打包必须成功。后端建立后再追加后端测试和启动命令。