DeepSeek Harness v0.1.2-rc.1:默认版本升级与迁移重点

作者
DeepSeekAgent.io 编辑部
发布
更新

2026 年 9 月 3 日,DeepSeek Harness 官方发布 dsh-v0.1.2-rc.1,npm 的 latestnext 随后都切换到 @deepseek-ai/[email protected]。这意味着普通的 npx @deepseek-ai/dsh web 已不再启动旧的 0.1.1-rc.2,而会进入新的 0.1.2 候选版本。

这一版汇总了 0.1.1-rc.2 之后的主要用户体验、Agent Teams、SDK、网络、安全与 Session 架构变化。它仍属于 Developer Preview 和 GitHub Pre-release,不应被称为稳定版,但已经成为 npm 默认安装路径,影响面比之前的 alpha 版本更大。

一句话结论

新安装用户默认会获得 rc.1;现有用户升级前应备份 Session 与配置、核对插件兼容性,并重点关注 SQLite Session 后端移除、一次性远程访问令牌、PTC Mode 更名和 Session API 变化。

版本状态

检查项状态
GitHub Releasev0.1.2-rc.1,标记为 Pre-release
GitHub Tagdsh-v0.1.2-rc.1,提交 a66e470
发布时间2026-09-03 06:06 UTC
npm 精确版本@deepseek-ai/[email protected] 已发布
npm latest / next均指向 0.1.2-rc.1
npm alpha仍指向 0.1.2-alpha.5

固定版本运行:

npx @deepseek-ai/[email protected] web

普通命令现在也会解析到 rc.1:

npx @deepseek-ai/dsh web

用户最容易感知的变化

会话流默认折叠已完成回答前的过程内容和 System prompt,正文宽度可以自适应或拖动调整,回答末尾会显示 Token 用量与耗时。长会话新增覆盖完整历史的回合导航,流式代码高亮、图片后台上传、草稿保留和连接自动重试也得到改善。

插件列表开始区分会话插件与全局插件,并支持查看其他 Agent Preset。模型目录可以搜索和筛选,自定义模型发现也会复用 Profile 请求头。这些变化让日常配置更直观,但不会自动保证第三方插件与新接口兼容。

Agent Teams 与子 Agent

父 Agent 与可持续子 Agent 现在通过 send_message 双向传递后续消息,取代原先单向的 report 工具。调用方还可以在授权范围内指定子 Agent 的 Provider、模型、推理力度和最大输出长度。

升级后应实际验证消息顺序、冷恢复和子 Agent 生命周期。只看到配置成功加载,不代表长任务中的后续消息一定按旧逻辑工作。

Web、Headless、SDK 与远程访问

Python SDK 新增 Windows x64 runtime;ACP 补齐 Session 控制、模型、MCP、权限与取消能力。Python SDK、Headless、ACP 和自定义 Profile 默认获得 web_fetch,Headless 则把运行进度写到 stderr,只把最终结果留在 stdout。

通过网络访问 Web 界面时,启动链接中的一次性 Token 现在参与鉴权。反向代理、远程桌面或自建启动器不能继续假设只要端口可达就能进入界面。

需要认真处理的兼容性变化

rc.1 包含数项可能影响现有环境的变化:

  • Code Mode 更名为 PTC Mode,旧会话仍可读取。
  • 可选 SQLite Session 持久化后端被移除;已有数据不会自动删除,但需要用旧版本导出。
  • Session.eventsseqeventAt()snapshotEvents() 等按需读取 API 取代。
  • Remote 网关移除了旧 APIProxy 路径。
  • Web PTC Mode 不再默认向模型提供通用 workflow 工具。
  • 公网 web_fetch 默认启用,并带 SSRF 防护;外部内容仍应按不可信数据处理。

安全说明不能省略

本版同步更新了官方 Safety Notice:DeepSeek Harness 尚未接受安全审计,沙箱、审批和权限控制不能保证完整隔离。插件以用户权限运行,启用前仍需检查源码、网络访问、文件权限和凭证边界。

升级建议

  1. 记录当前 DSH、插件与 Preset 版本,并备份重要 Session 和配置。
  2. 使用独立 $DSH_HOME 或测试 Profile 验证 rc.1。
  3. 检查 SQLite Session、Remote 入口、PTC 工具清单和自定义 Session API。
  4. 对关键插件执行真实的启动、工具调用、会话续接与子 Agent 消息测试。
  5. 确认无误后再升级日常环境,不要只以“npm 默认版本已变化”作为兼容性结论。

相关阅读

常见问题

rc.1 是稳定版吗?

不是。GitHub 将它标记为 Pre-release,项目仍处于 Developer Preview;它只是当前 npm 默认版本。

普通 npx 命令现在会安装哪个版本?

截至 2026 年 9 月 5 日,npm 的 latestnext 都指向 0.1.2-rc.1,所以不写版本号会解析到 rc.1。

应该直接从 rc.2 升级吗?

先在隔离环境验证。0.1.2 汇总了多个 alpha 阶段的接口与存储变化,特别是 Session 持久化、Remote 鉴权和插件 API,不能只做启动测试。