跳到正文

VifuHub CLI ​

VifuHub CLI 是面向本地互动体验和游戏项目的开发工具,用于连接 VifuHub 托管发布与 Playtest。它负责项目设置、静态 Web 构建、验证、发布和定位部署错误。

安装 ​

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

项目内使用:

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

创建项目使用 npm 初始化命令。

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

先在 vifu.ai 创建账号,然后登录:

bash
vf login

常用命令 ​

命令用途
vf login为部署或发布登录。
vf logout退出当前 API 环境。
vf logout --all清除所有已缓存的 VifuHub 认证信息。
vf setup检测并配置当前游戏项目。
vf build构建当前项目。
vf build ./game构建其他目录的项目。
vf run运行本地游戏项目。
vf test运行支持的本地测试流程。
vf deploy构建、验证、上传并创建可玩的链接。
vf publish面向准备好构建成果的底层发行命令。

将浏览器游戏发布到 VifuHub ​

  1. 运行 vf setup。
  2. 确认检测到的构建设置。
  3. 只有检测不正确时才调整项目配置。
  4. 通过 VifuHub SDK 使用 Agent Runtime 宿主能力。
  5. 运行 vf deploy。

如果游戏使用 CDN JavaScript 或外部 AI API,请先阅读 部署策略。

Coding agent 工作流需要单独安装 VifuHub CLI Skill。

管理游戏 ​

bash
vf games list
vf games share <game-id>
vf games submit <game-id>
vf games delete <game-id>

管理命令会使用与部署相同的 VifuHub 账号。

可选诊断 ​

bash
vf manifest check
vf manifest explain

通常不需要在 vf deploy 前手动运行这些命令;部署会自动检查项目配置。它们适合高级诊断,或者在 CI 中不构建、不上传时使用。