chengmaandClaude Opus 4.8
541dfab967
建立 harness coding 文档体系并完成一致性修正： - 文档集：AGENTS.md/CLAUDE.md 入口，docs/00-05 规范文档， api.md/routes.md/current-state.md，根目录 tasks.md/progress.md。 - 一致性补丁：TaskStatus 中英映射、支付模式收敛为全局 PaymentConfig、 执行器级 RunnerState 暂停语义、progress 与 current-state 职责边界。 - 工程地基：新增 .gitignore，忽略运行产物/敏感数据与 .claude 本地设置。 - 合规留痕：02 需求新增平台规则与合规风险条目。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2.9 KiB
2.9 KiB
项目愿景
一、核心目标
拼多多批量下单执行器要解决：内部运营同事需要根据 Excel 中的商品链接和 SKU 信息，重复在拼多多 App 中手动选择规格、下单、记录订单号，流程耗时且容易漏记的问题。
让运营同事能够从 Excel 批量导入已审核下单任务，使用桌面 GUI 控制 Android 真机执行下单，并把订单号、状态和失败原因回写到结果表。
它不是电商平台后台，也不是自动抢购工具，而是一个为内部合规运营流程服务的批量下单执行工具。
二、目标用户
- 运营同事：导入已审核 Excel、勾选任务、启动执行、配置支付模式、查看订单号和失败原因。
- 开发/维护人员：维护 SKU 选择规则、页面状态识别、异常处理和设备连接能力。
- 管理人员：通过运营整理后的 Excel 历史文档查看下单结果和异常情况。
三、产品原则
遇到取舍时，以这些原则为准：
- 受控自动化优先：Excel 数据已由运营审核时，可以自动下单；支付默认人工确认，也可在金额、SKU、数量、地址二次校验通过后按配置自动支付。
- 安全校验转人工：验证码、风控、人脸、短信等安全校验环节必须人工接管，不做绕过。
- 核心流程优先：先跑通单机、单设备、单账号、固定 Excel 表头的最小闭环。
- 真实设备优先：基于真实 Android 真机和拼多多 App 行为验证，不用模拟假流程冒充成功。
- 可排查优先：每条任务必须有状态、失败原因、截图或页面 XML 线索。
- Excel 兼容运营习惯：MVP 不强行引入数据库，结果回写到 Excel 便于后续整理。
- 小步交付：先验证最高风险链路，再接入 GUI 和批量任务。
四、核心价值主张
| 价值点 | 说明 |
|---|---|
| 降低重复劳动 | 运营只需维护已审核 Excel 和处理异常节点，减少反复打开链接、选择 SKU、支付、复制订单号。 |
| 减少漏记错记 | 成功订单号、失败原因、执行时间统一写回结果文件。 |
| 易于落地 | 桌面 GUI 直接运行在连接手机的 Windows 电脑上，不需要部署后端服务。 |
| 可审计排查 | 保存任务日志、截图、页面 XML，便于定位 SKU 不匹配、页面变化或风控问题。 |
五、不做什么（非目标）
- 不做绕过验证码、风控、人脸、短信、安全校验或平台限制的能力。
- 不做无配置、无金额上限、无二次校验的自动支付。
- 不做拼多多非公开接口调用、逆向协议或账号风控规避。
- 不做 Web 后台、多用户权限、多设备调度，除非后续版本明确升级。
- 不做 Excel 历史数据分析系统，运营后期可基于结果 Excel 自行整理。
MVP 的具体功能范围与验收标准，见 需求。