Files
moyi-model-intelligence-hub/docs/04-open-source-baseline-and-development-nodes.md
T

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/completions
  • POST /v1/responses
  • POST /v1/messages
  • GET /v1/models
  • GET /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 密钥与模型目录实施计划。