DeepSeek Harness v0.1.2-alpha.2
DeepSeek Harness v0.1.2-alpha.2：连接重试、Preset 与 Token 统计
- 作者
- DeepSeekAgent.io 编辑部
- 发布
- 更新
2026 年 8 月 30 日，DeepSeek Harness 官方发布 dsh-v0.1.2-alpha.2。这次不只是 GitHub 上的源码标签：@deepseek-ai/[email protected] 已进入 npm 的 alpha 通道。不过，npm 的 latest 和 next 仍指向 0.1.1-rc.2，普通的 npx @deepseek-ai/dsh web 不会自动升级到 alpha.2。
alpha.2 没有再次大改 Harness 架构，重点是把 alpha.1 的新能力变得更容易观察和使用：连接失败能重试，定时计划能在会话中看见，插件与 Preset 更容易查找，回答末尾也能直接查看 Token 用量和耗时。
一句话结论
v0.1.2-alpha.2 是已经发布到 GitHub 和 npm alpha 通道的官方预发布版，但不是稳定版。想验证新功能，可以固定 alpha.2 在隔离环境中测试；只想稳定使用 DSH，继续使用默认的 rc.2 更合适。
这个版本到底发布到哪里了
| 检查项 | 2026 年 8 月 31 日状态 |
|---|---|
| GitHub Release | v0.1.2-alpha.2，标记为 Pre-release |
| GitHub Tag | dsh-v0.1.2-alpha.2，对应提交 0a53fb5 |
| npm 精确版本 | @deepseek-ai/[email protected] 已发布 |
npm alpha | 指向 0.1.2-alpha.2 |
npm latest / next | 仍指向 0.1.1-rc.2 |
因此，下面两条命令的结果不同：
# 仍会使用默认发布通道
npx @deepseek-ai/dsh web
# 明确测试 alpha.2
npx @deepseek-ai/[email protected] web
不要因为 npm 上已经能找到 alpha.2，就把它当成默认稳定升级。官方仍把它标记为 Pre-release。
alpha.2 有哪些实际变化
连接失败后可以重试
Web 界面现在会显示连接异常状态，支持自动重试，也提供立即重连操作。对使用远程 DSH、反向代理或不稳定网络的用户来说，这比只看到会话停止响应更容易判断问题发生在哪一层。
它改善的是连接恢复体验，不代表所有失败都会自动安全重放。遇到工具已经执行、但界面连接中断的情况，仍应先确认会话记录，再决定是否重新发送任务。
会话标题可以看到活动的定时计划
启用 Schedule 组合后，活动提醒会显示在会话标题区域。这个位置只负责展示，不会在界面里创建、修改或确认提醒。
DSH 的 Schedule 是 Session 内的提醒机制，不是操作系统通知或云端定时任务。关闭进程或让 Session 保持冷状态时，内存中的计时器不会继续运行；重新打开原 Session 后，持久化记录可以恢复并处理逾期提醒。
插件与 Agent Preset 更容易查找
插件列表现在会区分会话插件和全局插件。在列表里选择一个 Agent Preset，就能看到它包含哪些插件，也可以继续搜索其他 Preset。
这里的重点是看清“当前 Agent 由什么组成”。Plugin 提供模型、工具、存储或界面等能力，Preset 则把这些 Plugin 组合成一个可启动的 Agent。alpha.2 改善的是管理和查看入口，不应理解成任何运行中的会话都可以随意更换整套工具。
回答末尾显示 Token 用量和耗时
每次回答完成后，界面会显示 Token 用量和耗时，点击后可以查看更详细的统计。相比只在日志中查用量，这更适合判断长会话是否开始变贵，以及某次任务的耗时是否异常。
这些数字是观测信息，不是预算上限。它不会自动阻止高成本任务，也不能替代 API 服务商的最终账单。
长会话和实时消息处理更快
官方说明提到，alpha.2 提升了长会话历史和密集实时消息的处理效率，并减少 macOS、Linux 加载会话时不必要的文件系统检查。对于包含大量工具调用、图片或子 Agent 事件的会话，这类优化比首页动画变化更值得关注。
错误信息更具体
web_search 失败时，现在会报告实际使用的端点和错误明细。这有助于区分搜索服务不可用、Endpoint 配置错误和上游返回异常。
Remote 网关也增加统一的 RemoteError 调用异常封装，插件作者可以围绕更一致的错误形态处理远程调用失败。
修复部分 Node.js 24 启动问题
alpha.2 修复了 Node.js 24.0 到 24.11.1 上可能出现的启动失败和 HMR 失效。这个修复对源码开发和插件调试更直接；如果当前 rc.2 环境运行稳定，不必只为这一项切换整个工作环境。
插件作者需要注意什么
alpha.2 恢复了 alpha.1 中移除的 SessionEvent.ignorable。这说明 alpha 阶段的事件接口仍可能快速调整，插件不应只在编译通过后就宣布兼容。
至少应该检查：
- 会话事件解析是否兼容
ignorable的恢复。 - Remote 调用失败是否正确识别新的统一错误封装。
- Web UI 插件是否依赖旧的插件列表或回答尾部 DOM 结构。
- 长会话、断线重连和重复消息场景是否会重复执行有副作用的工具。
package.json是否固定了实际测试过的 DSH 版本范围。
alpha.1 与 alpha.2 怎么选
| 场景 | 建议 |
|---|---|
| 普通用户 | 继续使用 npm 默认的 0.1.1-rc.2 |
| 想测试 0.1.2 新功能 | 直接固定 alpha.2，没有必要新装 alpha.1 |
| 插件兼容测试 | 同时保留 rc.2 与 alpha.2 测试环境 |
| 生产部署 | 不要自动跟随 alpha 标签，固定并验证具体版本 |
alpha.1 的价值主要是引入 Agent Teams、PTC、ACP、子 Agent 模型选择和大规模客户端重构。alpha.2 是这条开发线上的后续修订，改进连接、可观测性、Preset 管理和运行体验。
现在应该升级吗
如果你只是通过 npx @deepseek-ai/dsh web 使用默认 Web 界面，而且当前没有连接或 Node.js 24 问题，可以继续留在 rc.2。
如果你正在开发 DSH Plugin、测试 Schedule、使用长会话，或者需要验证 0.1.2 的接口变化，alpha.2 比 alpha.1 更适合作为当前测试基线。测试时应固定完整版本号，并使用可丢弃的工作区和独立配置，避免预发布迁移影响日常会话。
相关阅读
- DeepSeek Harness v0.1.2-alpha.1：Agent Teams、PTC 与兼容性变化
- DeepSeek Harness 教程：安装、API Key 配置与使用指南
- Agent Preset 与 Plugin 有什么区别
- DeepSeek Harness 安全：沙箱、权限与提示词注入
常见问题
v0.1.2-alpha.2 是稳定版吗？
不是。它是官方 GitHub Pre-release，也是 npm alpha 通道中的预发布版本。npm 的 latest 和 next 仍是 0.1.1-rc.2。
直接运行 npx 会升级到 alpha.2 吗？
不会。npx @deepseek-ai/dsh web 使用默认发布通道。测试 alpha.2 时需要明确指定 @0.1.2-alpha.2，并在升级前再次核对 npm dist-tag。
alpha.2 支持 Cron 定时任务吗？
不支持。当前 Schedule 支持延时、指定时间和固定间隔提醒，属于原 Session 的本地持久化记录，不是 Cron、系统通知或外部消息服务。