feat: complete T-528 cmhub billing feedback

progress.md

@@ -1124,4 +1124,14 @@
 - 测试：`tests/test_ai.py` 覆盖 cmhub 余额 helper；`tests/test_gui.py` 覆盖 `CMHubSettingsWorker` 成功/失败脱敏、设置页 cmhub backend 切换、保存 `config.json` + `config/cmhub.json`、别名过滤与已存值保留。
 - 文档：`docs/06-tasks.md` 将 T-527 标为 DONE；同步 `docs/current-state.md`，下一步为 T-528。
 - 验证：`python -m py_compile tests\test_ai.py tests\test_gui.py` 通过；`python -m unittest discover -s tests -p "test_ai.py"` 通过（17 tests）；`python -m unittest discover -s tests -p "test_gui.py"` 通过（77 tests）；`python -m compileall app main.py` 通过；`python -m unittest discover -s tests` 通过（184 tests）；`git diff --check` 无空白错误（仅 LF/CRLF 提示）。全量测试仍有本机 PySide6 字体目录提示，不影响结果。
-- 下一步：T-528 ②计费错误提示 + 余额展示。
+- 下一步：T-528 ②计费错误提示 + 余额展示。
+
+## 【2026-07-04】T-528 完成 · ②计费错误提示 + 余额展示
+
+- 状态：DONE
+- 代码：②AI生成页新增 cmhub 余额显示，仅在 `backend=cmhub` 时展示；`GenerateWorker` 读取 cmhub metadata，把 `points_cost`、`points_balance`、`call_id` 以脱敏用户日志写入 `run_logs/run_log_events`，并把最新 `points_balance` 回传给页面。
+- 点数不足：`app/ai.py` 的生成错误回调会透传 `CMHubError.code/status/retryable`；`GenerateWorker` 通过 `code=insufficient_points` 识别点数不足，设置本轮停止标记，弹「点数不足，请先充值。本轮未开始任务将停止。」并让未开始任务不再继续，不靠中文错误字符串匹配。
+- 边界：只改②AI生成 UI、worker 事件处理和测试；未改 AI HTTP 协议、DB schema、Excel、Shopee/CDP 流程。
+- 文档：`docs/06-tasks.md` 将 T-528 标为 DONE；同步 `docs/current-state.md`，下一个可领取任务回到 T-525 ruff。
+- 测试：`python -m unittest discover -s tests -p test_gui.py` 通过（80 tests）；`python -m unittest discover -s tests -p test_ai.py` 通过（17 tests）；`python -m compileall app main.py` 通过；`python -m unittest discover -s tests` 通过（187 tests）；`git diff --check` 通过，仅有本机 LF/CRLF 提示。全量测试仍有本机 PySide6 字体目录提示，不影响结果。
+- 下一步：T-525「引入 ruff（lint + format）+ 可选 pre-commit」。