DeepSeek Harness 更新日志

会话后端被移除的第二天,会话 API 又被改写了——连续第三个版本在动会话这一层。

要点

• 父 Agent 与可持续子 Agent 现在通过 send_message 双向传递后续消息,取代原来单向的 report 工具。
• 自定义模型发现复用 Profile 请求头;模型目录支持搜索和筛选。
• Python SDK、Headless、ACP 与自定义 Profile 默认提供 web_fetch;Web PTC Mode 默认不再向模型提供通用 workflow 工具。
• 超长会话在流式回复、界面布局、导航预览三个场景的渲染开销都降低了。

alpha.2 之后一天,主要是长会话的打磨,外加一处升级前必须先处理的移除。

要点

• 长会话右侧导航可以预览并跳转到全部分页轮次,包括尚未载入的那些。
• 长会话渲染的内存开销降低,代码高亮也更跟得上。
• 会话运行中追加或排队发送的图片能正确回显、可靠投递;持续子代理的后续消息也支持图片了。
• 修复:read_image 能读取没有扩展名的图片附件;命令菜单打开时 Tab 可补全高亮的斜杠命令;后端卡顿不再被误判为断线。

alpha.1 三天后的跟进版，把上一版的一处移除撤了回来。

要点

• 插件列表现在按作用域分组——会话级与全局级分开，可切换 Agent Preset 查看组合，也能跨预设搜索。
• 界面会显示连接异常状态，自动重试并提供立即重连；会话标题区能看到活动中的定时计划。
• 每个回答末尾显示 token 用量和耗时，点开是完整统计；web_search 失败时会报出它实际打到的端点和错误明细。
• 修复：Node.js 24.0–24.11.1 上启动失败与 HMR 失效；用鼠标在 @ 菜单里下钻目录时面包屑丢失。

上线以来最大的一版，也是第一次从 rc 退回 alpha。界面改动之下，两个面向插件的接口挪了位置：旧的 ApiProxy 被删掉，会话视图被拆成了模块。

要点

• 插件在界面里多了两个落脚点：模型设置页的提供方登录配置，以及可以自行注册的第三方界面语言。
• 子代理拿到了真正的模型控制权——在你配置的授权范围内，Agent 可以自己挑提供方、模型和推理力度，启动方还能额外指定最大输出长度。Claude Code 和 Codex 子代理也支持配置模型。
• ACP 补齐了标准会话控制、模型设置、MCP、权限和取消能力，Python SDK runtime 新增 Windows x64 发行包。
• 公网 WebFetch 默认开启，内置 SSRF 防护、不再逐次审批；反过来，从网络访问 Web 界面时必须带上启动链接里的一次性 token。
• 会话整体变轻：启动和初始化的传输量下降，会话记录占的磁盘更小，图片发出即显示，每个已完成回答都能展开看精确 token 用量。

rc.1 之后五小时的安静补丁：上一版打开的图片链路，这一版把管道接好了。

要点

• DeepSeek 适配器改为优先走 Files API 上传图片，并复用已上传过的文件，不再重复发送字节。
• 图片在请求发出前，会按目标模型的要求自动缩放并转换成合适的格式。

一个小版本，装着一个大修复：补掉了一个沙箱逃逸，同时前几版铺的多模态地基终于等来了能看图的模型。版本线从 0.1.0 走到 0.1.1。

要点

• DeepSeek 适配器新增 DeepSeek-V4-Flash-Vision-Exp，一个实验性的多模态视觉理解模型。rc.8 让 harness 学会了搬运图片，这一版给了它能读图的东西。
• 安全：受限进程原本可以通过 /proc/<pid>/root 绕过 Bubblewrap 沙箱限制，本版已修。如果你靠沙箱来关住插件代码，那就该升到这一版——我们怎么看插件风险。
• 细节打磨：会话里的 Markdown 表格自适应、缓存命中率停在 99.x% 时的精度显示、子代理会话标题切换，以及 ask_user_question 回答支持多行与 Shift+Enter 换行。

