feat: add mock key catalog and standard calls

This commit is contained in:
wlx committed 2026-08-23 19:21:31 +08:00
1 parent 78ed3c1103
commit 5e8e462548
8 files changed
+671 -8

No files matched your search

@@ -6,7 +6,7 @@
- 阶段:阶段 3,系统设计与工程基线
- 状态:开发基线 v1
- 更新时间:2026-08-20
- 当前节点:D1,网关适配契约
- 当前节点:D4,密钥与模型目录 Mock 闭环
## 一、开源项目使用决策
@@ -114,7 +114,7 @@ POST /v1/tasks
| D1 网关适配契约 | 固化开源边界和前端网关接口 | 本文档、类型化 Gateway Client、演示适配器 | 类型检查和前端构建通过 |
| D2 Otari 本地基座 | 运行锁定版本的 Otari 与持久化数据库 | Compose、环境模板、健康检查、启动说明 | 重启后配置和用量可持久化 |
| D3 身份与权限 | 实现邀请码、登录、会话、角色与管理端守卫 | Control Plane 认证 API、数据库迁移、前端认证客户端、测试 | 普通用户无法访问管理 API |
| D4 密钥与模型目录 | 打通 MOYI Key、网关 Key、模型目录和权限 | Key API、模型 Schema、Otari 映射、管理页面 | 创建 Key 后可完成一次真实调用 |
| D4 密钥与模型目录 | 打通 MOYI Key、网关 Key、模型目录和权限 | Key API、模型 Schema、Otari 映射、管理页面 | Mock Key 可完成一次标准同步调用和异步 3D 任务调用 |
| D5 调用与计量 | 打通同步、流式、用量事件和额度账本 | 代理链路、SSE、幂等计量、用量页面 | 调用量与额度变更可追溯且不重复扣减 |
| D6 异步任务与 3D | 打通任务提交、排队、进度和结果文件 | Task API、队列、对象存储、AI SoulMate 适配器 | 3D 任务完成正常/失败闭环 |
| D7 管理运营 | 接入用户额度、供应商、路由、并发、审计 | 管理端真实 API 与高风险操作审计 | 关键管理操作可追踪和回滚 |
@@ -140,4 +140,4 @@ POST /v1/tasks
## 六、当前结论
当前 D3 已完成认证与权限基线。D4 输入已确认:先使用 Mock 建立 Key/模型目录闭环,真实接入方向包含国内文本/多模态模型和 VAST 相关 3D 模型,测试环境使用现有服务器,首轮规模按 4—5 人、3—4 个项目估算。下一节点进入 D4,补充 MOYI Key、统一模型目录与 Otari 映射。详见 [D4 密钥与模型目录实施计划](06-d4-integration-plan.md)。
当前 D3 已完成认证与权限基线。D4 输入已确认:先使用 Mock 建立 Key/模型目录闭环,真实接入方向包含国内文本/多模态模型和 VAST 相关 3D 模型,测试环境使用现有服务器,首轮规模按 4—5 人、3—4 个项目估算。D4 Mock 已提供平台 Key 生命周期、统一模型目录、标准同步调用和异步 3D 任务接口;目录使用内存仓库,PostgreSQL 表结构已准备,下一步进入真实 Provider Adapter 与用量计量。详见 [D4 密钥与模型目录实施计划](06-d4-integration-plan.md)。
+15
View File
@@ -78,3 +78,18 @@ SDK 不直接暴露给 MOYI 用户。后续如果上游从 HTTP API 切换为 SD
- 企业认证、团队审批和 BYOK。
- 正式公网开放、生产 SLA 和大规模并发承诺。
- 自托管模型和 GPU 调度。
## 七、D4 Mock 已实现接口
当前 Control Plane 已提供一套可供前端控制台联调的内存 Mock:
- `GET /api/models`:登录用户读取统一模型与供应商目录,目录中包含一个同步多模态模型和一个异步 3D 模型。
- `GET|POST /api/keys`:用户查看或创建 MOYI Key;明文只在创建响应返回一次,服务端只保存 SHA-256 摘要。
- `POST /api/keys/:id/revoke`:用户撤销自己的 Key。
- `GET /v1/models`:使用 `Authorization: Bearer <MOYI_KEY>` 查询可调用模型。
- `POST /v1/chat/completions`:兼容 OpenAI 风格的 Mock 同步文本/多模态调用。
- `POST /v1/3d/tasks`、`GET /v1/tasks/:id`:Mock 异步 3D 任务创建与查询。
- `GET|POST /api/admin/providers`:管理员查看或登记供应商适配位。
- `GET|POST /api/admin/models`:管理员查看或登记统一模型目录。
Mock 目录使用内存仓库,重启会重置,适合原型与接口联调;`migrations/002_catalog_keys.sql` 已准备 PostgreSQL 表结构,后续接持久化仓库时保持 API 不变。