DeepSeek Harness 自定义 Agent 预设实战
八个经截图验证的步骤:用创造模式做出专属 DSH 预设、配好插件,把编码助手变成你的定制工作台。
最近更新: 2026-09-25
在 DeepSeek Harness 里,一个会话运行什么样的 Agent,由「Agent 预设」决定——工具、系统提示词、挂载的插件,全都在预设里定义。DSH 内置四套预设,而创造模式是官方留给你的入口:描述你想要的 Agent,批准写入,DSH 就会替你起草、保存并挂载一套新预设。
本教程还原了来源视频里的一次完整实战:做一个「经营分析与汇报助手」,能读需求文档、Excel 销售数据和竞品截图,最后产出管理层汇报。每张截图都与视频逐帧核对过,并回链到取帧的确切时间点。
八步做出 DeepSeek Harness 自定义预设
- 1
认识四套内置预设
打开 Settings → Agent presets,四张内置卡片一目了然:标准模式(功能完整的编码 Agent,支持文件编辑、Shell、文件与网页检索、Skills、计划、子代理和工作流)、PTC 模式(保留标准模式全部能力,并通过 Code Mode SDK 让模型用一个 TypeScript 程序组合多步操作)、极简模式(只提供持久 bash 与 str_replace_editor 两个工具)和创造模式(具备标准模式全部能力,外加运行时检查、插件实验和 preset 创作指导)。任何预设都能复制一份改造成自己的,面板右上角还有「打开配置文件」的入口。

每个预设就是一张卡片:四张内置,外加创作者自己的汇报助手,带「自定义」徽标。在 1:16 观看 - 2
先装好场景需要的插件
预设能挂载什么,取决于装了哪些插件——引用了缺失插件的预设,创建时会直接报错,所以先把插件备齐。插件面板列出当前部署已安装的全部插件(视频里是 162 个),每项带「已启用」徽标;安装本身要去插件仓库(比如社区 awesome 列表),这个面板暂时装不了。视频的「经营汇报」场景挂了四个:AnyDoc(把各种格式的文档转成 Markdown)、DeepRead(深度文件分析)、ExcelChat(分析 Excel 数据)和 VisionRouter(把图片路由给有视觉能力的模型,让纯文本的 DeepSeek-V4-Flash 也能读懂截图)。

当前部署装了 162 个插件——预设能挂载的只有这里列出的。在 2:44 观看 - 4
批准沙箱提权
预设根目录在 ~/.dsh/.agent-presets/,位于会话工作区之外,第一次写入会被 workspace-write 沙箱拦下。DSH 对此早有预案:它以提权重试的方式再次写入,并弹出「等待审批」卡片,请求把沙箱升级到 danger-full-access,好让 agent.cordis.yml 落进新预设目录。看清卡片内容,再选择拒绝或允许一次——这类写权限,本就该在你知情时给出。

工作区之外的写入需要显式放行——批准前先读卡片。在 5:24 观看 - 5
检查 DSH 保存了什么
重新打开 Settings → Agent presets,新卡片已经出现:经营分析与汇报助手,落在「自定义」分区里,带「自定义」徽标,以及文件夹、复制、删除三个图标——内置预设可没有删除键。打开它所在目录(面板上的「打开配置文件」按钮通向同一位置),里面是两个关键文件:agent.cordis.yml 装着预设真正的插件组装,preset.yml 存名称和元信息。预设就是纯配置——信任它之前,先读一遍。

新预设已进入列表,带「自定义」徽标——还有内置预设没有的删除键。在 5:48 观看 
两个 YAML 文件装下整个预设:agent.cordis.yml 管行为,preset.yml 管名字。在 6:08 观看 - 7
跑任务,盯轨迹
把任务发给智能体——视频里的提示词开头甚至先要求确认「当前会话用的是经营分析与汇报助手预设」——然后切到「轨迹」标签页。DSH 把整个执行过程画成一条彩色时间线,可按耗时、轮次、调用数三种视图切换,下面每条记录都能查看:bash、glob 的调用,boss_request.txt 的读取,以及 anydoc 工具逐个处理 PPTX 和 Excel 的过程。筛选器能按工具或成本切分运行,悬停任一条目可看调用详情。

