DeepSeek Harness v0.1.7-alpha.2
DeepSeek Harness v0.1.7-alpha.2：会话恢复、Agent Team 与 Token 截断
- 作者
- DeepSeekAgent.io 编辑部
- 发布
- 更新
DeepSeek 于 2026 年 9 月 22 日发布 dsh-v0.1.7-alpha.2。它紧接 alpha.1，重点处理新架构进入实际使用后暴露的可靠性问题：连续后台命令和一次性 Sub-agent 任务可能让 Session 停住、Web 重启后可能显示假连接、长 Tool 内容的截断可能丢掉图片或关键尾部信息。
这一版还调整了 Agent Team 初始任务、模型名称展示、PowerShell 等待和首次插件安装的 registry 选择。它不是 alpha.1 的合并说明，而是一篇独立的修复版本记录。
发布与安装
| 检查项 | 2026-09-23 状态 |
|---|---|
| GitHub Release | v0.1.7-alpha.2，Pre-release |
| npm 完整版本 | 0.1.7-alpha.2 已发布 |
npm alpha | 0.1.7-alpha.2 |
npm latest | 0.1.5-rc.2 |
| 上一版本 | v0.1.7-alpha.1 |
固定本版运行：
npx @deepseek-ai/[email protected] web
已经测试 alpha.1 的用户可以直接比较两个固定版本；依赖 latest 的环境不会自动升级到本版。
Session 停住：完成通知现在默认不设上限
alpha.2 修复了两类 Session 无法继续的问题：连续执行多个后台命令后，主 Session 可能收不到正确唤醒；一次性 Sub-agent 完成任务后，也可能没有把控制权交还给后续流程。
完成通知的唤醒次数现在默认不设上限，同时保留配置入口。这不是允许 Agent 无限执行任务，而是避免“任务已经结束，Session 却因为通知次数耗尽而停在等待状态”。
升级后可以用以下回归场景验证：
- 连续启动两个短后台命令；
- 同时委派一个一次性 Sub-agent；
- 等待三者结束；
- 确认主 Session 收到完成事件并继续生成下一步；
- 重载页面，检查事件和最终状态没有重复。
如果团队主动配置过 completion wakeup 上限，应重新核对该值，而不是默认沿用旧限制。
Web 重启后的连接状态
alpha.2 修复 Web 重启后界面仍显示已连接、实际请求却无法送达的问题。前端会在服务真正就绪后重新连接。
这项修复对远程工作区、反向代理和开发环境热重启尤其重要。验证时应同时观察状态指示、Session 列表刷新和一次真实模型请求，不能只以绿色连接图标作为判断依据。
Tool 内容按 Token 预算截断
Tool 的文字和图片现在共享估算 Token 预算。内容过长时，DSH 会同时保留头部与尾部，并提供被省略内容的访问路径；这也修复了 MCP 返回图片时，前面的文字触发截断后图片一起消失的问题。
自定义 spill policy 存在一个配置迁移：
maxInlineBytes -> maxInlineTokens
仍使用 maxInlineBytes 的插件需要改名，并按 Token 语义重新评估阈值。字节数与 Token 数不等价，不能机械复制旧值后就认为行为一致。
建议用三组 Tool Result 回归：长文本、文字加图片、重要结论位于末尾的长输出。检查模型既能看到开头的上下文，也能取得尾部结果和完整内容入口。
Agent Team 初始任务更明确
新建 Agent Team 时，成员初始任务会包含队友和 Lead 的协作提示。这样可以减少成员只理解自己的局部任务、却不知道向谁汇报或如何交接的情况。
任务板和成员工具仍应承担结构化协作。提示词提供方向，不能替代任务状态、依赖关系和完成条件。团队模板可以检查自定义初始提示是否与新版内置提示重复。
首次安装插件会选择可响应的 registry
当用户没有预先配置 npm registry 时，首次插件安装会从可响应的 registry 中选择一个。对网络环境复杂的用户，这能减少安装过程长时间等待无响应源的问题。
企业或可复现环境仍应显式固定 registry。自动选择适合首次使用，不应替代团队对包来源、镜像同步和供应链策略的控制。
交互、模型与 Office 修复
alpha.2 继续修正了一批可见问题：
- 滚动、历史加载、Turn 导航和消息显示更稳定；
- 代码块样式、复制、自动换行、Diff 和行号得到整理；
- 排队消息保留换行；
- 长文件名不再挤出 Review Popover；
- Excel 特殊内容与缩放状态修复；
- PowerShell 持续等待的问题修复；
- 语音识别设置可以正确保存；
- 自动发现的模型显示可读名称，同时保留真实模型 ID。
模型显示名和模型 ID 分离后，排障时应记录真实 ID。可读名称适合界面选择，Provider 请求和迁移检查仍以 ID 为准。
插件更新范围收紧
Vendor Package 的自动更新限制在同一 minor 内的 patch 版本，降低自动更新跨越兼容边界的风险。预发布版本和自定义 Bundle 仍应固定完整版本并进行加载、卸载、配置迁移和 Session 恢复测试。
alpha.1 用户的升级清单
| 场景 | alpha.2 重点检查 |
|---|---|
| 后台任务 | 多个命令完成后主 Session 被正常唤醒 |
| Sub-agent | 一次性任务完成后流程继续，不重复通知 |
| Web | 重启后重新连接并能完成真实请求 |
| MCP/Tool | 长文字与图片共同截断，尾部结论仍保留 |
| 自定义 spill policy | maxInlineBytes 改为 maxInlineTokens |
| Agent Team | 初始任务包含队友与 Lead 协作信息 |
| 插件安装 | registry 选择符合团队来源策略 |
| 模型接入 | 显示名正确，底层模型 ID 未被替换 |
alpha.2 适合已经进入 0.1.7 alpha 测试的用户优先采用。仍在 rc 主线的环境，可以把它作为评估 Session V4 和新插件架构时的当前 alpha 基线。
相关阅读
常见问题
alpha.2 是稳定版吗？
不是。GitHub 将它标记为 Pre-release，npm 默认 latest 也仍是 rc 版本。
“完成通知不设上限”会让 Agent 无限循环吗？
它解决的是已完成任务无法唤醒 Session 的问题，不等于取消 Agent Turn、任务或权限边界。Agent Loop 仍需独立控制。
自定义插件一定要改配置吗？
使用自定义 spill policy 且仍配置 maxInlineBytes 的插件需要迁移到 maxInlineTokens。其他插件也应验证长 Tool Result 与图片内容。