DeepSeek Harness（dsh）由 DeepSeek AI 于 2026 年 8 月 13 日开源，基于"Everything is a Plugin"架构，以 Cordis 元框架为底层，发布 6 天内突破 161,000 颗 GitHub Star，创下开发者工具类项目增速纪录之一。2026 年 8 月 19 日，项目发布 v0.1.0-rc.8，在多模态支持、子代理管理和 Windows 平台兼容性三个方向集中迭代：DeepSeek 模型适配器开放原生图片请求配置，/goal、/plan 等核心命令首次支持图文混合输入；Claude Code 与 Codex 子代理升级为可按需安装的 Profile Bundle；Windows PTY 终端引入持久 PowerShell 会话。与此同时，SQLite 后端完成读写性能和存储体积双重优化，但存储格式不向下兼容，升级前需注意数据迁移。截至本文发布，仓库已累计 167,547 颗 Star、17,896 个 Fork。

DeepSeek Harness 是什么？

DeepSeek Harness（命令行工具名 dsh）是 DeepSeek AI 开发的开源 Agent 运行时框架，核心设计理念是"Everything is a Plugin"（万物皆插件）。框架基于 Cordis 元框架构建，后者在学术论文 A Programming Paradigm for Spatiotemporal Composability 中形式化描述了其时空可组合性设计——每个插件卸载时，其产生的所有副作用（事件监听、服务注册、状态变更）会被完整回滚，系统可干净恢复到插件加载前的状态。

与 IDE 集成工具（Cursor、Copilot）不同，dsh 是运行时层而非产品层，开发者通过它将 Agent 能力嵌入自己的工程流程或应用，而非使用预设的固定工作流。

当前状态：v0.1.0-rc.8，开发者预览阶段，官方明确警告存在 breaking changes，不保证向下兼容。

v0.1.0-rc.8 新增功能详解

多模态支持全面提升

rc.8 最受关注的功能是多模态能力的系统性升级，分三层展开：

  1. DeepSeek 适配器支持配置启用原生图片请求：此前图片输入依赖通用转换层，rc.8 开放了 DeepSeek 模型适配器的原生图片请求配置项，可显著降低图片内容的处理延迟和截断率。

  2. /goal、/plan 等命令支持图文混合输入：这两个核心工作流命令原本只接受文本，rc.8 后可直接在命令中附带截图、设计稿、错误截图等图片内容，模型能够同步理解视觉上下文。

  3. @ 菜单支持引用文件和会话：@ 快捷菜单新增了对本地文件和历史会话的引用支持，操作路径与现有文本引用保持一致。

修复配套：同步修复了图片尺寸过大或历史图片累计载荷过高导致模型请求失败的问题——在多轮对话中频繁传递图片时，之前可能触发 payload 超限报错，rc.8 已在适配器层加入了自动裁剪和载荷控制逻辑。

子代理管理：Profile Bundle 机制

rc.8 将 Claude Code 和 Codex 两个子代理（subagent）升级为可按需安装的 Profile Bundle，带来以下变化：

特性

rc.8 之前

rc.8 之后

Claude Code 子代理安装方式

内置，无法独立控制

Profile Bundle，按需安装/卸载

Codex 子代理安装方式

同上

Profile Bundle，按需安装

Codex 权限模式

仅交互式

新增非交互（non-interactive）权限模式

Codex 实例数量

单一实例

支持多个命名实例（named instances）

非交互权限模式对 CI/CD 场景尤为关键：Codex 子代理在流水线中运行时，不需要人工确认操作权限，可以静默完成文件读写、Shell 执行等动作。多个命名实例则允许在同一个 dsh 会话中并行运行功能不同的 Codex 任务，避免全局状态冲突。

父任务唤醒机制：rc.8 还优化了子代理的 reportDelivery——子代理完成任务后会立即反馈并主动唤醒父任务，而非依赖轮询或超时检测，减少等待时间。

Windows PTY 终端：持久 PowerShell 会话

rc.8 为 Windows 平台的 PTY 终端引入了持久 PowerShell 会话，并在极简模式（Minimal preset）中默认启用。

持久会话的核心价值是：Shell 状态（环境变量、当前目录、已加载模块）在多次工具调用之间保持一致，不再因每次调用都启动新进程而导致上下文丢失。这对 Windows 开发者在 dsh 中运行跨步骤任务（如 Set-ExecutionPolicy → 安装依赖 → 执行构建脚本）具有实际意义。

问题修复与体验优化

Bug 修复清单

问题

修复说明

取消流式生成后回复前缀丢失

取消生成后已展示的内容前缀，现在会正确带入后续提问和分叉会话

自定义 OpenAI 兼容网关调用失败

修复因请求格式差异导致部分第三方网关无法调用，以及推理内容回传可能缺失的问题

图片载荷超限导致请求失败

适配器层自动控制图片尺寸和历史累计载荷

自定义网关修复对接入自建推理服务或国内可直接访问的第三方 API 网关的开发者影响最大——此前部分请求格式（如 reasoning_content 字段回传格式）不兼容会导致静默失败，rc.8 做了兼容性适配。

