navori
navori

doctor

审计项目配置、插件、漂移、不变量并建议后续步骤。

用法 

navori doctor [--json] [--strict]

参数

--json 面向 CI 的结构化输出，可接管道。
--strict 发现漂移或 .mcp.json 与插件清单不一致时退出 1，适用于 CI 关卡。

示例

诊断

$ navori doctor
Config · navori.config.json
Managed blocks · 5
! drift: .claude/agents/orchestrator.md edited by hand
Next steps · run 'navori sync --interactive'

注意事项

  • 在 CI 运行 doctor --strict，使未解决漂移导致构建失败。
  • navori.config.json 的可选 harnessVersion 记录最后实际修改内容的 navori 版本。仅 render/sync/adopt --apply 真正写入或删除时更新，且从不降低。它高于当前 CLI 版本时，doctor 报告 harness 问题，--strict 失败。
  • 逐块 version 漂移和 staleBlocks 已退役；标记 version 表示该内容最后变化的版本。--json 的 DriftReport.kind 变为 downgrade|harness|content，对 JSON 消费者构成不兼容变化。
  • 检查必须保留的关键子串不变量，缺失时退出 2。
  • CODEX_HOME 已设置时读取 $CODEX_HOME/config.toml，否则读取 ~/.codex/config.toml；拒绝相对路径。
  • 启用 codex 时检查所有带 .codex/config.toml 的 git worktree；缺少批准时显示钩子、路径与 cd <path> && navori codex trust。Codex 新于最近已验证版本时也提示；git 或磁盘失败时降级为警告。
  • 渲染钩子调用 navori 时，若 PATH 中全局 navori 低于当前 doctor CLI 则警告，避免旧逻辑；不改变 ok。
  • 对声明 latestRelease 的外部工具（目前 engram），以信息提示稳定新版本，低于已知故障下限（engram < 3.0.0）时警告。均不改变结论或 --strict。