DeepSeek Harness v0.1.5-alpha.1 主要更新一览

距离 v0.1.3-alpha.2（2026-09-07 21:59 北京）1 天 2 小时 17 分，DeepSeek Harness 团队又推了一版——但这次不是 0.1.4 系列，直接跳到 v0.1.5-alpha.1（2026-09-09 00:16 北京）。

跳过整个 0.1.4 系列意味着这个版本的变更足够大，需要单独起一个 minor。会话格式从 V2 升到 V3（升级后不支持降级）+ 插件 Agent API 和 Inbox API 两项破坏性调整——这三个 breaking 都需要写 dsh 集成 / 插件的同学重点关注。

本文目录

一、官方原文（中文版）

二、值得展开的几件事

三、跳过 0.1.4 整条线意味着什么

四、适合升级吗

一、官方原文（中文版）

下面是官方 release body 的中文原文，逐项未删（引号统一为中文弯引号）。

新增功能

• 支持动态修改系统提示词且不破坏 KV Cache，模型需显式声明支持 — @tianyicui
• 新增实验性右侧 Sidebar，支持多标签、分栏与全屏；聊天文件链接和产出文件支持 Sidebar 打开，并移除原 Detail 面板 — @imccyu

体验优化

• 改善 Web 输入框的菜单层级、提示文字和间距；会话统计改为两个可展开的摘要，分别查看轮次与速度、精确 Token 用量与缓存命中 — @Yifffan
• 内置斜杠命令说明支持中文，并随界面语言即时更新；切换语言时保留已打开菜单和查询内容 — @Kaige-Gao
• 可选子代理插件的内置运行时升级至 Codex 0.153.4 和 Claude Code 2.1.263；显式模型配置保持不变，未配置模型时 Codex 使用上游默认值 — @koalazf99

问题修复

• 修复会话运行中发送按钮与 Enter 的行为不一致：两者均遵循“繁忙时的发送行为”设置，并明确提示排队或插话发送 — @lsdsjy
• 修复模型可自行恢复用户已暂停目标的问题；暂停后须由用户恢复，尚未激活的目标也会显示恢复入口 — @mektpoy
• 修复聊天中本地图片路径无法显示的问题，支持模型回复引用的 POSIX 绝对路径图片，包括工作区外截图；加载失败时显示替代文字或原路径 — @kermanx
• 拒绝不含正文或附件的空消息及空白队列编辑，保留仅发送图片或文件的能力 — @turtle1999
• 修复查找项目根目录遇到权限或 I/O 错误时误用上级项目指令的问题，相关错误会直接报告 — @turtle1999
• 修复折叠的思考摘要直接显示 Markdown 加粗标记的问题，展开内容保持完整 — @turtle1999
• 修复 macOS 和 Linux 依赖 fs-ext 需要本地编译的问题 — @imccyu

其他变更

• 会话格式升级至 V3： 恢复受支持的历史会话时生成新版日志并保留原文件，系统提示词纳入消息历史，旧 PTC 事件与 code 预设引用自动迁移。自定义日志读取器需适配新格式；升级后的会话不支持降级读取 — @tianyicui
• 插件 Agent API 调整： 移除 ctx.agent，调用方需显式传递 Agent；同时修正可继续对话的子代理归属，避免它们被当作根会话参与定时调度 — @kermanx
• Inbox API 调整：Inbox 改为类型接口，不再导出可构造的运行时类；插件通过 agent.inbox 读写待处理消息，hasPending 与 claim 不再属于公共接口 — @kermanx

二、值得展开的几件事

15 项里大部分是常规迭代，下面这几件值得多说几句。

1. 会话格式升 V3——升级前必读

官方："会话格式升级至 V3： 恢复受支持的历史会话时生成新版日志并保留原文件，系统提示词纳入消息历史，旧 PTC 事件与 code 预设引用自动迁移。自定义日志读取器需适配新格式；升级后的会话不支持降级读取 — @tianyicui"

这是这次最大的破坏性变更——三个关键点：

• 历史会话自动迁移：恢复时生成新版日志，原文件保留（不会丢数据）
• 系统提示词纳入消息历史：之前 system prompt 是单独的，现在成为消息流的一部分
• 升级后不支持降级：升到 V3 后回不去 V2——升之前确认你不需要降级

谁要看：

• 自定义日志读取器的代码（要适配 V3 格式）
• 长期会话备份策略（旧的 V2 会话会保留，但不能再用 dsh 旧版本读）

2. 动态改 system prompt 不破坏 KV Cache——性能特性

官方："支持动态修改系统提示词且不破坏 KV Cache，模型需显式声明支持 — @tianyicui"

这是个性能特性，不是新功能本身：

• 之前改 system prompt 会让模型重算整段缓存——长会话代价很大
• 现在模型可以显式声明支持这个能力，dsh 改 system prompt 时保留 KV Cache

实际效果：长会话里改 persona / 加规则，不用重头算——这是大模型使用体验的细节但很重要。

