[navori](https://ulisescm.github.io/navori-harness/zh-cn/docs/doctor) · 简体中文

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

## 命令 

[navori init](https://ulisescm.github.io/navori-harness/zh-cn/docs/init)[navori add](https://ulisescm.github.io/navori-harness/zh-cn/docs/add)[navori remove](https://ulisescm.github.io/navori-harness/zh-cn/docs/remove)[navori adopt](https://ulisescm.github.io/navori-harness/zh-cn/docs/adopt)[navori configure](https://ulisescm.github.io/navori-harness/zh-cn/docs/configure)[navori preset](https://ulisescm.github.io/navori-harness/zh-cn/docs/preset)[navori render](https://ulisescm.github.io/navori-harness/zh-cn/docs/render)[navori sync](https://ulisescm.github.io/navori-harness/zh-cn/docs/sync)[navori update](https://ulisescm.github.io/navori-harness/zh-cn/docs/update)[navori refresh](https://ulisescm.github.io/navori-harness/zh-cn/docs/refresh)[navori scan](https://ulisescm.github.io/navori-harness/zh-cn/docs/scan)[navori doctor](https://ulisescm.github.io/navori-harness/zh-cn/docs/doctor)[navori status](https://ulisescm.github.io/navori-harness/zh-cn/docs/status)[navori bench](https://ulisescm.github.io/navori-harness/zh-cn/docs/bench)[navori codex](https://ulisescm.github.io/navori-harness/zh-cn/docs/codex)[navori audit](https://ulisescm.github.io/navori-harness/zh-cn/docs/audit)[navori backup](https://ulisescm.github.io/navori-harness/zh-cn/docs/backup)[navori migrations](https://ulisescm.github.io/navori-harness/zh-cn/docs/migrations)[navori registry](https://ulisescm.github.io/navori-harness/zh-cn/docs/registry)[navori workspace](https://ulisescm.github.io/navori-harness/zh-cn/docs/workspace)[navori ticket](https://ulisescm.github.io/navori-harness/zh-cn/docs/ticket)[navori dominio](https://ulisescm.github.io/navori-harness/zh-cn/docs/dominio)[navori tools](https://ulisescm.github.io/navori-harness/zh-cn/docs/tools)[navori receipt](https://ulisescm.github.io/navori-harness/zh-cn/docs/receipt)[navori plan](https://ulisescm.github.io/navori-harness/zh-cn/docs/plan)[navori spec](https://ulisescm.github.io/navori-harness/zh-cn/docs/spec)[navori handoff](https://ulisescm.github.io/navori-harness/zh-cn/docs/handoff)[navori master](https://ulisescm.github.io/navori-harness/zh-cn/docs/master)[navori gate](https://ulisescm.github.io/navori-harness/zh-cn/docs/gate) 暂无 man 手册，本页为命令参考。 

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。