DeepSeekDSH
独立社区指南与 DeepSeek 无隶属关系。下载版本与教程参考

DSH 用 pnpm 安装后找不到 zod

排查 DeepSeek Harness rc.2 和 rc.3 启动时的 zod 缺失错误。核对发布包,使用 pnpm packageExtensions 补依赖,再检查 typert 模块导入。

本页内容

核对错误信息

在页面或终端中查找下面的错误码或提示词。完整信息可能因操作系统和版本不同而略有差异。

Cannot find package 'zod'
ERR_MODULE_NOT_FOUND
dsh-web/lib/typert.host.js
zod

搜索或求助时尽量复制完整报错,同时删除 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 模块导入。

对应文档与源码

修复步骤

  1. 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
  2. 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
  3. 03

    准备一个独立目录检查模块导入

    新建空目录,进入后运行 pnpm init。把下方两行保存为 pnpm-workspace.yaml。这个目录用于验证单个软件包,关闭依赖提升以观察它实际声明的依赖。无需在其中配置模型、API Key 或原有 DSH Profile。

    nodeLinker: isolated hoist: false
  4. 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);
  5. 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
  6. 06

    重新导入模块,再检查 DSH 启动

    再次运行下方命令。输出 @deepseek-ai/dsh-web 表示 typert 模块成功加载。若 DSH 装在 pnpm 项目内,可在该项目的工作区根目录补同样的依赖,再通过 pnpm exec dsh web 启动。通过 pnpm add -g 安装的版本使用另一套依赖目录。

    node probe.mjs
  7. 07

    验证搜索与抓取服务商列表

    打开新启动的 DSH 进程打印的地址,检查启动日志是否还出现 zod 报错。打开 Web 工具设置,确认能读取服务商列表。已经配置服务商时,再执行一次简单搜索或抓取。若此时出现 401 或服务商不可用,按新错误排查对应的凭据或服务配置。

  8. 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 的验证以启动日志不再出现同一条缺包错误、服务商列表可以读取为准。

来源与版本

内容更新 · 查看核对来源