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:
@@ -34,7 +34,7 @@ cmshopee 是一个 Windows 本地桌面自动化工具(PySide6,5 Tab),
|
||||
|
||||
优先路径:
|
||||
|
||||
1. Phase 0:把已验证流程模块化(`editor.py`),建立 `config.json` 与 SQLite。
|
||||
1. Phase 0:先建立正式代码包 `app/` 与根入口 `main.py`,再把已验证流程模块化到 `app/editor.py`,建立 `config.json` 与 SQLite。
|
||||
2. Phase 1:账号绑定 user-data-dir、Chrome 启动、登录保活、PySide6 主窗口骨架。
|
||||
3. Phase 2:导入 Excel、采集旧标题/旧封面并回写。
|
||||
4. Phase 3:AI 生成新标题/新封面。
|
||||
@@ -61,7 +61,7 @@ cmshopee 是一个 Windows 本地桌面自动化工具(PySide6,5 Tab),
|
||||
|
||||
- 单账号已登录 Chrome,通过 CDP 打开商品页、改标题、换封面。
|
||||
- 原型脚本默认不提交线上,`UPDATE=1` 才点击「更新」。
|
||||
- 作为 `editor.py` 的已验证参照,不再代表当前完整产品范围。
|
||||
- 作为 `app/editor.py` 的已验证参照,不再代表当前完整产品范围。
|
||||
|
||||
**V1 当前 coding 目标**:
|
||||
|
||||
@@ -86,7 +86,7 @@ cmshopee 是一个 Windows 本地桌面自动化工具(PySide6,5 Tab),
|
||||
- [`04-architecture.md`](04-architecture.md) 第七节:CDP 交互已验证结论(选择器、就绪判断、上传/拖拽方式)。
|
||||
- [`04-architecture.md`](04-architecture.md) 5.1/5.1b/5.2/5.3:`config.json`、`config/ai_models.json`、SQLite schema、Excel 模板。
|
||||
- 真实页面探查结果(用 `prototypes/inspect_images.py` / `prototypes/cookies.py` 实地确认)。
|
||||
- 已验证脚本 `cdp.py`、`prototypes/demo.py`、`prototypes/set_title.py`、`prototypes/set_cover.py` 中跑通的逻辑。
|
||||
- 已验证脚本 `cdp.py`(T-000 后迁入 `app/cdp.py`)、`prototypes/demo.py`、`prototypes/set_title.py`、`prototypes/set_cover.py` 中跑通的逻辑。
|
||||
|
||||
不要把以下当事实来源:
|
||||
|
||||
@@ -106,7 +106,7 @@ cmshopee 是一个 Windows 本地桌面自动化工具(PySide6,5 Tab),
|
||||
|
||||
- 先看 `04-architecture.md` 第七节已验证事实。
|
||||
- 再看 `api.md` 的 `cdp` / `editor` 模块合约。
|
||||
- 复用 `cdp.py`,不重写一套。
|
||||
- 复用 `app/cdp.py`(迁移前参考根目录 `cdp.py`),不重写一套。
|
||||
|
||||
做账号配置 / Chrome 启动:
|
||||
|
||||
@@ -116,7 +116,7 @@ cmshopee 是一个 Windows 本地桌面自动化工具(PySide6,5 Tab),
|
||||
## 验证命令
|
||||
|
||||
```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 # 单账号闭环验证(分步,不提交)
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user