[Bug] dsh 0.1.5-rc.1 在 Node.js < 24 上完全静默失败(import.meta.main 守卫 + 未声明 engines)

[ice5kysl]

现象

按官方公告的快速体验命令,在 Node.js < 24 的环境里启动 Web UI,命令无任何输出、退出码 0,完全静默失败:

$ node --version
v23.11.0
$ npx @deepseek-ai/dsh web
$                        ← 直接回到提示符,没有任何输出
$ dsh --version          ← 全局安装的 0.1.5-rc.1
$ echo $?
0

所有子命令(--version / --help / web / plugin)行为相同,终端、stderr 均无任何信息,用户无从排查。降回 0.1.2-rc.1 则一切正常。

环境

• macOS 15(darwin arm64),Node v23.11.0(Homebrew)
• @deepseek-ai/dsh 0.1.5-rc.1(npm dist-tag latest),npm install -g 安装过程无任何警告

根因

0.1.5-rc.1 的 bin 入口(lib/bin.js)末行:

if (import.meta.main) await runCli();

import.meta.main 是 Node.js 24 才引入的属性,旧版本上为 undefined(属性访问,不是语法错误),因此整个 runCli() 被静默跳过,进程正常退出 —— 零输出、退出码 0。

实测(macOS,同一台机器):

Node 版本	import.meta.main	结果
v22.14.0(LTS)	undefined	静默失败
v23.11.0	undefined	静默失败
v26.8.2	true	正常

同时 package.json 没有 engines 字段,npm 在旧 Node 上安装时不会给出任何提示,问题直到运行才暴露。

建议

1. package.json 声明 "engines": { "node": ">=24" },让安装阶段至少有警告;
2. bin 入口增加运行时守卫:检测到 import.meta.main === undefined 时打印明确的 Node 版本要求并以非零码退出;或改用兼容旧版本的入口判断,例如 import.meta.url === pathToFileURL(process.argv[1]).href。

受影响范围

公告推荐的安装路径 npx @deepseek-ai/dsh web + "已安装 Node.js 开发工具链" 的表述,会覆盖大量 Node 20/22/23 用户(含 22 LTS),症状是完全静默的失败。

临时解法:升级 Node ≥ 24(如 brew upgrade node),或回退 npm install -g @deepseek-ai/dsh@0.1.2-rc.1。

附录:官方公告

《DeepSeek Harness 更新:适配 DeepSeek V4.1 Flash 模型》(2026-09-10)— "安装使用"一节仅要求"已安装 Node.js 开发工具链",未提及 Node 版本要求;v0.1.5-rc.1 的 release notes 中同样未提及。

---

EN summary: On Node.js < 24, every dsh 0.1.5-rc.1 command (npx @deepseek-ai/dsh web, dsh --version, …) exits 0 with zero output. Root cause: the bin entry ends with if (import.meta.main) await runCli() and import.meta.main is only defined on Node ≥ 24 (verified undefined on v22.14/v23.11, works on v26.8.2); the package also declares no engines field, so npm installs silently. Suggested: declare engines.node >= 24 and/or fail loudly (non-zero exit with a clear message) when the entry guard is unsupported.

[yx755141]

v24.1.0也不行

[yanglbme]

直接改用 node v26.8.2，成功启动了