版本号从 0.1.3 跳到 0.1.5，中间隔了 288 个 commit
9 月 8 日，DeepSeek Harness 发布了 v0.1.5-alpha.1。
距离上一个公开版本 0.1.3-alpha.2 只过去了一天，但版本号直接从 0.1.3 跳到了 0.1.5。Release Note 里轻描淡写地写着一行字：
288 commits to master since this release
也就是说，这个 alpha 版本切出来的时候，master 分支已经又往前跑了 288 个提交。DSH 的迭代速度，已经不能用"快"来形容了。
而这次更新里，有两个变化值得所有深度用户认真看：动态修改系统提示词且不破坏 KV Cache ，以及实验性右侧 Sidebar。
下面我们逐项拆解。
一、动态修改系统提示词：不破坏 KV Cache 的"黑魔法"
这是本次更新里技术含量最高的一项。
先解释一下背景。在 LLM 推理中，KV Cache 是一种缓存机制：模型处理完一段文本后，会把中间计算结果缓存下来，下次遇到相同前缀时直接复用，从而大幅降低延迟和成本。
但问题在于：系统提示词（System Prompt）通常是整个对话的最前缀。一旦你修改了系统提示词，整个缓存就会失效，模型需要从头重新计算。这就是为什么很多框架里，系统提示词在会话开始后就"锁死"了，中途改不了。
而 v0.1.5-alpha.1 支持了动态修改系统提示词且不破坏 KV Cache。
这意味着什么？
- 你可以在对话进行中，动态调整 Agent 的行为准则，而不需要重开会话。
- 修改系统提示词后，已有的缓存依然有效，不会导致推理成本飙升或响应变慢。
- 但有一个前提：模型需要显式声明支持这项能力。不是所有模型都能做到，框架层面提供了接口，模型层面需要配合。
对于需要长期运行、动态调整策略的 Agent 场景来说，这是一个非常底层但非常重要的能力 。它让"系统提示词"从一个静态配置，变成了一个可以随时微调的控制面板。
二、实验性右侧 Sidebar：工作台形态初现
第二个大变化，是 Web 端新增了实验性右侧 Sidebar。
这个 Sidebar 支持：
- 多标签
- 分栏
- 全屏
更重要的是，聊天中的文件链接和产出文件，现在可以直接在 Sidebar 中打开 。同时，原有的 Detail 面板被移除，相关功能整合进了 Sidebar。
这看起来只是一个 UI 调整，但实际上它改变了 DSH Web 端的工作流形态：
- 以前查看文件、预览产出，可能需要跳出聊天界面，或者在一个有限的 Detail 面板里操作。
- 现在你可以一边聊天，一边在右侧 Sidebar 里打开多个文件、对比内容、分栏查看，而且支持全屏，阅读长文件不再局促。
Sidebar 的加入，让 DSH Web 更像一个"Agent 工作台"，而不只是一个聊天窗口。 虽然官方标注为"实验性"，但方向已经很明确了。
三、体验优化：细节之处见真章
输入框与统计面板
- Web 输入框的菜单层级、提示文字和间距得到改善，操作更顺手。
- 会话统计改为两个可展开的摘要 ：
- 第一个摘要：轮次与速度
- 第二个摘要：精确 Token 用量与缓存命中
以前这些数据可能混在一起，现在分开呈现，想看速度就看速度，想算成本就算成本，信息组织更清晰。
中文斜杠命令说明
内置斜杠命令的说明支持中文 ，并且随界面语言即时更新。切换语言时，已打开的菜单和查询内容会保留，不会因为切语言而丢失当前操作。
子代理运行时升级
可选子代理插件的内置运行时升级至：
- Codex 0.153.4
- Claude Code 2.1.263
显式模型配置保持不变；如果未配置模型，Codex 会使用上游默认值。这意味着子代理的能力和兼容性都随上游同步更新，用户不需要手动折腾。
四、问题修复：那些让人头疼的小毛病
这次修复的问题，很多都是日常使用中高频遇到的痛点：
发送按钮与 Enter 行为不一致
以前在会话运行中，点发送按钮和按 Enter 可能表现不一样。现在两者均遵循"繁忙时的发送行为"设置 ，并且会明确提示是排队 还是插话发送。
模型自行恢复用户已暂停的目标
这是一个权限边界问题 。用户手动暂停目标后，模型不应该自行恢复。现在修复为：暂停后须由用户恢复，尚未激活的目标也会显示恢复入口。
聊天中本地图片路径无法显示
修复了本地图片路径无法显示的问题，现在支持模型回复引用的 POSIX 绝对路径图片 ，包括工作区外的截图。加载失败时，会显示替代文字或原路径，而不是一片空白。
空消息与空白队列编辑
现在会拒绝不含正文或附件的空消息 ，以及空白队列编辑，同时保留仅发送图片或文件的能力。这避免了误触发空请求。
项目根目录查找错误
修复了查找项目根目录遇到权限或 I/O 错误时，误用上级项目指令的问题。相关错误现在会直接报告，而不是静默降级。
折叠思考摘要的 Markdown 标记
修复了折叠的思考摘要直接显示 Markdown 加粗标记的问题，展开内容保持完整格式。
macOS/Linux 的 fs-ext 编译问题
修复了 macOS 和 Linux 上依赖 fs-ext 需要本地编译的问题，安装体验更顺畅。
五、⚠️ 破坏性变更：会话格式 V3 与插件 API 调整
以下变更主要面向开发者和插件作者，升级前需要仔细评估。
会话格式升级至 V3
- 恢复受支持的历史会话时，会生成新版日志并保留原文件。
- 系统提示词纳入消息历史。
- 旧 PTC 事件与 code 预设引用自动迁移。
- 自定义日志读取器需适配新格式。
- 升级后的会话不支持降级读取。
这意味着，如果你有自定义的日志解析工具，必须适配 V3 格式。同时，升级后的会话无法再被旧版本读取，降级需谨慎。
插件 Agent API 调整
- 移除
ctx.agent，调用方需显式传递 Agent。 - 修正可继续对话的子代理归属，避免它们被当作根会话参与定时调度。
插件作者需要更新调用方式。
Inbox API 调整
- Inbox 改为类型接口，不再导出可构造的运行时类。
- 插件通过
agent.inbox读写待处理消息。 hasPending与claim不再属于公共接口。
同样需要插件作者适配。
六、写在最后
v0.1.5-alpha.1 是一个底层能力大幅推进的版本。
动态修改系统提示词且不破坏 KV Cache ，解决的是 Agent 长期运行中"策略调整"的刚需；右侧 Sidebar 则让 Web 端的工作流形态向前迈了一大步。再加上会话格式 V3、插件 API 的持续收口，DSH 正在从"能用"快速走向"好用"和"可扩展"。
当然，288 个 commit 的积累 也提醒我们：这个项目还在高速奔跑。Alpha 版本意味着接口可能继续变，破坏性变更可能还会来。但正是这种不掩饰、不拖延的迭代方式，让 DSH 的每一个版本都值得认真对待。
如果你已经在使用 DSH，升级前请务必关注会话格式 V3 的不可降级特性，并备份重要会话。如果你是插件作者，请尽快适配新的 Agent API 和 Inbox API。
升级命令 ：npm i -g @deepseek-ai/dsh@next
GitHub 仓库 ：github.com/deepseek-ai/deepseek-harness
特别提醒：会话格式 V3 升级后不支持降级读取，请提前备份。