轨迹页把每一步画成时间线,可按耗时、轮次或调用数切换。在 7:44 观看 
往下滚动日志,能看到 anydoc 一行行处理 PPTX 和 Excel 的过程。在 8:08 观看 
第二支实录(录自 0.1.5-rc.1 开发者预览版)里的同一个 Trajectory tab:预设固定插件阵容,模型依然一键切换。在 1:12 观看 
模型旁边还有力度选择:从 Off 到 Max——画面录自 0.1.5-rc.1 开发者预览版。在 1:20 观看 - 8
看运行统计,读汇报
跑完后,输入框下方那条统计给出全程账单:1 轮、25 步,工具调用 11 分 30 秒,生成速度 140 tok/s,缓存命中率 91%,输入 120 万 token、输出约 44 万。报告本身以渲染好的幻灯片落在会话里:先核心指标,再给带 CAC 和复购率的渠道对比表,附证据、下月动作建议,还主动指出了数据里埋的异常值。先数字、后结论——正是管理层汇报该有的样子。

最终报告直接渲染在会话里——下方统计条给出了全程账单。在 8:32 观看
DeepSeek Harness 自定义预设:常见问题
动手做自己的预设之前,用户最常问的几件事。
DeepSeek Harness 的 Agent 预设是什么?
预设是一个会话里 Agent 运行所依据的完整插件组装——工具、提示词与能力都在其中。DSH 内置四套(标准、PTC、极简、创造),在设置的 Agent 预设面板里可以复制任意一套,或者用创造模式做自己的。
怎么创建自定义 DSH 预设?
先装好场景需要的插件,再打开 Settings → Agent presets,点「+ 用『创造模式』创建自定义预设」。独立会话打开后,描述需求或贴入准备好的配置,按提示批准写入,DSH 就会自动保存并挂载新预设。
保存预设时为什么要求完全访问权限?
预设存放在 ~/.dsh/.agent-presets/,位于会话工作区之外。默认的 workspace-write 沙箱会拦截这些写入,所以 DSH 弹出审批卡片,请求把沙箱升级到 danger-full-access。看清它要写什么,再选拒绝或允许一次。
自定义预设包含哪些文件?
预设目录里两个关键文件:agent.cordis.yml 保存预设的插件组装与行为,preset.yml 存名称等元信息。视频在访达里看到的正是这两个 YAML 文件;面板的「打开配置文件」按钮通向同一位置。
自定义预设能删除或修改吗?
能。自定义预设在面板里带「自定义」徽标,配有文件夹、复制、删除三个图标,删除只需一下。底层文件是纯 YAML,也可以直接改;内置预设只能复制,不能删除。
视频里的汇报预设用了哪些插件?
四个:AnyDoc 负责把文档转成 Markdown,DeepRead 做深度文件分析,ExcelChat 分析表格,VisionRouter 让纯文本的 DeepSeek-V4-Flash 借助有视觉能力的模型读懂截图。最终运行工具调用约 11.5 分钟,缓存命中率 91%。
官方内置的四个 Preset 到底是哪四个?
随版本内置的是四个,稳定 ID 分别为 `standard`、`ptc`、`minimal` 和 `cordis`——界面上显示为 Standard、PTC、Minimal 和 Creator。Standard 是完整工具箱;PTC 换上程序化工具调用;Minimal 砍到只剩一个持久终端加基础文件工具;Creator(cordis)额外带上构建自定义预设的运行时能力。它们在预设注册表里就是普通的插件行——另外 0.2.0-rc.2 修了设置页:关闭「显示代码工作视图」后 Agent 预设也能正常调整。
相关指南
配置细节、模型选择与插件生命周期。
DeepSeek Harness 配置指南
Profiles、patch 与四套预设的参考手册——本篇实战背后的配置分层。
阅读指南DeepSeek Harness 切换模型
把任意预设指向不同的服务商或模型,比如本篇演示用的 DeepSeek-V4-Flash。
阅读指南如何安装 DeepSeek Harness 插件
创建预设之前,把需要的插件从 npm 或 GitHub 装好。
阅读指南DeepSeek Harness 计划模式
让智能体先规划再执行——和汇报类预设是绝配。
阅读指南DeepSeek Harness 是什么?
预设与插件背后的平台,以及它和编码助手的异同。
阅读指南定制业务 Agent 实战图文
从验收清单到插件打包、一次提权审批、汇总核对,12 步全流程实录。
阅读指南创造模式深潜:审批与挂载收据
本页的进阶续读:沙箱提权对话、standingKeyFor 挂载收据,以及一场 25 步分析实战与 Excel 公式核验。
阅读指南来源与致谢
截图来自这两支公开实测视频,每张图都回链到取帧的确切时间点。文中的面板文案、文件名与运行数据均经逐帧核对;步骤 7 的选择器两帧录自 0.1.5-rc.1 开发者预览版。




