SuperAPI AI 工具集

lsp-setup

智能体与模型

查看项目

更新于 10-15 20:13

技能介绍

用途:为项目配置正确的 Language Server,使 lsp MCP 工具(诊断 diagnostics、goto_definition、find_references、symbols、rename)可用。该技能是一个索引:先检测项目需要什么,再安装服务器、写配置,最后用真实往返验证。

主要能力与流程:

  1. 语言门控:按文件扩展名识别语言并读取对应参考文档,覆盖 TypeScript/JS/Vue/Svelte、Python、Go、Rust、C/C++、Java、Kotlin、C#、Swift、Ruby、PHP、Dart、Elixir、Zig、Lua、Bash、YAML、Terraform、Haskell、Julia 等。
  2. 检测:运行 bun scripts/detect-lsp.ts <projectDir>(--json 输出机器可读),报告每种语言的内置服务器 id、所需可执行文件、是否已安装、安装提示及配置状态。
  3. 安装:按参考文档执行对应操作系统的安装命令,再用 command -v <server-executable> 确认可用。
  4. 配置:多数内置服务器无需配置,按扩展名自动解析。仅在需要选择服务器、设置优先级、传初始化选项、覆盖扩展名、设置环境变量或禁用服务器时写配置。项目级配置文件为 Codex 的 .codex/lsp-client.json 与 OpenCode/omo 的 .opencode/lsp.json(亦支持 .omo/lsp.json),结构含 command、extensions、priority、initialization、env、disabled。规则:项目配置中内置 id 自动继承 command,只可覆盖 extensions/priority/initialization;非内置 id 的项目配置被忽略,自定义服务器须放在用户配置(~/.codex/lsp-client.json 或 LSP_TOOLS_MCP_USER_CONFIG 指定路径)。项目条目优先于用户条目,两者均优先于内置默认。
  5. 验证:运行 bun scripts/verify-lsp.ts <file>(可加 --timeout=90000),启动服务器并请求诊断,返回 OK/FAIL;未安装则回到安装步骤,SKIP 表示找不到引擎源码。

脚本:detect-lsp.ts 扫描目录;verify-lsp.ts 做真实 LSP 诊断往返;lsp-server-table.ts 为各语言主内置服务器快照。需用 Bun 运行(curl -fsSL https://bun.sh/install | bash)。限制:脚本依赖 omo 仓库/worktree 引擎源码;具体各语言安装命令见对应参考文档,本资料未逐条列出。