feat: add multi-image vision analysis

docs/04-architecture.md

@@ -41,6 +41,8 @@ T-301 已实现 `ApiKeyAuthentication` 与 `ExternalApiView`：外部 API 使用
 
 T-302 已实现 `/api/v1/generate/title` 与 `/api/v1/generate/image`：API 层只做鉴权、参数校验和编排；别名解析、Provider 选择、计费计算、预扣、成功确认、失败退点分别调用 `apps.ai` / `apps.billing` 既有模块。T-613 已把生成链路抽为 `apps.api.generation` 的核心阶段：`prepare_generation()` 负责审核、图片输入、别名、Provider 与计费准备；`precharge_generation()` 只调用 billing 预扣；`execute_precharged_generation()` 复用已预扣 `CallRecord` 调上游并成功确认或失败退点，供旧同步接口和后续异步 worker 共用。图片结果 MVP 先用本地 `default_storage` 保存到 `MEDIA_ROOT/generated/images/...` 并返回 `image_url`；核心阶段通过 URL 构建器生成外部 URL，不依赖 DRF `Request`；`CallRecord` 只写 URL / 摘要，不保存 provider `raw` 或 base64。
 
+T-619 已在同一生成核心增加 `vision` 分支和 `/api/v1/analyze/images`：API 接收有序的 `images[]`，每项二选一提供 `image_url` / `image_base64`；prompt 审核通过后才下载或解码图片，随后校验同时具备 `text + vision` 的模型与 Provider、按 `vision + alias` 默认价格预扣一次、同步调用 Chat Completions / Gemini 多模态接口并返回完整文字。输入图片只在请求内存中使用，不落库；`CallRecord` 只保存最多 500 字结果摘要。
+
 T-614 已实现 `/api/v1/generate/image/tasks` 与 `/api/v1/generate/image/tasks/{task_id}`：提交接口同步审核 prompt、解析图片输入和预扣点，创建 `ImageGenerationTask(status=queued)` 后立即返回公开 UUID `task_id`；后台 worker 通过 `select_for_update(skip_locked)` 抢任务，复用 T-613 `execute_precharged_generation()` 对已预扣 `CallRecord` 调上游、保存结果、成功确认或失败退点。任务表记录 worker 租约、心跳和尝试次数；reaper 识别僵尸 `running` 任务后默认判失败并幂等退点，不默认重排队。异步 worker 没有 DRF request，结果 URL 由 `MEDIA_PUBLIC_BASE_URL` / `PUBLIC_BASE_URL` 生成。当前实现中 worker 会基于任务快照再次运行 `prepare_generation()`，因此会复审 prompt、重解析别名 / Provider / 定价；账务仍使用已预扣 `CallRecord.points_cost`，不会重复扣点。这个取舍偏安全（排队期间敏感词库更新后仍能拦截并退款），但如果未来队列积压明显，应单独实现“提交时模型配置快照”，避免执行时别名映射变化导致按旧价预扣、按新模型执行。
 
 T-616 起异步生图 worker 对临时性上游失败增加自动重试：`upstream_timeout` / `upstream_error` 在未达到最大次数前回到 `queued` 并设置 `next_attempt_at`，`CallRecord` 保持 `pending` 且不退点；不可重试错误或最后一次失败才置 `failed` 并幂等退款。默认 `IMAGE_TASK_MAX_RETRIES=2`，因此 `attempt_count` 最多为 3。
@@ -57,6 +59,8 @@ T-504 已实现用户端 `/recharge` 页面：GET 展示当前余额、充值表
 
 T-306 已实现对外 API 安全加固：`download_image_input()` 在请求前校验 `image_url` 协议与解析后的 IP，只允许公网 `http` / `https`，拒绝私有、回环、链路本地、保留、组播、未指定地址；重定向由服务端手动跟随并逐跳重新校验，响应按 `IMAGE_URL_MAX_BYTES` 流式限长读取。`REST_FRAMEWORK` 全局默认认证为空、默认权限为 `IsAuthenticated`，外部 API 和用户端 session API 必须显式声明认证类；生成接口挂 `GenerateRateThrottle`，认证失败挂 IP 限流；充值下单通过 `RECHARGE_MAX_AMOUNT_CNY` 控制单笔上限。T-607/T-609/T-617 版本检查接口已显式使用 `AllowAny` / 空认证，且只返回公开发布元数据、强制更新标记和文件大小字节数。
 
