命令行界面

FloopFloop CLI

安装 FloopFloop CLI，授权设备，并从您的终端控制每个项目 — `floop login`、`floop new`、`floop chat`、`floop refine` 等。

最后更新： 2026年4月28日

FloopFloop CLI

FloopFloop CLI（floop）是适用于 FloopFloop 平台的单一二进制命令行客户端。它具备网页控制台的全部功能 — 通过提示词创建项目、实时查看部署进度、在聊天 REPL 中精细化项目 — 无需离开您的终端。

与 API 密钥（仅限商业计划）不同，CLI 设备令牌与您的普通账户计划绑定，就像在网页端登录一样。CLI 面向人类用户；API 密钥面向脚本程序。

安装

选择适合您机器的二进制文件并将其添加到 $PATH。完整的安装指引（含复制按钮）请访问 floopfloop.com/cli。

macOS（Apple Silicon）

curl -L https://github.com/FloopFloopAI/floop-cli/releases/latest/download/floop-darwin-arm64 -o /usr/local/bin/floop
chmod +x /usr/local/bin/floop

macOS（Intel）

curl -L https://github.com/FloopFloopAI/floop-cli/releases/latest/download/floop-darwin-x64 -o /usr/local/bin/floop
chmod +x /usr/local/bin/floop

Linux x64

curl -L https://github.com/FloopFloopAI/floop-cli/releases/latest/download/floop-linux-x64 -o /usr/local/bin/floop
chmod +x /usr/local/bin/floop

Windows x64

# In PowerShell:
Invoke-WebRequest https://github.com/FloopFloopAI/floop-cli/releases/latest/download/floop-windows-x64.exe -OutFile $env:USERPROFILE\floop.exe

在 macOS 或 Windows 上首次启动时，系统会提示该二进制文件尚未签名。在 macOS 上，请右键单击 → 打开，或运行 xattr -d com.apple.quarantine /usr/local/bin/floop。在 Windows 上，请点击 "更多信息" → "仍要运行"。

命令

`floop new <prompt>`

创建一个新项目，默认情况下等待其上线。

floop new "a crypto RSI dashboard for BTC and ETH" --subdomain my-rsi

参数	说明
`--name <name>`	项目名称（默认为提示词的前几个词）
`--subdomain <slug>`	子域名（默认为名称的 slug）
`--bot-type <type>`	可选值：`site`、`app`、`bot`、`api`、`internal`、`game`
`--team <teamId>`	在团队工作区下创建
`--no-wait`	加入队列后立即返回，不串流进度
`--json`	输出机器可读的 JSON

`floop list`（别名 `ls`）

以表格或 JSON 格式列出您的项目。

floop list
floop list --json
floop list --team team_abc123

`floop status <project>`

显示项目的构建状态。接受项目 ID 或子域名。添加 --watch 可实时串流进度，直到构建达到终态。

floop status my-rsi
floop status my-rsi --watch
floop status my-rsi --json

`floop chat <project>`

打开与项目绑定的交互式 REPL。您输入的每一行都将作为精细化请求发送，并实时显示构建进度。斜杠命令：

/help — 显示所有斜杠命令
/status — 单次状态查询
/open — 打开实时 URL
/clear — 清屏
/exit — 退出 REPL（也可使用 Ctrl+D）

构建期间，Ctrl+C 停止监听；构建仍在服务端运行。再次按 Ctrl+C（或使用 /exit）才能真正退出 REPL。

`floop refine <project> "<message>"`

非交互式精细化 — 即 floop chat 的脚本化版本。发送一条精细化消息后退出，不进入 REPL。适用于 CI 流水线（"在此分支合并时精细化首页"）或一次性调整。

floop refine my-bot "tighten the dashboard table padding"
floop refine my-bot "fix the typo in the hero" --code-only --watch
floop refine my-bot "swap the brand colour to teal" --json

参数	说明
`--watch`	将构建结果追踪至终态（live / failed / cancelled / archived）。不使用此参数时，加入队列后立即返回。
`--code-only`	设置 `codeEditOnly: true` — 跳过重新规划/重新设计，执行 3 步就地补丁，而非完整的 6 步重建。消耗约半个精细化积分。最适合对已上线项目进行文案修改、颜色替换、错别字修正。
`--json`	输出机器可读的 JSON。包含三种响应形式 — `processing`（构建已启动）、`queued`（在当前构建后排队）或 `queued: false`（已保存为聊天消息，未触发构建）。

`floop cancel <project>` · `floop reactivate <project> [--watch]`

取消正在运行的构建，或重新激活之前已取消的项目。reactivate 将基于项目最新的提示词启动一次新构建；使用 --watch 可将新构建追踪至终态（live / failed / cancelled / archived），而非立即返回。与 floop status --watch 和 floop refine --watch 采用相同的去重轮询模式。

floop cancel my-bot
floop reactivate my-bot
floop reactivate my-bot --watch
floop reactivate my-bot --watch --json

`floop open <project>`

在默认浏览器中打开项目的实时 URL。若 API 尚未返回自定义 URL，则回退至 https://<subdomain>.floop.tech。

