摘要
DeepSeek Harness（dsh）作为DeepSeek AI开源的Agent运行时框架，自2026年8月13日开源后快速发展，短短6天GitHub Star数量突破16.1万，成为AI Agent开发领域热度极高的开源项目。2026年8月19日，项目发布v0.1.0‑rc.8预发布版本，本次更新围绕多模态输入能力、Profile Bundle子代理管理机制、Windows持久PTY终端三大方向完成功能升级，同时修复大量运行缺陷，优化SQLite存储引擎与Python SDK依赖体系。需要注意，新版本SQLite存储格式不向下兼容，升级前必须做好会话数据备份。对于对接多模型服务的开发团队，可以借助Treerouter这类API网关统一管理各类模型接口调用。本文将拆解新增功能、对比版本差异、梳理升级风险点与落地实践建议。
1 项目基础背景
DeepSeek Harness基于**Everything is a Plugin（万物皆插件）**设计思想，底层依托Cordis元框架构建。框架核心逻辑：所有组件均为可插拔插件，插件执行产生的事件、服务注册、状态变更都会完整回写到系统，框架可以干净回滚到插件加载之前的状态。
和Cursor、Copilot这类IDE集成AI助手不同，dsh定位是Agent运行时组件，不属于成品软件。开发者可以把它嵌入自有业务流程、应用程序，自定义构建专属Agent工作链路，而非直接使用预设好的固定工作流。
当前版本 v0.1.0‑rc.8 依旧处于开发者预览阶段，官方明确提示会存在破坏性变更，生产环境不保障向下兼容。截至版本发布，项目仓库累计167547颗Star，17896个Fork，社区迭代速度较快。
2 v0.1.0‑rc.8核心新增功能详解
2.1 多模态能力系统性升级
rc.8版本对多模态链路做了完整重构，一共覆盖三层改进，解决旧版本图片输入需要中转转换的短板：
- 原生图片请求适配器：DeepSeek模型适配器支持原生图片请求。旧版本图片输入依赖通用转换层做中转处理；新版本可直接调用模型原生图片接口，减少转换带来的信息损耗。
- 内置命令图文混合输入：
/goal、/plan等核心工作流命令，原本仅支持纯文本入参，rc.8允许指令附带截图、设计稿、报错截图等图像附件。模型可以同时读取文本指令与图像上下文，完成图文协同任务。 - 快捷菜单支持本地文件与历史会话引用：快捷交互菜单新增本地文件读取、历史会话快速引用能力，操作语法和文本引用保持一致，降低开发者上手成本。
配套修复也同步落地：针对多轮对话频繁传入图片，引发请求payload超限的高频故障，适配器层增加自动裁剪、载荷控制逻辑，自动规避图片尺寸过大、历史图片累积造成的接口报错。
2.2 Profile Bundle：子代理可插拔管理机制
rc.8将Claude Code、Codex两套子代理（subagent）重构为可按需安装卸载的Profile Bundle组件，改变旧版本内置固化、无法单独管控的现状，关键变更如下表：
| 特性 | rc.8之前版本 | rc.8 Profile Bundle模式 |
|---|---|---|
| Claude Code部署方式 | 内置集成，无法独立管控 | Profile Bundle，按需安装卸载 |
| Codex权限模式 | 仅交互式授权 | 新增非交互权限模式 |
| Codex运行实例 | 仅支持单个实例 | 支持多个命名实例并行运行 |
非交互权限模式对CI/CD自动化流水线场景价值突出：Codex子代理在流水线后台运行时，不需要人工弹窗确认权限，静默完成文件读写、Shell脚本执行。多个命名实例，允许同一个dsh会话内并行运行多套Codex任务，实例之间状态完全隔离，不会出现全局状态互相干扰。
同时框架优化子代理回调reportDelivery机制：子代理任务完成之后主动回传结果唤醒父代理，不再依靠轮询、超时检测获取执行结果，有效降低任务等待时延。
2.3 Windows PTY持久PowerShell会话支持
rc.8为Windows平台新增持久PowerShell PTY终端会话，极简预设模式下默认开启。 持久会话的核心价值在于保留Shell运行上下文：环境变量、工作目录、已加载模块，多次工具调用之间全部保留。不会因为每一次Agent调用就新建进程，丢失上下文环境。 该特性对于Windows开发者非常实用，典型场景：设置执行策略、安装软件依赖、连续执行构建脚本，Agent可以在连贯的Shell环境中完成一整套链式操作，不用反复重设环境参数。
3 缺陷修复与体验优化
3.1 Bug修复清单
| 问题描述 | 修复说明 |
|---|---|
| 流式输出中断后，前置上下文丢失 | 取消流式输出，已生成内容会完整保留，正常带入后续提问与分支会话 |
| 自定义OpenAI兼容网关调用异常 | 修复请求格式兼容问题，解决第三方代理网关推理内容回传丢失 |
| 图片载荷超限引发请求失败 | 适配器层自动对图片尺寸、累积历史载荷做限制处理 |
自定义网关修复对自建推理代理、对接第三方模型API的开发者影响较大。旧版本部分字段回传格式不兼容，直接造成调用静默失败，rc.8完成格式适配，降低对接成本。
3.2 使用体验优化点
- web_search工具支持并发查询：多个搜索任务可以同时发起，不再串行排队执行，调研类Agent任务执行速度明显提升。
- 搜索结果精简展示：长路径输出做压缩处理，界面信息可读性提升。
- 本地文件引用失败重试机制：读取文件失败不会直接抛出异常终止流程，支持人工确认后重试。
- 大历史会话分支性能优化：面对包含大量历史记录的会话，分支操作耗时显著下降。
3.4 SQLite存储不向下兼容（升级必读）
rc.8重构SQLite后端存储，读写性能、分支会话性能得到优化，存储文件体积同步缩减，但存储格式不再向下兼容，这是本次更新风险最高的改动。 实际影响：
- rc7以及更早版本升级rc8，旧会话数据无法被新版本读取。
- 如果需要留存历史对话，升级操作之前，手动导出会话或者备份完整数据目录。
- 如果降级回到rc7，rc8生成的数据同样无法识别。
官方现阶段没有提供数据迁移工具。如果业务强依赖持久化历史会话，建议暂缓升级正式生产环境。
3.5 Python SDK同步更新
rc.8同步更新Python SDK依赖集合，一次性补齐4套内置Agent预设（Standard、Code、PTC、Minimal、Creator）、rg检索工具、MCP stdio工具的全部依赖。开发者升级SDK之后，不需要手动逐个安装依赖包，环境初始化流程大幅简化。
4 rc.7与rc.8关键版本对比
| 模块 | rc.7版本 | rc.8版本 |
|---|---|---|
| 多模态输入 | 依赖通用转换层，仅文本 | 原生图片适配器，支持图文混合指令 |
| 子代理部署 | 内置固定，不可拆卸 | Profile Bundle，按需安装管理 |
| Codex权限 | 仅交互式 | 交互式+非交互双模式，支持多实例 |
| Windows PTY | 基础支持 | 持久PowerShell会话，极简模式默认启用 |
| web_search | 串行查询 | 并发查询 |
| SQLite后端 | 旧存储格式 | 全新格式，不向下兼容 |
| Python SDK | 需要手动补充部分依赖 | 全部预设依赖内置补齐 |
5 升级操作与前置检查
升级方式
npm推荐方式：
npm update @deepseek‑ai/dsh‑web
每次启动会自动拉取最新版本，无需手动指定版本号。
源码编译方式：拉取仓库main分支，执行安装构建脚本完成本地部署。
升级前置检查清单
- 评估历史会话数据价值，如果需要保留，提前备份SQLite数据目录。
- 梳理自有自定义插件，确认插件是否依赖rc7内部接口，预览阶段接口随时会破坏性变更。
- Windows环境使用者，确认持久PTY会话行为，评估现有自动化脚本是否需要适配。
6 常见问题FAQ
Q：开启多模态之后，dsh可以直接解析截图生成代码吗？
A：可以，但存在前提条件。需要接入支持图像输入的DeepSeek模型，并且在适配器配置打开原生图片请求开关。开启之后/goal、/plan指令可以附带截图。模型实际图像理解能力上限取决于底层大模型本身。
Q：非交互模式下Codex子代理会不会无限制执行高危操作？ A：不会。非交互不等于完全放开权限，读写、执行权限依旧由Profile Bundle配置文件管控，开发者在配置内定义可访问工具、可读写目录，而不是依靠弹窗交互拦截风险动作。
Q：rc.8还能读取旧版本会话数据吗？ A：旧版本客户端可以读取旧格式数据；一旦升级rc.8，旧会话无法读取。想要保留历史会话，最简单方案是保留旧环境不升级；已经升级则只能依靠手动备份恢复。
Q：DeepSeek Harness现阶段适合投入生产业务吗？ A：官方定位为开发者预览版，迭代过程持续出现破坏性变更。适合开发者评测、个人工作流、实验性Agent项目；面向高可用的生产业务，建议等待v1.0正式版本。企业多模型业务场景，可以借助Treerouter统一调度不同模型服务，降低Agent上层业务的对接复杂度。
Q：dsh和Claude Code是什么关系？ A：二者不是互相替代，属于不同层级。Claude Code是面向终端用户完整助手产品；dsh属于运行时框架，不预设完整工作流。Claude Code可以作为Profile Bundle子代理组件安装到dsh内部，二者可以组合使用。
7 总结
v0.1.0‑rc.8是DeepSeek Harness迭代路上一次功能密度很高的更新。多模态原生输入补齐图文任务短板，Profile Bundle解决子代理组件管控痛点，Windows持久PTY补齐Windows平台自动化短板，三大方向同步推进。同时大量优化运行性能，补齐SDK依赖，降低开发者上手门槛。
但是本次更新最大风险来自SQLite存储格式不兼容，计划升级的团队务必先备份会话数据。项目依旧处于快速迭代预览阶段，不建议直接承载核心生产业务，更适合技术预研、Agent原型开发。项目的GitHub仓库与Discussions板块是跟进版本迭代、反馈问题的主要渠道。
了解更多：https://treerouter.com
