feat: add public model catalog discovery
This commit is contained in:
QiuSW
+46
@@ -968,3 +968,49 @@
|
||||
- 已知限制：真实 AI 上游和真实图片耗时仍未验证，因当前环境未配置 `AI_KEY_ENCRYPTION_KEY` 且数据库无真实 AiModel/ModelAlias；真实微信/支付宝商户配置和 SDK 仍待生产环境提供。`deployment.md` 已明确未跑通真实图片 smoke 前不能声称生产图片链路已验证。
|
||||
- 决策：生产限流共享 cache 的 MVP 推荐路径先用 Django `DatabaseCache` + MySQL cache 表，不引入 Redis 作为当前代码依赖；高并发后可切换 Redis/Memcached 并安装对应 backend。生产静态资源采用 `STATIC_ROOT + collectstatic + Nginx/宝塔托管`，不在应用内引入 WhiteNoise。
|
||||
- 下一步：计划内 MVP 任务已完成；进入 VPS 实际部署、真实邮件/支付/AI 配置和真实图片耗时验证，或从 Backlog 重新拆后续任务。
|
||||
|
||||
## 2026-07-04 Phase 6 T-601 可行性复核与文档口径修正（非任务）
|
||||
|
||||
- 状态：DONE
|
||||
- 变更：复核 Claude Code 新增的 Phase 6 / T-601「可用别名发现」后，更新 `docs/06-tasks.md`、`docs/00-ai-start-here.md`、`docs/current-state.md`、`README.md`。T-601 路由统一为 `GET /api/v1/models`；验收要点收紧为只列 `ModelAlias.is_active=True` 且 `ai_model.is_active=True` 的别名；实现不得调用 `AiModel.to_resolved_model()` 或任何会解密 provider key 的路径；响应与 portal 页面不得暴露具体 SKU、模型 URL、provider key、`api_key_encrypted`、`extra_body` 等内部字段；模型列表成功请求不占用生成接口 `GenerateRateThrottle` 额度，只复用认证失败限流。
|
||||
- 验证：文档修改；未运行代码测试。
|
||||
- 决策：T-601 可行，属于 MVP 后低风险只读增强，不新增数据表；当前下一个可领取任务改为 T-601。真实邮件、支付、AI 模型和图片真实耗时验证仍是生产配置待办，不因 T-601 取消。
|
||||
- 下一步：领取 T-601 可用别名发现。
|
||||
|
||||
## 2026-07-04 T-601 可用别名发现
|
||||
|
||||
- 状态：DONE
|
||||
- 变更：
|
||||
- 新增 `apps/ai/catalog.py`：集中生成公开模型目录，只读取 `ModelAlias`、`AiModel` 的公开能力字段和 `PricingRule`，只列 active 且具备对应能力的别名；按 `api_type` / URL 推导 `images_edits` 是否需要原图；缺定价返回 `pricing_status=unpriced` 与空价格列表。
|
||||
- 新增 `GET /api/v1/models`：继承 `ExternalApiView`，使用 API Key 鉴权；不挂 `GenerateRateThrottle`，成功查询不占用生成接口额度；响应只含 `alias`、`operation_type`、`capabilities`、`requires_image`、`pricing_status`、`prices`。
|
||||
- 新增 portal `/models` 只读「可用模型」页，并在导航加入入口；页面显示别名、操作类型、能力、是否需要原图和点数单价，缺定价显示「暂未定价」。
|
||||
- 扩展 `apps/api/tests.py` 与 `apps/portal/tests.py`：覆盖 API Key 成功结构、缺失/无效 Key 拒绝、Web session 不能调用外部 API、portal 未登录跳转、页面不泄露底层 SKU / URL / key / `extra_body`、缺定价别名显示暂未定价。
|
||||
- 同步更新 `docs/api.md`、`docs/routes.md`、`docs/06-tasks.md`、`docs/current-state.md`、`docs/00-ai-start-here.md` 与 `README.md`；T-601 标记 DONE，当前暂无新的已拆 `TODO`。
|
||||
- 验证：
|
||||
- `.\init.ps1`：通过；Python 3.12.3，依赖均已满足，`manage.py check` 0 issues，并打印启动命令 `py -3.12 manage.py runserver`。
|
||||
- `py -3.12 -m py_compile apps\ai\catalog.py apps\api\views.py apps\api\urls.py apps\api\tests.py apps\portal\views.py apps\portal\urls.py apps\portal\tests.py`：通过。
|
||||
- `py -3.12 manage.py check`：通过，0 issues。
|
||||
- `py -3.12 manage.py makemigrations --check --dry-run`：通过，No changes detected。
|
||||
- `git diff --check`：通过，仅 Windows CRLF 提示。
|
||||
- `py -3.12 manage.py test apps.api.tests.ModelsCatalogApiTests apps.portal.tests.PortalAccountFlowTests.test_models_page_requires_session_login apps.portal.tests.PortalAccountFlowTests.test_models_page_lists_public_aliases_prices_and_unpriced_state --keepdb --noinput --verbosity 2`：5 条目标用例中 3 条 API 测试已通过；portal 测试未跑到断言，因远程 MySQL 连接 `43.128.3.240` 超时中断。
|
||||
- `Test-NetConnection 43.128.3.240 -Port 3306`：`TcpTestSucceeded=True`。
|
||||
- `py -3.12 manage.py test apps.portal.tests.PortalAccountFlowTests.test_models_page_requires_session_login apps.portal.tests.PortalAccountFlowTests.test_models_page_lists_public_aliases_prices_and_unpriced_state --keepdb --noinput --verbosity 2`：通过，2 tests OK。
|
||||
- 阻塞：T-601 功能无阻塞；完整套件未单次重跑，远程 MySQL 仍存在间歇超时风险。测试/迁移阶段仍有 allauth `account.EmailAddress` 条件唯一约束在 MySQL 上不可创建的 `models.W036` 既有警告。
|
||||
- 决策：模型目录接口是只读发现能力，不调用 `AiModel.to_resolved_model()`，不依赖 `AI_KEY_ENCRYPTION_KEY`，不解密或输出 provider key；未来接 `account_alias_permission` 时在同一 catalog 查询层按用户过滤。
|
||||
- 下一步：暂无已拆 `TODO`；建议先处理真实邮件、支付、AI 模型导入与真实图片耗时验证，或从 Backlog 拆新任务。
|
||||
|
||||
## 2026-07-04 T-601 复核（Claude Code review，非任务）
|
||||
|
||||
- 状态：DONE（复核完成，结论：达标，质量高）
|
||||
- 对象：codex 完成的 T-601「可用别名发现」（`GET /api/v1/models` + portal 只读「可用模型」页）。
|
||||
- 逐条核对全过：
|
||||
- ① `ModelsView(ExternalApiView)` API Key 鉴权，未挂 `GenerateRateThrottle`（不占用生成限流额度，仅认证失败限流），`filter(is_active=True, ai_model__is_active=True)`。
|
||||
- ② 响应字段 alias/operation_type/capabilities/requires_image/pricing_status/prices[{resolution,points_cost}]；缺价 → pricing_status=unpriced + prices=[]，不报错，有专测。
|
||||
- ③ **不走解密路径**：`apps/ai/catalog.py` 只读 capabilities/api_type/url（url 仅用于 `resolve_api_type` 推导 requires_image，不输出），全项目 `to_resolved_model()` 仅出现在 generation.py；清单不依赖 `AI_KEY_ENCRYPTION_KEY`、不碰 `api_key_encrypted`。
|
||||
- ④ 不暴露 SKU/url/key/extra_body：测试用哨兵值（secret-sku / provider-secret.example / encrypted-provider-key / provider-extra-secret）断言响应 JSON 一个都搜不到，另断言字段名 api_key/api_key_encrypted/extra_body/url/model_used 缺席——比「断言不含字段」更强，能抓从别路径的泄漏。
|
||||
- ⑤ portal `ModelCatalogView`（session）+ models.html（单价「X 点」/暂未定价/需原图）+ base.html「可用模型」导航入口。
|
||||
- ⑥ 测试：API Key 成功结构、缺/无效/仅 session 拒绝、portal 未登录跳转、portal 页不泄露内部字段、unpriced 显示暂未定价——均覆盖。
|
||||
- 加分：catalog 额外做能力校验过滤（别名指向模型无对应能力则不列，与 resolve_alias 口径一致）；查询无 N+1（select_related + 批量 PricingRule）；api.md 已同步 /v1/models 契约（补上上轮登记的缺口）。
|
||||
- 小点（不用改）：`prices` 按分辨率字符串排序，`512` 排在 `4K` 之后，纯展示层顺序，无功能影响。
|
||||
- 保留：本轮完整套件未单次全绿（远程 MySQL 间歇超时），T-601 相关测试本身通过，非断言失败。
|
||||
- 结论：达标，无 P1/P2，不需要修补任务。
|
||||
|
||||
Reference in New Issue
Block a user