Zed 扩展
nudo Zed 扩展把 Nudo 语言服务器挂到 JavaScript / TypeScript buffer 上,作为次要 language server——与 vtsls / typescript-language-server 并存。
前置条件
- Zed 内置 Node 运行时(用于启动服务器)
@nudojs/lsp≥ 0.5.0——扩展会通过 Zed 托管 npm 自动安装,无需手动准备
0.5.0+ 自带 dist/server.js 与 nudo-lsp shebang 入口,并在未传 transport 参数时默认走 stdio。
安装
扩展位于独立仓库:nudojs/nudo-zed。
源码安装(开发)
git clone https://github.com/nudojs/nudo-zed
在 Zed 中:Extensions → Install Dev Extension… → 选择克隆下来的 nudo-zed 目录。
设置
~/.config/zed/settings.json(或项目 .zed/settings.json)的复制即用默认配置:
{
"languages": {
"JavaScript": {
"language_servers": ["vtsls", "nudo", "..."]
},
"TypeScript": {
"language_servers": ["vtsls", "nudo", "..."]
}
},
"code_lens": "on",
"inlay_hints": { "enabled": true },
"semantic_tokens": "combined"
}
"..." 会保留其余已注册 language server。semantic_tokens: "combined" 把服务器的 contract / generated / derived modifier 叠加到语法高亮上(类型感知高亮)。
覆盖二进制路径
跳过托管安装,直接指定服务器(与其它 Zed LSP 扩展同一配置面):
{
"lsp": {
"nudo": {
"binary": {
"path": "node",
"arguments": ["/abs/path/node_modules/@nudojs/lsp/dist/server.js"]
}
}
}
}
或 PATH 上已有 nudo-lsp 时:
{
"lsp": {
"nudo": {
"binary": { "path": "nudo-lsp", "arguments": [] }
}
}
}
LSP 设置透传
lsp.nudo.settings 与 lsp.nudo.initialization_options 会转发给语言服务器
(与 VS Code 的 LSP 设置面一致)。项目分析配置(analysis.mode / include /
exclude)仍在 package.json#nudo 或 nudo.json。
服务器解析
扩展通过 Zed 托管 npm 安装 @nudojs/lsp(npm_install_package),并以 <node_binary_path>/node_modules/@nudojs/lsp/dist/server.js --stdio 启动——与其它 Zed language-server 扩展同一模式。用户若配置了 lsp.nudo.binary,则优先使用该覆盖路径。
Zed 中的能力
| 能力 | 说明 |
|---|---|
| Diagnostics | 分析目标(.js/.mjs/.ts)自动分析;无指令文件见 nudo.analysis.mode |
| Hover 类型 | |
| 跳转定义 / 引用 / 重命名 | 标准 LSP(含侧车绑定名) |
| Inlay hints | 需打开 inlay_hints.enabled;implicit 导出标 derived。参数契约 hint(where …)默认关——经 language-servers.nudo.initialization_options: { "inlayHints": { "parameters": true } }(或 package.json#nudo.inlayHints.parameters)开启;开启后展示契约声明形态(侧车模板表达式 / 指令约束名,如 where nullable(astNode)),完整谓词经 hint tooltip 展示 |
| CodeLens | 需打开 code_lens: "on"——观察选择器:●/○ contract / hw|gen|imp(默认激活)+ persist/update + ⚡ draft contract;●/○ case "…" 选项跟随 |
| Semantic tokens | 默认关闭,设 semantic_tokens: "combined"——含 contract/generated/derived modifier |
| Code actions / Signature help | 标准 LSP quickfix 与 signature help(真实 paramTypes / 返回类型)。含 action-map quickfix([fix] / [silence] / [review] / [adjust] / [scaffold]) |
Agent 命令(nudo.check / nudo.contract.draft / …) | 经任意 LSP 客户端或 Zed agent 工具可达 |
| JSX / TSX buffer | 已挂接(JavaScript React / TypeScript React),与 VS Code 同文档面 |
CodeLens ⚡ draft contract 与 CLI nudo contract --draft 同源(仅客户端显式 write: true 时写 *.nudo.draft.js)。迁移步骤:迁移已有 JS。
VS Code 扩展里 active case 的 decoration 在 Zed 无对应 API,请改用 CodeLens 的 case 选择。
完整客户端对比与已知缺口:LSP 客户端矩阵。
文件检测
分析目标为 .js / .mjs / .ts。package.json#nudo.analysis.mode 出厂默认 "exports";模式语义与保守的 "directives" 门禁:共存。CodeLens contract 档使用更宽的目标路径。
构建 WASM 扩展
安装 dev extension 时 Zed 会自行编译。手动构建:
rustup target add wasm32-wasip2
cd nudo-zed
cargo build --target wasm32-wasip2 --release
参见
- VS Code 扩展
- LSP 客户端矩阵——跨编辑器能力对齐
- 迁移已有 JS
- 版本与发布
- Agent 集成——同一服务器服务 coding agent
- @nudojs/lsp API