DSH 0.1.2-alpha.5：alpha.4 升级故障修复与重要变化

先看结论：要评估这一轮变化，目标应是 alpha.5，不是 alpha.4

DeepSeek Harness（DSH）0.1.2-alpha.5 是官方于 2026-09-02 发布的预发布版，固定提交为 db6bdc3576c2d4e7c965e8e3ed0c2a731eed87f5。它修复了从 0.1.1-rc.2 或 0.1.2-alpha.3 升级到 alpha.4 后可能无法启动、Session 列表标题消失的问题。alpha.4 承载本轮主要功能变化，alpha.5 紧接着修复升级兼容，因此需要一起判断。

52DSH 于 2026-09-02 核对了两个 Release、固定提交、实现说明和 npm 元数据。0.1.2-alpha.4、0.1.2-alpha.5 精确包均已存在，但 npm latest、next 仍为 0.1.1-rc.2。所以 alpha.5 可以被明确指定用于隔离评估，却没有成为普通 npx @deepseek-ai/dsh 的默认安装版；本站的默认教程基线也继续保持 rc.2。

本文是第一方 Release 与固定源码审阅，没有安装或运行 alpha.4、alpha.5，没有使用真实 Profile、Session、凭据或第三方插件，也没有执行升级和回退。页面中的“修复”是官方声明和实现事实，不代表本站完成跨平台运行认证。

版本状态与症状分流

本次已知兼容问题有明确来源版本范围，但它不是所有启动失败的统一解释。端口占用、Node 版本、损坏的 Profile、Provider 401、真实网络断开和第三方插件构建失败仍需分别排查。

alpha.5 修复的不是权威 Session 正文迁移

固定实现说明把 session_projcache 分为三个磁盘代次：rc.2 使用单个 v3 文件，alpha.3 使用逐记录 v4，alpha.4 增加 lineage 字段并升级为 v5。alpha.4 读取旧缓存时存在两条问题路径：v3 记录可能被错误按当前版本解释并阻止启动；v4 投影记录会因版本不匹配被丢弃，而 Session 列表只读取投影缓存，因此标题可能暂时消失。

alpha.5 为 v3、v4 增加兼容读取，旧记录在下次写入时转为 v5；不能安全解释的可丢弃投影记录会先备份为带时间戳的 .bak 文件，再跳过并冷重建。这里处理的是可重建的 Session 投影缓存，不是证明权威 JSONL Session 正文被删除或自动迁移。自定义 SQLite 路由也不自动获得这项 JSON 兼容放宽。

因此，遇到标题异常时不要运行来源不明的“恢复标题”脚本，更不要删除唯一 Session 目录。先保存版本、启动日志、Profile、Session 数量和数据副本，再按Web UI 启动排障与更新、回退指南分流。

alpha.4 的子 Agent 消息：从单向 report 改为受限双向 send_message

alpha.4 删除旧 report 工具包，并在子 Agent 控制工具中提供 send_message。它允许在线 Agent 向直属、可继续的子 Agent 发送后续消息；常驻可继续的子 Agent也可以在直属父 Agent 在线时向父级发送消息。目标仍在工作时，消息会在最近的步骤边界引导当前任务；目标空闲时，会触发一轮后续处理。

这不是任意 Agent 消息总线。固定边界包括：

• 只面向直属父子，不支持跨兄弟或任意深层后代寻址；
• 冷恢复只支持直属子 Agent；
• 子 Agent 向父级发送时，父 Agent 必须保持在线；
• 没有持久化的父级邮箱，不能承诺离线必达；
• report 与 send_message 不是名字不同但语义完全相同的接口。

需要把它落到代码复核任务时，阅读DSH 多 Agent 代码复核流程；任务合同、证据返回和人工批准仍然是主线。

web_fetch 默认可见，意味着要重新审阅公网数据边界

alpha.4 把 web_fetch 默认能力移动到共享 dsh-base。完整 Python SDK、Headless、ACP 以及只使用 base 的自定义 Profile 会继承 web_search 与 web_fetch；独立的 sdk-minimal 不使用 base，因此不在这个默认范围。Web app 会覆盖 base 工具配置，再通过 Agent Preset 组合相同能力。

官方实现只允许经过验证的公开 http:、https: 目的地址，但抓取在 shell 和文件系统审批 preset 之外执行，不需要逐次文件审批。公开地址校验也不等于阻止向公网发送任务输入。因此“模型看得到工具”不代表任意 URL 都成功，更不代表可以把密钥、内网地址、签名 URL 或客户数据交给抓取工具。受限部署应在 Profile 层显式关闭或覆盖网络工具配置。

