DeepSeek Harness 自定义 Agent 预设实战

八个经截图验证的步骤:用创造模式做出专属 DSH 预设、配好插件,把编码助手变成你的定制工作台。

最近更新: 2026-09-25

在 DeepSeek Harness 里,一个会话运行什么样的 Agent,由「Agent 预设」决定——工具、系统提示词、挂载的插件,全都在预设里定义。DSH 内置四套预设,而创造模式是官方留给你的入口:描述你想要的 Agent,批准写入,DSH 就会替你起草、保存并挂载一套新预设。

本教程还原了来源视频里的一次完整实战:做一个「经营分析与汇报助手」,能读需求文档、Excel 销售数据和竞品截图,最后产出管理层汇报。每张截图都与视频逐帧核对过,并回链到取帧的确切时间点。

八步做出 DeepSeek Harness 自定义预设

  1. 1

    认识四套内置预设

    打开 Settings → Agent presets,四张内置卡片一目了然:标准模式(功能完整的编码 Agent,支持文件编辑、Shell、文件与网页检索、Skills、计划、子代理和工作流)、PTC 模式(保留标准模式全部能力,并通过 Code Mode SDK 让模型用一个 TypeScript 程序组合多步操作)、极简模式(只提供持久 bash 与 str_replace_editor 两个工具)和创造模式(具备标准模式全部能力,外加运行时检查、插件实验和 preset 创作指导)。任何预设都能复制一份改造成自己的,面板右上角还有「打开配置文件」的入口。

    DeepSeek Harness 设置的 Agent 预设面板:标准、PTC、极简、创造四张内置预设卡片,下方是自定义的「经营分析与汇报助手」。
    每个预设就是一张卡片:四张内置,外加创作者自己的汇报助手,带「自定义」徽标。在 1:16 观看
  2. 2

    先装好场景需要的插件

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

    DeepSeek Harness 设置里的插件列表:include、timer、session、agent 等 162 个已安装插件,各带「已启用」徽标。
    当前部署装了 162 个插件——预设能挂载的只有这里列出的。在 2:44 观看
  3. 3

    从创造模式起步

    回到 Settings → Agent presets,点面板底部的「+ 用『创造模式』创建自定义预设」。DSH 会新开一个独立会话,自动加载创造模式,输入框提示你「描述你想要构建的内容」。你可以直接写需求,也可以像视频里那样提前准备好预设内容再贴进去——起草过程中 DSH 会检查运行时环境,并就有歧义的地方跟你确认。

    DeepSeek Harness Agent 预设面板底部:「+ 用『创造模式』创建自定义预设」按钮位于四张内置卡片下方的独立分区。
    创造模式按钮单独一栏,就在内置卡片下方。在 5:00 观看
    DeepSeek Harness 新开的创造模式会话,输入框提示「描述你想要构建的内容」,权限为 Workspace Write,模型为 DeepSeek-V4-Flash High。
    一个独立会话,已经跑在创造模式里——用大白话描述你要的预设。在 5:02 观看
  4. 4

    批准沙箱提权

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

    DeepSeek Harness 创造模式请求审批:把沙箱升级到 danger-full-access,才能把 agent.cordis.yml 写入 ~/.dsh/.agent-presets 下的预设目录。
    工作区之外的写入需要显式放行——批准前先读卡片。在 5:24 观看
  5. 5

    检查 DSH 保存了什么

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

    创建完成后的 DeepSeek Harness Agent 预设面板:新卡片「经营分析与汇报助手」带「自定义」徽标,配文件夹、复制、删除图标。
    新预设已进入列表,带「自定义」徽标——还有内置预设没有的删除键。在 5:48 观看
    访达窗口显示 DeepSeek Harness 自定义预设目录里的两个文件:agent.cordis.yml 和 preset.yml,背后是 Agent 预设面板与自定义卡片。
    两个 YAML 文件装下整个预设:agent.cordis.yml 管行为,preset.yml 管名字。在 6:08 观看
  6. 6

    一键切换工作台

    用起来就是一次点击。新会话输入框上方的预设选择器里,自定义助手已经和标准、PTC、极简并列——选中它,会话即加载这套预设的插件和提示词。再把工作区选择器指向存放材料的文件夹;视频里选的工作区放着需求 PDF、销售渠道 Excel、PPT 模板和竞品截图。

    DeepSeek Harness 输入框的预设选择器已切到自定义的「经营分析与汇报助手」,会话为新建会话。
    自定义助手已经出现在预设选择器里,和标准、PTC、极简并列。在 6:16 观看
    DeepSeek Harness 新会话:侧栏选中 source files 工作区,输入框上方的工作区与预设选择器待选。
    发送任务前,先把会话指向存放材料的工作区。在 7:20 观看
  7. 7

    跑任务,盯轨迹

    把任务发给智能体——视频里的提示词开头甚至先要求确认「当前会话用的是经营分析与汇报助手预设」——然后切到「轨迹」标签页。DSH 把整个执行过程画成一条彩色时间线,可按耗时、轮次、调用数三种视图切换,下面每条记录都能查看:bash、glob 的调用,boss_request.txt 的读取,以及 anydoc 工具逐个处理 PPTX 和 Excel 的过程。筛选器能按工具或成本切分运行,悬停任一条目可看调用详情。

    DeepSeek Harness 会话的轨迹标签页:彩色执行时间线悬在 SYSTEM、USER 与 bash、glob 等 TOOL 条目上方。
    轨迹页把每一步画成时间线,可按耗时、轮次或调用数切换。在 7:44 观看
    DeepSeek Harness 轨迹日志里的经营分析任务:anydoc 工具调用读取 PPTX 与 Excel,穿插在 bash 和 read 条目之间。
    往下滚动日志,能看到 anydoc 一行行处理 PPTX 和 Excel 的过程。在 8:08 观看
    DeepSeek Harness 轨迹标签页里展开的模型选择器:DeepSeek-V4.1-Flash(已勾选)、DeepSeek-V4-Flash、DeepSeek-V4-Pro 与 DeepSeek-V4-Flash-Vision-Exp,背后是工具调用日志和已完成的报告面板
    第二支实录(录自 0.1.5-rc.1 开发者预览版)里的同一个 Trajectory tab:预设固定插件阵容,模型依然一键切换。在 1:12 观看
    DeepSeek Harness 的推理力度下拉菜单:Off、Low、High、Max 四档,Max 已勾选,背后是轨迹工具调用日志和净收入报告面板
    模型旁边还有力度选择:从 Off 到 Max——画面录自 0.1.5-rc.1 开发者预览版。在 1:20 观看
  8. 8

    看运行统计,读汇报

    跑完后,输入框下方那条统计给出全程账单:1 轮、25 步,工具调用 11 分 30 秒,生成速度 140 tok/s,缓存命中率 91%,输入 120 万 token、输出约 44 万。报告本身以渲染好的幻灯片落在会话里:先核心指标,再给带 CAC 和复购率的渠道对比表,附证据、下月动作建议,还主动指出了数据里埋的异常值。先数字、后结论——正是管理层汇报该有的样子。

    DeepSeek Harness 会话内渲染完成的汇报:渠道预算表含 CAC 与复购率,下方统计条显示 140 tok/s、缓存命中 91%、输入 1.2M token。
    最终报告直接渲染在会话里——下方统计条给出了全程账单。在 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 预设也能正常调整。

相关指南

配置细节、模型选择与插件生命周期。

来源与致谢

截图来自这两支公开实测视频,每张图都回链到取帧的确切时间点。文中的面板文案、文件名与运行数据均经逐帧核对;步骤 7 的选择器两帧录自 0.1.5-rc.1 开发者预览版。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。