用途:对 gbrain 知识库执行周期性健康检查与清理,保证反向链接、引用格式、归档规则等符合规范,并报告各维度问题数量。
主要能力:检查过期页面(compiled_truth 早于最新时间线条目)、孤立页(零入链)、死链、缺失交叉引用、反向链接、引用、归档与标签;每类问题给出具体修复动作;强制反向链接铁律;校验引用格式;按维度报告计数。
使用方式:先运行 gbrain health 查看仪表盘,再逐维度检查。链接图稀疏时可运行 gbrain extract links --dir ~/brain;时间线为空时运行 gbrain extract timeline --dir ~/brain。完整维护周期用 gbrain dream,包含 lint、backlinks、sync、synthesize、extract、patterns、embed、orphans 等阶段,可加 --phase、--input、--from/--to、--json 等参数。自动路径先预览:gbrain doctor --remediation-plan --json,用户同意后再执行 gbrain doctor --remediate --yes --include-repairs --expect <plan_hash> --target-score 90 --max-usd 5。自动巡检用 gbrain autopilot --status,未运行则 gbrain autopilot --install --repo ~/brain。
适用场景:例行维护、启动检查、doctor --fix、修复损坏内容、按维度审计、排查评分停滞。
限制:所有权失败属于检查边界,常规维护不授权更改写入拓扑;owner_unavailable 或写入协调拒绝时先查 gbrain sources writer status --brain <id> --json 并报告,不得认领检出、启用托管模式、转移所有权或移除所有权标记。目标分不可达时(如空大脑图覆盖上限 70、未配置嵌入密钥上限 60)任务停止并列出缺失项。--max-usd 为累计成本上限。v1 不自动 git add/commit/push。--dry-run 仍会调用 LLM 做评分分诊,零调用预览需用 gbrain dream retriage --dry-run。合成阶段有引用逐字校验、slug 规范、写入白名单与冷却时间等约束。