【求助】项目启动后抛出 client-modules: HTML did not preload @deepseek-ai/dsh-client-modules/client.js 错误

[JasonYadi]

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

Error: client-modules: HTML did not preload @deepseek-ai/dsh-client-modules/client.js
    at Object.create ((index):13:39)
    at Cp.run (index.js:188:32)

[liyangbing]

这个错误不是在说 npm 包一定缺失，而是一个很精确的浏览器启动不变量失败了：页面里的 window.__ModuleLoader__ facade 已经运行并调用了 create()，但 registration queue 里没有 @deepseek-ai/dsh-client-modules 的 factory。

alpha.1 的正确顺序是：

1. inline __ModuleLoader__ queue；
2. application preload links；
3. parser-blocking /plugins/??...&rev=... bootstrap script；
4. inline __DSH_BOOT__ graph；
5. Web shell 调用 create()。

所以需要从同一次页面加载保存 HTML 和 bootstrap response，不能把多次重启后的证据混在一起。建议先执行：

curl -fsS http://127.0.0.1:端口/ -o dsh-index.html
grep -o '/plugins/[^"<]*' dsh-index.html
grep -n '__ModuleLoader__\|__DSH_BOOT__\|script src=' dsh-index.html

再用 curl -i 请求 HTML 中原样复制的 bootstrap URL。重点看：

• HTML 是否真的包含 queue、blocking bootstrap script、boot graph，且顺序正确；
• /plugins 是否返回 200 JavaScript，而不是 404、登录页或代理错误 HTML；
• proxy/CDN 是否保留 ?? 和完整 query/rev；
• 是否被 CSP、TLS、浏览器扩展或 service worker 拦截；
• 是否给 script 添加了 async / defer / type=module；
• localhost 直连是否正常、仅公网代理失败；
• 启动的是否为 CLI 的 dsh web Host composition，而不是裸 apps/web Vite、IDE preview 或只复制出来的静态 dist/。apps/web 自己的 package contract 明确说明 dist 由 CLI 的 dsh web 提供；动态 /plugins route 和 HTML injection 来自 Host plugin。

请补充启动命令/cwd、版本或 commit、Node/pnpm、页面 URL、HTML 中 bootstrap URL、该 URL 的 status/content-type、浏览器 Network 失败原因，以及 Host activation/fiber 日志，就可以继续把根因缩到一个边界。

完整的诊断矩阵、安全恢复顺序和 10 项回归契约已整理在：
https://github.com/sandbaseai/deepseek-harness-handbook/blob/main/docs/en/troubleshooting/client-modules-html-did-not-preload.md

[cainiaochaocai]

折腾了半天不知道怎么解决，先不用deepseek-harness 了，等后面有空了再折腾

[denial123789]

I expanded the handbook Web boot runbook with evidence-first triage for this exact client-module preload mismatch: https://github.com/sandbaseai/deepseek-harness-handbook/blob/main/docs/en/troubleshooting/web-client-plugin-boot-failure.md — it covers HTML/module revision drift, proxy rewrites, and safe recovery without bypassing the assertion.

[cnyaqi]

切换 node 版本到 22 就好了。#4885

[Yuuine]

Node版本升级到 v24.20.0，重新构建就可以正常使用了

[JasonYadi]

我用ai来改了一些，运行没问题了