cmpdd/docs/current-state.md

# 当前实现状态

> 本文记录代码与任务看板的现实状态，帮助 AI coding agent 避免只看计划而忽略仓库现状。
>
> **职责边界**：本文是**可覆盖的当前快照**——只描述"现在仓库长什么样"（目录、可运行命令、下一个可领取任务），变化时直接改写为最新状态。历史执行流水、每轮验证结果和阻塞记录写入 [`../progress.md`](../progress.md)，本文不保留历史条目。

## 当前快照

- 日期：2026-06-24
- 阶段：Phase 0 地基（T-001、T-002、T-003 完成）/ 进入 Phase 1 原型验证
- 技术栈：Python 3.10（骨架已跑通）；计划接入 PySide6 + `uiautomator2` + ADB + `openpyxl`
- 生产代码：骨架 + 核心数据模型 + 运行时基建（`src/main.py` 入口、`src/core/` 模型与状态、`src/logging_config.py` 日志、`src/paths.py` 产物路径）
- 测试：标准库 `unittest`，覆盖冒烟、核心模型、日志与产物路径（`tests/` 下 4 个测试文件）
- 数据：尚未提供真实 Excel 样例

## 当前目录要点

| 路径 | 状态 | 说明 |
| --- | --- | --- |
| `docs/` | 已有 | 项目规范化文档，已按 harness coding 文档风格建立。 |
| `src/` | 已有 | `main.py` 入口 + `core/`（状态枚举、任务模型）+ `logging_config.py`、`paths.py`；GUI/执行器/Excel/Android 模块后续添加。 |
| `tests/` | 已有 | `test_smoke`、`test_models`、`test_paths`、`test_logging`（unittest）。 |
| `requirements.txt` | 已有 | 依赖清单；当前零第三方运行时依赖，含依赖纪律注释。 |
| `samples/` | 待建 | 脱敏 Excel 样例。 |
| `logs/` | 运行时创建 | `app.log` 运行日志；被 `.gitignore` 忽略。 |
| `artifacts/` | 运行时创建 | 截图、UI XML 等运行产物；被 `.gitignore` 忽略。 |

## 任务与进度状态

任务定义以 [`../tasks.md`](../tasks.md) 为准，执行记录以 [`../progress.md`](../progress.md) 为准。

- 已完成：项目文档初始化；`T-001`、`T-002`、`T-003`（Phase 0 地基全部完成）。
- 正在进行：无。
- 下一个可领取任务：`T-101 验证 ADB 和 uiautomator2 真机连接`（Phase 1，需真机环境）。

## 当前可运行内容

骨架已可运行（T-001）。真实命令（Windows 用 `python`，Linux/WSL 用 `python3`）：

```powershell
# 本地运行入口
python -m src.main

# 测试
python -m unittest discover -s tests -t .

# 语法检查
python -m compileall src
```

## 已确认产品决策

- 第一版使用桌面 GUI，不做 Web 后台。
- 第一版通过固定表头 Excel 导入任务，并回写结果 Excel。
- 第一版控制单台 Android 真机，使用 `uiautomator2 + ADB` 做最小可行性验证。
- 第一版默认人工确认支付，并预留受控自动支付：必须显式开启，且通过金额上限、商品/SKU/数量/地址二次校验；安全校验、验证码、风控、人脸、短信等节点必须人工接管。
- 默认不覆盖原始 Excel，生成 `_执行结果.xlsx`。

## 待用户提供 / 待验证

- 真实 Excel 表头样例。
- 一台可连接的 Android 真机。
- ADB 可用环境。
- 已登录拼多多账号的真机状态。
- 至少一个用于测试的拼多多商品链接和 SKU 信息。

## 开始编码前检查

开始任意任务前：

1. 读仓库级 agent 规则文件（如有）。
2. 读 `docs/00-ai-start-here.md`。
3. 读 `docs/05-coding-rules.md`。
4. 在 `../tasks.md` 取第一个 `TODO` 且依赖均 `DONE` 的任务。
5. 将该任务状态改为 `DOING`。

## 维护规则

当实际代码状态发生变化时，同步更新本文件：

- 新增或移动入口文件。
- 初始化框架或模块。
- 任务从 `TODO` 进入 `DOING` 或 `DONE` 时，同步 `../tasks.md` 和 `../progress.md`。
- 新增可运行命令。
- 发现文档和代码现实不一致。