chengma
917656f205
将正式代码目标结构统一为 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。
prototypes —— 已验证原型 / 探查脚本
这些是单账号阶段写的已验证脚本，逻辑与关键事实将被正式模块（尤其 app/editor.py，见任务 T-001）移植。
待 app/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 最小调用测试 | app/ai.py 调用方式参考 |
运行注意
- 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第七节。