安装失败 + 原生目录选择器崩溃：koffi 3.1.3/3.1.4 win32-x64 预编译二进制损坏，建议暂时锁定 koffi@3.1.2

[875231907]

Title: Windows 安装失败 + 原生目录选择器崩溃：koffi 3.1.3/3.1.4 win32-x64 预编译二进制损坏，建议暂时锁定 koffi@3.1.2

环境

• OS: Windows x64
• Node.js: v24.16.0, npm 11.13.0
• @deepseek-ai/dsh: 0.1.0-rc.6

问题

npm i -g @deepseek-ai/dsh 在 Windows 上安装失败，报错：

Failed to load prebuilt binary, rebuilding from source
Error: CMake does not seem to be available

即使用 --ignore-scripts 绕过安装，运行时的原生目录选择器也会崩溃：

directory picker failed: win32 folder dialog worker exited before reporting a result

根因

dsh 经 @deepseek-ai/dsh-fs-local 依赖 koffi@^3.1.0，当前解析到 3.1.4。
koffi 3.1.3 起 Windows 构建改用 Clang 交叉编译，其 @koromix/koffi-win32-x64
预编译二进制是坏的：koffi.load() 时会直接段错误（access violation）。

实测同一台机器、同一 Node 24.16：

• koffi 2.16.3 / 3.1.2：完全正常
• koffi 3.1.3 / 3.1.4：koffi.load('kernel32.dll') 100% 崩溃

崩溃导致两个连锁故障：

1. 安装时 koffi 自检（cnoke.cjs 的 checkPrebuild）退出码非 0 → 误判预编译不可用
   → 回退源码编译 → 无 CMake 的机器直接安装失败；
2. dsh-host-directory-picker-native 的 worker 子进程在
   loadWin32DialogBindings() 的 koffi.load('ole32.dll') 处崩溃，
   来不及发任何 IPC 消息 → 主进程报 "worker exited before reporting a result"。

复现

npm install koffi@3.1.4 --ignore-scripts
node -e "require('koffi').load('kernel32.dll')"   # 段错误

临时规避（已验证有效）

npm i -g @deepseek-ai/dsh --ignore-scripts
cd <全局目录>/node_modules/@deepseek-ai/dsh
npm install koffi@3.1.2 --no-save --ignore-scripts

建议

在 koffi 上游修复前，将 dsh-fs-local 的 koffi 依赖锁定为 3.1.2（精确版本），
或在根包加 npm overrides，避免解析到 3.1.3+。上游 issue:（此处可贴上你报的 koffi issue 链接）