Web PTC Mode 则做了相反方向的收窄：通用 workflow 工具仍在工作流引擎组中，但默认标记为禁用，因为 PTC 使用 run_code 作为模型生成的组合入口。标准 Preset 仍保留普通 workflow 工具。看到 PTC 中缺少 workflow 时，不应把它误判为整个 DSH 删除了工作流能力。一次性任务的网络和输出边界见DSH Headless 指南。

模型发现：复用部署请求头，同时增加目录搜索

对于已经配置并命名的自定义 Provider，alpha.4 的模型发现会在 Host 侧读取已存凭据与 Profile headers。浏览器的 Models 页面仍不负责编辑或回显这些部署请求头；页面输入的新 Key 优先于已存凭据，而 Profile headers 继续随 GET /models 请求发送。

模型候选选择器同时支持按模型 ID 或显示名称搜索。全选、取消全选只影响当前可见结果，并保留被筛掉项目的勾选状态。该变化能改善大型模型目录操作，但只适用于相应发现协议和合法配置；它不表示所有 Provider 都提供 /models，也不表示自定义 Header 会让不兼容协议自动工作。配置方法和 401 分流见模型、API Key 与 Provider 指南。

Session 开发 API：事件身份和日志偏移不再混用

alpha.4 用 seq、eventAt()、snapshotEvents() 等按需接口替代直接读取 Session.events 的模式，并区分两种以前都表现为普通数字的含义：

• SessionSeq 指向一条已经存在的事件；
• SessionLogOffset 指向事件之间的间隙、前缀长度或读取切点，可以等于事件总数。

这主要影响直接使用 Session API 的插件与集成。普通用户的 Resume、Fork、Compaction 概念没有因此变成另一套产品功能；但开发者不能继续把事件身份、事件数量和读取偏移随意互传，也不能只把 TypeScript 报错强制断言掉。磁盘 v0 JSONL 和公共 wire 仍保持普通数字表示，由各适配器在进入进程领域代码时验证并加上品牌类型。更多数据角色见DSH Session 使用与恢复指南。

三阶段升级检查表

升级前

1. 记录来源版本、启动命令、Profile、Node.js、模型 Provider 和必要插件版本；
2. 等待当前 turn 结束并正常停止 DSH；
3. 按部署制度备份配置、重要 Session 与工作区，凭据使用独立安全方案；
4. 保存 Session 列表的数量和标题快照，并确认至少一个重要旧会话可打开；
5. 为预发布评估准备隔离 Profile、可丢弃工作区和明确回退版本。

升级到 alpha.5 后

1. 确认实际版本是 0.1.2-alpha.5，不是移动标签或缓存中的旧构建；
2. 检查进程能否启动、Session 数量和标题是否符合升级前快照；
3. 只读打开一个旧会话，再新建一个不含敏感数据的低风险会话；
4. 根据实际使用范围检查模型目录、Headless 网络能力、子 Agent 后续消息或 Session 插件；
5. 保存脱敏日志、退出码和工作区 Diff，不把一次成功写成全平台兼容。

失败或准备回退时

1. 停止继续写入，不删除缓存、Session、Profile 或数据库来“试试”；
2. 保留失败版本、日志和数据副本，确认问题发生阶段；
3. 在另一个副本恢复升级前版本与匹配配置；
4. 验证旧版本能否读取自身格式，不假设版本回退等于数据结构自动回退；
5. 官方证据不足时暂停，请勿使用未经审阅的迁移或修复脚本。

谁适合隔离评估，谁应暂缓

常见问题

alpha.5 是稳定版吗？

不是。GitHub 将它标记为 Pre-release，npm 精确包虽已存在，但 latest、next 在 2026-09-02 仍是 0.1.1-rc.2。

默认执行 npx @deepseek-ai/dsh 会安装 alpha.5 吗？

不能这样推断。默认解析受 npm dist-tag 和本机缓存等因素影响；本文核对时默认标签未切换。需要可复核环境时应记录并明确指定经过审核的版本。

Session 标题消失是否表示会话正文已删除？

不是同一结论。alpha.5 固定说明将该现象定位到可重建的 Session 投影缓存跨版本读取；权威 Session 内容与列表投影不是同一数据域。仍应先备份和确认实际内容，不可凭此假设所有个案都安全。

旧教程是否都已经适配 alpha.5？

没有。52DSH 保留每篇教程自己的 dsh_version 与核验日期，只定向更新受本轮变化影响的页面。默认基线仍为 rc.2，第三方插件也必须单独核对。

上一轮长会话、图片和 SQLite Session 风险可查阅alpha.3 历史更新说明；如果还需要先确认 DSH 的官方身份、能力与默认通道，阅读DeepSeek Harness 是什么。准备实际更新前，继续阅读DSH 更新、回退与卸载指南。