智能体改完一个 TypeScript 文件,执行你要求的命令,然后说已经完成。类型错误要等到你构建或者 CI 报错时才出现。在那之前,它一直在摸黑工作:读文件、凭推断做出选择、继续往下走。
Verboo Code 的 /lsp 命令正好补上这个缺口。它把语言服务器接到智能体上,从那一刻起,对话可以真正查询定义、引用、类型和诊断,而不是根据文件文本猜。
整个过程有四步,全部在终端里完成:查看当前状态、找到适合你项目的插件、安装二进制和插件、确认智能体已经能看见代码。
接上语言服务器后,智能体多了什么?
它得到两样没有 LSP 就不存在的能力:结构化的代码查询,以及自动诊断。
查询来自一个支持九种操作的工具。每种操作都需要文件路径、行号和列号,从 1 开始计数,和编辑器里看到的一致:
| 操作 | 返回什么 |
|---|---|
| goToDefinition | 符号定义的位置 |
| findReferences | 该符号在项目中的所有使用位置 |
| hover | 该位置的类型和文档 |
| documentSymbol | 文件里的函数、类和变量 |
| workspaceSymbol | 整个工作区里的符号 |
| goToImplementation | 接口或抽象方法的实现 |
| prepareCallHierarchy | 调用层级分析的起点 |
| incomingCalls | 调用该位置函数的函数 |
| outgoingCalls | 该函数调用的函数 |
诊断是另一半。服务器在编辑后发布错误时,Verboo Code 会把诊断作为附件送进对话,不需要你主动询问。每次发送上限为每个文件 10 条、每批 30 条,已经发送过的诊断不会在下一轮重复出现。
怎么检查是否已经有 LSP 服务器在运行?
在会话里运行 /lsp status。它会显示初始化状态,以及每个来自插件的服务器。
> /lsp status
LSP status
Initialization: success
Configured plugin LSP servers: 1
- typescript (state: running)
command: typescript-language-server --stdio
extensions: .cjs, .cts, .js, .jsx, .mjs, .mts, .ts, .tsx
如果列表为空,输出会以 Configured plugin LSP servers: none 结束。状态是 stopped 不算失败:这是懒启动,第一次查询时才拉起进程,在不用该语言的项目里节省内存。
怎么找到适合自己项目的插件?
运行 /lsp recommend,指向文件夹、某个文件或某个扩展名。命令会读取项目的扩展名,按出现频率排序,再和已安装市场里的 LSP 插件做匹配。
> /lsp recommend .
LSP recommendations for .
- typescript-lsp@claude-plugins-official (not installed, binary: found)
command: typescript-language-server
extensions: .cjs, .cts, .js, .jsx, .mjs, .mts, .ts, .tsx
description: TypeScript/JavaScript language server for enhanced code intelligence
next: /lsp install typescript-lsp@claude-plugins-official
括号里的两个标记要分开看。not installed 说的是插件。binary: found 说的是服务器可执行文件,它必须在 PATH 里。二进制缺失时,输出会把最后一行换成一个代码块,里面有安装命令和验证命令。
Verboo Code 有自己的市场 verboo-plugins,同时把生态的官方插件市场作为第二来源。语言类插件在第二个市场里,找不到候选时 /lsp recommend 会自动注册它。这需要系统里有 git。没有的话,输出会提示市场暂时不可用。
怎么安装二进制和插件?
两样东西,顺序很重要:先装服务器可执行文件,再装告诉 Verboo Code 怎么调用它的插件。表格里的命令就是二进制缺失时 /lsp recommend 打印出来的内容。
| 语言 | 插件 | 安装二进制 | 验证 |
|---|---|---|---|
| TypeScript 和 JavaScript | typescript-lsp | npm install -g typescript typescript-language-server | typescript-language-server --version |
| Python | pyright-lsp | npm install -g pyright | pyright-langserver --help |
| Go | gopls-lsp | go install golang.org/x/tools/gopls@latest | gopls version |
| Rust | rust-analyzer-lsp | rustup component add rust-analyzer | rust-analyzer --version |
| C 和 C++ | clangd-lsp | sudo apt install clangd | clangd --version |
| PHP | php-lsp | npm install -g intelephense | intelephense --version |
| Ruby | ruby-lsp | gem install ruby-lsp | ruby-lsp --version |
| C# | csharp-lsp | dotnet tool install --global csharp-ls | csharp-ls --version |
二进制在 PATH 里之后,用完整 id 安装插件,@ 后面是市场名:
> /lsp install typescript-lsp@claude-plugins-official
Installed typescript-lsp@claude-plugins-official. Activated 1 plugin LSP server.
安装作用在用户级别:对这台机器上的所有项目生效,不只是当前打开的文件夹。要撤销,运行 /lsp uninstall typescript-lsp@claude-plugins-official。
二进制必须位于打开 Verboo Code 的那个进程的 PATH 里。用 nvm 装 Node 的人最容易在这里踩坑:npm 的全局目录只有在 nvm 加载后才进入 PATH。先打开终端、加载 nvm,再调用 verboo。如果安装看起来没问题,/lsp recommend 却仍报 binary: missing,先运行 which typescript-language-server,再去怀疑插件。
怎么确认智能体已经能看见代码?
再运行一次 /lsp status,确认服务器出现在列表里。然后提一个只有服务器能回答的问题,比如某个类型定义在哪里、谁在调用某个函数。智能体会用行号和列号调用 LSP 工具,返回真实位置,而不是文本搜索的结果。
最快的验证是错误。让它做一次故意破坏类型的修改。服务器在运行时,错误会在同一次回复里返回,早于任何 tsc。没有服务器时,工具会返回 No LSP server available for file type: .ts,智能体只有跑到构建阶段才会发现问题。
服务器起不来怎么办?
三种原因几乎覆盖所有情况:二进制不在 PATH、插件缺失、内存里留着旧配置。
- 推荐结果里出现
binary: missing:安装可执行文件,再用表格里的验证命令确认。 Configured plugin LSP servers: none:插件没装或被禁用。/lsp install解决第一种情况。- 服务器带着旧配置:
/lsp restart重启管理器并重新读取插件。
> /lsp restart
LSP restarted. 1 server configured.
初始化失败时,/lsp status 会显示 Initialization: failed 和错误信息,每个有问题的服务器还会带一行 last error。真正的原因就在那里,比如命令不存在或者启动超时。
如果问题出在环境而不是服务器,/doctor 可以把诊断做完:它会读取安装方式、PATH 和配置,然后你再决定要不要重装。
/lsp 不会猜你的技术栈:它读取项目,打印插件和二进制安装命令。如果你的项目是 TypeScript,在 Verboo Code 里打开文件夹,运行 /lsp recommend .,看看它对你这个仓库给出的真实推荐。

![[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)