DeepSeek Harness v0.1.2-alpha.4：Agent 双向通信与 Session API 变化

2026 年 9 月 1 日，DeepSeek Harness 官方发布 dsh-v0.1.2-alpha.4。这一版最重要的产品变化，是父 Agent 与可持续子 Agent 可以通过 send_message 双向传递后续消息；同时，Python SDK、Headless、ACP 和自定义 Profile 默认获得 web_fetch，模型目录与长会话性能也继续改善。

对插件作者来说，alpha.4 还有两项需要认真处理的接口变化：Session.events 被按需读取 API 取代，SessionSeq 与 SessionLogOffset 也被区分为不同强类型。

一句话结论

alpha.4 让持续子 Agent 从“完成后单向报告”走向可继续协作的双向通信，也扩大了非 Web 入口的网页读取能力。普通用户可以关注交互改进；Agent 与插件开发者则应优先检查消息协议和 Session API 兼容性。

版本状态

复现时固定具体版本：

npx @deepseek-ai/[email protected] web

父 Agent 与可持续子 Agent 可以双向通信

alpha.4 使用 send_message 取代原先单向的 report 工具，让父 Agent 和仍可继续运行的子 Agent 都能发送后续消息。

这改变了协作模型：父 Agent 不必等子 Agent 以一次性报告结束全部工作，可以在获得中间结果后继续追问、补充边界或请求验证；子 Agent也可以在后续回合接收新上下文。它更适合研究、代码审查和长链路交付任务。

但“双向”不等于所有子 Agent 永久在线。是否还能继续消息，仍取决于该子 Agent 的生命周期、会话状态和调用方是否保留了正确身份。

更多入口默认获得 web_fetch

Python SDK、Headless、ACP 和自定义 Profile 现在默认提供 web_fetch。这使不经过默认 Web 界面的 Agent 也更容易读取明确 URL，而不必额外拼装相同能力。

web_fetch 仍属于外部内容入口。获取到的网页可能包含提示词注入、错误信息或不可信指令；Agent 应把它当作数据，而不是更高优先级的命令。网络策略和 SSRF 防护也仍然适用。

Web PTC Mode 不再默认提供通用 workflow 工具

alpha.4 不再向 Web PTC Mode 的模型默认暴露通用 workflow 工具。这是一项组合边界调整，不代表所有 Workflow 能力被删除。

如果自定义 Preset 依赖模型直接调用通用 workflow，升级后要检查最终工具清单和系统提示词，不能只根据插件是否安装判断能力仍然可见。

模型目录更容易搜索

自定义模型发现会复用 Profile 请求头，模型目录也新增搜索与筛选。这对需要鉴权请求头的自建网关，以及暴露大量模型的 Provider 更实用。

目录能发现某个模型，不代表模型一定支持当前 Agent 所需的视觉、工具调用、推理力度或上下文长度。选择后仍应验证实际请求能力。

长会话性能继续改善

alpha.4 继续降低超长会话在流式回复、布局计算和导航预览时的渲染开销，并调整界面圆角、描边、回合导航和投影效果。

这延续了 alpha.3 的长会话工作。alpha.3 更突出分页导航和内存占用，alpha.4 则继续优化流式更新和界面计算路径。

插件作者需要迁移的 Session API

alpha.4 用按需读取接口替代 Session.events：

• seq
• eventAt()
• snapshotEvents()

同时，SessionSeq 和 SessionLogOffset 被定义为不同的强类型。两者都可能表现为数字，但语义不同：一个表示事件序列位置，另一个表示日志存储偏移。依赖旧 Session.events 或把两种位置混用的插件，应在升级前完成编译和行为测试。

升级前检查

1. 使用 Agent Teams 或自定义子 Agent 的项目，验证 send_message 路径和持续会话身份。
2. 依赖 report 的插件，检查工具是否已被替换以及消息结束条件是否变化。
3. 依赖 Session.events 的代码，迁移到新的按需读取 API。
4. 检查 PTC Preset 的最终工具列表，不要假设通用 workflow 仍会默认出现。
5. 从 alpha.2 或更早版本升级时，先阅读 alpha.3 的 SQLite 后端移除提醒。

相关阅读

• DeepSeek Harness v0.1.2-alpha.3：长会话优化与 SQLite 后端移除
• DeepSeek Harness v0.1.2-alpha.5：npm 发布状态与升级建议
• DeepSeek Harness Agent Teams 指南
• DeepSeek Harness Python SDK 教程

常见问题

alpha.4 是稳定版吗？

不是。它是官方 GitHub Pre-release，应固定完整版本并先在隔离环境测试。

send_message 是否完全取代所有 Agent 报告？

发布说明明确说它取代父 Agent 与可持续子 Agent 之间原先单向的 report 工具。其他一次性任务、插件自定义协议或不可持续子 Agent 不应在没有验证的情况下套用同一结论。

Session.events 还能继续使用吗？

alpha.4 发布说明称其已被 seq、eventAt() 和 snapshotEvents() 取代。插件作者应按新 API 迁移，而不是依赖旧字段继续存在。