DeepSeek Harness 又更新了多模态正式上线一篇文章讲清新特性、用法与二次创作距离 8 月 13 日开发者预览版开源公测不到 10 天DeepSeek Harness 已经连续发了三个版本v0.1.0-rc.7、v0.1.0-rc.8 和 v0.1.1-rc.1。多模态能力正式补齐Claude Code 和 Codex 变成了可插拔的子代理插件。这篇把更新内容、最佳用法和二次创作路径一次讲清。一、先搞明白DeepSeek Harness 到底是什么Harness 直译是马具在 Agent 工程语境里它指的是包裹在模型外面的那一整圈运行时工具怎么注册调度、上下文怎么组装裁剪、会话怎么持久化、代码在哪个沙箱里跑、失败了怎么恢复。DeepSeek 官方给了一个很干脆的公式Model Harness Agent模型负责推理和生成Harness 负责模型之外的一切工程能力。它的核心设计理念是“Everything is a Plugin”一切皆插件底层由 Cordis 插件框架驱动 。换句话说它不是一个聊天机器人也不是又一个 AI 编程助手而是一套Agent 工作底座 / 统一调度层上层负责拆任务、编排工作流底层按需把不同的 Coding Agent、模型和工具拉进来干活。这个项目 8 月 13 日以 MIT 协议开源后势头极猛GitHub 仓库公开不到 2 小时 star 破万12 小时突破 5 万一周内超过 15 万 star被称为Agent 领域的 Linux 时刻。二、最近到底更新了什么2.1 时间线一周三版版本日期主题v0.1.0-rc.78 月 17 日Claude Code / Codex 子代理任务接入 Job Panel多模态底层铺垫MCP/ACP 图片附件持久化v0.1.0-rc.88 月 20 日多模态正式补齐14 项更新v0.1.1-rc.18 月 21 日新增视觉模型选项DeepSeek-V4-Flash-Vision-Exp体验与安全修复2.2 rc.8 的 14 项更新重点看这五块① 多模态从纯文本到能看图DeepSeek 模型适配器可通过配置启用原生图片请求具备视觉能力的模型可以直接接收图片/goal、/plan等核心命令支持图文混合输入输入框菜单新增文件和历史会话引用——一次提问可以同时挂上截图、本地文件和过往对话MCP/ACP 支持持久化图片附件附件不再随单次调用结束而消失PTC Mode 可转发嵌套图片修复了单张图片过大、多轮对话历史图片累积载荷过高导致请求失败的问题。一个有意思的细节如果模型本身不支持图像输入Harness 会自动退化到工具层视觉——先 OCR 识别文字再统计颜色比例、扫描像素行、读取图片元信息把图片拆成结构化信息交给纯文本模型推理。② 子代理体系Claude Code 和 Codex 变成按需插件这是 rc.8 最具战略意义的变化。Claude Code 和 Codex 不再与主体捆绑分发而是变成可按需安装的 Profile Bundle作为子代理被 Harness 调用。其中 Codex 新增非交互权限模式可以在无人值守的流程里运行多命名实例同一任务中可配置多个不同配置的 Codex 子代理并存。加上 rc.7 已把两者的任务接入 Job Panel任务面板统一管理DeepSeek Harness 正在成为一个Agent 的统一调度层。③ 工具调用与效率web_search支持并发查询子代理的reportDelivery机制会及时反馈结果并主动唤醒父任务父任务不再盲等。④ Windows 终端体验PTY 终端支持持久化 PowerShell 会话并在极简Minimal模式预设中默认开启避免频繁重建终端环境。⑤ 性能与存储SQLite 后端读写与分叉fork性能提升存储体积降低注意数据结构不兼容旧版Python SDK 依赖覆盖 4 个内置 Agent 预设包含 rg/glob 搜索和 MCP stdio 工具所需依赖。2.3 v0.1.1-rc.1视觉模型落地 安全修复新增功能DeepSeek 适配器新增多模态视觉理解模型选项DeepSeek-V4-Flash-Vision-Exp——前一天社区还在猜测是不是在剧透 V4 视觉版第二天官方就实锤了问题修复修复输入框引用前编辑文本的潜在布局问题修复 Bubblewrap 沙箱内受限进程可经/proc/pid/root绕过限制的安全问题重要建议尽快升级 体验优化会话中 Markdown 表格自适应、缓存命中率 99.x% 时的精度显示、子代理会话标题切换ask_user_question支持多行输入和ShiftEnter换行 。三、怎么用最好从安装到进阶3.1 安装三条路径前置条件Node.js ≥ 22建议 LTS 版本以及一个 DeepSeek API Keyplatform.deepseek.com 申请。# 方式一npx 一键尝鲜推荐首次体验npx-ydeepseek-ai/dsh web# 方式二全局安装日常长期使用npminstall-gdeepseek-ai/dsh dsh web# 方式三源码运行打算二次开发gitclone https://github.com/deepseek-ai/deepseek-harness.gitcddeepseek-harnesspnpminstallpnpmrun buildpnpmdsh web启动后浏览器自动打开http://127.0.0.1:3080。3.2 多模态的正确打开方式这是本次更新最容易踩坑的地方。Harness 多模态了不等于你当前用的模型多模态了默认的 DeepSeek-V4-Pro 是纯文本模型适配器标记为[text]直接发图会报错这是有意设计——工具结果要进入持久会话历史路由不支持图片会破坏续聊和分叉想体验原生看图在模型适配器中切换到DeepSeek-V4-Flash-Vision-Exp或其他支持视觉的模型并开启原生图片请求配置实用技巧/goal目标模式适合描述最终要什么的开放式任务/plan计划模式适合先让它拆解方案再执行两者现在都可以直接贴截图、拖图片文件。3.3 用好子代理编排通过 Profile Bundle 安装 Claude Code / Codex 后可以让 Harness 主 Agent 拆任务把编码子任务派发给它们结果通过reportDelivery自动回传无人值守场景CI、定时任务记得给 Codex 开非交互权限模式在 Job Panel 里统一监控所有子代理任务的执行过程。3.4 插件生态安装插件一条命令dsh plugin--profilewebaddgithub:owner/repo#main⚠️ 踩坑提示启动 Web UI 时建议加--patch参数否则部分插件和技能不生效npx deepseek-ai/dsh web --patch。社区已有桌面端封装、Web UI 增强、侧边栏工作台、TUI 终端界面等热门插件按界面 → 效率 → 能力 → 成本的顺序按需装配即可。3.5 脚本化Python SDK不想依赖 Web 界面的话官方提供 Python SDK可以用代码驱动和编排 Agent适合脚本自动化或集成进现有工作流。文档见下方资源汇总。 小提示DeepSeek API 已采用峰谷定价长时任务可以放在空闲时段跑省钱。四、二次创作三条由浅到深的路径DeepSeek Harness 是 MIT 协议开源一切皆插件的架构天生就是为二次创作设计的。按投入程度从低到高推荐三条路径4.1 路径一写 Skill / 配置 Profile零代码低代码最轻量的二创方式是沉淀自己的工作流 Skill——把怎么做某件事的 SOP比如 PPT 制作、论文翻译、代码评审写成 Markdown 技能文件喂给它让它按你的规范执行。社区已有 PPT-Master 这类 Skill 可直接参考。进阶一点可以定制自己的Profile Bundle把模型选择、权限模式、子代理组合打包成预设一键切换不同工作场景如写作档和编程档。4.2 路径二开发插件核心玩法Cordis 插件框架意味着界面、工具、渠道、存储全都可以拆下来换掉开发自己的工具插件内部 API 封装、私有数据源接入做 MCP 工具扩展接入团队已有的 MCP 服务新版已支持图片附件持久化多模态工具链更好做了发布时给仓库加上dsh-plugintopic方便被社区发现 [1]已有插件作者分享了把 GitHub 地址直接丢给 DSH 让它自己装的体验生态门槛很低。4.3 路径三源码级二开深度玩家仓库 MIT 协议、源码全量开放官方提供了 development guide、架构文档和专门给 AI 协作者看的 AGENTS.md [1]底层设计论文A Programming Paradigm for Spatiotemporal Composability值得读理解 Cordis 的时空可组合性设计后再动手注意当前仍是开发者预览版官方明确声明会有破坏性改动比如 rc.8 的 SQLite 数据结构就不兼容旧版二开要做好跟进上游变更的准备 。五、冷静提醒这是开发者预览版版本号还在 rc 阶段尝鲜可以上生产要谨慎升级前注意 rc.8 的存储结构变更旧会话数据可能不兼容v0.1.1-rc.1 修了一个沙箱逃逸安全问题正在用沙箱跑不可信任务的用户建议立即升级“DeepSeek Harness” 已注册商标二创发布时注意遵守官方品牌使用指南。资源汇总资源链接GitHub 仓库https://github.com/deepseek-ai/deepseek-harnessrc.8 更新日志https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.0-rc.8rc.1 更新日志https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.1-rc.1快速上手文档https://deepseek-harness.github.io/deepseek-harness/guide/quickstartPython SDK 文档https://deepseek-harness.github.io/deepseek-harness/guide/python-sdk DeepSeek Harness 又更新了：多模态正式上线，一篇文章讲清新特性、用法与二次创作
DeepSeek Harness 又更新了多模态正式上线一篇文章讲清新特性、用法与二次创作距离 8 月 13 日开发者预览版开源公测不到 10 天DeepSeek Harness 已经连续发了三个版本v0.1.0-rc.7、v0.1.0-rc.8 和 v0.1.1-rc.1。多模态能力正式补齐Claude Code 和 Codex 变成了可插拔的子代理插件。这篇把更新内容、最佳用法和二次创作路径一次讲清。一、先搞明白DeepSeek Harness 到底是什么Harness 直译是马具在 Agent 工程语境里它指的是包裹在模型外面的那一整圈运行时工具怎么注册调度、上下文怎么组装裁剪、会话怎么持久化、代码在哪个沙箱里跑、失败了怎么恢复。DeepSeek 官方给了一个很干脆的公式Model Harness Agent模型负责推理和生成Harness 负责模型之外的一切工程能力。它的核心设计理念是“Everything is a Plugin”一切皆插件底层由 Cordis 插件框架驱动 。换句话说它不是一个聊天机器人也不是又一个 AI 编程助手而是一套Agent 工作底座 / 统一调度层上层负责拆任务、编排工作流底层按需把不同的 Coding Agent、模型和工具拉进来干活。这个项目 8 月 13 日以 MIT 协议开源后势头极猛GitHub 仓库公开不到 2 小时 star 破万12 小时突破 5 万一周内超过 15 万 star被称为Agent 领域的 Linux 时刻。二、最近到底更新了什么2.1 时间线一周三版版本日期主题v0.1.0-rc.78 月 17 日Claude Code / Codex 子代理任务接入 Job Panel多模态底层铺垫MCP/ACP 图片附件持久化v0.1.0-rc.88 月 20 日多模态正式补齐14 项更新v0.1.1-rc.18 月 21 日新增视觉模型选项DeepSeek-V4-Flash-Vision-Exp体验与安全修复2.2 rc.8 的 14 项更新重点看这五块① 多模态从纯文本到能看图DeepSeek 模型适配器可通过配置启用原生图片请求具备视觉能力的模型可以直接接收图片/goal、/plan等核心命令支持图文混合输入输入框菜单新增文件和历史会话引用——一次提问可以同时挂上截图、本地文件和过往对话MCP/ACP 支持持久化图片附件附件不再随单次调用结束而消失PTC Mode 可转发嵌套图片修复了单张图片过大、多轮对话历史图片累积载荷过高导致请求失败的问题。一个有意思的细节如果模型本身不支持图像输入Harness 会自动退化到工具层视觉——先 OCR 识别文字再统计颜色比例、扫描像素行、读取图片元信息把图片拆成结构化信息交给纯文本模型推理。② 子代理体系Claude Code 和 Codex 变成按需插件这是 rc.8 最具战略意义的变化。Claude Code 和 Codex 不再与主体捆绑分发而是变成可按需安装的 Profile Bundle作为子代理被 Harness 调用。其中 Codex 新增非交互权限模式可以在无人值守的流程里运行多命名实例同一任务中可配置多个不同配置的 Codex 子代理并存。加上 rc.7 已把两者的任务接入 Job Panel任务面板统一管理DeepSeek Harness 正在成为一个Agent 的统一调度层。③ 工具调用与效率web_search支持并发查询子代理的reportDelivery机制会及时反馈结果并主动唤醒父任务父任务不再盲等。④ Windows 终端体验PTY 终端支持持久化 PowerShell 会话并在极简Minimal模式预设中默认开启避免频繁重建终端环境。⑤ 性能与存储SQLite 后端读写与分叉fork性能提升存储体积降低注意数据结构不兼容旧版Python SDK 依赖覆盖 4 个内置 Agent 预设包含 rg/glob 搜索和 MCP stdio 工具所需依赖。2.3 v0.1.1-rc.1视觉模型落地 安全修复新增功能DeepSeek 适配器新增多模态视觉理解模型选项DeepSeek-V4-Flash-Vision-Exp——前一天社区还在猜测是不是在剧透 V4 视觉版第二天官方就实锤了问题修复修复输入框引用前编辑文本的潜在布局问题修复 Bubblewrap 沙箱内受限进程可经/proc/pid/root绕过限制的安全问题重要建议尽快升级 体验优化会话中 Markdown 表格自适应、缓存命中率 99.x% 时的精度显示、子代理会话标题切换ask_user_question支持多行输入和ShiftEnter换行 。三、怎么用最好从安装到进阶3.1 安装三条路径前置条件Node.js ≥ 22建议 LTS 版本以及一个 DeepSeek API Keyplatform.deepseek.com 申请。# 方式一npx 一键尝鲜推荐首次体验npx-ydeepseek-ai/dsh web# 方式二全局安装日常长期使用npminstall-gdeepseek-ai/dsh dsh web# 方式三源码运行打算二次开发gitclone https://github.com/deepseek-ai/deepseek-harness.gitcddeepseek-harnesspnpminstallpnpmrun buildpnpmdsh web启动后浏览器自动打开http://127.0.0.1:3080。3.2 多模态的正确打开方式这是本次更新最容易踩坑的地方。Harness 多模态了不等于你当前用的模型多模态了默认的 DeepSeek-V4-Pro 是纯文本模型适配器标记为[text]直接发图会报错这是有意设计——工具结果要进入持久会话历史路由不支持图片会破坏续聊和分叉想体验原生看图在模型适配器中切换到DeepSeek-V4-Flash-Vision-Exp或其他支持视觉的模型并开启原生图片请求配置实用技巧/goal目标模式适合描述最终要什么的开放式任务/plan计划模式适合先让它拆解方案再执行两者现在都可以直接贴截图、拖图片文件。3.3 用好子代理编排通过 Profile Bundle 安装 Claude Code / Codex 后可以让 Harness 主 Agent 拆任务把编码子任务派发给它们结果通过reportDelivery自动回传无人值守场景CI、定时任务记得给 Codex 开非交互权限模式在 Job Panel 里统一监控所有子代理任务的执行过程。3.4 插件生态安装插件一条命令dsh plugin--profilewebaddgithub:owner/repo#main⚠️ 踩坑提示启动 Web UI 时建议加--patch参数否则部分插件和技能不生效npx deepseek-ai/dsh web --patch。社区已有桌面端封装、Web UI 增强、侧边栏工作台、TUI 终端界面等热门插件按界面 → 效率 → 能力 → 成本的顺序按需装配即可。3.5 脚本化Python SDK不想依赖 Web 界面的话官方提供 Python SDK可以用代码驱动和编排 Agent适合脚本自动化或集成进现有工作流。文档见下方资源汇总。 小提示DeepSeek API 已采用峰谷定价长时任务可以放在空闲时段跑省钱。四、二次创作三条由浅到深的路径DeepSeek Harness 是 MIT 协议开源一切皆插件的架构天生就是为二次创作设计的。按投入程度从低到高推荐三条路径4.1 路径一写 Skill / 配置 Profile零代码低代码最轻量的二创方式是沉淀自己的工作流 Skill——把怎么做某件事的 SOP比如 PPT 制作、论文翻译、代码评审写成 Markdown 技能文件喂给它让它按你的规范执行。社区已有 PPT-Master 这类 Skill 可直接参考。进阶一点可以定制自己的Profile Bundle把模型选择、权限模式、子代理组合打包成预设一键切换不同工作场景如写作档和编程档。4.2 路径二开发插件核心玩法Cordis 插件框架意味着界面、工具、渠道、存储全都可以拆下来换掉开发自己的工具插件内部 API 封装、私有数据源接入做 MCP 工具扩展接入团队已有的 MCP 服务新版已支持图片附件持久化多模态工具链更好做了发布时给仓库加上dsh-plugintopic方便被社区发现 [1]已有插件作者分享了把 GitHub 地址直接丢给 DSH 让它自己装的体验生态门槛很低。4.3 路径三源码级二开深度玩家仓库 MIT 协议、源码全量开放官方提供了 development guide、架构文档和专门给 AI 协作者看的 AGENTS.md [1]底层设计论文A Programming Paradigm for Spatiotemporal Composability值得读理解 Cordis 的时空可组合性设计后再动手注意当前仍是开发者预览版官方明确声明会有破坏性改动比如 rc.8 的 SQLite 数据结构就不兼容旧版二开要做好跟进上游变更的准备 。五、冷静提醒这是开发者预览版版本号还在 rc 阶段尝鲜可以上生产要谨慎升级前注意 rc.8 的存储结构变更旧会话数据可能不兼容v0.1.1-rc.1 修了一个沙箱逃逸安全问题正在用沙箱跑不可信任务的用户建议立即升级“DeepSeek Harness” 已注册商标二创发布时注意遵守官方品牌使用指南。资源汇总资源链接GitHub 仓库https://github.com/deepseek-ai/deepseek-harnessrc.8 更新日志https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.0-rc.8rc.1 更新日志https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v0.1.1-rc.1快速上手文档https://deepseek-harness.github.io/deepseek-harness/guide/quickstartPython SDK 文档https://deepseek-harness.github.io/deepseek-harness/guide/python-sdk