[Bug] Node 24.0–24.11.1 下 dsh web 0.1.2 alpha.1 启动失败，前端报 "HTML did not preload @deepseek-ai/dsh-client-modules/client.js"

[good770326]

原因是有代码简单按 Node 主版本判断区分接口，但有些接口在同个 Node 主版本内有变。

使用者升级 Node 到 v24.12.0 及以上（如最新 LTS v24.20.0）可规避。

具体如下(AI分析)：

环境

• 系统：Windows
• Node.js：v24.11.1
• deepseek-harness：0.1.2-alpha.1（commit cd5ef81）
• 启动方式：源码目录下 pnpm dsh web

复现步骤

1. 在 Node v24.11.1 环境下进入源码目录
2. 运行 pnpm dsh web
3. 用浏览器打开服务地址

实际行为

页面加载后显示：

Failed to load plugins
client-modules: HTML did not preload @deepseek-ai/dsh-client-modules/client.js

服务端返回的 HTML 中 window.__DSH_BOOT__ 为空：

{"rev":"240c4d8dcf0d","entries":[],"batches":[]}

期望行为

__DSH_BOOT__ 正常填充所有 dsh.client 客户端模块，前端插件正常加载。

根因分析

vendor/loader/src/internal.ts 的 ModuleLoader.fromInternal() 对所有 Node
>= 24 都标记为 v2 接口：

if (major >= 24) {
  const raw = ...
  if (raw) return _cachedLoader = Object.assign(raw, { version: 'v2' })
} else if (major >= 22) {
  ...
  if (raw) return _cachedLoader = Object.assign(raw, { version: 'v1' })
}

但 v2 接口（resolveSync(parentURL, request) + getOrCreateModuleJob）实际是在
Node 24.12.0 才引入的。Node 24.0–24.11.1 仍然是 v1 接口
（resolveSync(specifier, parentURL, attributes) + getModuleJobForImport）。

在 Node v24.11.1 上实测：

• getOrInitializeCascadedLoader() 返回的对象包含 resolve、getModuleJobForImport，
  但没有 getOrCreateModuleJob。
• resolveSync(specifier, parentURL, {}) 正常返回。
• resolveSync(parentURL, { specifier, attributes }) 抛 ERR_INVALID_ARG_TYPE。

于是 packages/client/modules/src/index.ts 的 locatePkgJson 走 v2 分支、参数错位，
异常被 try/catch 吞掉后返回 undefined，所有 dsh.client 包被跳过，
__DSH_BOOT__ 为空。

vendor/hmr/src/index.ts 的 _resolve 同样依赖 internal.version 分支，同样受影响。

影响范围

Node >=24.0.0 <24.12.0（在 engines 声明的范围内），仅影响 web 界面。
Node 22/23 与 Node >=24.12.0 不受影响。

建议修复方向

fromInternal() 改为按实际接口方法检测，而非按 major 版本：

const version = typeof raw.getOrCreateModuleJob === 'function' ? 'v2' : 'v1'

[good770326]

#4885
相同问题贴，这条关闭