feat: add ai model alias configuration

docs/api.md

@@ -184,6 +184,16 @@
 resolve_alias(operation_type: str, alias: str | None) -> ResolvedModel
 ```
 
+T-102 后，别名解析已接入数据库表 `AiModel` / `ModelAlias`：每次调用读取当前 active 记录，缺省 `alias=None` 时取该 `operation_type` 的默认别名；标题要求 `text` 能力，图片要求 `image` 能力。密钥以 `AiModel.api_key_encrypted` 存储，使用 Fernet 解密后进入 `ResolvedModel`。
+
+从 `cmbot` 形状导入配置的管理命令：
+
+```bash
+py -3.12 manage.py import_ai_models path\to\ai_models.json --create-default-aliases
+```
+
+导入前必须配置有效 `AI_KEY_ENCRYPTION_KEY`。不要把真实 `ai_models.json` 或真实上游 key 提交到 git。
+
 ### Provider 适配器接口
 
 每个供应商一个适配器，按 `api_type` 注册；移植自 cmbot 的调用逻辑落到各适配器内：
@@ -206,8 +216,7 @@ class Provider(Protocol):
 
 要点：
 
-- `ResolvedModel` 来自数据库 AiModel（形状同 `cmbot/config/ai_models.json`，外加 `capabilities`；`api_key` 在库中加密，使用时解密，不落明文）。
-- T-101 先用 `ResolvedModel` dataclass 承接配置，不建数据库表；T-102 再把它接到 AiModel/ModelAlias。
+- `ResolvedModel` 来自数据库 AiModel（形状同 `cmbot/config/ai_models.json`，外加 `capabilities`；`api_key` 在库中以 Fernet 加密，使用时解密，不落明文）。
 - `TextGenerationResult` 包含 `text`、清洗后的 `titles`、`model_used`、`raw`；`ImageGenerationResult` 包含图片 bytes、`model_used`、`raw`。图片落对象存储并返回 URL 属 T-302 之后的 API 编排职责。
 - 适配器按 `api_type`（`chat`/`gemini`/`images`/`images_edits`/`auto`）从注册表选取，新增供应商 = 新增一个适配器，不改对外接口。
 - `parameters` 为供应商特有参数透传；适配器负责把统一入参翻译成各家上游格式。
@@ -219,7 +228,7 @@ class Provider(Protocol):
 
 - 支付商户真实配置：微信 `appid/mchid/apiv3_key/证书/notify_url`，支付宝 `appid/应用私钥/支付宝公钥/notify_url`。协议字段、验签方式与成功应答已按同系统实现明确；缺真实配置时用 mock。
 - 汇率与各操作/别名（+ 分辨率档）的点数单价。
-- `AiModel.api_key` 加密方案（应用层 Fernet / KMS）与后台脱敏展示方式；运行配置见 `env.md`。
+- 配置变更审计：T-103 补 AiModel / ModelAlias / 密钥变更留痕（谁、何时、改了什么）。
 - 图片结果存储：对象存储选型与 `image_url` 生成（默认走存储返回 URL）。
 - **图片模型调用机制**：`gpt-image-2` 走 `images/edits`（改图，原图必传）、`nano-banana2` 走 `chat/completions` 多模态返图（需自定义解析），两者非标准 `images/generations`。图片返回结构（URL / base64 / 位置）**首次对接抓真实响应确认**后再定适配器解析。
 - 别名命名规范、默认别名、是否按账号授权可用别名（`account_alias_permission`）。