安装

先安装 CLI。只有当游戏代码需要 VifuHub API 时，再添加 VifuHub SDK。

CLI

CLI 用于创建、运行、测试、构建、生成和发布 AI-native 游戏。

bash

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

Agent skill 单独安装，见 VifuHub CLI Skill。

项目内 CLI 使用方式：

bash

npm install --save-dev @vifu/vf
npx vf --help

bash

npm create @vifu/vifu my-game -- --template vanilla --no-interactive
cd my-game
vf deploy --yes

npm create @vifu/vifu 是受支持的项目初始化命令；项目创建与 vf 命令相互独立。

已有浏览器游戏可以这样开始:

bash

cd path/to/your-game
vf deploy --yes

deploy 也会在缺少项目设置时自动启动设置流程。CI 中可以用 vf deploy --yes 接受检测到的默认值。

VifuHub SDK 用在浏览器游戏内部，向 Agent Runtime 暴露安全的会话上下文、事件和游戏拥有的动作。

使用打包工具或构建步骤的游戏，通过 npm 安装：

bash

npm install @vifu/hub@alpha

import * as hub from "@vifu/hub";

先在 vifu.ai 创建账号，然后运行:

bash

vf login

然后从游戏目录部署：

bash

vf deploy