DeepSeek Harness v0.1.5-rc.1：0.1.5 系列功能冻结，DeepSeek-V41-Flash 成默认模型

从 0.1.2-rc.1 到 0.1.5-rc.1，中间隔了无数个 alpha，现在终于迎来了首个候选版本

9 月 10 日，DeepSeek Harness 发布了 v0.1.5-rc.1。

这是 0.1.5 系列的首个候选版本（Release Candidate） 。按照语义化版本的规则，rc 意味着功能已经冻结，接下来只修 bug，准备正式发版。

Release Note 的第一句话写得很清楚：

作为 0.1.5 系列的首个候选版本，本版本汇总了自 v0.1.2-rc.1 以来的主要用户和开发者相关变更。

也就是说，这个版本不是突然冒出来的，而是把过去一段时间里 alpha.1、alpha.2 以及更早的改动全部收拢到一起，形成一个可发布的候选版本。从 0.1.2-rc.1 到 0.1.5-rc.1，版本号跳过了 0.1.3 和 0.1.4 的正式 rc，中间经历了多个 alpha 的快速迭代。

下面我们来看这个候选版本里，最值得关注的几个变化。

一、DeepSeek-V41-Flash：新会话的默认模型

本次 rc.1 最显眼的新功能，是 DeepSeek 模型适配器新增了 DeepSeek-V41-Flash（deepseek-flash）。

它支持：

文本
图片
会话历史中的系统提示词更新

并且，新会话默认使用该模型。如果你的配置文件里显式指定了模型，则以配置值为准。

这意味着，从 rc.1 开始，新用户开箱即用的模型就是 DeepSeek-V41-Flash。它同时具备文本和图片理解能力，还能配合"动态修改系统提示词"这一新特性，在会话历史中更新系统提示词。

对于之前一直在用旧默认模型的用户，升级后新建会话会感受到模型切换。如果需要保持原有模型，记得在配置中显式指定。

rc.1 汇总了自 0.1.2-rc.1 以来的主要功能，其中多项我们之前在 alpha 版本中已经见过，这里一并梳理：

通用文件上传

Web 支持上传任意类型的通用文件 。文件与图片可以在同一预览区混排 ；后台上传支持进度、取消与会话切换续显 ；模型可以通过已保存路径，使用现有文件工具按需读取。这让 Web 端从"只能传图"进化成了通用文件管理入口。

可继续对话的子代理

子代理支持消息排队、编辑、删除、单条或全部 Steer 与停止操作。排队消息发送期间显示"发送中"，并暂不可编辑、删除或 Steer。这让子代理从"派出去等结果"变成了可以中途管理的执行单元。

动态修改系统提示词

支持动态修改系统提示词且不破坏 KV Cache，但模型需显式声明支持。这是一项底层能力，让系统提示词从静态配置变成了可随时微调的控制面板。

Web 右侧 Sidebar 支持多标签、分栏、全屏 ，以及 Markdown、代码、HTML、PDF 和图片预览 ，包括子代理和未激活会话的文件 。模型可显式交付文件 ，并可在 Sidebar 中预览、用默认应用打开或在文件管理器中定位。原 Detail 面板已移除。

这意味着 Sidebar 正式成为 DSH Web 端的文档工作台。

模型探测与网络代理

模型探测新增对自定义模型提供商 models 对象 和 Anthropic 原生模型列表 的支持，并支持回填模型名称、上下文窗口及最大输出 token。所有出站网络请求都会遵循启动环境中的 HTTP_PROXY、HTTPS_PROXY、ALL_PROXY 与 NO_PROXY 配置。

Web 顶栏"在应用中打开"

Web 顶栏新增"在应用中打开"，可用已安装的编辑器、IDE、终端或文件管理器等打开 Workspace。

反馈机制

反馈可独立提交，无需继续对话 ；/feedback 命令支持提交明细反馈内容，提交时附带相关会话内容。

三、体验优化：长会话、链接、设置面板

rc.1 汇总的体验优化覆盖了多个日常使用场景：

Web 可直接显示 顶层及 PTC 嵌套 read_image 的图片结果，以及模型回复中引用的 POSIX 绝对路径本地图片，包括工作区外截图；加载失败时显示替代文字或原路径。
Skill 选择器支持模糊搜索；优化聊天气泡中的 Skill 和命令引用。
调整会话内可点击链接的颜色、hover/focus 样式和分类图标，优化 Markdown 链接、文件引用、网页来源、产物链接与 Workflow 成员链接的辨识度。
Windows 上的本地非终端子进程不再弹出控制台窗口。
Agent Team 的 send_message 统一采用 steer 语义，并在跨 Agent 和冷恢复投递中保留发送者归属与顺序。
改善长会话打开、恢复和持续对话时的卡顿，降低内存占用。
引用较长会话时，模型可按需读取预览中未展示的内容。
改善设置面板的标签、开关状态样式，改善浅色和深色主题下的显示效果，改善本地化与可访问性。
PTC 模式下支持展开查看命令及其输出。
改善 Web 输入框的菜单层级、提示文字和间距；会话统计改为两个可展开的摘要，分别查看轮次与速度、精确 Token 用量与缓存命中。
内置斜杠命令说明支持中文，并随界面语言即时更新；切换语言时保留已打开菜单和查询内容。

四、问题修复：一批高频痛点被解决

rc.1 汇总的修复项非常多，挑几个重点：

