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
2026-06-24 17:02:15 +08:00
co-authored by Claude Opus 4.8
parent 541dfab967
commit 2863bf2750
11 changed files with 106 additions and 35 deletions
+12 -11
View File
@@ -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