vscode插件报module version mismatch或cannot find module './build/release/xxx.node'，根本原因是原生模块abi版本（napi_build_version）与vscode扩展主机内置node的napi版本不匹配；需用vscode内置node执行npm rebuild并指定--napi-build-version、--runtime=electron和--target参数，再彻底清理插件目录下的out及node_modules缓存。
VSCode 里 Node 项目升级后报 module version mismatch 或 Cannot find module './build/Release/xxx.node'，不是 Node 版本没装对，而是原生模块（如 sqlite3、node-sass、ffi-napi）编译时用的 ABI 版本和当前 VSCode 扩展主机进程实际加载的 Node ABI 不一致——差一个 napi_build_version 就彻底失败。
怎么确认是 ABI 不匹配而不是路径或权限问题
打开 VSCode 开发者工具（Help → Toggle Developer Tools），在控制台执行：
process.versions.node<br>process.versions.napi
对比你本地终端运行 node -v 和 node -p "process.versions.napi" 的输出。若两者 napi 值不同（比如终端是 8，扩展主机是 9），就是 ABI 错位。VSCode 1.90+ 内置 Node.js 22.4.0，napi_build_version=9 是硬性要求，不接受降级加载。
重编译原生模块必须用 VSCode 内置 Node 运行时
npm rebuild 默认调用系统 Node，生成的二进制无法被插件加载。必须显式指定 VSCode 捆绑的 Node 环境：
- macOS：找到 VSCode 安装路径中的 Helper 可执行文件（如
~/Applications/Visual Studio Code.app/Contents/Frameworks/Code Helper (Renderer).app/Contents/MacOS/Code Helper (Renderer)），然后执行：./Code\ Helper\ \(Renderer\) --type=extensionHost node /usr/bin/npm rebuild --napi-build-version=9 --runtime=electron --target=34.0.0 - Windows：使用
Code.exe --extensions-dir定位插件目录后，在该目录下运行："C:\Users\XXX\AppData\Local\Programs\Microsoft VS Code\Code.exe" --type=extensionHost node npm rebuild --napi-build-version=9 --runtime=electron --target=34.0.0 - Linux：类似 macOS，路径为
/usr/share/code/code --type=extensionHost node npm rebuild ...
缺 --napi-build-version=9 或 --target=34.0.0 都会失败；--runtime=electron 不能省略，否则仍走普通 Node 模式。
ZenHeart zenlink 与 zenlink-mcp 为 OpenClaw，涵盖安装、MCP 注册、钩子接线、入站轮询及升级维护。
清缓存比重编译更关键
即使重编译成功，旧缓存仍可能被优先加载，导致报错照旧。务必在插件目录（如 ~/.vscode/extensions/ms-vscode.vscode-qsharp-0.32.0）中执行：
rm -rf ./out/-
rm -rf ./node_modules/.pnpm/node_modules/（若用 pnpm） -
rm -rf ./node_modules（谨慎，仅当确定无其他依赖时）
不要只删 node_modules 顶层目录——.pnpm 下的嵌套 node_modules 是真实加载源，漏删等于白干。
调试器里 runtimeExecutable 不影响插件加载
在 launch.json 里设了 "runtimeExecutable": "/path/to/node"，只能控制调试会话主进程，对扩展主机（Extension Host）完全无效。插件里的 require('./binding.node') 依然走 VSCode 内置 Node。所以：
- 断点灰掉、
command not found、插件输出通道空白，大概率是扩展主机没加载成功 - 验证方式：在插件激活后的输出通道（
Output → Extensions）里看是否打印出process.versions.napi - 别在
settings.json里硬写terminal.integrated.env.*覆盖 PATH——这会破坏 nvm 切换逻辑，反而让终端也错配
ABI 兼容性没有“差不多就行”——process.versions.napi 必须和编译参数 --napi-build-version 完全相等，差 1 都加载失败。这是 VSCode 1.90+ 的安全加固行为，不是 bug，绕不过去。
