dsh-workspace-intelligence

在 LLM 驱动的代码代理工作流中，一个反复出现的痛点是：模型需要引用某个函数或类，却完全不知道它住在哪个文件里。DeepSeek Harness 自带 goToDefinition、findReferences 等 LSP 工具，但这些都要求先有一个文件路径和光标位置才能发起查询。当 agent 面对一个陌生代码库、手里只有一个符号名时，这些工具全都帮不上忙。dsh-workspace-intelligence 恰好补上了这块空白：它暴露一个 workspace_symbol 工具，让 agent 可以直接按名称在整个 workspace 中查找符号。

插件在底层通过 stdio 与一个或多个 language server 进行标准 LSP workspace/symbol 通信。一次查询会并发扇出到所有已配置的 server，同一 server 内的请求则保持串行以维护协议完整性。结果按精确匹配、前缀匹配、其余命中三段稳定排序，并以 name + kind + URI + 可选 range 为复合键去重，确保模型看到的始终是一份干净、确定性的列表。整个插件仅依赖 DSH 公开接口 ctx.fs、ctx.subprocess 和 ctx.tools，从不修改 Harness 运行时，也不调用 ctx.lsp，因此现有的 goToDefinition、hover 等功能完全不受影响。

它适合那些已经在 DSH 或 Cordis profile 中运行 language server（如 Pyright、TypeScript Language Server 或其他基于 stdio 的 server）的高级用户。无论是 agent 需要补全跨模块调用、为集成测试定位接口，还是在代码评审时确认某个符号属于哪个命名空间，workspace_symbol 都能省去一轮猜测，直接返回名称、类型、canonical URI 和可选范围。