症状往往一模一样:命令能运行,但某个地方出了问题。会话找不到文件,更新迟迟不来,一条权限警告被你忽略了几周。在重装之前,有一个命令能把安装状态一次性摊在一屏里。
它叫 /doctor。它在 Verboo Code 会话内运行,不做任何修改,只读取并报告。
/doctor 做什么?
它检查 Verboo Code 是如何安装的,并报告检查结果:安装类型、版本、路径、shell 实际调用的二进制、配置安装方式、文件搜索状态、更新通道、全局目录的写权限以及沙箱依赖。它还会汇总那些平时容易被忽略的上下文警告,比如过大的 CLAUDE.md、膨胀的智能体描述,以及在你还没输入任何内容前就消耗 token 的 MCP 服务器。
它是一个会话内命令,以 local-jsx 实现。没有等价的 shell 子命令:你需要打开 verboo,在里面输入。
怎么运行 /doctor?
在任意目录打开 Verboo Code,输入该命令。读取立即发生,面板会留在屏幕上直到你关闭它。
$ verboo
> /doctor
Diagnostics
└ Currently running: npm-global (0.15.43)
└ Path: /usr/local/lib/node_modules/@verboo/code
└ Invoked: /usr/local/bin/node
└ Config install method: npm-global
└ Search: OK (bundled)
Updates
└ Auto-updates: Yes
└ Update permissions: No (requires sudo)
└ Auto-update channel: latest
└ Latest version: 0.15.43
以上为示例输出。关键是按顺序读 Diagnostics 区块的前五个字段,因为它们回答了最常见的问题:出问题时,真正在运行的是你以为的那个安装吗?
每个区块是什么意思?
| 区块 | 显示什么 | 什么时候重要 |
|---|---|---|
| Diagnostics | 安装类型、版本、路径、调用的二进制与配置方式 | 当实际行为与你以为的版本不一致时 |
| Search | 文件搜索是否正常,二进制来自哪里 | 当会话找不到项目文件时 |
| Updates | 自动更新是否开启、是否有权限、走哪个通道 | 当新版本已存在却迟迟不到时 |
| Sandbox | 沙箱依赖是否齐全 | 当命令在沙箱内以奇怪方式失败时 |
| Context Usage Warnings | 占用上下文的记忆文件与 MCP 服务器 | 当会话可用空间比预期小时 |
| Invalid Settings | 未通过校验的配置键 | 当你设置的某个选项完全没有生效时 |
常见警告怎么解决?
每条警告都指向一个具体修法,大多数只有一行。
Warning: Multiple installations found
机器上存在两份 Verboo Code,shell 可能正在调用你从不更新的那一份。该区块会列出每一份的类型和路径。把它与 shell 实际解析的结果对比:
which -a verboo
npm ls -g --depth=0 2>/dev/null | grep -i verboo
第二条列出的是 npm 全局副本。如果两者指向不同路径,卸载你不用的那份。同时保留两份,是“我更新了但什么都没变”最常见的成因。
Update permissions: No (requires sudo)
全局目录属于 root,自动更新无法写入。要么用属于你自己用户的 npm prefix 安装,要么用 sudo 手动更新。面板不会自行修复,只会告诉你。
Search: Not working
文件搜索未工作。括号里的值说明二进制本该来自哪里:bundled 表示随包内置,vendor 表示来自发行版,或者是某个系统二进制的路径。当模式为系统且该路径已不存在时,重装即可。
Context Usage Warnings
这里会出现三类上限:单个记忆文件过大、智能体描述累计 token 过多、MCP 工具超过上下文上限。面板会同时给出排好序的主要贡献者列表。砍掉不用的东西,而不是抬高上限。
Unreachable Permission Rules
你的一条权限规则永远不会被评估,因为前面某条规则已经决定了这个情况。这类配置看起来是生效的,其实没有。
Invalid Settings
配置文件里某个键没通过校验。面板会显示键名和原因,省得你在庞大的 JSON 里逐个排查。
/doctor 能显示 MCP 服务器的问题吗?
不能,这是有意为之,但容易让人误会。/doctor 在 MCP 连接建立之前运行,所以即使配置了服务器,MCP 工具计数也可能为空。关于 MCP 的上下文警告要等工具加载完成后才会出现。
MCP 服务器的诊断走 /mcp,它会列出每个已连接服务器及其状态。/doctor 管环境,/mcp 管服务器。
/doctor 解决不了的时候?
它只描述状态,不执行修复。如果面板一切正常而问题依旧,下一步要看会话而不是安装:模型是否回答了你预期的内容、项目配置文件是否被读取、工作目录是不是你以为的那个。这类情况下,答案通常在本轮会话的历史里,而不在机器的诊断里。
/doctor 存在的意义,是让你不要再靠猜测重装。动任何东西之前先运行它,从上到下读完 Diagnostics 区块,修好出现的第一个警告。如果你还没用上 Verboo Code,安装和第一个命令在 verboo.ai。

![[CC] 卡住 15 分钟毫无响应:怎样脱身](/_next/image?url=https%3A%2F%2Fstorage.googleapis.com%2Fverboo-landing-page%2Fblog-uploads%2F1783232445352-verboo-code-cover.png&w=3840&q=75)