94 lines
3.7 KiB
Markdown
94 lines
3.7 KiB
Markdown
# 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. 如果脚本因 `T-001` 尚未完成而主动失败，只能领取 `T-001`；不要宣称基线可运行。
|
||
6. 有真实基线后先跑 smoke；基线失败时先修基线。
|
||
7. 领取编号最小、依赖已完成的一个 `TODO` 任务并改成 `DOING`。
|
||
8. 完成实现、验证、任务执行记录和当前状态同步后再结束。
|
||
|
||
## 当前阶段与优先路径
|
||
|
||
当前处于“文档基线完成、最高风险验证尚未开始”阶段。
|
||
|
||
严格按以下顺序推进：
|
||
|
||
1. 接入并构建 Roubao Android 基线。
|
||
2. 用 App 内固定任务验证拼多多搜索和页面操作。
|
||
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 -> 架构数据模型和状态机 -> 编码规则。
|
||
- 安全相关：需求风险 -> 架构安全边界 -> 编码规则，无法满足时停止。
|
||
|
||
## 当前验证命令
|
||
|
||
当前没有生产代码，`init.ps1` 和 `init.sh` 会主动报错。`T-001` 完成后必须用真实
|
||
命令替换本文，例如 Android 至少应有可复现的 Gradle 构建命令；后端建立后再追加
|
||
后端测试和启动命令。
|