核心功能与用法
Biver Builder 是 Biver 落地页构建器的官方 API 集成技能，专为开发者、营销团队和自动化工作流设计。该技能提供完整的 REST API 封装，涵盖页面创建、域名配置、AI 内容生成、产品/表单/媒体资源管理等核心能力。
主要能力模块：
| 模块 | 核心功能 | 典型场景 |
|------|---------|---------|
| **Pages** | 创建/更新/删除/部署落地页 | 批量生成营销活动页面 |
| **Subdomains** | 管理 `.lp.biver.id` 子域名 | 为每个活动分配独立 URL |
| **Domains** | 自定义域名绑定与 SSL | 品牌官网 white-label |
| **AI Generation** | AI 生成完整页面或单区块 | 快速原型设计、A/B 测试 |
| **Products** | 产品目录 CRUD | 电商落地页商品同步 |
| **Forms** | 表单构建与提交数据获取 | 潜客收集、问卷调查 |
| **Gallery** | 媒体资源上传与管理 | 批量图片/视频资产管理 |
| **Workspace** | 全局设置与品牌配置 | 多租户场景、 agency 管理 |
认证机制：采用 X-API-Key Header 认证，支持 bvr_test_（沙箱）和 bvr_live_（生产）两种密钥前缀，支持细粒度 OAuth 风格 Scope 权限控制。
典型工作流示例：
1. 创建子域名 → AI 生成页面内容 → 部署发布
2. 上传产品图片 → 批量创建产品 → 关联到落地页区块
3. 绑定自定义域名 → 配置 DNS → 设置为主域名
---
显著优点
1. 官方原生集成：直接对接 Biver 官方 API（api.biver.id），非第三方逆向，数据一致性与服务稳定性有保障
2. AI 原生能力：内置 /v1/ai/pages 和 /v1/ai/sections 端点，支持自然语言生成完整页面，显著降低设计门槛
3. 细粒度权限：16 个独立 Scope（如 pages:read、domains:write、ai:generate），支持最小权限原则
4. 双环境密钥：明确的 test/live 密钥分离机制，避免测试误操作影响生产数据
5. 完整域名生态：同时支持平台子域名（免费 .lp.biver.id）和自定义域名（CNAME/SSL），覆盖从 MVP 到企业品牌的全阶段需求
6. 无代码友好：表单提交端点 /v1/forms/:id/submit 无需认证，可直接嵌入前端，降低集成成本
---
潜在缺点与局限性
1. 生态锁定：深度绑定 Biver 平台，数据迁移至其他建站工具成本较高
2. 地理限制：API 服务端点位于印尼（biver.id），对非东南亚用户可能存在延迟问题
3. Rate Limit 分层严格：免费档（SCOUT）仅 30 req/min，高频自动化场景需付费升级
4. AI 生成不可控：AI 输出为黑盒，复杂品牌视觉系统可能需要人工后调整
5. DNS 配置外部依赖：自定义域名需用户自行配置 CNAME，无法完全自动化
6. 社区规模有限：GitHub 仓库（RamaAditya49/biver-builder）为个人维护，非 Biver 官方组织，长期维护可持续性待观察
---
适合人群
- 数字营销团队：需要批量快速生成活动落地页、A/B 测试页面
- SaaS 产品公司：需为不同客户生成 white-label 落地页或文档站点
- 电商运营：管理大量 SKU 详情页，需要产品与页面内容联动
- Agency / 工作室：为客户托管多租户建站方案，需 API 自动化
- 自动化工程师：构建 CI/CD 驱动的页面发布流水线
---
常规风险
| 风险类别 | 具体描述 | 缓解建议 |
|---------|---------|---------|
| **密钥泄露** | API Key 硬编码至代码仓库或日志 | 强制使用环境变量 `BIVER_API_KEY`，启用密钥轮换 |
| **权限过度** | 为测试目的授予 `*:write` 全权限 | 遵循文档建议，初始仅使用 `*:read`，按需增量开放 |
| **生产误操作** | 测试脚本误用 `bvr_live_` 密钥 | 在 CI/CD 中设置密钥前缀校验拦截 |
| **DNS 劫持** | 自定义域名 CNAME 配置错误导致流量劫持 | 严格遵循 API 返回的 `verificationToken` 进行 DNS 验证 |
| **Rate Limit 中断** | 高频任务触发 429 限流 | 实现指数退避重试，监控 `X-RateLimit-Remaining` |
| **供应链风险** | 个人仓库维护可能中断 | 建议 Fork 后内部维护，或关注 Biver 官方是否接管 |