dsh-tool-lsp

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

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