`floop upgrade`

将 floop 二进制文件替换为最新的 GitHub Release。在替换前会对照已发布的 SHA256SUMS 验证 SHA256。添加 --check 仅检查更新而不安装。

floop upgrade
floop upgrade --check

仅适用于编译后的二进制文件。若您通过 npm 安装或从源码运行 node dist/index.js，该命令将拒绝执行并指引您使用正确的工具。

`floop docs` · `floop feedback`

快捷方式：floop docs 打开本页面， floop feedback 打开 floopfloop.com 上的支持/问题反馈表单。

`floop completion <bash|zsh|fish|powershell>`

将 Shell 补全脚本输出到标准输出。各 Shell 的安装方式：

# bash
echo 'source <(floop completion bash)' >> ~/.bashrc

# zsh — save to a directory on $fpath
floop completion zsh > "${fpath[1]}/_floop"

# fish
floop completion fish > ~/.config/fish/completions/floop.fish

# PowerShell
floop completion powershell | Out-String | Invoke-Expression
# (or append to your $PROFILE to persist)

目前补全为静态内容 — 仅识别命令和子命令名称，不包含您的项目子域名。通过本地缓存实现动态补全已列入路线图。

`floop config get [key]` · `floop config set <key> <value>`

读取或修改本地 CLI 设置。可设置的键： apiUrl（覆盖 API 基础 URL，适用于预发布环境或自托管）和 telemetry（true/false）。

floop config get
floop config get telemetry
floop config set telemetry false
floop config set apiUrl https://staging.floopfloop.com

令牌存储故意不支持通过 config set设置 — 此设计可防止令牌出现在 Shell 历史记录中。请使用 floop login / floop logout 管理当前会话。

`floop usage`

显示您的套餐信息、可用积分（本月 + 结转 + 累计使用量），以及当前周期内的使用情况（已创建项目数、构建次数、精细化次数、存储量、带宽）与套餐限额的对比。

floop usage
floop usage --json

`floop conversations <project>`（别名 `history`）

按时间顺序打印项目的聊天历史 — 用户消息、助手回复及部署标记（● Deployed v2）。添加 --limit 10 仅显示最近 10 条记录。

floop conversations my-bot
floop history my-bot --limit 5
floop conversations my-bot --json

`floop keys <list|create|rm>`

管理用于 CI/CD 脚本的程序化 API 密钥（flp_…）。与 floop login 的设备令牌不同— 设备令牌面向人类用户，与普通套餐绑定；API 密钥面向程序，需要商业计划，可通过控制台或使用 floop keys rm 按名称/ID 单独撤销。

floop keys list
floop keys create "github-actions"     # raw key shown ONCE — copy it
# In CI:
export FLOOP_TOKEN=flp_…
floop list --json | jq …
# Later:
floop keys rm "github-actions"

rm子命令拒绝撤销当前调用所使用的 API 密钥 — 如确需撤销，请使用另一个密钥操作（或从控制台撤销）。

`floop library <list|clone>`

浏览公共库中的项目并将其克隆到您的账户。

floop library list
floop library list --search "trading bot" --sort popular
floop library clone <projectId> --subdomain my-fork

聊天 REPL：`/attach <file>` + 交互式选择器

在 floop chat 中，将文件附加到下一条精细化消息：

floop chat my-bot
you ▸ /attach ./mockup.png
✓ Attached mockup.png (320 KB, image/png)
  Attached to your NEXT message. 1 file(s) pending.
you ▸ make the dashboard look like this

CLI 通过现有的预签名 PUT 流程上传文件；支持的类型为 png/jpg/gif/svg/webp/ico/pdf/txt/csv/doc/docx，最大 5 MB。附件在您发送下一条消息时使用 — 输入更多斜杠命令或按回车留空均保持待发状态。

不带项目参数运行 floop chat 将进入项目编号选择器。若只有一个项目，则直接选中。

`floop subdomain check <slug>` · `floop subdomain suggest "<prompt>"`

用于 floop new 的脚本辅助工具。check 在 slug 可用时返回退出码 0，否则返回 1。suggest根据提示词输出一个可用的 slug — 可直接通过管道传入 --subdomain：

# Pre-flight check
floop subdomain check my-bot && echo "available"

# Auto-pick a slug from the prompt
SLUG=$(floop subdomain suggest "a crypto rsi dashboard for btc")
floop new "a crypto rsi dashboard for btc" --subdomain "$SLUG"

`floop secrets <list|set|rm> <project> [<key>]`

管理项目上的只写环境变量。API 不返回值 — list 仅显示元数据（键名、末 4 位字符、时间戳）。set 子命令按优先级依次从--value、--from-env 或标准输入读取值 — 敏感值请优先使用标准输入或 --from-env，以避免出现在 Shell 历史记录中。

# List
floop secrets list my-bot

# Set (most secure: from a local env var)
export STRIPE_KEY="sk_live_..."
floop secrets set my-bot STRIPE_KEY --from-env STRIPE_KEY

