feat: add cmhub AI backend

progress.md

@@ -1094,4 +1094,23 @@
 - 打包安全：`cmshopee.spec` 不声明本地数据 `datas`；构建脚本打包后检查 `dist\cmshopee`，发现 `config.json`、`config/ai_models.json`、`cmshopee.db*`、`db.sqlite`、`chrome_user_data_dir/`、`images/`、`logs/`、`prompts/`、`title_prompt.txt` 会直接失败；脚本会打印当前 Python 版本，低于项目目标 3.10 时给出警告。
 - 文档：新增 `docs/packaging.md`，同步 `docs/README.md`、`docs/03-tech-stack.md`、`docs/06-tasks.md`、`docs/current-state.md`；T-524 标为 DONE，下一个可领取任务更新为 T-525。
 - 测试：新增 `tests/test_packaging.py` 覆盖 frozen 入口路径、spec 不打包本地数据、构建脚本排除列表。
-- 验证：`python -m compileall app main.py` 通过；`python -m unittest discover -s tests -p "test_packaging.py"` 通过（3 tests）；`python -m unittest discover -s tests` 通过（170 tests）；`git diff --check` 无空白错误（仅 LF/CRLF 提示）；`powershell -ExecutionPolicy Bypass -File scripts\build_exe.ps1` 成功产出 `dist\cmshopee\cmshopee.exe`，脚本确认未混入本地数据。本机当前 `python` 为 3.7.9，构建脚本已提示低于项目目标；正式发布建议切到 Python 3.10+ 环境后重新打包。
+- 验证：`python -m compileall app main.py` 通过；`python -m unittest discover -s tests -p "test_packaging.py"` 通过（3 tests）；`python -m unittest discover -s tests` 通过（170 tests）；`git diff --check` 无空白错误（仅 LF/CRLF 提示）；`powershell -ExecutionPolicy Bypass -File scripts\build_exe.ps1` 成功产出 `dist\cmshopee\cmshopee.exe`，脚本确认未混入本地数据。本机当前 `python` 为 3.7.9，构建脚本已提示低于项目目标；正式发布建议切到 Python 3.10+ 环境后重新打包。
+## 【2026-07-04】文档修正 · cmhub 网关对接任务定义
+
+- 背景：Claude Code 已新增 `docs/cmhub-integration-design.md` 与 T-526~T-528；本轮从全栈工程角度评审后修正任务边界，避免未配置 cmhub 时破坏现有 direct 生文/生图流程。
+- 修正：`docs/cmhub-integration-design.md` 增补 v3 评审结论，明确旧配置缺 `backend` 时按 `direct` 迁移、cmhub Key 固定存 `config/cmhub.json`、新增 `CMHubError` 结构化错误、点数/余额通过事件回调传播、cmhub HTTP 调用需区分 connect/read timeout、`image_url` 下载需安全校验。
+- 任务：`docs/06-tasks.md` 将业务优先级调整为 Phase 7 cmhub，对 T-526/T-527/T-528 验收重写；T-525 ruff 顺延到 Phase 8。`docs/current-state.md` 下一个可领取任务改为 T-526。
+- 验证：文档-only 更新，未改代码，未运行单元测试。
+## 【2026-07-04】文档修正 · cmhub v3.2 六点一致性收口
+
+- 修正：`docs/cmhub-integration-design.md` 将目标接口改为 title/image/balance/models 四类接口；统一 `gen_title`/`gen_cover` 为“返回值与现有调用兼容，可新增可选事件回调参数”；把不存在的 `default_ai_config()` 改为现有 `DEFAULT_CONFIG` / `default_config()` 表述；明确 T-526 只发出计费 metadata 事件，T-528 再负责 GUI run_logs 与余额展示；补充 `image_url` 域名解析后 IP 也要拒绝内网/回环/本机地址。
+- 任务：`docs/06-tasks.md` 将 T-526/T-527/T-528 引用统一为 `docs/cmhub-integration-design.md` v3.2，并同步 T-526 的 run_logs 边界与安全下载验收。
+- 验证：文档-only 更新，未改代码，未运行单元测试。
+## 【2026-07-04】T-526 完成 · `app/ai.py` + `appconfig` 接入 cmhub backend
+
+- 状态：DONE
+- 变更：`app/appconfig.py` 在 `config.json` 的 `ai` 段新增 `backend=direct/cmhub` 和 `ai.cmhub` 默认配置，新增 `config/cmhub.json` 的读写/打码 helper；`.gitignore` 增加 `config/cmhub.json`。`app/ai.py` 保留 direct 直连模型清单路径，新增 cmhub 生文、生图和 `/models` 别名发现 helper；`gen_title()` / `gen_cover()` 返回值不变，cmhub 计费 metadata 通过事件回调传出；新增 `CMHubError` 结构化错误、按 code 的重试策略、tuple timeout、生图读超时不自动重发、`image_url` http/https + DNS/IP 内网拦截 + 大小上限下载。
+- 文档：同步 `docs/03-tech-stack.md`、`docs/04-architecture.md`、`docs/api.md`、`docs/06-tasks.md`、`docs/current-state.md`；T-526 标记 DONE，下一步为 T-527。
+- 测试：`python -m py_compile app\appconfig.py app\ai.py tests\test_appconfig.py tests\test_ai.py` 通过；`python -m unittest discover -s tests -p "test_appconfig.py"` 通过（8 tests）；`python -m unittest discover -s tests -p "test_ai.py"` 通过（16 tests）；`python -m compileall app main.py` 通过；`python -m unittest discover -s tests` 通过（179 tests）。全量测试仍有本机 PySide6 字体目录提示，不影响结果。
+- 决策：全新配置和旧配置缺 `ai.backend` 时都保持 `direct`，避免升级后未配置 cmhub 就破坏现有生成；cmhub Key 固定只进 `config/cmhub.json`，不进 `config.json`；T-526 只传出 metadata，GUI 余额/计费提示留给 T-528。
+- 下一步：T-527 ⑤设置 cmhub 网关面板。