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
+6 -7
View File
@@ -1,25 +1,24 @@
# prototypes —— 已验证原型 / 探查脚本
这些是单账号阶段写的**已验证脚本**,逻辑与关键事实将被正式模块(尤其 `editor.py`,见任务 T-001)移植。
**待 `editor.py` 完成并实测通过后,本目录可清理删除。** 在此之前保留它们作为"唯一已验证参照"。
这些是单账号阶段写的**已验证脚本**,逻辑与关键事实将被正式模块(尤其 `app/editor.py`,见任务 T-001)移植。
**待 `app/editor.py` 完成并实测通过后,本目录可清理删除。** 在此之前保留它们作为"唯一已验证参照"。
## 文件
| 文件 | 用途 | 移植去向 |
| --- | --- | --- |
| `demo.py` | 单账号端到端:改标题 + 换封面(UPDATE=1 提交) | `editor.py` 编排 |
| `demo.py` | 单账号端到端:改标题 + 换封面(UPDATE=1 提交) | `app/editor.py` 编排 |
| `set_title.py` | 改标题(原生 setter + 事件,value/modelvalue 验证) | `editor.change_title` |
| `set_cover.py` | 上传图片 + 拖到第一位设封面(含选择器、拖拽落点) | `editor.replace_cover` |
| `get_title.py` | 找/开商品 tab 并读取标题 | `editor.open_product` / `read_title` |
| `cookies.py` | 读 shopee.tw 标签页 Cookie/会话 | `editor.is_logged_in` 的依据 |
| `inspect_images.py` | 只读探查图片管理器 DOM(**Shopee 改版时重新探查可复用**) | 工具,保留参考 |
| `grab.py` | 抓商品页 HTML + 列表接口 JSON(早期探查) | 参考 |
| `1.py` | OpenAI SDK 最小调用测试 | `ai.py` 调用方式参考 |
| `1.py` | OpenAI SDK 最小调用测试 | `app/ai.py` 调用方式参考 |
## 运行注意
- **`cdp.py` 在项目根目录**(正式模块),不在本目录。
- 仅 `demo.py` `import cdp`;其余脚本各自内置了 CDP 类,可独立运行。
- 跑 `demo.py` 需让根目录的 `cdp.py` 可被导入(从项目根运行,或设 `PYTHONPATH=项目根`)。
- T-000 后正式 CDP 底座在 `app/cdp.py`;`demo.py` 从项目根运行并导入 `app.cdp`。
- 其余脚本各自内置了 CDP 类,可独立运行。
- 这些脚本默认连开发期的 WSL 转发地址 `192.168.0.224:9333`;正式模块用 `127.0.0.1:9222`(可用 `CDP_HOST` 覆盖)。
- 已验证的关键事实(选择器、SPA 就绪判断、上传/拖拽方式)权威记录见 [`../docs/04-architecture.md`](../docs/04-architecture.md) 第七节。