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>
3.0 KiB
3.0 KiB
当前实现状态
本文记录代码与任务看板的现实状态，帮助 AI coding agent 避免只看计划而忽略仓库现状。
职责边界：本文是可覆盖的当前快照——只描述"现在仓库长什么样"（目录、可运行命令、下一个可领取任务），变化时直接改写为最新状态。历史执行流水、每轮验证结果和阻塞记录写入
../progress.md，本文不保留历史条目。
当前快照
- 日期：2026-06-24
- 阶段：MVP 起步 / 原型验证前
- 技术栈：计划使用 Python + PySide6 +
uiautomator2+ ADB +openpyxl - 生产代码：尚未初始化
- 测试：尚未初始化
- 数据：尚未提供真实 Excel 样例
当前目录要点
| 路径 | 状态 | 说明 |
|---|---|---|
docs/ |
已有 | 项目规范化文档，已按 harness coding 文档风格建立。 |
src/ |
待建 | 桌面 GUI、任务执行器、Excel、Android 自动化代码。 |
tests/ |
待建 | Excel 解析、状态机、SKU 匹配等测试。 |
samples/ |
待建 | 脱敏 Excel 样例。 |
logs/ |
待建 | 本地运行日志。 |
artifacts/ |
待建 | 截图、UI XML、结果文件等运行产物。 |
任务与进度状态
任务定义以 ../tasks.md 为准，执行记录以 ../progress.md 为准。
- 已完成：项目文档初始化。
- 正在进行：无。
- 下一个可领取任务：
T-001 初始化 Python 项目骨架。
当前可运行内容
当前没有可运行代码。初始化后应补充真实命令：
# 本地开发
python src/main.py
# 测试
python -m pytest
# 语法检查
python -m compileall src
已确认产品决策
- 第一版使用桌面 GUI，不做 Web 后台。
- 第一版通过固定表头 Excel 导入任务，并回写结果 Excel。
- 第一版控制单台 Android 真机，使用
uiautomator2 + ADB做最小可行性验证。 - 第一版默认人工确认支付，并预留受控自动支付：必须显式开启，且通过金额上限、商品/SKU/数量/地址二次校验；安全校验、验证码、风控、人脸、短信等节点必须人工接管。
- 默认不覆盖原始 Excel，生成
_执行结果.xlsx。
待用户提供 / 待验证
- 真实 Excel 表头样例。
- 一台可连接的 Android 真机。
- ADB 可用环境。
- 已登录拼多多账号的真机状态。
- 至少一个用于测试的拼多多商品链接和 SKU 信息。
开始编码前检查
开始任意任务前：
- 读仓库级 agent 规则文件（如有）。
- 读
docs/00-ai-start-here.md。 - 读
docs/05-coding-rules.md。 - 在
../tasks.md取第一个TODO且依赖均DONE的任务。 - 将该任务状态改为
DOING。
维护规则
当实际代码状态发生变化时，同步更新本文件：
- 新增或移动入口文件。
- 初始化框架或模块。
- 任务从
TODO进入DOING或DONE时，同步../tasks.md和../progress.md。 - 新增可运行命令。
- 发现文档和代码现实不一致。