tesserae doctor — 项目健康检查

<!-- translations:start -->

English · 한국어 · 中文 · 日本語 · Русский · Español · Français · Deutsch

<!-- translations:end --> tesserae doctor 会端到端地检查一个 Tesserae 工作区——初始化、图谱完整性、注册表一致性、新鲜度、锁、LLM 登录状态以及磁盘卫生——并打印一份检查清单。它默认只读；--fix 只应用可安全重复执行的修复，绝不会破坏活动状态。

tesserae doctor                 # check the current project
tesserae doctor --fix           # apply the safe repairs, then re-check
tesserae doctor --all --json    # every registered project, JSON report
tesserae doctor --project ~/src/other

检查内容

二十项检查，按类别分组：

崩溃的检查会作为一条 error 级发现被报告——doctor 本身永不抛出异常。

--fix 策略

• --fix 只运行上表标记为 SAFE 的检查，然后重新检测，使报告反映修复后的状态。
• 每个修复都是幂等的：连续运行两次 doctor --fix，第二次运行结果是干净的。
• Doctor 绝不杀掉进程，也绝不移除活动的编译锁——被持有的锁会连同持有它的 pid 一并报告，并保持原样。
• 重型或联网操作（重新编译、依赖安装、后端刷新）绝不会被折叠进 --fix；doctor 会打印出命令供你自己运行。

退出码

与 tesserae lint 同一约定：

报告产物

每次运行都会把两种形式的报告写入工作区：

.tesserae/doctor-report.md      # human checklist
.tesserae/doctor-report.json    # structured findings

--json 额外把 JSON 报告打印到 stdout，替代 markdown 检查清单。--all 遍历注册表中的每个项目（忽略 --project），并按项目分别报告。

MCP：doctor_report

MCP 服务器以 doctor_report 工具的形式暴露同一份报告（对照 lint_report，包括其返回内容的字节上限），因此 agent 可以在对话中途检查工作区健康状况而无需调用 shell。它需要一个项目根目录——传入 graph_path/project，或配置一个默认图谱。