7.7 KiB
7.7 KiB
开源技术基线与开发节点
文档信息
- 产品:模亦灵枢 / MOYI Model Intelligence Hub
- 阶段:阶段 3,系统设计与工程基线
- 状态:开发基线 v1
- 更新时间:2026-08-20
- 当前节点:D1,网关适配契约
一、开源项目使用决策
模亦灵枢不直接修改某个中转站项目并把它整体作为产品,而采用“开源网关能力 + MOYI 自研控制面与双端控制台”的组合方式。这样可以复用成熟的模型代理、虚拟密钥和用量能力,同时保留多类型模型、异步 3D 任务、额度台账和未来 MaaS 能力的产品自主性。
| 项目 | 当前定位 | 许可证基线 | 使用方式 |
|---|---|---|---|
| Otari | 第一阶段模型网关与用量基础 | Apache-2.0 | 计划部署为独立服务,通过 MOYI 适配层调用,不修改其前端作为本产品控制台 |
| Apache APISIX | 后续高性能数据面 | Apache-2.0 | 第一版不进入关键路径,达到容量门槛后再引入 |
| New API | 产品功能与兼容性参考 | AGPLv3,官方另有品牌与商业许可说明 | 只参考功能边界和交互,不复制代码进入当前代码库 |
| Sub2API | 共享额度、账号池和运营流程参考 | LGPL-3.0 | 只参考业务流程和测试场景,若未来复用代码需单独完成法务与许可证审计 |
进入生产前必须锁定实际使用版本的 commit 或镜像 digest,保存 LICENSE、NOTICE、依赖清单和安全扫描结果。本文档是工程决策记录,不替代正式法律意见。
二、系统职责边界
用户端 / 管理端 Vue 控制台
│
▼
MOYI Control Plane API
认证 · 用户 · 角色 · 邀请码
模型目录 · 额度台账 · 异步任务
审计 · 运营 · 网关适配接口
│
┌─────┴─────┐
▼ ▼
Otari Adapter MOYI Task Adapter
文本/多模态 3D/图像/视频
Key/预算/用量 排队/进度/文件
│ │
└─────┬─────┘
▼
供应商 API / 自托管模型
2.1 Otari 负责
- OpenAI/Anthropic 兼容请求转发。
- 供应商凭证、模型别名与基础路由。
- 虚拟 Key、预算前置校验、用量和成本记录。
- 网关健康检查和基础可观测数据。
2.2 MOYI 自研负责
- 邀请码注册、登录、用户角色和双端权限。
- 平台额度账本;Otari 预算是执行限制,不作为财务事实来源。
- 面向用户的
sk-moyi-*密钥生命周期及其到网关 Key 的映射。 - 统一模型目录、展示名称和多类型能力 Schema。
- 3D、图像和视频等异步任务的队列、进度、结果文件和回调。
- 管理端运营、审计、额度发放和未来支付订单。
- 对 Otari、APISIX 和自托管模型隐藏实现差异的适配契约。
2.3 前端不得承担
- 不得持有 Otari Master Key、供应商密钥或数据库凭证。
- 不得直接调用网关管理接口创建 Key、预算和供应商。
- 不得根据前端余额直接决定是否允许调用。
- 不得把隐藏管理菜单当作权限控制。
三、第一版调用契约
3.1 同步与流式模型
应用携带 sk-moyi-* 请求 /v1/*
→ 数据面验证 MOYI Key
→ 控制面读取用户、模型权限和可用额度
→ Otari 执行供应商路由与预算限制
→ 流式透传响应
→ 用量事件写入 MOYI 台账
第一批兼容入口预留:
POST /v1/chat/completionsPOST /v1/responsesPOST /v1/messagesGET /v1/modelsGET /v1/usage
最终开放范围以目标 Otari 版本和首批供应商联调结果为准。
3.2 异步模型
POST /v1/tasks
→ 校验 Key、模型权限、额度和并发
→ 创建幂等任务与额度预占
→ 排队并调用 3D/图像/视频供应商
→ 轮询或接收回调更新进度
→ 结果文件进入对象存储
→ 成功结算 / 失败释放预占
异步任务不强行转换成聊天接口。它与 Otari 共用统一认证、模型目录和用量视图,但使用 MOYI 自研任务适配层。
四、开发节点
每个节点遵循“目标确认—代码与文档—构建/测试—提交—推送—进度同步”的交付方式。页面细节在节点内持续调整,不阻塞核心链路开发。
| 节点 | 目标 | 主要产物 | 节点门禁 |
|---|---|---|---|
| D0 原型基线 | 固化品牌、用户端、管理端和认证流程 | Vue 可交互原型 | 已完成,提交 bebff16 |
| D1 网关适配契约 | 固化开源边界和前端网关接口 | 本文档、类型化 Gateway Client、演示适配器 | 类型检查和前端构建通过 |
| D2 Otari 本地基座 | 运行锁定版本的 Otari 与持久化数据库 | Compose、环境模板、健康检查、启动说明 | 重启后配置和用量可持久化 |
| D3 身份与权限 | 实现邀请码、登录、会话、角色与管理端守卫 | Control Plane 认证 API、数据库迁移、前端认证客户端、测试 | 普通用户无法访问管理 API |
| D4 密钥与模型目录 | 打通 MOYI Key、网关 Key、模型目录和权限 | Key API、模型 Schema、Otari 映射、管理页面 | 创建 Key 后可完成一次真实调用 |
| D5 调用与计量 | 打通同步、流式、用量事件和额度账本 | 代理链路、SSE、幂等计量、用量页面 | 调用量与额度变更可追溯且不重复扣减 |
| D6 异步任务与 3D | 打通任务提交、排队、进度和结果文件 | Task API、队列、对象存储、AI SoulMate 适配器 | 3D 任务完成正常/失败闭环 |
| D7 管理运营 | 接入用户额度、供应商、路由、并发、审计 | 管理端真实 API 与高风险操作审计 | 关键管理操作可追踪和回滚 |
| D8 测试与部署 | 完成功能、性能、安全和上线准备 | 自动化测试、部署、监控、告警、回滚 | UAT 与发布评审通过 |
五、分阶段资源与信息门禁
完整的信息准备时点见信息准备与阶段门禁清单。本节保留工程资源视角,避免把生产资源误认为当前开发前置条件。
以下内容在对应节点前逐项确认,暂未确定项可以先使用本地开发替代方案:
| 资源 | 开发阶段替代 | 生产前需要确认 |
|---|---|---|
| 服务器与容器环境 | 本地 Docker Desktop | 云服务器、CPU/内存、磁盘、备份和网络 |
| 数据库 | PostgreSQL 本地容器 | 高可用、备份、恢复、加密和保留周期 |
| 缓存与队列 | Redis 本地容器 | 持久化、并发容量和故障恢复 |
| 对象存储 | MinIO 本地容器 | OSS/S3 地区、生命周期、跨域和下载授权 |
| 域名与 TLS | localhost | 控制台、管理端、API 域名和证书 |
| 首批模型供应商 | Mock 或单个测试账号 | 名单、密钥、额度、计价、限流和数据条款 |
| AI SoulMate 3D | Mock Task Adapter | 正式 API、回调、文件格式、超时和计费单位 |
| 邮件/短信 | 控制台验证码 | 服务商、模板、签名、发送限制和风控 |
| 地区与合规 | 不对公网开放 | 服务地区、隐私政策、日志和内容安全要求 |
六、当前结论
当前 D3 已完成认证与权限基线。D4 输入已确认:先使用 Mock 建立 Key/模型目录闭环,真实接入方向包含国内文本/多模态模型和 VAST 相关 3D 模型,测试环境使用现有服务器,首轮规模按 4—5 人、3—4 个项目估算。下一节点进入 D4,补充 MOYI Key、统一模型目录与 Otari 映射。详见 D4 密钥与模型目录实施计划。