进阶 📋 6 个步骤 第 310 / 470 篇

DeepSeek Harness 进阶:多模态图片、Claude Code/Codex 子代理与并发搜索编排

8-21 DeepSeek Harness 更新 RC.8:模型适配器支持原生图片请求,Claude Code/Codex 可按需安装作子代理,web_search 并发查询,Windows 持久 PowerShell 会话。本教程在《一键跑起》基础上教你搭出「看得见+多引擎」的进阶调度层。

2026.08.22· 15 分钟阅读· 约 2052 字· 🧩 DeepSeek Harness

8 月 21 日,DeepSeek Harness 更新到 RC.8(距 RC.7 仅两天):模型适配器新增原生图片请求配置,接入第三方视觉模型后,任务可同时附上截图、本地文件与历史会话;Claude Code 与 Codex 被纳入 Agent 编排体系,可按需安装并作为子代理调用;web_search 支持并发查询;Windows 端新增持久 PowerShell 会话。一句话:Harness 正从「本地工作台」变成「统一调度层」。

🧩 本教程适合:已经跑过《Harness 一键跑起》的进阶用户。我们聚焦 RC.8 的三项新能力:多模态输入、多引擎子代理、并发与持久会话。

先搞懂:RC.8 解决了什么问题

上一版 Harness 的短板是「看不见图、只有一个引擎、串行搜索」。RC.8 针对这三点逐一补齐:

新能力解决什么状态
原生图片请求截图/文件/历史会话可一并交给 Agent模型适配器配置
多引擎子代理Claude Code、Codex 可按需安装并调用Profile Bundle 按需安装
并发网页搜索web_search 多路查询提速RC.8 内置
持久 PowerShellWindows 终端会话不中断Windows PTY 终端

注意:多模态输入 ≠ DeepSeek 视觉模型已发布。图片理解走的是「接入第三方视觉模型」的适配器路径;RC.8 还修复了图片过大、历史图片累积引发的请求失败。

Step 1:开启原生图片请求

1 配置模型适配器的视觉能力
在 Harness 的模型适配器配置中:
1. 确认当前模型支持多模态
   · 若用 DeepSeek 文本模型,
     需接入第三方视觉模型
     (如 Qwen-VL 系列、GPT 视觉等)
2. 开启原生图片请求:
   · 配置 adapter 的 image 参数
   · 允许请求携带图片附件
3. 验证三种输入:
   · 截图:让 Agent 看当前画面
   · 本地文件:图片类文件直接附上
   · 历史会话:连同前文一起提交
4. 关注持久化:
   · MCP 与 ACP 开始持久保存图片附件
   · PTC 模式可转发嵌套图片

常见报错排查:
· 图片过大 → 压缩后再传
· 历史图片累积报错 → 清理会话
  图片附件
💡 配好视觉后,先跑一个「看图说话 + 文件综合」的测试:给一张截图 + 一段历史对话,让 Agent 基于两者做判断,验证图片链路是否通畅。

Step 2:把 Claude Code / Codex 装成子代理

2 一个 Harness 调度多个引擎
RC.8 支持多引擎编排:
1. 按需安装(Profile Bundle):
   · Claude Code:作为子代理接入
   · Codex:支持多命名子智能体
     (同时开多个 Codex 实例)
2. 安装方式:
   · Harness 内按提示安装/配置
   · 各引擎凭证单独管理
3. 调度关系:
   · Harness = 统一调度层
   · 子代理 = 具体执行引擎
   · 任务可分派给不同引擎,
     按模型优势分工

多命名 Codex 子智能体的价值:
· 同时跑多个独立 Codex 任务
· 各子智能体有独立会话上下文
· 适合并行编码、并行调研

注意:安装子代理前
先确认各引擎的配额与计费

多引擎 ≠ 更聪明:子代理各管一段,交接与冲突管理反而更复杂。先单引擎跑熟,再加第二个引擎做「它擅长的环节」,比如 Codex 并行做批量重构。

Step 3:并发网页搜索 + 持久 PowerShell

3 搜索提速,终端会话不丢
方向 A:web_search 并发查询
· 单条查询 → 多路并发
· 多个关键词/多数据源同时搜
· 减少串行等待,缩短任务总时长
· 用法:任务里一次给多个查询目标,
  Harness 并行执行并汇总

方向 B:Windows 持久 PowerShell
· 传统:每次执行开新会话,
  状态丢失(当前目录、变量、venv)