体验优化亮点

  • web_search 工具支持并发查询：多个搜索意图可同时发起，不再串行等待，Agent 在调研型任务中速度明显提升

  • HOME 目录以 ~ 缩写显示：改善路径信息的可读性，长路径不再占满输出区域

  • 本地文件打开失败支持重试：文件引用失败时不再直接报错退出，支持用户手动确认后重试

  • 大历史会话分叉性能提升：针对包含大量历史记录的会话，分叉操作的耗时显著降低

SQLite 后端不兼容变更：升级前必读

rc.8 对 SQLite 后端做了读写性能和分叉性能双重优化，同时降低了存储体积。代价是：存储格式不向下兼容（incompatible storage format）。

具体影响：

  • 从 rc.7 或更早版本升级到 rc.8 后，旧会话数据将无法被 rc.8 读取

  • 如需保留历史会话，请在升级前手动导出或备份数据目录

  • 降级回 rc.7 后，rc.8 写入的数据同样无法读取

官方暂未提供迁移工具，这是开发者预览阶段的已知取舍——生产环境依赖历史会话持久化的场景，建议等待正式版再迁移。

Python SDK 更新

rc.8 同步更新了 Python SDK 的依赖配置，现在覆盖以下内容：

  • 全部 4 个内置 Agent 预设（Standard / Code/PTC / Minimal / Creator）的依赖

  • rg（ripgrep）/ glob 搜索所需运行时依赖

  • MCP stdio 工具所需依赖

SDK 用户升级后无需手动补装上述依赖，环境初始化步骤更简洁。

rc.8 与 rc.7 核心变更对比

模块

rc.7

rc.8

多模态输入

通用转换层

原生图片请求（DeepSeek 适配器可配置）

/goal / /plan

仅文本

支持图文混合输入

子代理安装

内置固定

Profile Bundle，按需安装

Codex 权限模式

仅交互式

新增非交互模式

Codex 实例

单一

支持多命名实例

Windows PTY

基础支持

持久 PowerShell 会话，极简预设默认开启

web_search

串行查询

并发查询

SQLite 后端

旧格式

新格式（不向下兼容）

Python SDK

部分预设覆盖

全 4 个预设 + rg/MCP 依赖

如何升级到 rc.8？

npm 方式（推荐）：

npx @deepseek-ai/dsh web

每次运行 npx 时会自动拉取最新版本，无需手动指定版本号。

源码方式：

git pull origin main
pnpm install
pnpm run build
pnpm dsh web

升级前检查清单：

  1. 确认是否需要保留历史会话 → 如需保留，先手动备份数据目录

  2. 确认 SQLite 不兼容变更的影响范围

  3. 检查自定义插件是否依赖 rc.7 的内部 API（breaking changes 阶段不保证向下兼容）

FAQ

Q：rc.8 的多模态支持是否意味着 dsh 可以分析截图或设计稿来生成代码？

可以，但有前提：需要使用支持视觉输入的 DeepSeek 模型，并在适配器配置中启用原生图片请求。启用后，/goal 和 /plan 命令可接受图片附件，模型可以结合视觉内容理解任务意图。具体模型的视觉能力上限取决于 DeepSeek 官方部署的版本。

Q：非交互权限模式下，Codex 子代理会无限制执行任何操作吗？

不会。非交互模式取消的是"每步确认"弹窗，但操作权限边界仍由 Profile Bundle 的配置决定——哪些工具可用、哪些目录可写，都在 Bundle 配置中声明。如果需要限制 Codex 的操作范围，应在 Bundle 配置层面设置，而不是依赖交互式弹窗拦截。

Q：SQLite 不兼容变更之后，还能用旧版本读取旧数据吗？

可以。旧版本（rc.7 及之前）仍可正常读取旧格式数据。如果需要保留旧会话，保持旧版本不升级是最简单的策略；如果必须升级 rc.8，只能通过手动备份数据目录来保留旧数据（升级后 rc.8 无法解读旧格式）。

Q：DeepSeek Harness 目前是否适合生产使用？

官方明确说明当前处于开发者预览阶段（developer preview），且在可预见的迭代中仍会有 breaking changes。因此目前不建议作为核心生产系统的依赖。适合场景：开发者评测、个人工作流、实验性 Agent 工程项目。需要生产级稳定性的团队，建议等待正式版（v1.0）。

Q：dsh 和 Claude Code 的定位有什么区别？

Claude Code 是面向个人开发者的完整编程助手产品，开箱即用、工作流预设完整。dsh 是运行时框架层，不预置工作流，Claude Code 可以作为 Profile Bundle 安装到 dsh 中作为子代理使用——两者不是直接替代关系，而是可以组合使用的不同层次。

结语

v0.1.0-rc.8 是 DeepSeek Harness 在快速迭代周期中一次密度较高的版本：多模态、子代理管理、Windows 适配三条主线同步推进，SQLite 后端的不兼容升级换取了长期性能收益。对于已在使用 dsh 的开发者，图文混合输入和 web_search 并发查询是最值得立即体验的两项改进；计划升级的用户务必提前处理 SQLite 数据备份。项目目前仍处于开发者预览阶段（167,547 ⭐，2026-08-19），官方 Discord 和 GitHub Discussions 是追踪后续迭代的最快通道。

数据来源（均来自官方渠道，2026-08-19/20）：

  • Release Notes v0.1.0-rc.8：github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.0-rc.8

  • 仓库主页：github.com/deepseek-ai/deepseek-harness

  • README：github.com/deepseek-ai/deepseek-harness/blob/main/README.md

延伸阅读