Vifu Runtime
Vifu Runtime 让游戏和互动应用在每个用户会话中连接 AI 服务、AI 伙伴、会话状态和平台能力。Vifu Cloud 保存认证、记忆、会话历史、AI 解读、使用量计量和个性化数据。Runtime 负责加载游戏，并提供桥接能力，让 Vifu 接收安全的上下文，再通过游戏自己定义的动作完成响应。
平台模型
| 层级 | Vifu 提供 | 游戏负责 |
|---|---|---|
| Vifu Cloud | 认证、数据库、AI 服务、AI 伙伴、记忆、使用量计量、版本托管、运行时清单。 | 通过发布流程提交的、面向玩家展示的产品信息和元数据。 |
| Web Shell | SSR 项目页、元数据、登录会话上下文、宿主桥接、creator/project 路由。 | 公开项目身份和面向玩家的元数据。 |
| Runtime Gateway | 独立 runtime origin、/play、CSP、可执行 bundle 资源、runtime session 文件。 | HTML、JavaScript、WASM、CSS、图片和其他部署成果物资源。 |
| Web Runtime | 浏览器 iframe 宿主、静态资源加载、宿主桥接、生命周期事件、运行环境隔离。 | HTML、JavaScript、资源、渲染、输入、会话规则。 |
| Mobile Runtime（待发布） | 在原生应用中加载已通过审核的浏览器游戏和 Godot 模块。 | 浏览器资源、Godot 模块、共享元数据，以及可以安全交给 AI 伙伴使用的状态和动作。 |
| Vifu SDK | 处理安全上下文、事件、工具、信号、宿主管理资源、平台能力调用和宿主连接状态的浏览器 API。 | 哪些状态可以安全暴露，Vifu 可以请求哪些工具，游戏希望使用哪些宿主能力。 |
| Vifu CLI | 本地创建、运行、测试、构建、生成和发布流程。 | 源代码、测试期望和发布意图。 |
AI Runtime 分层
多数游戏先用 vifu.ai.generateText(...)。宿主 / session 负责选择当前 Mind，游戏不需要硬编码 provider 或人格。
只有当游戏里有多个必须隔离工具、指令和运行状态的 AI 参与者时，才使用 Runtime Agent。
| 名称 | 含义 |
|---|---|
| Mind | 智能、人格、模型或 provider。 |
| Agent | 运行时里的可行动实体，拥有自己的工具和 runs。 |
| Companion | 面向用户的伙伴、bubble、语音或 surface，是一种 agent kind。 |
| NPC / Tutor / Director | 游戏、学习和互动场景里的其他 agent kind。 |
| Tool | Agent 或当前 AI turn 可调用的运行时能力。 |
当 NPC、导师、AI 伙伴、旁白或游戏对象需要隔离的工具、指令和 run session 时，使用 vifu.tool(...)、vifu.agent(...) 和 vifu.run(...)。不要为了单次 AI 调用创建 agent。
生产域名分层
Vifu 把可信 Web 外壳、不可信 runtime 和后端 API 放在不同 origin：
| Origin | 所属层 | 职责 |
|---|---|---|
https://vifu.ai | Web shell Worker | SSR/BFF 页面、登录态外壳、宿主桥接、creator/project URL。 |
https://runtime.vifu.ai | Runtime Gateway Worker | /play、runtime HTML、可执行 runtime bundle 资源、runtime session 文件 URL。 |
https://api.consenger.com | API Gateway 和 API Workers | launch resolve、认证、private check、AI、credits、game state、runtime data/media。 |
开发环境使用 https://runtime-dev.vifu.ai 作为 runtime gateway， https://api-dev.consenger.com 作为 API。
它们如何协作
- 将游戏或互动体验构建成浏览器资源，或构建成已支持的 Godot 模块。
- 通过 Vifu SDK 处理安全的会话上下文、事件、游戏拥有的动作、宿主管理资源和已批准的平台能力。
- 用 Vifu CLI 完成本地运行、测试、构建和发布。
- Vifu Cloud 保存版本元数据、会话历史、记忆、使用量数据和 AI 解读结果。
vifu.ai/{owner}/{project}的公开项目页在服务端解析游戏和 public launch payload。- Web shell 嵌入
play_url，它指向runtime.vifu.ai/play。 - Runtime Gateway 返回 entry HTML，并把可执行 bundle 资源 URL 改写到 runtime origin。
- 目前 runtime data 和 media 仍从 Vifu API endpoint 读取；后续如果要进一步收紧网络出口，可以移到 Runtime Gateway 后面。
- Web Runtime 或 Mobile Runtime（待发布）按浏览器或 Godot 的运行方式加载体验，并连接宿主桥接。
重要边界
runtime 不会让任意浏览器代码变成可信代码。Vifu-hosted community games 仍然是不可信 iframe code。安全模型是分层的：
- Web shell 负责路由解析、元数据、会话上下文和 host bridge。
- Runtime Gateway 负责
/play、CSP、runtime HTML、可执行 bundle 资源和 runtime session 文件。 - API 负责授权、private check、AI、credits、game state 和后端拥有的 runtime data/media。
- iframe sandbox 和 CSP 是浏览器层加固；业务安全边界仍然是后端授权。
命名
完整产品叫 Vifu Platform。托管后端服务叫 Vifu Cloud。在 Web、移动浏览器和支持 Godot 的移动环境中执行游戏的机制叫 Vifu Runtime。游戏内使用的浏览器 API 叫 Vifu SDK。本地开发和发布使用 Vifu CLI。