如何验证no-mistakes安装成功：doctor命令完全指南

如何验证no-mistakes安装成功：doctor命令完全指南

【免费下载链接】no-mistakesgit push no-mistakes项目地址: https://gitcode.com/GitHub_Trending/no/no-mistakes

刚装好no-mistakes却不确定是否装对了？一条命令就能搞定——no-mistakes doctor。作为 AI 驱动的代码质量门禁工具，no-mistakes 让你执行git push no-mistakes后自动完成审查、测试、开 PR 全流程，而doctor 命令正是验证 no-mistakes 安装成功的官方自检工具：它会一次性检查 git、数据目录、守护进程和 AI Agent 运行环境，并用 ✓ / – / ✗ 三色符号告诉你哪里有问题。

什么是 no-mistakes doctor 命令

doctor是 no-mistakes 内置的"系统健康检查"子命令，相当于新装系统后的体检报告。它不启动任何流水线，只负责确认环境就绪：

• 核心依赖是否安装（git、gh、az）
• 数据目录与 SQLite 数据库是否正常
• 后台守护进程（daemon）是否在运行
• 至少一个 AI Agent（claude、codex、grok 等）是否可用
• 门禁校验（gate validation）能否找到可运行的验证 Agent

检查逻辑的完整实现位于 internal/cli/doctor.go，官方命令文档见 docs/src/content/docs/reference/cli.md。

三步完成 no-mistakes 安装验证

第 1 步：打开终端运行 doctor

no-mistakes doctor

如果终端提示找不到该命令，说明安装本身没成功，先回到安装脚本（docs/src/content/docs/start-here/installation.md）重新执行安装。

第 2 步：读懂三种状态符号

输出末尾若出现红色的some checks failed，说明存在✗项，需按下面的对照表逐项修复。

第 3 步：确认 gate validation 为 ✓

这是最关键的一行。no-mistakes 的每条流水线都必须由一个可运行的 Agent 驱动，gate validation显示xxx is runnable（如claude is runnable）才代表验证安装成功，可以正式使用。

doctor 检查项逐项详解

System 部分：系统基础依赖

• git（必需）：显示版本号，缺失即安装失败
• gh（可选）：GitHub 的 PR 与 CI 步骤需要
• az（可选）：Azure DevOps 的 PR 与 CI 步骤需要
• data directory：~/.no-mistakes/数据目录，安装时自动创建
• database：SQLite 数据库，首次使用时自动创建，所以显示–也正常
• daemon：后台守护进程，running表示健康

Agents 部分：AI Agent 运行器

doctor 会逐个探测常见 Agent 的二进制文件，你只需要装好其中一个：

Agent 探测逻辑见 internal/cli/doctor.go，各 Agent 的配置与选择方式详见 docs/src/content/docs/guides/agents.md。

Forge profiles 部分：自定义代码托管配置

如果你在~/.no-mistakes/config.yaml中配置了forge_profiles，doctor 还会验证每个主机 profile 的 CLI 认证状态（如gh auth status）。未配置则跳过此项。

常见问题快速修复

gate validation显示 no runnable agent

原因：所有已配置 Agent 的二进制都不在 PATH 中。no-mistakes 不会"降级"跳过验证，找不到 Agent 就是硬性失败。

修复：

1. 确认已安装至少一个 Agent（如claude --version能跑通）
2. 若 Agent 装在版本管理器的 shim 目录等非标准位置，在~/.no-mistakes/config.yaml中用agent_path_override显式指定路径
3. 重新运行no-mistakes doctor

git not found

安装 no-mistakes 的前提是系统已装好 git。先执行git --version确认，缺失则通过系统包管理器安装。

daemon stopped是故障吗？

不一定是。daemon 显示–只表示当前没在运行，推送时会按需启动。如果你希望它常驻，可执行no-mistakes daemon restart后再跑一次 doctor 确认。

排查顺序建议

官方推荐的调试顺序是：先跑 doctor → 再看 daemon 状态 → 最后查 Agent 与 provider 配置，详见 docs/src/content/docs/guides/troubleshooting.md。

验证通过后的下一步：第一次 git push no-mistakes

doctor 全部变绿后，就可以正式使用了：

no-mistakes init # 在目标仓库中初始化门禁 git checkout my-branch # 切到工作分支 # …做一些改动并提交… git push no-mistakes # 推送到门禁 remote，而非 origin no-mistakes # 打开 TUI 查看流水线进度

流水线全绿后，门禁会自动把分支转发到真实 remote 并替你开好 PR。完整的初次运行流程见 docs/src/content/docs/start-here/quick-start.md。

小结

记住一条原则：gate validation出现 ✓，就代表 no-mistakes 安装成功、随时可用。遇到其他问题，把 doctor 的输出贴给项目维护者，能极大加快定位速度。

【免费下载链接】no-mistakesgit push no-mistakes项目地址: https://gitcode.com/GitHub_Trending/no/no-mistakes