DeepSeek Harness

DeepSeek 91 依赖:升级迁移清单

11月15日核验npm包元数据:0.2.2-rc.3含91个运行时依赖、532文件,rc.1仅90个依赖、20文件。官方rc.2发布说明列出十余处需迁移变更。附企业升级影响面核对建议。

2026-11-15 13:22:14 · Editor: 刘立永

2026 年 11 月 15 日核验 npm 官方包元数据:@deepseek-ai/dsh 0.2.2-rc.3 有 91 个运行时依赖、包内 532 个文件、解压 6,219,851 字节;11 月 4 日的 rc.1 只有 90 个依赖、20 个文件、76,416 字节。文件数跳变对应官方 rc.2 的一条明确变更:npm 安装与桌面端开始随附同版本源码和文档。

一、依赖清单本身就是架构清单

从 rc.3 的 dependencies 字段可直接读出「一切皆插件」的落地粒度,以下均为官方包元数据原值,不是架构推测。运行时依赖 91 个、另列开发依赖 54 个,其中 13 个包名带 experimental 前缀,覆盖会话搜索、终端、自动评审、工作树、插件市场、语音输入等实验能力;正式与实验能力在同一个安装单元里,靠插件开关区分。会话侧能看到 dsh-session-projection、dsh-session-reference、dsh-compaction-basic 与 dsh-compaction-tool-result-pruner,说明会话投影与上下文压缩是独立包;工具侧能看到 dsh-workflow-ptc、dsh-tool-bash-persistent、dsh-mcp-client 与 dsh-mcp-resources;沙箱相关的 dsh-pwsh-sandbox 在运行时依赖,另三个沙箱包在开发依赖。这种拆法的好处是可替换,代价是升级时影响面被摊到几十个包上,不能只看主程序版本号。

二、三次候选版只动过两个包

逐版本比对依赖集合:rc.1 到 rc.2 新增 dsh-cua-bundle、移除 dsh-experimental-agent-team-profile,总数仍是 90;rc.2 到 rc.3 只新增 dsh-deepseek-chat-import,总数 90 变 91,解压体积增加 4,802 字节。两次增量与官方发布说明一一对应:rc.2 写明「调整 Computer Use 的窗口操作、键盘控制和授权,默认不移动系统鼠标」,rc.3 写明「新增实验性 DeepSeek 会话导入插件」。但要给这个观察划清口径:它只说明候选版迭代以插件包为粒度,不等于所有改动都体现为依赖增减。官方 rc.2 发布说明里的 Git Worktree 审阅、具名多层 SubAgent、网页搜索改用自家 API 等大量改动,都没有新增依赖,靠包内实现完成。

三、rc.2 里十余处需要迁移的变更

官方 rc.2 发布说明「其他变更」一栏,明确标注需迁移、需适配或需同步升级的有十余处,挑与工程落地最相关的几条。网页搜索默认改用 DeepSeek Search API,搜索与获取可分别选计费账号或 API Key,旧提供方与自定义配置需按升级指南调整;AgentTeam 改用统一的具名子代理、中断工具默认关闭,自定义插件与 SDK 集成需迁移,共享会话的进程须同步升级;工具失败提供更明确的错误类型与代码,依赖旧错误分类的插件和 SDK 需同步适配;Session 支持批量追加事件,日志格式不变但自定义追加接口需适配批量调用。安全边界的变化尤其要逐条读:PTC 按运行时限限制工具调用总量,超限会终止代码并清空保留状态,已完成的操作不会撤销;Office 改用原生工具,文档解析在 DSH 主进程中运行,不受命令行沙箱保护;Windows 的额外目录授权仅供文件工具使用,不扩大终端或 PTC 的访问范围;LiveShare 旧授权需重新配置,且 PTC 可访问分享目录之外,官方写明仅应分享给可信任的人。以上是发布说明原文表述,不是第三方实测结论。

四、给中小企业的三条建议

第一,把插件与依赖清单当作升级影响面清单,升级前逐项比对新增、移除的包名再决定动不动。这与我们给山东客户做用友、金蝶、管家婆补丁升级时先拉补丁清单、在测试账套跑一轮月结再上生产是同一套动作;Agent 工具把功能拆成几十个包,影响面反而更容易逐项核对。第二,凡涉及文档解析、终端与目录授权的默认行为变化,先在隔离环境重跑权限验证,尤其官方明写的「文档解析不受命令行沙箱保护」「PTC 可访问分享目录之外」,别沿用旧版的安全假设。第三,自动化测试补两类场景:工具调用超限后的状态一致性、会话恢复后旧授权是否仍按原范围生效;官方写明超限会清空保留状态但已完成操作不撤销,这类半完成状态在财务与 ERP 接口里必须留人工终审,不能自动回写。

参考来源:
• npm 官方 registry 上 0.2.2-rc.3 单版本元数据(依赖全表 / 532 文件),2026-11-15 核验:https://registry.npmjs.org/@deepseek-ai/dsh/0.2.2-rc.3
• npm 官方 registry 上 0.2.2-rc.1 单版本元数据,2026-11-15 核验:https://registry.npmjs.org/@deepseek-ai/dsh/0.2.2-rc.1
• DeepSeek 官方 GitHub Release dsh-v0.2.2-rc.2(其他变更与迁移清单),2026-11-11:https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.2-rc.2
• DeepSeek 官方 GitHub Release dsh-v0.2.2-rc.3,2026-11-13:https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.2.2-rc.3
• DeepSeek Harness 官方仓库(开发者预览与安全说明),2026-11-15 核验:https://github.com/deepseek-ai/deepseek-harness