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>
34 lines
1.9 KiB
Markdown
34 lines
1.9 KiB
Markdown
# 项目文档导航
|
||
|
||
## 一句话定位
|
||
|
||
拼多多批量下单执行器是一个给内部运营同事使用的 Windows 桌面工具，用于从固定表头 Excel 导入已审核的商品下单任务，按选中顺序控制一台 Android 真机在拼多多 App 中下单，并把执行状态、订单号和失败原因回写到 Excel 结果文件。
|
||
|
||
第一版先完成「导入 Excel -> GUI 展示任务 -> 控制真机下单 -> 默认支付前人工确认，可配置受控自动支付 -> 记录订单号或失败原因 -> 回写 Excel」闭环。
|
||
|
||
## 文档导航
|
||
|
||
- [AI 开发入口](00-ai-start-here.md)：agent 每次开始工作的入口、阅读顺序和任务领取规则。
|
||
- [项目愿景](01-vision.md)：为什么做、为谁做、产品原则、非目标。
|
||
- [需求](02-requirements.md)：MVP 要什么、用户故事、验收标准，不写技术实现。
|
||
- [技术栈](03-tech-stack.md)：确定使用哪些框架、库、设备依赖和运行方式。
|
||
- [架构设计](04-architecture.md)：系统结构、模块职责、数据模型、关键风险和开发顺序。
|
||
- [编码规则](05-coding-rules.md)：AI 写代码前必须遵守的硬约束。
|
||
- [任务看板](../tasks.md)：按依赖拆分的小任务，agent 每轮只做一个。
|
||
- [执行进度](../progress.md)：任务完成记录、验证结果、阻塞点和下一步。
|
||
- [本地模块合约](api.md)：无后端 API 时的本地模块接口约定。
|
||
- [界面结构](routes.md)：桌面 GUI 页面/区域职责。
|
||
- [当前实现状态](current-state.md)：仓库现实状态、代码结构、真实运行命令。
|
||
|
||
## 维护原则
|
||
|
||
- 需求变化先改文档，再改代码。
|
||
- 代码现实变化后同步 `current-state.md`；任务执行记录写入 [`../progress.md`](../progress.md)。
|
||
- Excel 字段、任务状态、模块接口一旦在文档中定稿，代码不得另起一套。
|
||
- agent 开始新任务前，必须从 `00-ai-start-here.md` 进入。
|
||
|
||
|
||
|
||
|
||
|