技术

先打开构建的状态页 —— 每个阶段都有「日志」按钮，可以精确看到失败发生在哪里。大多数失败属于三类：临时的基础设施抖动（点击 Retry）；AI 自己就能修复的代码错误（开一条聊天：「构建失败了，报错是：…」并贴上相关日志行）；或者已连接外部服务的问题（Stripe、GitHub、你的域名提供商等）。如果都不属于，请把项目 ID 发给客服 —— 我们可以手动重跑流水线。

三个常见原因：（1）DNS 还没完全生效 —— 等 5–15 分钟再硬刷新。（2）浏览器缓存了旧资源 —— 用无痕窗口打开。（3）首次构建的输出语法正确但逻辑有误 —— 开一条聊天：「我打开首页是空白」，AI 会在下一次优化中修复。浏览器控制台（F12 → Console）通常能显示真正的错误。

构建运行在共享队列中。Free 和 Starter 方案是标准优先级，高峰时可能等几分钟；Pro 和 Business 拥有优先名额，几乎从不排队。如果你的构建排队超过 10 分钟就不正常 —— 刷新页面（状态通过 websocket 更新，连接偶尔会掉），如果仍未开始，请把项目 ID 发给客服。

可以。打开项目，点击三点菜单，选择「重新部署」。代码完全保持不变 —— 但新的环境变量会被读取、过期的构建产物会被重建、平台侧的改进（例如运行时的安全补丁）也会被应用。无改动的重新部署消耗 1 个 credit，一分钟内完成。

在 AWS 上，默认 us-east-1 区域。静态资源由 CloudFront 全球边缘网络分发，所以无论源站在哪里，访客都会就近命中一个 PoP。服务端渲染运行在 AWS Lambda，你的项目数据库在 Amazon RDS Postgres，上传的文件存放在 S3 上。欧盟数据驻留在路线图中，但目前尚未提供 —— 如果对你而言是硬性要求，请告知客服。

可以 —— 你的项目代码保存在我们以你名义创建的 GitHub 仓库中。打开项目「设置 → 仓库」就能看到 URL，并为你的账户授予写权限。克隆、Fork 或迁移到其他 GitHub 组织都和普通仓库一样。数据库也是如此（我们在「设置 → 数据库 → 导出」中提供 Postgres 连接字符串）。代码和数据的所有权属于你；FloopFloop 只是叠加在其上的部署 + AI 层。

Pro 及以上方案：打开项目，进入「设置 → 域名」，点击「添加域名」并输入你的域名（根域名或子域名）。FloopFloop 会显示需要在你的注册商处添加的两条 DNS 记录 —— 一条 CNAME（apex 域名使用 A/ALIAS）和一条用于验证的 TXT 记录。当两者都被识别后，SSL 会自动配置，域名通常会在 5–30 分钟内上线。Free 和 Starter 方案不支持自定义域名，需要升级才能使用。

大多数问题出在 DNS 一侧。请确认 CNAME（或 A/ALIAS）记录存在、指向 FloopFloop 提供的值，并且没有被会拦截我们验证的代理挡住（Cloudflare 的「橙色云朵」要先关掉，等验证完成再开启）。在终端用 `dig 你的域名.com +short` 来查看全网解析结果。验证通常 15 分钟以内完成，如果过了一小时仍显示「Pending」，请把域名发给客服。

所有 secret 都使用 AES-256 在 AWS Secrets Manager 中进行静态加密，只有在你项目的运行时收到请求时才会解密 —— 它们绝不会写入磁盘或构建日志。保存之后，secret 的值是「只写」的：你可以更新或删除，但无法在仪表盘里再次查看。FloopFloop 员工无法访问明文值，我们只能看到 key 的名称以及审计元数据。

可以。打开「设置 → Secrets」，找到对应条目，点击「轮换」并粘贴新值。大约 30 秒后，运行中的运行时就会开始读取新值（我们对 secret 做热更新，不会重启函数）。如果该 secret 属于构建时配置（少见），会看到提示要求重新部署 —— 大约一分钟，消耗 1 个 credit。

在聊天里告诉 AI：「加一个每天早上 9 点跑、给我邮件发送新注册用户摘要的 cron」。AI 会在你的代码里生成 `/api/cron/<名称>` 路由，注册调度（cron 表达式或间隔），并在每次重新部署时由我们的调度器保持注册同步。每次调用都带着项目作用域的 bearer token，所以只有我们的调度器能触发。执行记录和日志在「设置 → 调度」下查看。

macOS 与 Linux：`curl -fsSL https://floop.tech/install.sh | sh`。Windows：从 floop-cli 仓库的 GitHub Releases 页面下载最新安装包，或使用 `winget install FloopFloopAI.floop`。安装后运行 `floop login`，浏览器会打开用来授权该设备。之后 `floop new`、`floop refine`、`floop deploy` 等命令无需任何额外配置即可使用。

CLI token 是 `floop login` 写入本地配置的凭证 —— 用来标识特定设备上的人类用户，停用某台电脑时可在 /account/devices 撤销。API key 用于来自脚本、CI 或第三方应用的无人值守访问 —— 在 /account/api-keys 中创建，可以按项目限定作用域，可随时轮换。两者调用的都是相同的 `/api/v1/*` 接口，但只有 API key 才应该出现在自动化流程中。

是的 —— 八个官方 SDK（Node、Python、Go、Rust、Ruby、PHP、Swift、Kotlin）全部封装相同的 `/api/v1/*`，方法名也保持一致。每当我们新增一个 endpoint，都会在同一次发布中同步到所有 SDK。MCP 服务器（`@floopfloop/mcp`）将 Node SDK 暴露给 LLM agent，新方法会自动可用。如果你发现存在差异，那就是 bug —— 请在对应的 SDK 仓库提交 issue。