跳到正文

Vifu CLI

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

安装

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

无法使用原生安装脚本时,也可以使用 npm:

bash
npm install -g @vifu/cli@alpha
vifu --help

项目内使用:

bash
npm install --save-dev @vifu/cli@alpha
npx vifu --help

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

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

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

bash
vifu login

常用命令

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

适配已有游戏

  1. 运行 vifu setup
  2. 确认检测到的构建设置。
  3. 只有检测不正确时才调整项目配置。
  4. 把直接 AI 或后端调用替换成 Vifu SDK。
  5. 运行 vifu deploy

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

Coding agent 工作流需要单独安装 Vifu Agent Skill

管理游戏

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

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

可选诊断

bash
vifu manifest check
vifu manifest explain

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