pnpm方式加载失败及修复全流程已经建议

[white-sand-grand]

事先声明：本次修复由GLM 5.3参与完成并进行总结，但我并不认为是AI废料

---

标题：

`pnpm add -g @deepseek-ai/dsh` 后 `dsh web` 启动失败：pnpm 隔离布局下约 200 个插件加载条目 ERR_MODULE_NOT_FOUND（npm/npx 安装正常）

正文：

## 环境

- dsh：`@deepseek-ai/dsh@0.1.0-rc.6`（next tag），全局安装
- pnpm：11.7.0（corepack）与 11.16.0 均复现
- Node：v22.23.2（WSL2 Ubuntu；判断与布局相关，非平台特有）
- 系统：WSL2

## 复现步骤

```sh
pnpm add -g @deepseek-ai/dsh@next   # 安装成功
dsh web                              # 启动即失败

同一台机器、同一个 profile（~/.dsh 未做任何改动），改用
npm i -g @deepseek-ai/dsh（或 npx @deepseek-ai/dsh web）则完全正常。

报错信息

Error: dsh: plugin tree failed to load: failed to apply loader entry include (cordis:include): loader entries failed to apply
AggregateError: loader entries failed to apply
...
Error: failed to import loader entry agent (@deepseek-ai/dsh-agent):
  Cannot find package '@deepseek-ai/dsh-agent' imported from
  ~/.local/share/pnpm/store/v11/links/@deepseek-ai/cordis-plugin-loader/1.0.2/<hash>/node_modules/@deepseek-ai/cordis-plugin-loader/lib/index.js

约 200 个条目以同样方式失败（dsh-agent、dsh-web-app、dsh-tools、
dsh-user-questions、dsh-host-apiproxy 等）。完整启动日志可按需提供。

根因分析

插件加载器从自身模块位置（cordis-plugin-loader/lib/index.js）按裸包名
解析 bundle 插件包。npm/npx 的扁平提升（hoisted）布局下，
@deepseek-ai/dsh-* 系列包位于 node_modules 顶层、互为邻居，可以正常
解析；而 pnpm 默认的隔离布局（isolated layout）中，每个包只能看见自己
声明过的依赖，cordis-plugin-loader 的依赖清单里没有这些兄弟插件包，
于是全部导入失败。

也就是说 pnpm add -g 能"装成功"，但装出来的是一个坏的安装，且报错
信息完全不会提示问题出在包管理器上——用户很容易误以为是安装损坏。

临时绕过

1. npm i -g @deepseek-ai/dsh（需要时配用户前缀目录）或
   npx @deepseek-ai/dsh web——实测正常。
2. 猜测给 pnpm 全局安装设 node-linker=hoisted 也可行（此处未验证）。

建议（任选其一即可帮到用户）

1. 文档：README 安装一节加一句说明——全局安装需使用 npm/npx，
   pnpm 的隔离布局暂不支持。
2. 加固：让 bundle 条目改为相对 dsh 安装根目录解析（例如用
   createRequire 锚定在 @deepseek-ai/dsh 包上），从而兼容严格布局。

如需完整启动日志或协助验证修复，我可以配合。

---