docs: 切换 GUI 选型为 PySide6

docs/03-tech-stack.md

@@ -13,7 +13,7 @@
 | WebSocket | `websocket-client`（import `websocket`） | 已定 | 讲 CDP 协议；用 `suppress_origin=True` 绕过 403 |
 | HTTP | `requests` | 已定 | 读 `/json` 拿 tab 列表；`trust_env=False` 忽略代理 |
 | 浏览器 | Google Chrome（已安装） | 已定 | 带 `--remote-debugging-port` 启动 |
-| GUI 框架 | Tkinter（标准库，`ttk.Notebook` 5 Tab） | 待定（推荐） | 零依赖、单机够用；如需更现代 UI 再评估 PySide6 / Web |
+| GUI 框架 | PySide6（Qt for Python，`QTabWidget` 5 Tab） | 已定 | 当前环境已安装 PySide6；V1 需要表格、图片预览、后台任务进度、确认弹窗，Qt 的 signal/slot + QThread 更适合 |
 | 应用配置 | `config.json`（JSON，stdlib） | 已定 | 少量应用级设置：Chrome 路径、目录根、端口、DB 路径等 |
 | 业务数据 | SQLite（stdlib `sqlite3`，`cmshopee.db`） | 已定 | 账号、任务、结果：成行增长、要查询/统计/导出 |
 | Excel 读写 | `openpyxl` | 已定 | 导入任务、回写结果；stdlib 读不了 .xlsx |
@@ -27,7 +27,7 @@
 ## 二、决策记录与演进
 
 - **CDP 自研而非 playwright**：当前手写 `cdp.py`，因为它零重依赖、完全可控，并已在开发环境绕开了代理（`*_proxy` 指向本地 :1080）和 Chrome 的 Origin 403 两个坑。未来若交互复杂度大幅上升，再评估 playwright。
-- **GUI 选 Tkinter**：V1 是单机配置 + 触发操作的轻量界面，Tkinter 零依赖即可。若后续需要表格、拖拽、复杂布局，再评估 PySide6。**该选型在动代码前需维护者确认。**
+- **GUI 选 PySide6**：V1 是 5 Tab 运营工作台，包含任务表格、筛选、图片预览、后台采集/生成/更新、进度与停止。当前环境已安装 PySide6，且 Tkinter 不可用；Qt 的 `QThread`/signal-slot 比 Tkinter 手动 queue/after 更适合长任务回传 UI。
 - **存储拆两层**：应用设置进 `config.json`，账号/任务/结果进 SQLite。判据：少量人改无需查询 → 配置文件；成行增长要查询/导出 → DB。同一事实只存一处，不重复。取代早期的 `accounts.json` 方案。
 - **Excel 用 openpyxl**：运营用真实 .xlsx；stdlib 无法读写 xlsx，引入一个轻依赖比改用 CSV 更贴合用户习惯。
 - **多账号隔离用独立 user-data-dir，不用 Chrome profile**：profile 共享同一 user-data-dir/进程/调试端口，无法每账号独立 CDP 与并行；独立 user-data-dir 才契合自动化。详见 [架构 3.0](04-architecture.md)。
@@ -41,7 +41,8 @@
 
 | 用途 | 命令 |
 | --- | --- |
-| 安装依赖 | `pip install websocket-client requests openpyxl` |
+| 安装依赖 | `pip install websocket-client requests openpyxl pillow PySide6` |
+| 检查 PySide6 | `python -c "import PySide6; print(PySide6.__version__)"` |
 | 语法检查 | `python -m py_compile *.py` |
 | 跑单账号演示 | `python prototypes/demo.py`（分步）/ `set AUTO=1 && python prototypes/demo.py`（自动） |
 | 提交更新（真改线上） | `set UPDATE=1 && python prototypes/demo.py` |
@@ -63,6 +64,6 @@ set AUTO=1 && python prototypes/demo.py
 ## 四、依赖纪律
 
 - 新增第三方依赖前，先在本文说明用途、替代方案和维护成本。
-- GUI 框架一旦确定（Tkinter 或其他），固定下来，不允许两套 UI 框架并存。
+- GUI 框架固定为 PySide6，不允许混入 Tkinter/PyQt/Web 形成两套 UI。
 - 不引入第二套浏览器自动化方案（不要 cdp.py 之外再混入 selenium/playwright）。
 - 不确定的技术选型先更新本文，再进入代码。