# Set (reads from stdin)
floop secrets set my-bot STRIPE_KEY < ./stripe.key

# Remove
floop secrets rm my-bot STRIPE_KEY

键名必须为 UPPER_SNAKE_CASE，以字母开头，最长 64 个字符（与项目密钥验证器一致）。

脚本化使用

每个命令均支持 --json。结合 jq 和 FLOOP_TOKEN 环境变量（可绕过交互式登录）， CLI 适合用于 CI/CD 场景。

# Create a project, capture its ID, poll for live URL
PROJECT=$(floop new "test page" --no-wait --json | jq -r '.project.id')

# Wait until live (or terminal failure)
while true; do
  STATUS=$(floop status "$PROJECT" --json | jq -r '.status.status')
  case "$STATUS" in
    live)      echo "shipped"; break ;;
    failed)    echo "build failed"; exit 1 ;;
    cancelled) echo "cancelled"; exit 1 ;;
  esac
  sleep 5
done

环境变量

变量	用途
`FLOOP_API_URL`	覆盖 API 基础 URL。默认值：`https://www.floopfloop.com`。适用于预发布环境。
`FLOOP_TOKEN`	替代 `~/.floop/config.json` 中令牌的 Bearer 令牌。适用于 CI 场景。

退出码

用于 Shell 脚本的已记录退出码：

退出码	含义
`0`	成功
`1`	用户错误（参数有误、验证失败、开发模式拒绝升级）
`2`	身份验证失败（未登录、令牌已撤销、FORBIDDEN）
`3`	已达速率限制
`4`	服务器错误（5xx、安装/升级失败）
`5`	网络不可达

配置文件

CLI 以 0600（仅所有者可读写）权限将会话存储在 ~/.floop/config.json。该文件包含：

{
  "apiUrl": "https://www.floopfloop.com",
  "token": "flp_cli_…",
  "tokenPrefix": "flp_cli_a1b2…",
  "user": { "id": "...", "email": "you@example.com", "name": "..." }
}

操作系统密钥链支持（macOS Keychain、Windows 凭据管理器）已列入路线图。

隐私 & 遥测

在首次交互运行时，CLI 会询问您是否愿意分享匿名使用数据。此功能为可选加入 — 选择 n 则不会发送任何数据。选择 y 后，CLI 在每次命令退出时向 /api/cli/telemetry 发送一条 POST 请求，仅包含以下内容：

anonymousId — 加入时生成的随机十六进制值，从不与您的账户关联
command — 顶级命令名称（如 new、list）
exitCode
durationMs
version — CLI 版本
os — darwin / win32 / linux

我们不会发送：提示词、项目名称、文件内容、命令参数、您的电子邮件或 IP 地址（后端记录请求 IP 用于速率限制，但不与遥测数据关联）。完整载荷仅包含上述六个字段。

跳过列表 — 遥测不适用于 floop config、 floop completion、floop help、 --help 或 --version（这些命令或存在循环问题、或常被管道使用、或不含有效内容）。遥测有 1 秒硬超时，不会延迟 CLI 退出。

随时可禁用： floop config set telemetry false。或直接手动编辑 ~/.floop/config.json。

源码 & 发布

适用于 macOS、Windows 和 Linux 的预构建二进制文件在每个 cli-v* 标签上发布至 GitHub Releases。发布说明包含安装指引和 SHA256 校验和。

如需查看发布产物列表，请浏览最新发布版本。

FloopFloop CLI

FloopFloop CLI

安装

macOS（Apple Silicon）

macOS（Intel）

Linux x64

Windows x64

登录

命令

floop new <prompt>

floop list（别名 ls）

floop status <project>

floop chat <project>

floop refine <project> "<message>"

floop cancel <project> · floop reactivate <project> [--watch]

floop open <project>

floop upgrade

floop docs · floop feedback

floop completion <bash|zsh|fish|powershell>

floop config get [key] · floop config set <key> <value>

floop usage

floop conversations <project>（别名 history）

floop keys <list|create|rm>

floop library <list|clone>

聊天 REPL：/attach <file> + 交互式选择器

floop subdomain check <slug> · floop subdomain suggest "<prompt>"

floop secrets <list|set|rm> <project> [<key>]

脚本化使用

环境变量

退出码

配置文件

隐私 & 遥测

源码 & 发布

`floop new <prompt>`

`floop list`（别名 `ls`）

`floop status <project>`

`floop chat <project>`

`floop refine <project> "<message>"`

`floop cancel <project>` · `floop reactivate <project> [--watch]`

`floop open <project>`

`floop upgrade`

`floop docs` · `floop feedback`

`floop completion <bash|zsh|fish|powershell>`

`floop config get [key]` · `floop config set <key> <value>`

`floop usage`

`floop conversations <project>`（别名 `history`）

`floop keys <list|create|rm>`

`floop library <list|clone>`

聊天 REPL：`/attach <file>` + 交互式选择器

`floop subdomain check <slug>` · `floop subdomain suggest "<prompt>"`

`floop secrets <list|set|rm> <project> [<key>]`