DSH 用 pnpm 安装后找不到 zod
排查 DeepSeek Harness rc.2 和 rc.3 启动时的 zod 缺失错误。核对发布包,使用 pnpm packageExtensions 补依赖,再检查 typert 模块导入。
本页内容
核对错误信息
在页面或终端中查找下面的错误码或提示词。完整信息可能因操作系统和版本不同而略有差异。
Cannot find package 'zod'ERR_MODULE_NOT_FOUNDdsh-web/lib/typert.host.jszod搜索或求助时尽量复制完整报错,同时删除 API Key、私有仓库名、用户名和敏感路径。
如果报错路径以 @deepseek-ai/dsh-web/lib/typert.host.js 结尾,在 pnpm 工作区用 packageExtensions 为该包补上 zod。按实际安装版本填写包选择器,执行 pnpm install 后再次检查导入。
错误含义
DSH 启动时会加载 Web 服务的 typert 模块。发布包里的 typert.host.js 通过 zod 定义网页搜索和抓取服务商列表的返回结构。这个导入失败时,模块无法加载。rc.2 的 Windows 用户报告中,浏览器仍能打开,但提供搜索和抓取的 ctx.web 没有注册。排查时应同时看启动日志和服务商列表。
常见原因
- rc.2 和 rc.3 发布包都引用了 zod,但 dependencies 和 peerDependencies 均未声明。对应版本的 dsh-typert-protocol 声明的是 zod 4.6.6,下文的检查使用这个版本。
- 使用隔离布局时,Node 从 typert.host.js 所在的软件包查找 zod。如果依赖提升后恰好能从这个位置找到 zod,导入可能成功。同一 DSH 版本在不同安装布局下可能有不同结果。
- rc.2 用户报告的环境是 Windows 11、Node 24.22.1 和 pnpm 12.16.1。本站在 macOS 上用 Node 25.6.1、pnpm 10.31.0 和关闭依赖提升的布局,验证了 rc.3 的 typert 模块导入。
对应文档与源码
修复步骤
- 01
确认是哪一份 DSH 安装报错
记下启动 DSH 时执行的命令,以及报错中 imported from 后面的路径。pnpm 全局安装、项目目录中的本地命令和 npx 启动可以指向不同的包。在 PowerShell 中可用 Get-Command dsh 查看入口,在 macOS 或 Linux 上可用 command -v dsh。rc.2 和 rc.3 的 CLI 包都要求 Node.js 24.9.0 或更新版本。
node --version pnpm --version pnpm list -g @deepseek-ai/dsh --depth=0 - 02
查报错路径里的准确包版本
从报错路径确定 @deepseek-ai/dsh-web 的版本。下面的命令会显示 rc.3 的普通依赖和同级依赖。路径中如果是 rc.2,把命令里的版本改成 0.2.2-rc.2。如果日常使用 npm 镜像,可以先用同一命令核对镜像上的包版本和清单。记录明确版本,便于和 npm 发布记录对照。
npm view @deepseek-ai/dsh-web@0.2.2-rc.3 dependencies peerDependencies --json - 03
准备一个独立目录检查模块导入
新建空目录,进入后运行 pnpm init。把下方两行保存为 pnpm-workspace.yaml。这个目录用于验证单个软件包,关闭依赖提升以观察它实际声明的依赖。无需在其中配置模型、API Key 或原有 DSH Profile。
nodeLinker: isolated hoist: false - 04
安装发布包,保存导入检查脚本
在这个目录执行 pnpm add --save-exact --ignore-scripts @deepseek-ai/dsh-web@0.2.2-rc.3。把下面两行保存为 probe.mjs,再执行 node probe.mjs。在上述布局中会出现 ERR_MODULE_NOT_FOUND,缺少的软件包是 zod。记下这次输出,便于补依赖后比较。
const { TYPERT } = await import("@deepseek-ai/dsh-web/typert"); console.log(TYPERT.package); - 05
为引用 zod 的软件包补依赖声明
把下面的配置追加到检查目录的 pnpm-workspace.yaml。已有 packageExtensions 时,把包选择器和 dependencies 合并到现有配置下。实际项目使用 rc.2 时,把选择器换成 0.2.2-rc.2。保存后执行 pnpm install,刷新当前目录的依赖和锁文件。
packageExtensions: '@deepseek-ai/dsh-web@0.2.2-rc.3': dependencies: zod: 4.6.6 - 06
重新导入模块,再检查 DSH 启动
再次运行下方命令。输出 @deepseek-ai/dsh-web 表示 typert 模块成功加载。若 DSH 装在 pnpm 项目内,可在该项目的工作区根目录补同样的依赖,再通过 pnpm exec dsh web 启动。通过 pnpm add -g 安装的版本使用另一套依赖目录。
node probe.mjs - 07
验证搜索与抓取服务商列表
打开新启动的 DSH 进程打印的地址,检查启动日志是否还出现 zod 报错。打开 Web 工具设置,确认能读取服务商列表。已经配置服务商时,再执行一次简单搜索或抓取。若此时出现 401 或服务商不可用,按新错误排查对应的凭据或服务配置。
- 08
升级后移除临时依赖声明
更换版本时,先查看新版包清单。如果新版已经声明 zod,可以删除旧版本对应的 packageExtensions 条目,再执行 pnpm install。项目使用 Git 时,对照工作区配置和锁文件的改动,最后用新版本复查模块导入和服务商列表。
检查结果
- 单包验证中,rc.3 补依赖前导入失败,补依赖后成功加载 TYPERT。
- 整套 DSH 的验证以启动日志不再出现同一条缺包错误、服务商列表可以读取为准。
常见问题速查
Cannot find package 'zod' 怎么修?
如果报错路径以 @deepseek-ai/dsh-web/lib/typert.host.js 结尾,在 pnpm 工作区用 packageExtensions 为该包补上 zod。按实际安装版本填写包选择器,执行 pnpm install 后再次检查导入。
Cannot find package 'zod' 是什么意思?
DSH 启动时会加载 Web 服务的 typert 模块。发布包里的 typert.host.js 通过 zod 定义网页搜索和抓取服务商列表的返回结构。这个导入失败时,模块无法加载。rc.2 的 Windows 用户报告中,浏览器仍能打开,但提供搜索和抓取的 ctx.web 没有注册。排查时应同时看启动日志和服务商列表。
怎么确认 Cannot find package 'zod' 已经修好?
单包验证中,rc.3 补依赖前导入失败,补依赖后成功加载 TYPERT。 整套 DSH 的验证以启动日志不再出现同一条缺包错误、服务商列表可以读取为准。
内容更新 · 查看核对来源