+T-619 多图理解继续复用上述 URL 下载器和逐跳 SSRF 校验，并额外用 `VISION_MAX_IMAGES`、`VISION_MAX_IMAGE_BYTES`、`VISION_MAX_TOTAL_BYTES` 控制图片数量、单图解码后大小和请求总大小。第一版只审核文字 prompt，不包含图片内容审核。
+
 **计费层（`apps/billing`）**
 
 - 计费规则查询：按「操作类型 + 能力别名（+ 可选分辨率）」算出本次点数 N。**按别名定价，不按具体供应商 SKU 定价**，这样后台换底层模型时计费不变。
@@ -146,8 +150,8 @@ CREATE TABLE ai_model (
 -- 能力别名（对外稳定标识 → 当前映射的具体模型）
 CREATE TABLE model_alias (
   id             BIGINT PRIMARY KEY,
-  alias          VARCHAR(64) NOT NULL, -- 如 title-standard / image-hd，对外用
-  operation_type VARCHAR(32) NOT NULL, -- title / image
+  alias          VARCHAR(64) NOT NULL, -- 如 title-standard / image-hd / vision-standard，对外用
+  operation_type VARCHAR(32) NOT NULL, -- title / image / vision
   ai_model_id    BIGINT NOT NULL REFERENCES ai_model(id), -- 可随时改指向
   is_default     BOOLEAN NOT NULL DEFAULT FALSE,
   is_active      BOOLEAN NOT NULL DEFAULT TRUE,
@@ -172,7 +176,7 @@ CREATE TABLE ai_config_audit_log (
 -- 计费规则（按别名定价，换底层模型不影响计费）
 CREATE TABLE pricing_rule (
   id             BIGINT PRIMARY KEY,
-  operation_type VARCHAR(32) NOT NULL, -- title / image
+  operation_type VARCHAR(32) NOT NULL, -- title / image / vision
   alias          VARCHAR(64) NOT NULL, -- 能力别名字符串，不绑具体模型
   resolution     VARCHAR(32) NOT NULL DEFAULT '', -- 空字符串表示该别名默认价
   points_cost    BIGINT NOT NULL,      -- > 0
@@ -307,7 +311,7 @@ CREATE TABLE call_record (
   id               INTEGER PRIMARY KEY,
   user_id          INTEGER NOT NULL REFERENCES "user"(id),
   api_key_id       INTEGER REFERENCES api_key(id),  -- 本次调用所用的 Key
-  operation_type   TEXT NOT NULL,   -- title / image
+  operation_type   TEXT NOT NULL,   -- title / image / vision
   alias            TEXT,            -- 调用方请求的能力别名（对外稳定标识）
   model_used       TEXT,            -- 实际服务该次请求的具体模型（解析后，便于排障/对账）
   resolution       TEXT,
@@ -389,6 +393,7 @@ CREATE TABLE image_generation_task (
 - 扣点锁 `user_wallet` 行（`select_for_update()`）或 `F('points_balance') - N` 原子更新 + DB 约束 `points_balance >= 0`（MySQL 的 CHECK 需 ≥8.0.16），**杜绝并发超扣 / 扣成负数**；钱包与 auth `user` 表分离，扣点不与登录/资料更新抢锁。
 - **先扣后调、失败必退**：保证不会“调用成功但没扣到”或“失败还扣钱”。
 - 余额不足在调上游**之前**拦截。
+- `vision` 同步调用在别名解析前先审核 prompt，再按顺序读取 1–8 张图片；输入失败不进入预扣。计费规则使用空 `resolution` 默认价，一次请求固定预扣一次，不随图片数量重复扣费。
 
 ### 4.1.1 调用扣点（异步图片任务）