docs: 规划正式代码包结构

将正式代码目标结构统一为 app/ 包和根目录 main.py,区分 app/ 正式代码与 prototypes/ 原型参照。

新增 T-000 作为首个实现任务:创建 app 包、迁移 cdp.py、补 app/__main__.py 与 main.py、修正 prototypes/demo.py 导入。

更新模块合约、技术栈、编码规则和 current-state:后续模块路径改为 app/editor.py、app/appconfig.py、app/db.py 等,启动方式为 python main.py 或 python -m app。
This commit is contained in:
chengma
2026-06-26 17:05:18 +08:00
parent 5c6fd0ff98
commit 917656f205
10 changed files with 92 additions and 57 deletions
+2 -2
View File
@@ -25,7 +25,7 @@ cmshopee 是一个 **Windows 本地桌面自动化工具**:管理多个 Shopee
## 工作规则
- 复用已有 `cdp.py`,遵守架构第七节的选择器、就绪判断、上传/拖拽方式,不另起一套 CDP 交互。
- 正式代码统一放入 `app/` 包;迁移完成后复用 `app/cdp.py`,遵守架构第七节的选择器、就绪判断、上传/拖拽方式,不另起一套 CDP 交互。
- 只做当前任务范围内的事;V2(多账号并行、dry-run、运行日志)只记录不实现。
- CDP 选择器 / 流程 / 配置 schema 变化,必须同步更新 `docs/04-architecture.md` 与相关任务。
- 改完后更新任务状态、追加 `progress.md`、覆盖 `docs/current-state.md`。
@@ -40,7 +40,7 @@ cmshopee 是一个 **Windows 本地桌面自动化工具**:管理多个 Shopee
## 验证
```bash
python -m py_compile *.py # 语法检查
python -m compileall app main.py # 语法检查(T-000 后)
python -m unittest discover -s tests # 纯逻辑单元测试(T-006 完成且 tests/ 存在后)
python prototypes/demo.py # 单账号闭环(不提交)
```