docs: 切换 GUI 选型为 PySide6

2026-06-26 16:09:09 +08:00
parent ccb4d52d9f
commit 92735ae7a4
11 changed files with 90 additions and 34 deletions
@@ -169,4 +169,15 @@
  - CDP 已验证事实统一引用 `docs/04-architecture.md` 第七节。
 - 下一步：继续处理剩余全栈落地缺口，如 SQLite/Excel schema、GUI 线程模型、AI 接入任务依赖。

+## 【2026-06-26】决策 · GUI 框架改为 PySide6
+
+- 状态：DONE（仅文档）
+- 变更：更新 `docs/03-tech-stack.md`、`docs/04-architecture.md`、`docs/routes.md`、`docs/06-tasks.md`、`docs/api.md`、`docs/00-ai-start-here.md`、`docs/02-requirements.md`、`docs/05-coding-rules.md`、`docs/current-state.md`、`docs/README.md`。
+- 决策：
+  - V1 GUI 框架固定为 PySide6（Qt for Python），不再使用 Tkinter。
+  - 理由：当前环境已安装 PySide6，Tkinter 不可导入；V1 需要表格、图片预览、后台任务进度、停止按钮、确认弹窗，Qt 的 `QThread` + signal/slot 更适合。
+  - GUI 线程模型：主线程只操作 Qt widget；采集/生成/更新/回写使用 `QObject` worker + `QThread`；worker 通过 signal 回传 `progress/log/row_updated/failed/finished/cancelled`；worker 不直接操作 QWidget，不跨线程共享 SQLite connection。
+  - 新增 `workers.py` 作为可选模块承载 PySide6 worker/QThread 编排。
+- 下一步：继续处理 SQLite/Excel schema 与 AI 接入任务依赖。
+
 <!-- 新一轮从这里向下追加记录。 -->