VifuHub CLI

VifuHub CLI 是本地游戏项目的开发工具。它用于项目设置、静态 Web 构建、部署、发布，以及理解部署错误。

安装

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

项目内使用:

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

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

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

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

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。

管理游戏

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

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

可选诊断

vf manifest check
vf manifest explain

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