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 内置 |
| 持久 PowerShell | Windows 终端会话不中断 | 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、回滚上一版本、按需调整插件配置 |