fix: address phase 1 ai review
This commit is contained in:
QiuSW
+39
@@ -363,3 +363,42 @@
|
||||
- 阻塞：真实上游 smoke 未执行，因为当前环境未配置 `AI_KEY_ENCRYPTION_KEY`，且业务库没有 AiModel/ModelAlias。配置 Fernet 主密钥并导入模型后，可去掉 `--recorded` 用同一命令跑真实标题 smoke。
|
||||
- 决策：T-104 采用“录制标题生成”作为验收路径，验证别名解析、Provider 选择、响应解析和同步耗时记录；真实图片同步耗时仍需在后续配置真实模型后补测。
|
||||
- 下一步：领取 T-201 User / UserWallet / ApiKey / PointsLedger / CallRecord 模型。
|
||||
|
||||
## 2026-07-02 Phase 1 审核（Claude Code review，非任务）
|
||||
|
||||
- 状态：DONE（审核完成）
|
||||
- 变更：新增 `docs/phase-1-review.md`；`06-tasks.md` 新增 T-105 修补任务、T-104 状态标注「图片同步风险未退」；`docs/README.md` 导航登记；`current-state.md` 阶段/下一步改 T-105。
|
||||
- 审核结论：**T-101~104 验收达标，代码质量高**。三模型机制忠实落地（chat / auto→chat 多模态返图 nano-banana2 / images_edits 改图 gpt-image-2）；`timeout_seconds=0→按分辨率有限超时` 修对了桌面端「0=无限」的坑；Fernet 加密 + 拒绝明文 fallback + 缺主密钥 fail-closed + admin 写入型脱敏字段 + 审计只记 empty/set，密钥零泄露闭环；审计 admin 真只读、delete_queryset 也留痕；smoke 用 override_settings+atomic+rollback 不落库、不打印 Bearer/key。
|
||||
- 发现（详见 `phase-1-review.md`）：
|
||||
- P1-1（进 T-302 前必修，资金安全）：`apps/ai/providers/openai_compatible.py:apply_extra_body` 无差别 `payload.update(parameters)`，调用方透传可覆盖 `model`/`n`/`size`/`resolution` 等核心/计费字段，击穿「按别名计费」契约。须白名单化、核心字段服务端固定不可覆盖。
|
||||
- P1-2（最高风险未退）：T-104 只跑了 recorded **标题**（`elapsed_ms=149` 无网络意义），Phase 1 存在的唯一理由「图片同步在 Gunicorn/nginx 下不超时」**未验证**。结论应改为「管路已验、图片同步风险未退」，并在依赖同步部署前（最迟 T-403）跑一次真实图片生成记录真实耗时。
|
||||
- P2：`.env.example` 的 `AI_DEFAULT_CONNECT/READ_TIMEOUT_SECONDS` 代码未读取（死配置，接上或删除）；`resolution_to_size` 未大小写归一（`"1k"` 漏命中）；导入器默认别名 `image-standard` 与文档示例 `image-hd` 口径不一致。
|
||||
- P3（登记）：`Provider.capabilities()` 无调用点（半冗余）；图生图 vs 改图都归 `operation_type=IMAGE`，T-302 需把「缺原图」翻成 400 而非 500；CallRecord 写入禁 dump `result.raw`（含 base64 大图/敏感）；provider 密钥无轮换（单 Fernet key）。
|
||||
- 未本地复跑：审核机无 `python3.12`，结论基于静态审查（providers/models/security/aliases/audit/importers/admin/tests/迁移/settings）+ codex 验证记录（7→18→23 tests 递增、含真实 MySQL 建库超时的诚实记录，可信度高）。T-104 的 149ms 不作为图片同步可行性证据。
|
||||
- 下一步：codex 领 T-105，按 `phase-1-review.md` 修 P1/P2；P1-1 须先于 T-302，全绿留证。
|
||||
|
||||
## 2026-07-02 T-105 Phase 1 AI 层审核修补
|
||||
|
||||
- 状态：DONE
|
||||
- 变更：
|
||||
- `apps/ai/providers/openai_compatible.py`：`parameters` / `extra_body` 改为白名单安全透传，`model`、`messages`、`n`、`size`、`stream` 等核心/计费字段不可被覆盖；`generationConfig` 仅允许安全子字段合并。
|
||||
- `apps/ai/providers/utils.py`：`resolution_to_size()` 增加大小写归一，`"1k"` / `"512px"` 可正确映射。
|
||||
- `apps/ai/importers.py` 与 `import_ai_models` 帮助文案：默认图片别名从 `image-standard` 对齐为 `image-hd`。
|
||||
- `smoke_ai_generation` 支持 `image --recorded`，录制图片路径走别名解析 + Provider 解析 + 事务回滚，不打印 key/Bearer、不持久化临时配置；保留真实 image smoke 入口和 `--image-file`。
|
||||
- 扩展 `apps/ai/tests.py`：覆盖 provider 参数越权拦截、分辨率归一、默认别名、录制 image smoke。
|
||||
- `.env.example` / `docs/env.md` 删除未被代码读取的 `AI_DEFAULT_CONNECT_TIMEOUT_SECONDS` / `AI_DEFAULT_READ_TIMEOUT_SECONDS`，改为说明超时来自 `AiModel` 字段与 Provider 分辨率默认值。
|
||||
- 同步更新 `docs/06-tasks.md`、`docs/api.md`、`docs/04-architecture.md`、`docs/03-tech-stack.md`、`README.md`、`docs/00-ai-start-here.md`、`docs/current-state.md`：T-105 完成，P1/P2 已修；P3 已挂到 T-201/T-302/T-403 或 Backlog。
|
||||
- 验证：
|
||||
- `py -3.12 -m py_compile apps\ai\providers\openai_compatible.py apps\ai\providers\utils.py apps\ai\importers.py apps\ai\management\commands\smoke_ai_generation.py apps\ai\tests.py`：通过。
|
||||
- `py -3.12 manage.py test apps.ai.tests.ProviderUtilsTests apps.ai.tests.ChatCompletionsProviderTests apps.ai.tests.ImagesEditsProviderTests apps.ai.tests.AiModelsImportTests apps.ai.tests.AiGenerationSmokeCommandTests --noinput --keepdb`：通过，10 tests OK。
|
||||
- `py -3.12 manage.py smoke_ai_generation image --recorded --prompt "生成测试图片" --resolution 1k`：通过；`alias=t-105-recorded-image-27c25b3a`，`model_used=recorded-image-model`，`elapsed_ms=71`，`image_bytes=20`。
|
||||
- `py -3.12 manage.py smoke_ai_generation title --recorded --prompt "为测试商品生成3个中文标题" --resolution 1K`：通过；`alias=t-104-recorded-title-ceec8dab`，`model_used=recorded-title-model`，`elapsed_ms=92`，`title_count=3`。
|
||||
- `py -3.12 manage.py check`：通过，0 issues。
|
||||
- `py -3.12 manage.py makemigrations --check`：通过，No changes detected。
|
||||
- `py -3.12 -m compileall apps`：通过。
|
||||
- `git diff --check`：通过，仅 Windows CRLF 提示。
|
||||
- `./init.ps1`：通过，依赖同步与基础检查正常。
|
||||
- `py -3.12 manage.py test apps.ai --noinput --keepdb`：两次未作为绿灯；一次在连接远程 MySQL 测试库前超时，一次跑到 23 tests 后于 `AiModelAdminTests.setUpClass` 事务连接阶段超时。失败点均为远程 MySQL `43.128.3.240:3306` 连接/重连，不是断言失败。
|
||||
- 阻塞：无代码阻塞。真实图片同步耗时仍未验证，已登记到 T-302/T-403；需要真实 `AI_KEY_ENCRYPTION_KEY`、AiModel/ModelAlias 与上游 key 后执行。
|
||||
- 决策：对外 `parameters` 不是任意直通上游，而是 provider 白名单安全参数；服务端固定字段优先，计费仍以能力别名/分辨率为准。未生效的全局 AI timeout 环境变量删除，避免运维误以为可通过 env 调整。
|
||||
- 下一步：领取 T-201 User / UserWallet / ApiKey / PointsLedger / CallRecord 模型。
|
||||
|
||||
Reference in New Issue
Block a user