diff --git a/01-vision.-.md b/01-vision.-.md deleted file mode 100644 index d3c0a10..0000000 --- a/01-vision.-.md +++ /dev/null @@ -1,49 +0,0 @@ - -> 同步来源：[`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)。 diff --git a/unnamed.md b/unnamed.md index d55ad25..878de8c 100644 --- a/unnamed.md +++ b/unnamed.md @@ -1,176 +1,49 @@ - -> 同步来源：[`docs/README.md`](/chengma/mroubao/src/commit/afc651f75a3abc2676bb13aa8a80f6aa6a25a72e/docs/README.md) · commit `afc651f75a3a` + +> 同步来源：[`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.-)。