用户在 Web 中暂停目标会立即终止当前模型轮次，且模型不能自行恢复；恢复必须由用户触发，尚未激活的目标也显示恢复入口。
修复 DeepSeek 流式工具调用的续传分片用空值覆盖调用 ID 或名称的问题，避免工具以空名称失败并写入无法重新打开的会话记录。
修复 Python SDK 单文件 runtime 将 Bash 中以 node 开头的命令错误重写为 dsh runtime 的问题。
修复从会话搜索结果进入会话后仍停留在搜索界面的问题；目标会话会在所属 Workspace 中展开并滚动到可见位置。
修复 Windows 盘符根目录 Workspace 的路径分隔符、标题与绝对路径校验，确保盘符根目录可以正常使用。
修复 Web 断线后无法自动恢复的问题。
修复发送消息或调整窗口后，聊天不再自动滚动到底部的问题。
修复 Windows 上 Python SDK 运行时可能出现的启动崩溃。
修复会话运行中发送按钮与 Enter 的行为不一致：两者均遵循"繁忙时的发送行为"设置，并明确提示排队或插话发送。
拒绝不含正文或附件的空消息及空白队列编辑，保留仅发送图片或文件的能力。
修复查找项目根目录遇到权限或 I/O 错误时误用上级项目指令的问题，相关错误会直接报告。
修复折叠的思考摘要直接显示 Markdown 加粗标记的问题，展开内容保持完整。
修复模型目录变化后失效的 pi-ai 配置导致整个模型设置入口消失的问题；错误项保留诊断和修复入口。
在发现模型或创建自定义 provider 前校验并规范化 Base URL，并直接提示无效地址。
修复 Windows Web 界面的原生文件夹选择器可能在其他窗口后方打开的问题。
修复在 Composer 中输入空白字符后占位提示仍然显示的问题。
修复工具筛选后的子代理仍收到不可用文件和 Web 工具指导的问题。
拒绝 MCP 工具发现中的重复分页游标，避免启动或同步持续等待，并保留上一组可用工具。

五、⚠️ 其他变更：破坏性变更集中呈现

作为 rc 版本，rc.1 把之前 alpha 中引入的破坏性变更正式汇总，开发者需要认真对待。

会话数据格式升级至 V3

受支持的旧日志通过版本迁移生成新版日志并保留原文件，升级后的会话不支持降级读取 。自定义日志读取器需适配 V3。跨版本迁移细节见 session-format-v2-to-v3/README.md。

Session 生命周期变更

Session persistence API 改为由生命周期持有的 SessionHandle ；agentLoop.create() 改为异步，新增 session 锁 ，同一 session 至多被一个进程持有。

默认工具调整

SDK、Headless 和 ACP 默认使用 read、write、edit 编辑文件；Web minimal 与 Python sdk-minimal 默认仅提供持久 shell ，str_replace_editor 需显式启用，持久 Bash 输出统一报告退出或超时状态。

子进程清理与 pid 移除

改善 Windows 和部分 Linux 环境下普通子进程的清理，减少任务停止后的后台进程残留；普通 subprocess handle 不再暴露 pid，终端 handle 不受影响。

FS_NOT_OBSERVED 诊断统一

统一未观察文件写入与编辑失败的 FS_NOT_OBSERVED 诊断，保留文件路径、结构化错误码和原始原因。

Python SDK 新增 macOS x64 wheel

可在 Intel 架构的 Mac 上安装并运行随包 runtime。

pi-ai 升级至 0.85.1

底层模型接口升级。

子代理运行时升级

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

自定义 persona 配置拆分

拆分为前缀和后缀，旧配置及相关常量需要适配。

插件 API 调整

插件 Agent API ：移除 ctx.agent，调用方需显式传递 Agent；同时修正可继续对话的子代理归属，避免它们被当作根会话参与定时调度。
Inbox API ：Inbox 改为类型接口，不再导出可构造的运行时类；插件通过 agent.inbox 读写待处理消息，hasPending 与 claim 不再属于公共接口。
Web 插件面板 API ：插件可通过 sidebar.panellist 与 main 注册全局面板；原 conversation Slot 迁移为 main 的 conversation key。

实验性 Agent Teams 包

现可从 npm 安装；用户需显式添加 profile，不默认启用。

六、写在最后

v0.1.5-rc.1 是一个承前启后的候选版本。

它把自 v0.1.2-rc.1 以来散落在多个 alpha 中的功能、修复和破坏性变更全部收拢，形成一个功能冻结的发布候选。DeepSeek-V41-Flash 成为新会话默认模型，右侧 Sidebar 正式成为文档工作台，动态系统提示词、通用文件上传、子代理排队与 Steer 等能力全部就位。

当然，rc 不等于正式版 。按照 DSH 的迭代习惯，rc.1 之后可能还会有 rc.2、rc.3，直到功能稳定、bug 清完，才会发布正式版。但方向已经明确：0.1.5 系列离正式发布不远了。

如果你一直在等一个相对稳定的版本，rc.1 值得开始认真评估。但升级前请务必注意：

会话格式 V3 不支持降级读取，请提前备份。
Session API 和多个插件 API 有破坏性变更，自定义脚本和插件需要适配。
新会话默认使用 DeepSeek-V41-Flash，如需保持旧模型请显式配置。

升级命令 ：npm i -g @deepseek-ai/dsh@next

GitHub 仓库 ：github.com/deepseek-ai/deepseek-harness