chengma/cmroubao
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs: sync wiki at afc651f75a3a

ila
2026-08-07 16:42:19 +08:00
parent ad8f98a4d7
commit fe53267497
2 changed files with 36 additions and 212 deletions
Download Patch File Download Diff File Expand all files Collapse all files
01-vision.-.md
-49
@@ -1,49 +0,0 @@
<!-- docs-wiki-sync:docs/01-vision.md@afc651f75a3abc2676bb13aa8a80f6aa6a25a72e -->
> 同步来源：[`docs/01-vision.md`](/chengma/mroubao/src/commit/afc651f75a3abc2676bb13aa8a80f6aa6a25a72e/docs/01-vision.md) · commit `afc651f75a3a`
# 项目愿景
## 核心目标
让采购团队能够把商品图片、标题、描述、数量和预算形成标准采购任务，由专用 Android
设备辅助完成拼多多检索和候选比较，减少重复搜索时间，并为每次自动化执行留下可审计
的结果。
本项目不是绕过电商平台规则的爬虫或支付机器人。首要目标是验证 AI 与 Android UI
自动化能否在真实采购场景中可靠协助人员，而不是追求无人值守。
## 目标用户
- **采购管理员**：创建任务、设置硬性约束、查看进度和结果。
- **采购执行员**：在 Android App 上领取任务、监控执行、人工确认候选和处理异常。
- **系统管理员（后续）**：管理人员、角色、设备、模型配置和审计策略。
- **审核员（后续）**：审核高金额或异常任务，不直接操作采购流程。
## 核心价值
| 价值 | 说明 |
| --- | --- |
| 减少重复操作 | 自动把图片和描述转为检索条件，减少人工输入和逐条翻找。 |
| 提高匹配一致性 | 用结构化约束和可解释的候选比较代替完全凭经验浏览。 |
| 保持人工控制 | 对不可逆操作设置明确停止点，人员随时知道当前状态并可接管。 |
| 留下执行证据 | 任务、候选、截图、失败原因和耗时可以追溯。 |
## 产品原则
- **先证伪最高风险**：先证明拼多多页面自动化可运行，再建设完整后台。
- **硬约束优先于模型**：数量、最高预算和人工输入不能被模型修改。
- **人工确认不可省略**：验证版的订单提交和支付必须由人控制。
- **失败要可诊断**：不能只返回“失败”，必须记录步骤、错误码和必要截图。
- **最小权限**：后台、人员、设备和第三方 App 权限各自隔离。
- **可替换模型**：业务流程不能绑定单一 VLM 厂商。
## 非目标
- MVP 不自动提交订单或支付。
- MVP 不支持淘宝、1688、京东等其他平台。
- MVP 不做后台推送后立即执行；只做 App 手动领取。
- MVP 不做多设备负载均衡、复杂审批、财务对账和退款。
- 不绕过验证码、风控、登录验证、平台限流或权限校验。
- 不承诺对所有拼多多版本和所有商品类目通用。
具体范围与验收见[需求](/chengma/mroubao/wiki/02-requirements)。
unnamed.md
+36 -163
@@ -1,176 +1,49 @@
<!-- docs-wiki-sync:docs/README.md@afc651f75a3abc2676bb13aa8a80f6aa6a25a72e -->
> 同步来源：[`docs/README.md`](/chengma/mroubao/src/commit/afc651f75a3abc2676bb13aa8a80f6aa6a25a72e/docs/README.md) · commit `afc651f75a3a`
<!-- docs-wiki-sync:docs/01-vision.md@afc651f75a3abc2676bb13aa8a80f6aa6a25a72e -->
> 同步来源：[`docs/01-vision.md`](/chengma/mroubao/src/commit/afc651f75a3abc2676bb13aa8a80f6aa6a25a72e/docs/01-vision.md) · commit `afc651f75a3a`
# CMRoubao 项目文档
# 项目愿景
本 Wiki 从仓库 `docs/` 目录同步。
## 核心目标
## 核心文档
让采购团队能够把商品图片、标题、描述、数量和预算形成标准采购任务，由专用 Android
设备辅助完成拼多多检索和候选比较，减少重复搜索时间，并为每次自动化执行留下可审计
的结果。
- [AI 开发入口](/chengma/mroubao/wiki/00-ai-start-here.-)
- [项目愿景](/chengma/mroubao/wiki/01-vision.-)
- [需求](/chengma/mroubao/wiki/02-requirements.-)
- [技术栈](/chengma/mroubao/wiki/03-tech-stack.-)
- [架构设计](/chengma/mroubao/wiki/04-architecture.-)
- [编码规则](/chengma/mroubao/wiki/05-coding-rules.-)
- [任务路线图](/chengma/mroubao/wiki/06-tasks.-)
- [用户故事清单](/chengma/mroubao/wiki/07-user-stories.-)
- [交互清单](/chengma/mroubao/wiki/08-interaction-checklist.-)
- [Agent 上下文清单](/chengma/mroubao/wiki/agent-context.-)
- [API 合约](/chengma/mroubao/wiki/api)
- [干净收尾检查清单](/chengma/mroubao/wiki/clean-state-checklist.-)
- [当前实现状态](/chengma/mroubao/wiki/current-state.-)
- [路由与页面结构](/chengma/mroubao/wiki/routes)
本项目不是绕过电商平台规则的爬虫或支付机器人。首要目标是验证 AI 与 Android UI
自动化能否在真实采购场景中可靠协助人员，而不是追求无人值守。
## 设计与集成
## 目标用户
- [设计原型输入约定](/chengma/mroubao/wiki/Design)
- [顺运宝 ERP 字段契约](/chengma/mroubao/wiki/Integrations-shunyunbao-contract.-)
- [老板汇报 PPT 与流程图](/chengma/mroubao/wiki/PPT)
- **采购管理员**：创建任务、设置硬性约束、查看进度和结果。
- **采购执行员**：在 Android App 上领取任务、监控执行、人工确认候选和处理异常。
- **系统管理员（后续）**：管理人员、角色、设备、模型配置和审计策略。
- **审核员（后续）**：审核高金额或异常任务，不直接操作采购流程。
## 任务记录
## 核心价值
- [任务文件](/chengma/mroubao/wiki/Tasks)
- [T-001](/chengma/mroubao/wiki/T-001.-)
- [T-002](/chengma/mroubao/wiki/T-002.-)
- [T-003](/chengma/mroubao/wiki/T-003.-)
- [T-004](/chengma/mroubao/wiki/T-004.-)
- [T-101](/chengma/mroubao/wiki/T-101.-)
- [T-102](/chengma/mroubao/wiki/T-102.-)
- [T-103](/chengma/mroubao/wiki/T-103.-)
- [T-104](/chengma/mroubao/wiki/T-104.-)
- [T-201](/chengma/mroubao/wiki/T-201.-)
- [T-202](/chengma/mroubao/wiki/T-202.-)
- [T-203](/chengma/mroubao/wiki/T-203.-)
- [T-204](/chengma/mroubao/wiki/T-204.-)
- [T-205](/chengma/mroubao/wiki/T-205.-)
- [T-206](/chengma/mroubao/wiki/T-206.-)
- [T-207](/chengma/mroubao/wiki/T-207.-)
- [T-208](/chengma/mroubao/wiki/T-208.-)
- [T-209](/chengma/mroubao/wiki/T-209.-)
- [T-210](/chengma/mroubao/wiki/T-210.-)
- [T-211](/chengma/mroubao/wiki/T-211.-)
- [T-212](/chengma/mroubao/wiki/T-212.-)
- [T-213](/chengma/mroubao/wiki/T-213.-)
- [T-214](/chengma/mroubao/wiki/T-214.-)
- [T-215](/chengma/mroubao/wiki/T-215.-)
- [T-216](/chengma/mroubao/wiki/T-216.-)
- [T-217](/chengma/mroubao/wiki/T-217.-)
- [T-218](/chengma/mroubao/wiki/T-218.-)
- [T-219](/chengma/mroubao/wiki/T-219.-)
- [T-220](/chengma/mroubao/wiki/T-220.-)
- [T-221](/chengma/mroubao/wiki/T-221.-)
- [T-222](/chengma/mroubao/wiki/T-222.-)
- [T-223](/chengma/mroubao/wiki/T-223.-)
- [T-224](/chengma/mroubao/wiki/T-224.-)
- [T-225](/chengma/mroubao/wiki/T-225.-)
- [T-226](/chengma/mroubao/wiki/T-226.-)
- [T-227](/chengma/mroubao/wiki/T-227.-)
- [T-228](/chengma/mroubao/wiki/T-228.-)
- [T-229](/chengma/mroubao/wiki/T-229.-)
- [T-230](/chengma/mroubao/wiki/T-230.-)
- [T-231](/chengma/mroubao/wiki/T-231.-)
- [T-232](/chengma/mroubao/wiki/T-232.-)
- [T-233](/chengma/mroubao/wiki/T-233.-)
- [T-234](/chengma/mroubao/wiki/T-234.-)
- [T-235](/chengma/mroubao/wiki/T-235.-)
- [T-236](/chengma/mroubao/wiki/T-236.-)
- [T-237](/chengma/mroubao/wiki/T-237.-)
- [T-238](/chengma/mroubao/wiki/T-238.-)
- [T-239](/chengma/mroubao/wiki/T-239.-)
- [T-240](/chengma/mroubao/wiki/T-240.-)
- [T-241](/chengma/mroubao/wiki/T-241.-)
- [T-242](/chengma/mroubao/wiki/T-242.-)
- [T-243](/chengma/mroubao/wiki/T-243.-)
- [T-244](/chengma/mroubao/wiki/T-244.-)
- [T-245](/chengma/mroubao/wiki/T-245.-)
- [T-246](/chengma/mroubao/wiki/T-246.-)
- [T-247](/chengma/mroubao/wiki/T-247.-)
- [T-248](/chengma/mroubao/wiki/T-248.-)
- [T-249](/chengma/mroubao/wiki/T-249.-)
- [T-250](/chengma/mroubao/wiki/T-250.-)
- [T-251](/chengma/mroubao/wiki/T-251.-)
- [T-252](/chengma/mroubao/wiki/T-252.-)
- [T-253](/chengma/mroubao/wiki/T-253.-)
- [T-254](/chengma/mroubao/wiki/T-254.-)
- [T-255](/chengma/mroubao/wiki/T-255.-)
- [T-256](/chengma/mroubao/wiki/T-256.-)
- [T-257](/chengma/mroubao/wiki/T-257.-)
- [T-258](/chengma/mroubao/wiki/T-258.-)
- [T-259](/chengma/mroubao/wiki/T-259.-)
- [T-260](/chengma/mroubao/wiki/T-260.-)
- [T-261](/chengma/mroubao/wiki/T-261.-)
- [T-262](/chengma/mroubao/wiki/T-262.-)
- [T-263](/chengma/mroubao/wiki/T-263.-)
- [T-264](/chengma/mroubao/wiki/T-264.-)
- [T-265](/chengma/mroubao/wiki/T-265.-)
- [T-266](/chengma/mroubao/wiki/T-266.-)
- [T-267](/chengma/mroubao/wiki/T-267.-)
- [T-268](/chengma/mroubao/wiki/T-268.-)
- [T-269](/chengma/mroubao/wiki/T-269.-)
- [T-270](/chengma/mroubao/wiki/T-270.-)
- [T-271](/chengma/mroubao/wiki/T-271.-)
- [T-272](/chengma/mroubao/wiki/T-272.-)
- [T-273](/chengma/mroubao/wiki/T-273.-)
- [T-274](/chengma/mroubao/wiki/T-274.-)
- [T-275](/chengma/mroubao/wiki/T-275.-)
- [T-276](/chengma/mroubao/wiki/T-276.-)
- [T-277](/chengma/mroubao/wiki/T-277.-)
- [T-278](/chengma/mroubao/wiki/T-278.-)
- [T-279](/chengma/mroubao/wiki/T-279.-)
- [T-280](/chengma/mroubao/wiki/T-280.-)
- [T-281](/chengma/mroubao/wiki/T-281.-)
- [Task-Template](/chengma/mroubao/wiki/Task-Template.-)
| 价值 | 说明 |
| --- | --- |
| 减少重复操作 | 自动把图片和描述转为检索条件，减少人工输入和逐条翻找。 |
| 提高匹配一致性 | 用结构化约束和可解释的候选比较代替完全凭经验浏览。 |
| 保持人工控制 | 对不可逆操作设置明确停止点，人员随时知道当前状态并可接管。 |
| 留下执行证据 | 任务、候选、截图、失败原因和耗时可以追溯。 |
---
## 产品原则
## `docs/README.md` 原文
- **先证伪最高风险**：先证明拼多多页面自动化可运行，再建设完整后台。
- **硬约束优先于模型**：数量、最高预算和人工输入不能被模型修改。
- **人工确认不可省略**：验证版的订单提交和支付必须由人控制。
- **失败要可诊断**：不能只返回“失败”，必须记录步骤、错误码和必要截图。
- **最小权限**：后台、人员、设备和第三方 App 权限各自隔离。
- **可替换模型**：业务流程不能绑定单一 VLM 厂商。
# 项目文档导航
## 非目标
## 一句话定位
- MVP 不自动提交订单或支付。
- MVP 不支持淘宝、1688、京东等其他平台。
- MVP 不做后台推送后立即执行；只做 App 手动领取。
- MVP 不做多设备负载均衡、复杂审批、财务对账和退款。
- 不绕过验证码、风控、登录验证、平台限流或权限校验。
- 不承诺对所有拼多多版本和所有商品类目通用。
采购自动化验证系统是一个由管理 Web 端创建任务、Android 采购端领取任务，并通过
AI 辅助完成拼多多检索和候选判断的系统；第一版先验证“创建 -> 领取 -> 搜索 ->
人工确认 -> 回传”的最小闭环。
VLM 和拼多多工作流在手机本地执行；管理后端只负责任务控制、取消和结果审计。
## 核心文档
- [`../AGENTS.md`](/chengma/mroubao/src/commit/afc651f75a3abc2676bb13aa8a80f6aa6a25a72e/AGENTS.md)：AI coding agent 的仓库级权威规则。
- [`00-ai-start-here.md`](/chengma/mroubao/wiki/00-ai-start-here.-)：每次开发的入口和开工流程。
- [`01-vision.md`](/chengma/mroubao/wiki/01-vision.-)：目标用户、价值、产品原则和非目标。
- [`02-requirements.md`](/chengma/mroubao/wiki/02-requirements.-)：MVP 范围、验收标准和待确认事项。
- [`07-user-stories.md`](/chengma/mroubao/wiki/07-user-stories.-)：角色目标和业务验收场景。
- [`08-interaction-checklist.md`](/chengma/mroubao/wiki/08-interaction-checklist.-)：Web 与 Android 的界面行为。
- [`03-tech-stack.md`](/chengma/mroubao/wiki/03-tech-stack.-)：已定技术选型、待验证项和计划命令。
- [`04-architecture.md`](/chengma/mroubao/wiki/04-architecture.-)：系统边界、数据流、状态机和数据模型。
- [`api.md`](/chengma/mroubao/wiki/api)：管理端和 App 共用的 API 合约。
- [`routes.md`](/chengma/mroubao/wiki/routes)：管理 Web 路由和 Android 页面结构。
- [`05-coding-rules.md`](/chengma/mroubao/wiki/05-coding-rules.-)：编码、安全和验证硬规则。
- [`06-tasks.md`](/chengma/mroubao/wiki/06-tasks.-)：只读路线图和建议任务拆分。
- [`tasks/README.md`](/chengma/mroubao/wiki/Tasks)：一任务一文件的默认执行协议。
- [`current-state.md`](/chengma/mroubao/wiki/current-state.-)：当前仓库现实和 blocker。
## Harness 辅助文档
- [`agent-context.json`](/chengma/mroubao/src/commit/afc651f75a3abc2676bb13aa8a80f6aa6a25a72e/docs/agent-context.json)：机器可读的按任务类型文档路由。
- [`agent-context.md`](/chengma/mroubao/wiki/agent-context.-)：上下文清单的使用方式。
- [`clean-state-checklist.md`](/chengma/mroubao/wiki/clean-state-checklist.-)：每轮结束前检查项。
- [`design/README.md`](/chengma/mroubao/wiki/Design)：P0 页面低保真原型约定。
- [`../progress.md`](/chengma/mroubao/src/commit/afc651f75a3abc2676bb13aa8a80f6aa6a25a72e/progress.md)：可选的项目级大事记。
- [`../init.ps1`](/chengma/mroubao/src/commit/afc651f75a3abc2676bb13aa8a80f6aa6a25a72e/init.ps1) / [`../init.sh`](/chengma/mroubao/src/commit/afc651f75a3abc2676bb13aa8a80f6aa6a25a72e/init.sh)：标准验证入口；当前等待
`T-001` 写入真实命令。
## 文档职责
- “做不做、怎么算完成”以 `02-requirements.md` 为准。
- “谁要获得什么结果”以 `07-user-stories.md` 为准。
- “界面如何反馈”以 `08-interaction-checklist.md` 为准。
- “系统如何分层、状态如何变化”以 `04-architecture.md` 为准。
- “接口字段和错误”以 `api.md` 为准。
- “当前代码是否存在、什么命令能跑”以 `current-state.md` 和真实验证结果为准。
- 任务规格、状态和证据以 `docs/tasks/T-<编号>.md` 为准。
需求或架构变化时同步所有受影响的文档，不允许代码独自形成另一套事实。
具体范围与验收见[需求](/chengma/mroubao/wiki/02-requirements.-)。