DeepSeek Harness
DeepSeek Harness alpha.2：工作树与升级检查
DeepSeek-V4 Team · 2026年10月8日 · 10 分钟阅读
DeepSeek Harness dsh-v0.2.1-alpha.2 于 2026 年 10 月 9 日发布，新增让智能体创建独立 Git 工作树的能力，也调整了自定义运行时使用的若干接口。如果你已经在用 10 月 3 日发布的 alpha.1，是否升级取决于具体需求：需要工作树、某项故障修复，还是新版 SDK 的行为？
本文最初针对 alpha.1 撰写，本次补充 alpha.2 的变化。依据是 alpha.2 官方发布说明 和固定版本文档。下文提供的是可在自己环境中执行的验收建议，不是跨平台跑分，也不代表我们已经运行过 Harness 桌面版。
先看哪项变化与你的工作有关
新的 Git Worktrees 插件允许智能体新建分支和独立工作目录，然后在该目录继续当前会话。功能仍属实验性质，默认关闭。第一次可以只做一个小范围尝试：让智能体在主工作目录之外修改一处文档，再检查差异。
Alpha.2 还新增了实验性的推理翻译插件。发布说明列出 Bing、Google 翻译，以及需要付费的 DeepSeek Flash 选项。它改变的是推理内容的呈现方式，不是发布了新基础模型，也不能据此判断推理准确率提高。评估时应看实际译文是否易读，技术标识符是否被错误改写。
另一组变化针对已有工作流的可靠性：响应流停滞时能够触发空闲超时；插件元数据无法读取时不再阻塞整个请求；后台任务也不再容易因父轮次结束而被误标为中断。这些是官方说明中的修复，在自己的环境中重现原故障并验证后，才能确认问题确实解决。
| 当前情况 | 优先检查什么 | 保留哪些证据 |
|---|---|---|
| 智能体修改与本地工作互相干扰 | Git Worktrees | 目录、分支、起始提交和差异 |
| 后台任务被显示为中断 | 升级后重新执行同一任务 | 实际产物和最终任务状态 |
| 维护自定义 SDK 运行时 | 接口迁移要求 | 集成测试与事件处理结果 |
| 现有工作流一直稳定 | 一次小范围回归检查 | 同一任务能否得到原有预期结果 |
工作树分开了文件，权限仍沿用原有策略
alpha.2 工作树文档 说明，新工作目录来自本地 Git 修订版本。原目录中尚未提交的文件变化不会一起带过去。如果智能体需要的内容还只存在于编辑器里，创建工作树后也不会自动获得它。
创建操作继续受会话已有的文件策略约束。新的路径不等于新的安全边界，也不会自动获得向受限位置写入的权限。目标目录和共享的 Git 管理目录都需要在现有策略下可写。
编辑前应核对工具返回的路径。工作树默认放在当前检出目录之下；如果从已有的关联工作树开始，就会在该工作树内建立新的存放目录。退出后，工作目录和分支都会保留。工作树入门教程 用一个便于检查的小任务说明了这些步骤。
自定义集成需要单独检查迁移要求
Alpha.2 中影响较大的变化，未必能从普通界面上看出来。子智能体工具现在立即返回子会话 ID，自定义 SDK 运行时需要支持 session/wait。如果旧代码把首次返回当作任务完成，就需要调整完成状态的判断方式。
工具呈现方式中的 both 已被移除，保留 native 和 ptc。Python PTC 开始使用会话的文件系统沙箱，自定义组合需要提供沙箱及沙箱策略服务。这涉及配置和生命周期，不能只在文件里搜索关键词后批量替换。
Agent Team 消息改为直接投递到目标 Inbox。依赖旧发件箱、自动重试或重发去重逻辑的自定义插件，应逐项对照迁移说明。发送成功后，接收方是否产生了预期结果，比“没有报错”更能说明问题。
共享 agents 目录现在支持 AGENTS.md，并可通过 DSH_AGENTS_HOME 指定替代目录。另一个独立变化是：智能体指令配置中逐行设置的 dshHome 选项被移除，改用进程级 DSH_HOME 的默认值。检查已有部署时，别把这两个环境变量混为一谈。
任务状态显示正确，还要检查实际产物
后台任务状态更准确，有助于定位故障，但不能证明所需产物已经存在。写报告的任务要打开报告；改代码的任务要检查差异和测试结果。把这些证据与界面上的状态一起保留，才方便追查。
例如，任务可能已经写完报告，却把文件放到了另一个目录。在核实进程的执行位置之前，“任务完成”和“没有找到文件”并不矛盾。Alpha.2 的 working_directory 工具和 SDK 目录操作，让会话位置成为可以明确检查的一项信息。
已有的定时工作流也应这样验收：提醒是否送达，与提醒要求的工作是否完成，要分开检查。自动化验收教程 解释了两者的区别，任务显示修复后，这个原则仍然适用。
分清 alpha.1 与 alpha.2 的变化
10 月 3 日的 alpha.1 版本 已经引入插件创建入口、内置 Web 自动化，以及实验性的 Claude Code Mods 兼容能力。从更早版本升级的读者需要了解这些背景，但它们不是 10 月 9 日新增的功能。
插件维护者应同时检查两个版本的迁移说明。Alpha.1 移除了运行时 invariant 插件，并将消息输入框的统计项拆分为 activity 和 usage。安装器也开始更清楚地显示实际安装版本，包括因发布时效策略而选用旧包的情况。请求安装的版本与最终安装的版本，仍然需要分别记录。
首次安装可先阅读 本地快速入门；需要创建插件时，可使用 Creator 教程。不必在同一次升级验收中，把所有实验性功能一起打开。
用一次范围明确的会话判断是否升级
记录当前 Harness 版本，并保留日常依赖的配置和会话数据。选一个预期结果明确的普通任务，升级后再执行一次。确认原有能力正常，再启用需要的实验性插件，或测试已经修改的集成。
对工作树而言，验收应覆盖起始提交、新分支、当前目录和已检查的差异；对 SDK 集成而言，应观察子任务真正完成，并测试实际使用的接口。如果这些变化暂时不能改善你的工作，考虑到它仍是 alpha 版，先在独立环境中试用也很合理。