限制：需要模型显式声明支持。具体哪些模型支持看 pi-ai 0.85.1 的更新列表。

3. 实验性右侧 Sidebar——替代原 Detail 面板

官方："新增实验性右侧 Sidebar，支持多标签、分栏与全屏；聊天文件链接和产出文件支持 Sidebar 打开，并移除原 Detail 面板 — @imccyu"

为什么是"实验性"：

• 多标签 / 分栏 / 全屏是基础能力
• 但移除原 Detail 面板意味着旧入口没了
• 标"实验性"说明 API 还可能变

用法：聊天里点文件链接 / 产出文件，会在右侧 Sidebar 打开，不再跳到原 Detail 面板。

4. 插件 API 两项调整——写插件必看

官方："插件 Agent API 调整： 移除 ctx.agent，调用方需显式传递 Agent；同时修正可继续对话的子代理归属，避免它们被当作根会话参与定时调度 — @kermanx""Inbox API 调整：Inbox 改为类型接口，不再导出可构造的运行时类；插件通过 agent.inbox 读写待处理消息，hasPending 与 claim 不再属于公共接口 — @kermanx"

@kermanx 一人做了 2 项 breaking（加上修复 1 项，3 项）：

• ctx.agent 没了：之前可以从上下文拿 Agent，现在要显式传
• Inbox 改成类型接口：不能再 new Inbox()，要用 agent.inbox
• hasPending / claim 不再公共：插件要适配新的消息查询接口

可继续对话的子代理归属也修了——之前会被错误地当根会话参与定时调度。

5. 新作者 @Kaige-Gao 首次出现

官方："内置斜杠命令说明支持中文，并随界面语言即时更新；切换语言时保留已打开菜单和查询内容 — @Kaige-Gao"

@Kaige-Gao 是这次首次出现的贡献者——做的是斜杠命令本地化。

6. 子代理 runtime 升级——间接依赖更新

官方："可选子代理插件的内置运行时升级至 Codex 0.153.4 和 Claude Code 2.1.263；显式模型配置保持不变，未配置模型时 Codex 使用上游默认值 — @koalazf99"

Codex 和 Claude Code 作为 dsh 的子代理运行时也跟着升了。如果你在用 Codex / Claude Code 子代理，这次升级会自动生效。

注意：未配置模型时 Codex 用上游默认值——之前用户可能希望固定某个模型，现在默认值会跟着 Codex 上游变。

三、跳过 0.1.4 整条线意味着什么

dsh 从 2026-08-17 第一个稳定 RC 到 2026-09-09 v0.1.5-alpha.1，22 天 4 小时 15 分里 13 个 release。

最近 4 版间隔：29h → 3 天 2h → 1 天 2h——节奏从放慢回到 1-2 天一版。

但这次最大的信号不是节奏，是跳版本号——从 0.1.3-alpha.2 直接到 0.1.5-alpha.1，中间没有 0.1.4 系列。可能的原因：

1. V3 格式 + 插件 API 调整破坏性太大，需要单独 minor
2. 团队对 0.1.4 有内部规划但未公开 release（可能性低）
3. 直接放弃 0.1.4 路线，把改进合到 0.1.5

3 个 breaking 同时落地——这在任何项目里都是大动作。建议：

• 写 dsh 集成的同学：先看自己的代码用没用 ctx.agent、Inbox 类、自定义日志读取器——任何一个用了都要适配
• 生产环境用户：继续等 0.1.5 系列收敛——3 个 breaking 一次落地通常意味着还会修

距离 stable 还有多远？3 个 breaking 的 minor 通常要走 4-8 个 alpha + 1-2 个 rc。乐观估计 0.1.5 stable 在 10 月上中旬。

npm tags 现状：

• latest：0.1.2-rc.1（不变）
• next：0.1.2-rc.1（不变）
• alpha：0.1.5-alpha.1（已同步，0.1.5 直接取代 0.1.3-alpha.5 在 alpha tag 上）

四、适合升级吗

升级命令：

注意：这次 @alpha tag 直接是 0.1.5-alpha.1——意味着 0.1.3-alpha.5 在 npm alpha tag 上被取代了。

dsh v0.1.5-alpha.1 是一个**「跨 minor + 3 breaking」版**——跳过整个 0.1.4 系列，会话格式从 V2 升到 V3（不可降级），插件 Agent API 和 Inbox API 同时调整。写 dsh 集成 / 插件的同学必看，普通用户可以等稳定版。

官方主动把所有破坏性变更集中在一个 alpha 里——这种"集中 break"反而是好事：一次性适配完，不用每次 alpha 都改。

互动问题：你写过 dsh 集成吗？这次 V3 格式 + Agent API + Inbox API 三个 breaking 对你影响大吗？跳过整个 0.1.4 系列你觉得是有意为之还是意外？dsh 团队把 3 个 breaking 集中在一个 alpha 里发布，你认为是好事还是激进？