feat(T-001): 初始化 Python 项目骨架
- 建立 src/（main.py 最小可运行入口）、tests/（unittest 冒烟测试）、requirements.txt。 - 骨架阶段测试用标准库 unittest，零第三方依赖；pytest 留待后续按需引入。 - 文档占位符验证命令替换为真实命令（pytest -> unittest discover）。 - 同步 tasks.md（T-001 DONE）、progress.md、current-state.md。 验证：compileall OK；unittest 2 passed；python src/main.py exit=0。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
chengma
co-authored by
Claude Opus 4.8
Claude Opus 4.8
parent
541dfab967
commit
2863bf2750
@@ -18,7 +18,7 @@
|
||||
4. [`04-architecture.md`](04-architecture.md)：系统结构、职责划分、数据模型和关键难点。
|
||||
5. [`05-coding-rules.md`](05-coding-rules.md)：写代码前必须遵守的规则。
|
||||
6. [`../tasks.md`](../tasks.md)：领取本轮唯一任务。
|
||||
7. [current-state.md](current-state.md)：当前代码现实、可运行命令、下一步入口。
|
||||
7. [current-state.md](current-state.md)：当前代码现实、可运行命令、下一步入口。
|
||||
8. [../progress.md](../progress.md)：历史执行进度、验证结果和阻塞点。
|
||||
|
||||
如果仓库根目录有 `AGENTS.md`、`CLAUDE.md` 或其他 agent 规则文件，也必须先读。仓库级规则优先于项目局部建议。
|
||||
@@ -55,7 +55,7 @@ MVP 只做：
|
||||
- 运营勾选任务并按当前排序顺序执行。
|
||||
- 通过 `uiautomator2 + ADB` 控制一台已登录拼多多账号的 Android 真机。
|
||||
- 打开商品链接，跳转拼多多 App，识别页面状态，选择指定 SKU 和数量。
|
||||
- 默认到支付确认或需要人工输入的位置暂停，支持人工接管后继续。
|
||||
- 默认到支付确认或需要人工输入的位置暂停，支持人工接管后继续。
|
||||
- 预留受控自动支付能力：仅在开启配置、金额/SKU/数量/地址二次校验通过、未触发安全校验时继续支付。
|
||||
- 成功后展示订单号，并写入 Excel 结果文件。
|
||||
- 失败时展示失败原因、保留截图和页面 XML 以便排查。
|
||||
@@ -110,12 +110,11 @@ MVP 不做：
|
||||
|
||||
## 验证命令
|
||||
|
||||
当前项目尚未初始化代码。初始化后应在这里补充真实命令：
|
||||
项目骨架已初始化（T-001）。当前可运行的真实验证命令（Windows 运营机用 `python`，Linux/WSL 开发用 `python3`）：
|
||||
|
||||
```powershell
|
||||
# 计划命令，待项目初始化后确认
|
||||
python -m pytest
|
||||
python -m compileall src
|
||||
python -m unittest discover -s tests -t .
|
||||
python src/main.py
|
||||
```
|
||||
|
||||
@@ -126,6 +125,6 @@ python src/main.py
|
||||
- 改 Android 自动化后跑：真机连接测试和最小链路测试。
|
||||
- 如果命令当前不可运行，必须在回复里如实说明原因。
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -17,7 +17,7 @@
|
||||
| 鉴权方式 | 无工具账号 | 已定 | 本地内部工具；拼多多账号由真机 App 登录态承担。 |
|
||||
| 后端服务 | 无独立后端 | 已定 | 单机 GUI 内直接调用本地模块。 |
|
||||
| 日志 | Python `logging` | 已定 | 保存执行日志，便于排查。 |
|
||||
| 测试 | `pytest` | 待定 | 建议用于 Excel 解析、状态机、SKU 匹配等纯逻辑测试。 |
|
||||
| 测试 | 标准库 `unittest`（当前）；`pytest` 后续按需 | 已定（骨架阶段） | 骨架阶段零第三方依赖，用 `unittest`；需参数化/夹具等能力时再按依赖纪律引入 `pytest`。 |
|
||||
| 打包 | PyInstaller | 待定 | MVP 稳定后打包为 Windows 可执行程序。 |
|
||||
|
||||
## 二、决策记录与演进
|
||||
@@ -27,10 +27,11 @@
|
||||
- 当前选择 **Excel 输入输出**，因为运营后期可直接整理历史文档，MVP 不需要数据库。
|
||||
- 当前不引入 **Web 后台 / 多设备调度 / 数据库**，避免第一版复杂度过高。
|
||||
- OCR、图像识别、Appium、SQLite 作为后续选项，仅在真实页面验证需要时引入。
|
||||
- T-001 骨架阶段测试先用**标准库 `unittest`**，不引入 `pytest`：骨架只需冒烟测试，且保持零第三方依赖、不依赖网络即可验证；待出现参数化、夹具、丰富断言等需求时再按依赖纪律引入 `pytest`。
|
||||
|
||||
## 三、构建与运行命令
|
||||
|
||||
当前代码尚未初始化。以下为计划命令，初始化后必须改成真实命令。
|
||||
骨架已初始化（T-001）。以下为真实命令；打包命令待 T-402 落地后确认。
|
||||
|
||||
| 用途 | 命令 |
|
||||
| --- | --- |
|
||||
@@ -38,9 +39,9 @@
|
||||
| 激活虚拟环境 | `.venv\Scripts\Activate.ps1` |
|
||||
| 安装依赖 | `pip install -r requirements.txt` |
|
||||
| 本地运行 | `python src/main.py` |
|
||||
| 测试 | `python -m pytest` |
|
||||
| 测试 | `python -m unittest discover -s tests -t .` |
|
||||
| 语法检查 | `python -m compileall src` |
|
||||
| 打包 | `pyinstaller app.spec` |
|
||||
| 打包（待 T-402） | `pyinstaller app.spec` |
|
||||
|
||||
Windows PowerShell：
|
||||
|
||||
@@ -49,7 +50,7 @@ python -m venv .venv
|
||||
.venv\Scripts\Activate.ps1
|
||||
pip install -r requirements.txt
|
||||
python src/main.py
|
||||
python -m pytest
|
||||
python -m unittest discover -s tests -t .
|
||||
```
|
||||
|
||||
## 四、设备与环境要求
|
||||
@@ -59,7 +60,7 @@ python -m pytest
|
||||
- ADB 可用，电脑能看到设备。
|
||||
- 真机已安装拼多多 App，并已登录可下单账号。
|
||||
- 真机网络稳定，屏幕常亮或执行期间不锁屏。
|
||||
- 支付默认由运营人工确认；开启受控自动支付时，必须由配置、金额上限和二次校验控制。
|
||||
- 支付默认由运营人工确认；开启受控自动支付时，必须由配置、金额上限和二次校验控制。
|
||||
- 验证码、风控、人脸、短信等安全校验节点由运营人工处理。
|
||||
|
||||
## 五、依赖纪律
|
||||
@@ -69,4 +70,4 @@ python -m pytest
|
||||
- 不允许同一职责并存两套框架或两套状态管理方案。
|
||||
- 不允许为了绕过平台安全校验而引入逆向、Hook、抓包改包等依赖。
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -41,7 +41,7 @@
|
||||
- 绝不实现无配置、无二次校验、无金额上限的自动支付。
|
||||
- 绝不记录支付密码、短信验证码、账号密码等敏感信息。
|
||||
- 绝不调用、逆向或改造拼多多非公开接口。
|
||||
- 自动支付必须显式开启，并在商品、SKU、数量、地址、金额校验通过后才能继续。
|
||||
- 自动支付必须显式开启，并在商品、SKU、数量、地址、金额校验通过后才能继续。
|
||||
- 遇到安全校验时进入 `待人工`，由运营在真机上处理。
|
||||
|
||||
## 5. 架构纪律
|
||||
@@ -73,11 +73,11 @@
|
||||
- [ ] 涉及 Android 自动化时，说明是否已用真机验证。
|
||||
- [ ] 回复里如实说明跑了什么命令、结果如何。
|
||||
|
||||
计划命令，初始化后必须改成真实命令：
|
||||
当前真实验证命令（Windows 用 `python`，Linux/WSL 用 `python3`）：
|
||||
|
||||
```powershell
|
||||
python -m pytest
|
||||
python -m compileall src
|
||||
python -m unittest discover -s tests -t .
|
||||
python src/main.py
|
||||
```
|
||||
|
||||
@@ -93,5 +93,5 @@ python src/main.py
|
||||
|
||||
问题要具体，说明你卡在哪里、有哪些选项、倾向哪个选项以及原因。
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
+12
-11
@@ -7,10 +7,10 @@
|
||||
## 当前快照
|
||||
|
||||
- 日期：2026-06-24
|
||||
- 阶段：MVP 起步 / 原型验证前
|
||||
- 技术栈：计划使用 Python + PySide6 + `uiautomator2` + ADB + `openpyxl`
|
||||
- 生产代码：尚未初始化
|
||||
- 测试：尚未初始化
|
||||
- 阶段：Phase 0 地基（T-001 完成）/ 原型验证前
|
||||
- 技术栈：Python 3.10（骨架已跑通）；计划接入 PySide6 + `uiautomator2` + ADB + `openpyxl`
|
||||
- 生产代码：已初始化最小骨架（`src/main.py` 最小入口）
|
||||
- 测试：标准库 `unittest` 冒烟测试（`tests/test_smoke.py`）
|
||||
- 数据：尚未提供真实 Excel 样例
|
||||
|
||||
## 当前目录要点
|
||||
@@ -18,8 +18,9 @@
|
||||
| 路径 | 状态 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| `docs/` | 已有 | 项目规范化文档，已按 harness coding 文档风格建立。 |
|
||||
| `src/` | 待建 | 桌面 GUI、任务执行器、Excel、Android 自动化代码。 |
|
||||
| `tests/` | 待建 | Excel 解析、状态机、SKU 匹配等测试。 |
|
||||
| `src/` | 已有 | 已建最小入口 `src/main.py`；GUI/执行器/Excel/Android 模块由后续任务添加。 |
|
||||
| `tests/` | 已有 | 已建冒烟测试 `tests/test_smoke.py`（unittest）。 |
|
||||
| `requirements.txt` | 已有 | 依赖清单；当前零第三方运行时依赖，含依赖纪律注释。 |
|
||||
| `samples/` | 待建 | 脱敏 Excel 样例。 |
|
||||
| `logs/` | 待建 | 本地运行日志。 |
|
||||
| `artifacts/` | 待建 | 截图、UI XML、结果文件等运行产物。 |
|
||||
@@ -28,20 +29,20 @@
|
||||
|
||||
任务定义以 [`../tasks.md`](../tasks.md) 为准，执行记录以 [`../progress.md`](../progress.md) 为准。
|
||||
|
||||
- 已完成：项目文档初始化。
|
||||
- 已完成：项目文档初始化；`T-001 初始化 Python 项目骨架`。
|
||||
- 正在进行：无。
|
||||
- 下一个可领取任务：`T-001 初始化 Python 项目骨架`。
|
||||
- 下一个可领取任务：`T-002 建立核心数据模型和状态枚举`。
|
||||
|
||||
## 当前可运行内容
|
||||
|
||||
当前没有可运行代码。初始化后应补充真实命令：
|
||||
骨架已可运行（T-001）。真实命令（Windows 用 `python`，Linux/WSL 用 `python3`）：
|
||||
|
||||
```powershell
|
||||
# 本地开发
|
||||
# 本地运行入口
|
||||
python src/main.py
|
||||
|
||||
# 测试
|
||||
python -m pytest
|
||||
python -m unittest discover -s tests -t .
|
||||
|
||||
# 语法检查
|
||||
python -m compileall src
|
||||
|
||||
Reference in New Issue
Block a user