dsh-tool-lsp

English | 中文

给 DeepSeek Harness 用的 LSP 工具面：把真实语言服务器 的诊断、格式化、重命名、代码动作和符号导航，变成模型可直接调用的 5 个工具。

工具

| 工具 | 作用 | 会写盘 | |---|---|---| | lsp_diagnostics | 文件诊断（合并 pull 与 push 两条通道） | 否 | | lsp_format | 整文件 / 范围格式化 | 是 | | lsp_rename | 语义级重命名，可跨文件 | 是 | | lsp_code_action | 语言服务器给出的修复建议 | 是（应用所选动作时） | | lsp_symbols | 文件大纲 / 工作区符号搜索 | 否 |

写盘走 Harness 的文件系统观测策略：文件在本次读取之后被外部改过，会以 LSP_WRITE_CONFLICT 失败，而不是静默覆盖。

安装

dsh plugin --profile web add dsh-tool-lsp

装完在 dshmarket 里启用。插件默认关闭——用时点一下开关，即时生效，不需要重启。开关不跨重启保留：重启后回到关闭。

配置

语言服务器表写在用户 profile 的补丁层（$DSH_HOME/profiles/<name>/cordis.patch.yml）， 不能写在插件包内：包内的 cordis.patch.yml 必须保持纯 insert 行，否则 dshmarket 无法热挂载/卸载本插件。

- id: lsp
  config:
    servers:
      vtsls:
        command: vtsls
        args: ["--stdio"]
        extensionToLanguage:
          ".ts": typescript
          ".tsx": typescriptreact
          ".js": javascript
          ".jsx": javascriptreact
        projectMarkers: ["package.json", "tsconfig.json"]
        configuration:                 # workspace/configuration 的应答
          typescript:
            preferences:
              includePackageJsonAutoImports: "on"

      rust:
        command: rust-analyzer
        extensionToLanguage:
          ".rs": rust
        projectMarkers: ["Cargo.toml"]

      biome:
        command: biome
        args: ["lsp-proxy"]
        extensionToLanguage:
          ".json": json
          ".css": css
        projectMarkers: ["biome.json"]

# 开关必须另起一行：同 id 的多行会按键合并，但合成一行会被市场开关破坏
- id: lsp
  disabled: true

服务器条目字段

| 字段 | 必填 | 默认 | 说明 | |---|---|---|---| | command | ✅ | — | 可执行文件名，挂载时按 PATH 解析；写错会当场报错 | | extensionToLanguage | ✅ | — | 扩展名 → LSP languageId | | fileGlobs | | [] | 路径 glob，优先级最高 | | projectMarkers | | [] | 项目标记文件名，用于同扩展名多服务器分流 | | args | | [] | 启动参数 | | env | | {} | 追加的环境变量 | | initializationOptions | | null | initialize 的 initializationOptions | | configuration | | null | workspace/configuration 的应答，按 section 分段返回 | | formattingOptions | | null | 覆盖全局格式化选项（tabSize / insertSpaces） |

分流规则

按顺序匹配，命中即停：

1. fileGlobs
2. projectMarkers —— 文件最近祖先目录中的标记文件；只在已映射该扩展名的条目间挑选
3. extensionToLanguage —— 按配置顺序取第一个

顶层选项

maxDiagnostics（200）、maxSymbols（100）、maxCodeActions（50）、 maxResultChars（16000）、maxDiffLines（60）、maxDocumentBytes（8 MiB）、 timeoutMs（60000）。

位置约定

工具参数里的 line / character 是 1-based UTF-16，与编辑器一致。 与服务器之间的 0-based 及 utf-8 / utf-32 编码转换由插件内部完成，模型不需要关心。

前置条件

语言服务器本身要装在 PATH 上，插件不代为安装：

vtsls、biome、rust-analyzer、ty、ruff 等，或任何实现了 LSP 的服务器。

已知限制

• biome 与 ruff 不实现 textDocument/documentSymbol，对它们调用 lsp_symbols 会返回 LSP_UNSUPPORTED。它们只服务诊断与格式化。
• 冷启动的服务器（如 rust-analyzer）首次拉取诊断可能为空（索引未完成）， 插件会退避重试；超过上限就返回已拿到的结果。

开发

npm test                 # 121 项单元测试，含假服务器协议覆盖
npm run verify:servers   # 用真实语言服务器跑通补丁层里配置的每一台

verify:servers 会读取 profile 补丁层里的 servers: 表，逐个启动真实服务器并 按其自报能力发一次真实请求。用法：node test/verify-servers.mjs [profileDir]。

改完插件源码要重启一次进程：市场开关能即时改变「是否挂载」，但不会把磁盘上的 新代码装进已运行的进程（ESM 模块缓存，实测确认）。

License

MIT