docs: define T-531 settings dirty-state flow

2026-07-06 10:56:42 +08:00
parent b99019e954
commit 26e59c8cea
5 changed files with 18 additions and 7 deletions
@@ -1150,4 +1150,10 @@
 - 边界：未改 AI HTTP 协议、DB schema、Excel、Shopee/CDP 流程；direct 兼容路径不变。
 - 测试：新增 appconfig URL 规整测试、ai 404 `not_found` 测试、GUI Base URL 提示/保存归一断言。
 - 验证：`python -m compileall app main.py` 通过；`python -m unittest discover -s tests` 通过（189 tests）。全量 GUI 测试仍有本机 PySide6 字体目录提示，不影响结果。
- 下一步：T-525「引入 ruff（lint + format）+ 可选 pre-commit」。
+- 下一步：T-525「引入 ruff（lint + format）+ 可选 pre-commit」。
+## 【2026-07-06】文档修正 · T-531 设置未保存提示方案收口
+
+- 背景：Claude Code 已在任务看板新增 T-531，用于解决⑤设置页填写 cmhub Base URL/API Key 后没有未保存提示、切 Tab/关闭窗口会静默丢输入的问题。
+- 修正：认可“显式保存 + 脏状态追踪 + 离开确认”方案，不做自动保存；补充 `save_app_settings()` 成功/失败返回语义、放弃必须重新从 `config.json` 与 `config/cmhub.json` 回填、程序化回填不置脏、`currentChanged` 回退需 guard 防递归、刷新别名/测试连接成功只提醒保存不落盘。
+- 文档：同步 `docs/06-tasks.md`、`docs/current-state.md`、`docs/routes.md`、`docs/api.md`；下一个可领取任务改为 T-531，T-525 ruff 顺延。
+- 验证：文档-only 更新，未运行单元测试。