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。

docs/04-architecture.md

@@ -34,8 +34,8 @@ Shopee 卖家中心页面 / 本地图片目录
 
 真实组件：
 
-- GUI 入口：`gui.py`（待建，PySide6 + `QMainWindow` + `QTabWidget`，5 Tab）。
-- 核心模块：`appconfig.py`、`db.py`、`excel.py`、`config.py`、`chrome.py`、`editor.py`、`ai.py`（待建）；CDP 底座 `cdp.py`（已有）。
+- GUI 入口：根目录 `main.py` 调用 `app/gui.py`（待建，PySide6 + `QMainWindow` + `QTabWidget`，5 Tab）；也支持 `python -m app`。
+- 核心模块统一放在正式代码包 `app/`：`appconfig.py`、`db.py`、`excel.py`、`config.py`、`chrome.py`、`editor.py`、`ai.py`、`prompts.py`、`workers.py`（待建）；CDP 底座迁入 `app/cdp.py`（当前根目录 `cdp.py` 为已验证来源）。
 - 已验证脚本（重构进模块）：`prototypes/demo.py`、`prototypes/set_title.py`、`prototypes/set_cover.py`、`prototypes/get_title.py`、`prototypes/cookies.py`、`prototypes/inspect_images.py`、`prototypes/grab.py`。
 - 外部依赖：本机 Google Chrome；Shopee；AI 服务（文本+图像，服务商待定）；`openpyxl`。
 
@@ -338,7 +338,7 @@ images/<slug>/<item_id>_new.<ext>    # AI 生成的新封面
 
 ## 八、推荐开发顺序
 
-1. **地基**：`editor.py`（含采集）、`appconfig.py`+`config.json`、`db.py`、`.gitignore`。
+1. **地基**：先建 `app/` 包、`app/cdp.py`、`app/__main__.py`、根目录 `main.py`；再做 `app/editor.py`（含采集）、`app/appconfig.py`+`config.json`、`app/db.py`、`.gitignore`。
 2. **账号与启动**（④）：`config` 建目录、`chrome` 启动器/快捷方式、登录保活与检测、账号 CRUD。
 3. **导入采集**（①）：`excel` 导入、采集旧标题/旧封面、回写。
 4. **AI 生成**（②）：`ai` 模块、提示词、对照预览。
@@ -350,6 +350,13 @@ images/<slug>/<item_id>_new.<ext>    # AI 生成的新封面
 ```text
 cmshopee/
 ├── docs/
+├── app/
+│   ├── __init__.py
+│   ├── __main__.py            # 支持 python -m app
+│   ├── cdp.py                 # CDP 底座（由根目录 cdp.py 迁入）
+│   ├── appconfig.py / db.py / excel.py / config.py / chrome.py
+│   ├── editor.py / ai.py / prompts.py / gui.py / workers.py
+├── main.py                    # GUI 启动入口：from app.gui import main
 ├── config.json               # 应用配置（模型选择/生成参数/路径，gitignore）
 ├── config/ai_models.json     # AI 模型清单（含密钥，必须 gitignore）
 ├── cmshopee.db               # SQLite（账号/任务/结果，gitignore）
@@ -357,11 +364,8 @@ cmshopee/
 ├── images/                   # 旧封面/新封面本地图片（gitignore）
 ├── title_prompt.txt          # 标题提示词（单文件，启动回显）
 ├── prompts/cover/<名称>.txt  # 封面提示词模板（多个）
-├── appconfig.py / db.py / excel.py / config.py / chrome.py / editor.py / ai.py / prompts.py / gui.py   # 待建
-├── workers.py                 # PySide6 worker/QThread 编排（可选拆分）
-├── cdp.py                    # CDP 底座（正式模块，已有）
 └── prototypes/               # 已验证原型/探查脚本（demo/set_*/get_title/cookies/inspect_images/grab/1.py）
-                              # 逻辑待并入 editor.py 后清理；见 prototypes/README.md
+                              # 逻辑待并入 app/editor.py 后清理；见 prototypes/README.md
 ```
 
 > `config.json`、`config/ai_models.json`、`cmshopee.db`、`chrome_user_data_dir/`、`images/` 含密钥/凭证/业务数据，必须 gitignore。
@@ -369,6 +373,8 @@ cmshopee/
 ## 十、架构纪律
 
 - CDP 交互事实变化同步第七节。
+- 正式代码只放 `app/` 包；根目录只保留 `main.py`、配置/数据目录、文档和原型目录，不新增正式业务模块。
+- `app` 包内模块优先用相对导入（如 `from .cdp import CDP`）；根入口 `main.py` 用 `from app.gui import main`。
 - 存储边界：应用设置→config.json，账号/任务/结果→SQLite，图片→本地目录并记路径于 DB，登录态→user-data-dir；同一事实只存一处。
 - 别名是账号↔任务唯一关联键。
 - 密码与 AI Key 本地明文保存、UI 打码、不外传、不写日志；不自动登录。