· RC.8:PTY 终端持久化会话
  · 工作目录、环境变量保留
  · 长任务跨多次调用不断
  · 适合:安装依赖→跑脚本→
    看结果 的连续操作
· 用法:直接在终端面板操作,
  会话状态跨轮次保留

组合场景:
并发搜资料 → PowerShell 里
批量处理文件 → 汇总报告
💡 持久会话 + 并发搜索是最实用的组合:搜索到的结果直接落到工作区,PowerShell 接着处理,全程不用反复初始化环境。

Step 4:搭一个「视觉 + 多引擎」进阶工作台

4 组合三种能力跑真实任务
实战场景:多模态代码审查 + 资料调研

任务:审查一个前端项目,
并调研某个新库的用法

编排:
1. 视觉链路(截图/UI 状态):
   · 截图项目页面,让 Agent 看
     实际渲染效果与布局问题
2. Claude Code 子代理:
   · 深读代码、找逻辑问题
   · 生成审查意见
3. Codex 子代理(多命名):
   · 并行调研新库文档
   · 输出接入方案
4. web_search 并发:
   · 同时搜新库的版本、坑、
     社区评价
5. PowerShell 持久会话:
   · 在项目环境里装库、跑验证
   · 输出可执行结论

检查点:
· 各子代理的产出要汇到一个
  统一报告里
· 涉及改代码的结论
  人工确认后再落地

给子代理设定边界:多引擎并行时,明确「谁负责看、谁负责查、谁负责改」;写操作(改文件、装依赖)默认人工确认。安全边界可对照《沙箱安全》。

Step 5:升级与回滚——版本敏感期怎么稳

5 RC 快速迭代下的工程化心态
Harness 处于开发者预览期,
接口可能不兼容变更。建议:

1. 升级前
   · 记录当前版本与配置备份
   · 读 changelog:RC.7 → RC.8
     主要变更点
2. 升级后
   · 回归你的核心任务
     (跑一遍日常工作流)
   · 重点验证:图片链路、子代理、
     持久会话
3. 出问题回滚
   · 保留上一个可用版本
   · 插件按需装载,回滚成本低
4. 生产环境
   · 生产任务别追最新 RC
   · 等稳定版或充分验证后再切
5. 生态注意
   · 插件市场(dsh-plugin)增长快,
     装插件前先看维护状态与
     权限诉求,参考
     《技能资产化》
     的筛选规范
💡 一切皆插件的设计让回滚很轻:哪个插件/子代理出问题,按需卸掉即可,不用动整个运行时。这是预览期敢于快速迭代的底气。

Step 6:把 Harness 放进你的 Agent 体系

6 统一调度层:选型与边界
Harness 的定位演进:
单一本地工作台 → 统一调度层
(模型 + 工具 + 子代理 + 插件)

何时值得把 Harness 当调度层:
1. 多模型多工具混用频繁
2. 需要插件化扩展(内部系统封装)
3. 想要本地可控 + 可审计

何时再想想:
1. 只需要单模型单工具的轻量场景
   ——直接用原厂 CLI 更省心
2. 团队有成熟商业平台
   ——权衡自维护成本
3. 对稳定性要求极高
   ——预览期功能谨慎依赖

组合生态参考:
· 模型端:V4-Pro/Flash 及
  《V4 Pro 迁移》
  的分层路由
· 子代理端:Codex 多智能体
  可对照《Codex V2》
· 技能端:Harness 的 AGENTS.md/
  .claude 目录对接
  《Agent Skills 标准》

别为了调度而调度:Harness 的复利来自「多引擎 + 插件生态」的组合价值;单一场景强上调度层,只会徒增复杂度。先想清楚你的 Agent 栈缺哪一层,再决定要不要它。

常见问题速查

你遇到的现象大概率原因 & 解决
传图片报请求失败图片过大或历史图片累积:压缩图片、清理会话附件
子代理装不上 / 调用失败凭证未配置或版本不匹配:检查各引擎凭证,确认按需安装步骤完成
搜索太慢串行查询:改用 web_search 并发,一次给多个查询目标
PowerShell 会话丢状态用了非持久会话:在 PTY 持久终端里操作,跨轮次保留目录与变量
升级后老任务跑不通RC 接口变更:读 changelog、回滚上一版本、按需调整插件配置
← 返回教程中心