DeepSeek Harness v0.1.5-rc.1:V4.1 Flash 与 Session V3

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

DeepSeek 于 2026 年 9 月 10 日发布 dsh-v0.1.5-rc.1。这是 0.1.5 系列首个候选版本,汇总了 v0.1.2-rc.1 之后面向用户和开发者的主要变化。npm 当前已将它设为 latest,不固定版本号的 npx @deepseek-ai/dsh web 会安装这一版。

发布与 npm 状态

检查项2026-09-11 状态
GitHub Releasev0.1.5-rc.1,标记为 Pre-release
GitHub Tagdsh-v0.1.5-rc.1
npm latest0.1.5-rc.1
npm next0.1.5-rc.2
npm alpha0.1.5-alpha.2

安装 npm 默认版本:

npx @deepseek-ai/dsh web

需要固定环境时显式指定版本:

npx @deepseek-ai/[email protected] web

V4.1 Flash 成为新会话默认模型

DeepSeek 模型适配器新增 DeepSeek-V41-Flash,对应模型 ID 为 deepseek-flash,支持文本、图片及会话历史中的系统提示词更新。新建 Session 会默认选择它;配置文件已经显式指定模型时,仍以配置值为准。

已有自动化需要核对实际发送的模型 ID、Provider 选择,以及针对上一代 V4 Flash 条目的配置假设。更完整的迁移步骤见 V4.1 Flash Harness 配置指南

Web 把文件作为完整的输入与交付对象

Web 现在支持上传任意类型文件,后台上传会显示进度和取消入口,切换会话后也能继续看到状态。模型可以通过已保存路径,使用现有文件工具按需读取。

右侧 Sidebar 新增多标签、分栏、全屏,以及 Markdown、代码、HTML、PDF 和图片预览。Agent 也能明确标记交付文件,用户可以预览、调用默认应用打开,或在文件管理器中定位。原 Detail 面板已经移除,依赖旧位置的 Web 插件需要迁移。

子 Agent 更容易在执行中调整

可继续对话的子 Agent 支持消息排队、编辑、删除、单条或全部 Steer,以及停止操作。Agent Team 消息统一采用 steer 语义,并在跨 Agent 投递和冷恢复中保留发送者归属与顺序。

对于长任务,用户可以在不中断整个子 Agent Session 的情况下调整委派方向。

Session V3 是主要迁移边界

旧日志会在支持范围内迁移成新文件,原文件仍会保留;升级后的 Session 无法再由旧版本读取。持久化 API 改为由生命周期范围内的 SessionHandle 持有,agentLoop.create() 改为异步,新 Session 锁保证同一 Session 最多被一个进程持有。

自定义集成升级前应完成这些检查:

  1. 备份 Session 文件,并用副本测试迁移。
  2. 让自定义日志读取器适配 V3。
  3. 把持久化逻辑迁移到 SessionHandle 生命周期。
  4. agentLoop.create() 使用 await
  5. 按新的 Session 锁测试并发打开行为。

插件 API 与默认工具有变化

  • SDK、Headless 和 ACP 默认使用 readwriteedit 编辑文件。
  • Web minimal 与 Python sdk-minimal 默认只提供持久 Shell,str_replace_editor 需要显式启用。
  • Agent 插件不再提供 ctx.agent,调用方要显式传入 Agent。
  • Inbox 改为纯类型接口,待处理消息通过 agent.inbox 访问。
  • Web 插件通过 sidebar.panellistmain 注册全局面板,原 conversation Slot 迁移到 main 下。
  • 实验性 Agent Teams 包已经可以从 npm 安装,但仍需显式启用。

其他值得验证的变化

本版还加入了出站请求代理环境变量支持、更完整的模型发现、“在应用中打开”工作区入口、独立反馈提交、长会话性能优化、Windows 修复、MCP 分页死循环防护,以及工具返回图片的改进展示。

升级建议

使用者建议
DSH 新用户使用 npm latest,启动后核对模型与 Workspace
现有 0.1.2 用户先备份 Session,再检查 V3 与插件兼容变化
Web 插件作者迁移面板注册方式,并验证 Detail 移除后的界面
SDK 或 Headless 集成审核默认文件工具和异步 Session 创建逻辑
需要最新界面微调通过 npm next 单独测试 0.1.5-rc.2

相关阅读

常见问题

不固定版本号的命令会安装哪一版?

截至 2026 年 9 月 11 日,npm latest0.1.5-rc.1;npm next 指向 0.1.5-rc.2

本文是否包含 rc.2?

不包含。每个版本单独记录,rc.2 是后续的小型更新,重点是反馈提交和交付文件展示。