KeynoWu/dsh-lsp-plugin

[!IMPORTANT]
本仓库已归档，不再维护。 功能已融合进 dsh-omp-tools（模块化融合仓库，LSP 为迭代 1 模块），请前往新仓库获取最新版本。

dsh-lsp-plugin

给 DeepSeek Harness 装上真正的语言智能：内置语言服务器检测与进程池，让 agent 在 coding 时拥有语义级的「查错 / 找定义 / 找引用 / 看类型」能力——不再靠猜。

状态：M1–M4 已实现并通过验证（设计文档：lsp-plugin-design.md v2）

为什么需要它：DSH 原本只有「文本级近似」

没有 LSP 时，agent 在代码库里是这样工作的：

| 想做的事 | 没有 LSP（现状） | 有了 LSP（本插件） |
|---|---|---|
| 写完代码查错 | 手动跑编译器/测试——慢、要搭命令、输出噪音大 | lsp_diagnostics：毫秒级增量诊断，精确到行，改完 A 立刻知道有没有破坏 B |
| 找定义 / 引用 | grep 字符串匹配——漏别名/重导出/动态分发，混进注释和字符串噪音 | lsp_definition / lsp_references：语义精确匹配，穿透 import 别名、重导出、动态分发，不含噪音 |
| 理解类型签名 | read 文件自己推断 | lsp_hover：直接给出类型签名与文档 |
| 大代码库导航 | 凭文件名和 grep 猜位置 | 按语言服务器解析的真实符号表定位，跨文件引用一次到位 |

核心区别一句话：没有 LSP 的 agent 在「猜」代码，有 LSP 的 agent 在「读」代码。 语义分析是每种语言的重活，不该由 LLM 猜测，也不该让 grep 硬凑——交给专业语言服务器（tsserver / pyright / gopls / rust-analyzer…），agent 只负责「问」和「用答案」。

它最值钱的使用场景：agent 在长会话、大代码库里「行动前先验证、行动后先查错」——这正是当前 coding agent 最常出错、最需要精确信息的地方。

能力

五个工具（四个只读 + 一个写操作，全部基于 LSP 语义分析，非文本搜索）：

| 工具 | 作用 |
|---|---|
| lsp_diagnostics | 文件级语言诊断（增量分析，按 severity 排序）——收益最大，写完先查错 |
| lsp_definition | 符号定义位置（穿透别名/重导出/动态分发） |
| lsp_references | 全部引用（含声明，语义精确，不含注释/字符串噪音） |
| lsp_hover | 类型签名/文档（Markdown 扁平化） |
| lsp_rename | 语义重命名（跨文件引用同步，WorkspaceEdit 经 DSH 文件 seam 应用，走写审批） |

内置 16 种语言目录（前端/后端/Android/iOS/数据岗位全覆盖）：TypeScript、Vue、HTML、CSS、Python(pyright)、Go、Rust、Java、C#、PHP、Ruby、C/C++、Kotlin、Swift、SQL、R。

- 默认全部不启用——在设置页勾选你要用的岗位语言即可，零资源浪费
- 勾选后当前会话即时生效，无需重启
- 语言服务器不随插件安装：检测本机已有二进制（node_modules/.bin → $PATH）；缺失时设置页显示状态，可一键安装引导（每语言内置安装命令，用户级目录安装）

工程化生命周期：懒启动（不勾选不 spawn）、command:projectRoot 进程池（同一项目共享一个服务器实例）、就绪等待独立预算（重语言如 rust-analyzer/sourcekit-lsp 首启不卡工具超时，实测独立超时生效）、idle 回收（空闲自动释放，in-flight 不打断）、崩溃自动重启（上限 1，避免打转）、并发上限（maxConcurrentServers 默认 4，超限明确拒绝）。

快速开始

1. 克隆本仓库，链接插件到目标 profile（以 web profile 为例）
mkdir -p ~/.dsh/profiles/web/node_modules
ln -s "$(pwd)/scratch-lsp-plugin" ~/.dsh/profiles/web/node_modules/dsh-lsp-plugin

2. 在 ~/.dsh/profiles/web/cordis.patch.yml 挂载：
- insert:
- id: dsh-lsp-plugin
name: dsh-lsp-plugin
config:
enabled:
typescript: true

3. 重启 dsh web，开始享受语义级 coding

建议先装好常用语言的服务器（插件负责检测与启动，安装交给包管理器）：

npm i -g typescript-language-server pyright   # TS/JS + Python（P0，最成熟）
其他语言：gopls / rust-analyzer / clangd / sourcekit-lsp 等按需安装

设置

设置 → LSP 语言：按岗位分组的 16 语言勾选 + 空闲回收超时 + 并发上限；每行显示状态徽标（可用 ✓版本 / 缺失 ⚠ + 安装按钮）。也可直接编辑 ~/.dsh/settings.yaml（外部编辑自动生效）：

lsp:
enabled:
typescript: true
python: true
idleTimeoutMs: 300000
maxConcurrentServers: 4

开发与验证

cd scratch-lsp-plugin && npx tsc --noEmit          # 类型检查
node scripts/build-client.mjs                      # client bundle（DSH ModuleLoader 格式）bash
npm run build:status                               # host remote gateway（装饰器转译）

各里程碑的验证结论（沙箱 spawn、双向 JSON-RPC、五工具 TS/Python 9/9、崩溃重试、settings 接线、慢启动独立预算、并发上限、pyright 噪音修复）记录在设计文档 lsp-plugin-design.md §11.3；开发期验证脚本依赖本机 DSH 安装，保存在仓库历史中，需要时从 git 历史找回。

里程碑

- M0 ✅ 风险验证（沙箱可 spawn 外部二进制、双向 JSON-RPC、环境 scrub）
- M1 ✅ 端到端最小（lsp_definition，agent 实测返回正确定义位置）
- M2 ✅ 四工具 + 生命周期 + 全量目录（9/9 + 崩溃重试 PASS）
- M3 ✅ host settings 接线 + client 设置页（esbuild ModuleLoader bundle，浏览器验收通过）
- M4 ✅ host remote 状态数据源 + 安装引导 + lsp_rename（ctx.fs 写审批）+ pyright 噪音修复 + 慢启动实测 + 并发上限（workspace 诊断按需）

License

MIT