用途:帮助用户为测试与开发选择并创建正确的 Neon 分支类型,产出为一个已创建的 Neon 分支,或在无法创建时给出明确的下一步。
主要能力:区分普通分支与仅模式(Schema-only,Beta)分支。需要针对类生产数据测试复杂迁移、性能或行为时选普通分支;需避免复制敏感数据时选仅模式分支。请求不明确时先问一句:需要真实数据测试,还是因数据敏感只需结构?
使用方式:优先使用用户已安装并认证的工具。MCP 可用且已认证时用 MCP;否则检查 CLI,运行 neon --version 确认安装,neon projects list 确认认证与上下文;CLI 缺失则按快速开始安装,未认证则先完成 neon auth 或 API key 认证;两者都不可用时改用 Neon REST API。创建普通分支:neon branches create --name <branch-name> --parent <parent-branch-id-or-name> --expires-at 2026-12-15T18:02:16Z,随后可用 neon connection-string <branch-name> 获取连接串。创建仅模式分支:neon branches create --name <schema-only-branch-name> --parent <parent-branch-id-or-name> --schema-only --expires-at 2026-12-15T18:02:16Z,多项目时加 --project-id <your-project-id>。
从父分支重置:用于子分支落后时刷新,会完全替换子分支的 schema 与数据,不合并,子分支本地改动丢失,连接信息不变但活动连接会短暂中断。命令:neon branches reset <id|name> --parent --preserve-under-name <backup-branch-name>。限制:仅子分支可重置,根分支与仅模式根分支不可;目标分支有子分支时需先移除;父分支从快照恢复后 24 小时内可能不可用;需要时间点恢复应使用 Instant restore。
适用场景:每个 PR 一个分支、每次测试运行一个分支、每位开发者一个分支、PII 感知分支、临时分支生命周期管理;CI/CD 中做预览部署、迁移测试与 schema diff。
限制:仅模式分支为 Beta,异常时可通过 Neon Console 反馈或 Discord 支持;仅模式分支是独立根分支,无父分支与共享历史,不适用从父分支重置;根分支配额与每分支存储限制会限制可创建数量。执行前应核对官方文档中的命令、API 行为、定价、配额与凭据,破坏性或高成本操作需用户确认。