代码语义导航 lengrufeng2008/dsh-code-intel

面向 DSH 的代码智能

Serena 证明了编码智能体需要符号级精确的导航，光靠 grep 不够。这里是那套工作流的一个小型、只读的 DSH 移植版：本地 LSP 服务器、四个工具，不用嵌入向量，不用托管索引，不用 API key。

它新增了什么

| 工具 | 职责 |
| code_definition | 跳到真正的定义处 |
| code_references | 改动前先查影响面 |
| code_symbols | 搜索类、函数、变量 |
| code_diagnostics | 单个文件的编译器、类型诊断 |
| code_hover | 查看符号处的类型与文档 |
| code_rename | 预览重命名改动，不写入 |

六个工具全部只读。code_rename 只返回预览，绝不写文件。审阅之后，用你平时用的编辑工具把预览应用上去。

安装

once the public repo exists:
dsh plugin --profile web add github:lengrufeng2008/dsh-code-intel

local package, before the repo is published:
dsh plugin --profile web add /home/lrf/dsh/products/dsh-code-intel/dsh-code-intel-0.1.0.tgz

至少装一个语言服务器：

| 语言 | 安装 |
| TypeScript / JavaScript | npm i -g typescript-language-server typescript@5.9 |
| Python | pip install pyright |
| Go | go install golang.org/x/tools/gopls@latest |
| Rust | rustup component add rust-analyzer |
| C / C++ | 安装 LLVM clangd |

使用

Use code_symbols to find where parseSession is defined.
Use code_references on this symbol before changing its signature.
Use code_diagnostics on the file I just edited.

位置从 1 开始计数。root 默认取 DSH 工作区目录；工作区之外的文件会被拒绝。

设计

- 每次调用起一个短生命周期的语言服务器进程，没有后台常驻进程泄漏。
- 走 stdio 上的 JSON-RPC，零依赖。
- 按文件扩展名选服务器，也可以显式指定 language。
- 超时和安装提示，而不是静默回退。
- 打开文件前先做路径包含检查。
- 诊断走 publishDiagnostics；只支持拉取式诊断的服务器会返回空。

真实服务器冒烟测试

用 typescript@5.9.3 和 typescript-language-server@5.3.0，针对一个小 .ts 文件对定义和引用做了冒烟测试（1 个定义，2 个引用）。Python 路径也用 pyright-langserver 冒烟测试过（1 个定义，2 个引用）。code_symbols 需要项目上下文；TypeScript 下请加一个 tsconfig.json，或者传 file 让服务器先打开项目文件，否则可能返回 No Project。内置的假服务器让 npm test 不依赖已安装的语言服务器。

它不做什么

- 不写入、不应用编辑、不执行重命名。code_rename 只做预览。
- 没有跨仓库索引，没有嵌入向量，没有远程服务。
- 不保证诊断结果等同于一次干净的测试运行。
- 不声称与 Serena 的完整功能集对等。

来源

受 Serena 启发；未复制任何源代码。见 NOTICE.md。
License: MIT。

测试

npm test

测试夹具是假的 LSP 服务器，所以 npm test 不需要安装 TypeScript、Pyright、Go 或 Rust。真实服务器的冒烟测试列在 docs/SMOKE.md 里；TypeScript 这条路径已用 typescript@5.9.3 和 typescript-language-server@5.3.0 做过冒烟测试（definition 1，references 2）。