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 | 面向准备好的构建和市场流程的底层发布命令。 |
适配已有游戏
- 运行
vifu setup。 - 确认检测到的构建设置。
- 只有检测不正确时才调整项目配置。
- 把直接 AI 或后端调用替换成 Vifu SDK。
- 运行
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 中不构建、不上传时使用。