pi-coding-tools

提供 AST/LSP 代码智能工具的 Pi 扩展包。

AST/LSP 代码理解工具

新增 5 个 token-efficient 工具，让 LLM 用最少 token 理解代码库：

支持语言

服务器以 pi 会话的工作目录为根启动，所以项目内的文件（node_modules、compile_commands.json、 Gradle/Maven 元数据）都相对它解析。

除服务器二进制本身外的前置依赖：

• TypeScript/JavaScript —— 最近的 typescript（按会话工作目录逐级向上找）≥ 7 时，直接用它内置的 native LSP：tsc --lsp --stdio，无需额外安装、也不经过 tsserver.js。用 lsp.servers.tsc.disabled 可强制回落。 旧项目（TypeScript ≤ 6）回落到 typescript-language-server，它需要一个带 lib/tsserver.js 的 TypeScript： 全局装 npm i -g typescript-language-server typescript@6，或装进项目（npm i -D typescript@6）按仓库固定 版本。typescript 7.x 是 native 移植版、没有 tsserver.js，无法充当这个回落；两者都没有时服务器会报 Could not find a valid TypeScript installation。
• Python —— 无额外依赖：解析标准库符号不需要解释器或 virtualenv。
• Java —— 需要 Java 21+（JAVA_HOME 或 PATH）；jdtls 包装脚本会自己挑 -data 目录。
• Kotlin —— 需 JDK 11+；classpath 由 Gradle、Maven 或 kls-classpath 脚本解析，所以单独的 .kt 文件只有有限结果。fwcd 版已废弃，官方 kotlin-lsp（alpha）可用： 把命令覆盖为 "lsp": { "servers": { "kotlin-language-server": { "command": ["kotlin-lsp.sh", "--stdio"] } } }。
• C/C++ —— compile_commands.json 只在需要项目专属 include 路径与宏时才必需；没有它 clangd 会退回 默认编译命令，基本 hover/跳转仍可用。

ast_grep_search 支持 ts/tsx/js/python/java/kotlin/c/cpp，无需 LSP。上表之外的语言（Rust、Go、Ruby……）不在 覆盖范围内：ast_grep_* 会拒绝未知的 lang，lsp_* 也只认上面这些语言——其它文件返回 No LSP server for <path>。配置只能覆盖内置服务器，不能新注册。

ast-grep 二进制

ast_grep_search 需要 ast-grep（或 sg）二进制。安装：npm i -g @ast-grep/cli / cargo install ast-grep / brew install ast-grep。

安装

pi install npm:@yandy0725/pi-coding-tools

配置

配置文件控制这 5 个自定义工具的启用状态。所有工具默认启用。

完整结构：

{
  "ast_grep_search": true,
  "ast_grep_replace": true,
  "lsp_symbols": true,
  "lsp_hover": true,
  "lsp_navigate": true,
  "lsp": { "disabled": false, "servers": { "clangd": { "disabled": true } } }
}

per-server 覆盖项还支持 command（字符串数组，如 ["clangd", "--background-index"]）。 内置 server id：tsc（native TypeScript ≥ 7）、typescript-language-server、pyright、jdtls、 kotlin-language-server、clangd。

全局配置

~/.pi/agent/coding-tools.json：

{
  "ast_grep_search": true,
  "lsp_hover": true
}

项目级配置

<project>/.pi/coding-tools.json（覆盖全局配置）：

{
  "lsp_hover": false
}

字段说明

License

MIT