test: add recorded ai generation smoke

progress.md

@@ -340,3 +340,26 @@
 - 阻塞：无代码阻塞；远程 MySQL 偶发连接超时会影响标准测试建库稳定性。
 - 决策：T-103 使用自建 `AiConfigAuditLog` 专表，不只依赖 django-admin `LogEntry`；密钥审计只记录状态变化，不记录明文或密文。
 - 下一步：领取 T-104 跑通一次真实/录制的标题或图片生成。
+
+## 2026-07-02 T-104 跑通一次真实/录制的标题或图片生成
+
+- 状态：DONE
+- 变更：
+  - 新增 `smoke_ai_generation` 管理命令：支持 `title --recorded`，在事务内临时创建 fake `AiModel` / `ModelAlias`，通过 `resolve_alias()` 解析别名，再用录制的 chat/completions 响应走 `ChatCompletionsProvider.generate_text()`，最后回滚临时配置，不写真实 key、不污染业务库。
+  - 扩展 `apps/ai/tests.py`：新增录制 smoke 命令测试，确认输出不包含 placeholder key / Bearer，且临时 `AiModel` / `ModelAlias` 不持久化。
+  - 同步更新 `README.md`、`docs/00-ai-start-here.md`、`docs/03-tech-stack.md`、`docs/06-tasks.md`、`docs/current-state.md`、汇报文档。
+- 验证：
+  - `./init.ps1`：通过，依赖同步与基础检查正常。
+  - `py -3.12 manage.py showmigrations ai`：通过，`0001_initial` / `0002_aiconfigauditlog` 均为 `[X]`。
+  - `py -3.12 manage.py shell -c "...AI_KEY_ENCRYPTION_KEY..."`：当前环境未配置 `AI_KEY_ENCRYPTION_KEY`。
+  - `py -3.12 manage.py shell -c "...AiModel/ModelAlias count..."`：业务库 `AiModel count=0`、`ModelAlias count=0`。
+  - `py -3.12 manage.py smoke_ai_generation title --recorded --prompt "为测试商品生成3个中文标题" --resolution 1K`：通过；`alias=t-104-recorded-title-c054d919`，`model_used=recorded-title-model`，`elapsed_ms=149`，`title_count=3`。
+  - smoke 后再次查询业务库：`AiModel count=0`、`ModelAlias count=0`，确认临时配置已回滚。
+  - `py -3.12 manage.py test apps.ai.tests.AiGenerationSmokeCommandTests --noinput --keepdb`：通过，1 test OK。
+  - `py -3.12 manage.py check`：通过，0 issues。
+  - `py -3.12 manage.py makemigrations --check`：通过，No changes detected。
+  - `py -3.12 -m compileall apps`：通过。
+  - `py -3.12 manage.py test apps.ai --noinput --keepdb`：多次在远程 MySQL `43.128.3.240:3306` 连接/测试库初始化阶段超时；失败点为数据库连接，不是断言失败。
+- 阻塞：真实上游 smoke 未执行，因为当前环境未配置 `AI_KEY_ENCRYPTION_KEY`，且业务库没有 AiModel/ModelAlias。配置 Fernet 主密钥并导入模型后，可去掉 `--recorded` 用同一命令跑真实标题 smoke。
+- 决策：T-104 采用“录制标题生成”作为验收路径，验证别名解析、Provider 选择、响应解析和同步耗时记录；真实图片同步耗时仍需在后续配置真实模型后补测。
+- 下一步：领取 T-201 User / UserWallet / ApiKey / PointsLedger / CallRecord 模型。