用途:把已使用 gbrain-base(或任意带 migration_from 的包)的 brain 迁移到 gbrain-base-v2 分类法,将大量零散 pages.type 收敛为 15 个规范类型(person、company、media、tweet、social-digest、analysis、atom、concept、source、deal、email、slack、writing、project、note),把子类型/格式/来源下沉到 frontmatter。
触发时机:运行 gbrain onboard --check 看到 pack_upgrade_available 或 type_proliferation 警告;用户询问规范分类法或如何清理页面类型;出现 dangling_aliases 结果;自定义包摄取时想参考 v2 分类法。
用法:先确认当前包:gbrain schema active --json | jq -r '.identity'。若已是 gbrain-base-v2 则跳过。随后 gbrain onboard --check 查看变更,并用 gbrain onboard --check --explain 预览(dry-run)各集群重定型、重定向转别名、页面转链接的数量。应用时显式提交 PROTECTED 处理器:gbrain jobs submit unify-types --params '{"target_pack":"gbrain-base-v2","apply":true}';在 PGLite 或无 worker 的环境加 --follow 内联执行,否则任务会一直排队。apply 默认 false,必须显式设为 true。可用 gbrain jobs get <job_id> 或 gbrain jobs watch --follow 查看进度。完成后用 gbrain onboard --check 与 gbrain schema stats 验证。
限制:托管 brain(managed persistence 开启)暂不支持应用迁移,重定型会因 writer_coordinator_required 被拒绝,只能预览;例外是预览显示无需重定型时仅可切换活动包。该处理器为 manual_only,autopilot 不会自动触发;远程 MCP 提交会被拒,需本地受信 CLI。并发提交由 gbrain-unify 锁串行化。186K 页约需 10 分钟,重定型可能调用模型,需先确认预算。回滚依赖 frontmatter.legacy_type;旧类型别名页与链接页软删除有 72 小时恢复窗口(gbrain restore <slug>),包切换可用 gbrain schema use gbrain-base 回退。
适用场景:页面类型泛滥、含大量概念重定向或边缘型页面的 brain 一次性分类法升级。