跳到正文

快速开始 ​

这个指南会把本地浏览器游戏发布为 VifuHub 上的可玩发行版本。

1. 注册并登录 ​

先在 vifu.ai 创建 VifuHub 账号。

先安装 CLI,然后在终端登录:

bash
curl -fsSL https://vifu.ai/cli | bash
vf login

使用和 vifu.ai 相同的邮箱和密码。CLI 会保存本地登录状态用于部署。

2. 创建或选择项目 ​

创建一个 starter:

bash
npm create @vifu/vifu my-game -- --template vanilla --no-interactive
cd my-game

或者使用已有浏览器游戏:

bash
cd path/to/your-game
vf setup
vf deploy

setup 会检测项目,并让你确认游戏名称和检测到的构建设置。只有检测不正确时才需要覆盖。如果跳过这一步,deploy 会在构建前启动同一个设置流程。CI 中可以用 vf deploy --yes 接受检测到的默认值。

3. 浏览 Open Source AI Native Games ​

bash
git clone --recurse-submodules https://github.com/vifudotdev/awesome-open-source-ai-native-games
cd awesome-open-source-ai-native-games

先看这两个项目:

进入任意游戏或 starter 目录后运行:

bash
vf deploy

4. 添加 VifuHub SDK ​

npm ​

使用打包工具或构建步骤的项目,通过 npm 安装:

bash
npm install @vifu/hub@alpha
ts
import * as hub from "@vifu/hub";

await hub.ready();

5. 调用 Vifu AI ​

ts
const result = await hub.ai.generateText({
  model: "basic",
  messages: [
    { role: "user", content: "Give the player a short hint." }
  ]
});

showHint(result.content);

basic 适合低成本玩法文本和简单分类。quality 适合故事回合或更复杂的推理。游戏不选择后端提供方名称,也不携带提供方 API key。

Vifu AI 默认可通过 VifuHub SDK 使用。普通 hub.ai.generateText(...) 调用不要添加 manifest 配置。

6. 部署 ​

bash
vf deploy

vf deploy 会在需要时运行项目设置,验证项目,构建游戏,检查构建输出,只在内容变化时上传,并输出可玩的 URL。

如果部署被阻止,先看错误中的文件、行号、URL 和修复建议。最常见原因是 CDN JavaScript import、浏览器 bundle 里残留外部 AI / API 直接调用,或本地专用提供方。

部署选项和游戏管理命令见 部署 部分。

本地行为 ​

在 Agent Runtime 外部,Vifu AI、存档和其他 Agent Runtime 宿主能力可能不可用。游戏仍然应该能用本地备用逻辑加载和游玩。