开发接入

Quick start：安装 Skill & CLI，让 Agent 使用 Voobase 创建或接管应用

安装说明可直接复制给 Agent，平台不限定Agent，你可使用Workbuddy、Cursor、Codex、Trae等。

platform

❶ 安装 Skill

voobase-light-app • 0.1.6

下载 ZIP

请帮我安装 Voobase 官方 Skill（voobase-light-app，版本 0.1.6）。
官方下载地址：https://assets.voobase.cn/distribution/skills/platform-light-app/0.1.6/voobase-light-app.zip
官网安装指引：https://www.voobase.com/install/
下载并解压完整 Skill，优先安装到当前 Agent 的用户级 Skill 目录；目录不可写时使用项目级目录。
安装后读取 SKILL.md 及其引用的 setup.md，并检查 CLI 是否可用。
如需安装 CLI，请使用本页第②步的全局安装说明；全局权限不足时，使用下方对应系统的沙箱安装说明。
请确认 Skill 已安装并读取、CLI 版本满足要求。仅下载 ZIP 不代表安装完成。

❷ 安装 CLI

0.1.6 • published

系统要求: Node 20+、npm、全局安装权限。需要 npm 全局安装权限，以及可写的全局 prefix / cache / bin。

# 安装平台 CLI（全局安装）
# 需要 npm 全局安装权限，以及可写的全局 prefix / cache / bin
npm install -g @voobase/cli
platform help

CLI 安装有问题？

检查基础环境

系统要求: Node 20+、npm、全局安装权限。需要 npm 全局安装权限，以及可写的全局 prefix / cache / bin。如权限不满足，可采用沙箱模式。

沙箱模式安装 CLI

0.1.6 • published

查看安装命令与系统要求

系统要求: Node 20+；macOS/Linux 需要 curl、unzip；Windows 需要 PowerShell 5+
默认 wrapper: voobase-cli-sandbox/bin/platform

macOS / Linux

# 安装平台 CLI（沙箱安装）

# macOS / Linux（POSIX）
curl -fsSL "https://assets.voobase.cn/distribution/cli/0.1.6/voobase-cli-sandbox-0.1.6.zip" -o voobase-cli-sandbox.zip
rm -rf ./voobase-cli-sandbox
unzip -oq voobase-cli-sandbox.zip
chmod +x ./voobase-cli-sandbox/bin/platform
export PATH="$PWD/voobase-cli-sandbox/bin:$PATH"
platform help

Windows PowerShell

# 安装平台 CLI（沙箱安装）

# Windows PowerShell
$ArchivePath = Join-Path $PWD "voobase-cli-sandbox.zip"
$InstallDir = Join-Path $PWD "voobase-cli-sandbox"
Invoke-WebRequest -Uri "https://assets.voobase.cn/distribution/cli/0.1.6/voobase-cli-sandbox-0.1.6.zip" -OutFile $ArchivePath
Remove-Item -LiteralPath $InstallDir -Recurse -Force -ErrorAction SilentlyContinue
if (Get-Command tar.exe -ErrorAction SilentlyContinue) {
  tar.exe -xf $ArchivePath -C $PWD
  if ($LASTEXITCODE -ne 0) { throw "tar.exe 解压失败；请查看 README-WINDOWS.md。" }
} else {
  Expand-Archive -LiteralPath $ArchivePath -DestinationPath $PWD -Force
}
$BinPath = [IO.Path]::GetFullPath((Join-Path $InstallDir "bin"))
$UserPath = [Environment]::GetEnvironmentVariable("Path", "User")
if (($UserPath -split ";") -notcontains $BinPath) { [Environment]::SetEnvironmentVariable("Path", "$BinPath;$UserPath", "User") }
$env:Path = "$BinPath;$env:Path"
& "$BinPath\platform.cmd" help
# 如安装异常，请查看 .\voobase-cli-sandbox\README-WINDOWS.md

Windows CMD 验证

# Windows CMD
# 首次安装请执行上方 PowerShell 段；完成后新开 CMD 验证：
where.exe platform.cmd
platform.cmd help