多模态版本。发布六天后：图片成了一等输入，两个竞品编程 agent 成了可安装的组件。

要点

• DeepSeek 模型适配器可配置启用原生图片请求；/goal、/plan 接受图文混合输入；@ 菜单可以引用文件和整个会话。
• Claude Code 和 Codex 可按需装成子代理 Profile Bundle，带非交互权限模式，Codex 支持多个命名实例——这对竞争格局意味着什么。
• Windows PTY 终端支持持久 PowerShell 会话，极简预设里默认开启。
• 体验优化：长会话分叉更快、web_search 支持并发查询、依赖下载体积更小、dsh web 会自动打开浏览器。
• Python SDK 运行时覆盖全部四个内置 agent 预设，并带上了 rg/glob 搜索和 MCP stdio 工具所需的依赖。

发布第四天：第一个求稳的版本——插件 UI 接缝、子代理任务管理、外加一次预设改名。

要点

• 插件可以在 harness UI 里注册自己的设置卡片。
• Codex 和 Claude Code 的子代理任务接入 Job Panel 统一管理。
• MCP 和 ACP 支持持久化图片附件，PTC Mode 可以转发嵌套图片。
• 英文内置预设 Code mode 更名为 PTC mode；DeepSeek 模型新增 low 推理强度选项（默认仍是 high）。
• 修复：极简预设下持久 Bash 的卡顿、长历史分页的栈溢出、max-token 截断后会话无法继续、Safari 输入框光标错位；并升级 node-pty 1.2 beta 改善终端兼容性。

DeepSeek Harness 以 MIT 协议开发者预览版的形式公开，头两天就拿了约 95,000 个 GitHub star；到我们上次刷新数据集时，仓库已到 207,390。它的卖点是把一个想法贯彻到底：模型、工具、技能、会话、沙箱、文件系统、循环和 UI 全都是 Cordis 运行时上的插件，通过 cordis.yml 加载配置组合起来。

要点

• 一条命令即可启动——npx @deepseek-ai/dsh web——在 127.0.0.1:3080 上提供本地 Web UI。
• 四个内置预设：Standard、Code（rc.7 起改叫 PTC）、跑基准用的 Minimal、自己攒预设用的 Creator。
• README 用大写字母警告：破坏兼容性的变更即将到来——rc.8 随后兑现了这句警告。

常见问题

DeepSeek Harness 目前最新版本是什么？

v0.1.2-alpha.4，发布于 2026-09-01。它是 v0.1 开发者预览阶段的预发布版本——目前还没有稳定分支，这条线上候选版本和 alpha 交替出现。比本页最后审阅日期更新的版本，请以官方 GitHub releases 页为准。

PTC mode 是什么？

就是原来叫 Code mode 的内置预设，rc.7 改了英文名。在这个模式里，模型通过生成并运行代码来调度任务，而不是逐个调用工具。预设没变，只是换了名字——老文章里说的 Code mode 指的就是 PTC mode。

DeepSeek Harness 稳定到能上生产了吗？

不行，它自己也没这么说。它是开发者预览版，README 用大写警告会有破坏兼容性的变更，而且第一周就发了两个候选版本、换了一次不兼容的存储格式。拿它做实验、在它上面开发都行——只是别放到升级一崩就赔钱的地方。

怎么更新 dsh？我的会话数据能保住吗？

用 npx 跑的话每次启动都会拉最新构建；源码方式就 pull 后重新构建。要注意的是会话：rc.8 对 SQLite 存储格式做了不兼容变更，官方说明也没写迁移方案，所以请默认本地会话数据过不了这次升级。

更新会弄坏已装的插件吗？

有可能。加载器格式和插件 API 都还在成形，这个候选版本上能加载的插件到下一个可能就失败了。依赖某个插件之前，先看它的仓库最近什么时候推送过——在维护的插件会跟着上游变，弃更的会悄悄加载不了。我们目录里每个插件页都标着这个新鲜度。