DeepSeek Harness系统教程：从Agent原理到插件生态的全链路实战指南

系统教程DeepSeekHarness从Agent原理到插件生态的全链路实战指南大模型·Agent·Harness·插件·应用·生态——一次搞懂AIAgent的完整工作链路2026年8月·基于官方文档与社区实践整理一切皆插件·Agent=Model+Harness目录01概念篇：大模型、Agent与Harness厘清三者定义与关联，理解AIAgent本质02价值篇：理解Harness的意义AI产品竞争的双维度，用好Harness三件事03DSH介绍：DeepSeekHarness是什么一切皆插件，毛坯房与精装房的差异04上手教程：手把手安装与使用安装、工作区、权限、模型、四种模式、轨迹05插件生态：必备插件与产业意义推荐插件、安装方法、Agent产品供应链06总结展望：落地路径与未来企业落地第三种道路，使用建议与未来展望本教程目标：体系化理解AIAgent工作原理，掌握DeepSeekHarness安装使用，了解插件生态价值，学会像拼乐高一样构建专属AI工作流。01概念篇：大模型、Agent与Harness大模型是脑子，Agent是接上双手会干活的人，Harness是套在脑子外面的一整套干活装备。大模型是什么：聪明的脑子，但只有嘴没有手第一章·04大模型（LLM）的核心能力是理解、推理和输出文本，但它无法执行任何真实操作大模型能做什么理解你的问题和需求进行推理和思考输出文本答案、代码、总结会写、会总结、会改周报大模型不能做什么不会自己点开文件夹不会真的去跑一条命令不会自己保存文件再打开检查答案说完，所有事情就结束了常见的大模型对话产品DeepSeek网页豆包ChatGPT网页Claude网页核心比喻：大模型就是脑子——它聪明，但只有嘴，没有手。复制、粘贴、保存全是我们自己的事。Agent是什么：接上双手，会干活的人第一章·05Agent在大模型基础上接入大量工具，通过多轮思考-解决循环独立完成任务Agent的工作原理大模型对需求做反馈（思考）→Agent使用工具做响应（执行）工具可能是读、写、看、浏览器、各种接口甚至软件一步一步多轮思考-解决，直到任务完成AIAgent：大脑连接工具的工作模式以Agent为核心的产品ClaudeCode·Codex·WorkBuddy·OpenClaw·豆包工作这些产品的核心逻辑相同：通过接入各种工具，帮你做更多的事PS：Agenttoken消耗大——想的多、做的多、上下文多房子比喻房子里有个聪明的你=大模型给你很多工具=Agent的能力房子本身=产品包装包装成办公=WorkBuddy，包装成写代码=CursorHarness是什么：套在脑子外面的干活装备第一章·06Agent=Model+Harness。除了大模型，其他所有让AI能动手的细节都是HarnessAgent=Model+HarnessHarness包含的核心组件组件类别具体内容作用工具（Tools）读文件、写文件、跑命令、上网搜、调接口模型的手脚Skills/技能预设的工作流程、提示词模板、操作规范模型的经验沙箱与存储安全执行环境、文件系统、记忆存储模型的工作空间循环与调度ReAct循环、任务拆解、错误重试、Subagent模型的指挥系统权限与护栏读写权限控制、安全检查、操作确认模型的安全边界Harness词义为驾驭、套具——就是让大模型能在真实环境里动手的所有细节，不是某一个按钮三者关系：大模型想，Harness干，Agent是合体第一章·07用一张图理解大模型、Harness、Agent三者的包含关系与协作模式Agent（智能体）Harness（驾驭层）工具·Skills·沙箱·存储·循环·调度Subagent·工作流·权限·护栏大模型（Model）理解·推理·输出负责"想"负责想负责干想+干=合体核心公式：大模型负责想，Harness负责干，拼在一起就是Agent。理解这个公式，就理解了所有AIAgent产品的本质。第一章小结：理解AIAgent的本质第一章·08大模型是脑子，Harness是装备，Agent是会干活的人——这是理解一切AI产品的钥匙大模型核心能力：理解、推理、输出只有嘴，没有手不会执行真实操作代表产品：DeepSeek网页豆包、ChatGPTClaude网页Harness核心定位：干活装备工具、Skills、沙箱存储、循环、调度Subagent、工作流权限、护栏不是某一个按钮是所有动手细节的总和Agent公式：Model+Harness多轮思考-解决循环独立完成具体任务代表产品：ClaudeCode、CodexWorkBuddy、OpenClaw豆包工作token消耗大02价值篇：理解Harness的意义评价AI产品好不好用，本质上看两个维度：大模型能力强不强，Harness能力强不强。AI产品竞争的两个维度：模型能力与Harness能力第二章·10我们常说某AI产品好用或不好用，本质上是在讨论这两个问题维度一：模型能力大模型本身的智商和能力推理深度、代码能力、知识广度上下文长度、多模态能力容易感知，讨论度高维度二：Harness能力工具丰富度、执行效率、调度能力权限管理、错误处理、记忆能力界面交互、工作流支持讨论相对较少，但一直存在同一个模型，不同Harness，体验完全不同都用DeepSeek大模型，在Claude中使用和在WorkBuddy中使用，体感肯定不同。模型一致，为什么体感不同？答案：Claude、Codex内部都有自己的Harness，带来了效果上的差异。Harness跟随产品而来，我们通常改不了。但我们可以学会和Harness配合——这才是真正拉开使用效率差距的关键。Harness如何影响产品体验：五大核心能力第二章·11Harness的五个核心组件直接决定了AIAgent产品的使用体验和能力上限1.工具丰富度能调用多少种工具决定了Agent能做多少事文件操作、终端命令、浏览器、数据库、API工具越多，能完成的任务越复杂2.执行效率工具调用的速度和并发能力影响任务完成时间只读操作可并发，修改操作需串行高效的Harness能显著减少等待时间3.调度能力任务拆解是否合理Subagent协作是否顺畅错误重试是否智能直接影响复杂任务成功率4.记忆与上下文长期记忆能力上下文管理策略历史任务复用影响连续工作的连贯性5.安全与权限操作权限分级危险操作确认沙箱隔离决定能否放心交给Agent用好Harness的三件事：工作区、工具、规矩第二章·12和Harness配合的核心就三件事，有意识地融入使用过程，才叫会用Agent01工作区让Agent做事情一定要明确它能操作的范围和权限不要让它在整个电脑里乱跑指定一个项目文件夹作为工作区权限分级：只读/工作区写/完全访问日常用工作区写就够了02给工具写Prompt需求时知道Harness包含什么工具就可以告诉它用什么工具做什么事例如："用终端运行测试""读取config.yaml文件""搜索最新的文档"明确工具选择能提高效率03写规矩定义验收标准哪些话不能写改完要不要跑检查例如："修改后必须运行单元测试""不要修改测试文件""代码注释用中文"规矩越清晰，结果越可控这三件事都有意识地融入使用过程，才叫会用Agent——而不是只会问问题第二章小结：Harness决定使用体验第二章·13模型决定智商上限，Harness决定动手能力——会用Harness才能真正用好AgentAI产品双维度竞争维度一：模型能力推理、代码、知识、上下文容易感知，讨论度高维度二：Harness能力工具、效率、调度、记忆、安全讨论较少，但一直存在同一模型不同Harness体验不同各厂商在Harness上竞争激烈用好Harness三件事1.工作区：明确操作范围和权限只读/工作区写/完全访问2.给工具：告诉Agent用什么工具明确工具选择提高效率3.写规矩：定义验收标准和约束规矩越清晰结果越可控三件事都做到，才叫会用Agent03DSH介绍：DeepSeekHarness是什么DeepSeek给自己的模型补了Harness，但它的野心更大——一切皆插件，毛坯房模式。DeepSeekHarness是什么：DeepSeek官方Agent产品第三章·15DeepSeek本身只有大模型，现在自己下场给自家模型补了Harness，变成了一个完整的Agent类比理解就像ClaudeOpus有了ClaudeCode，GPT模型有了Codex——DeepSeek模型有了DeepSeekHarness但DSH的野心更大官网首页第一句一切皆插件这是DSH跟Codex、ClaudeCode最大的不一样模型能换，AgentLoop能换界面能改，功能全靠插件开源HarnessHarness层完全开源给到几乎所有的基建能力Agent框架、工具系统、调度引擎但任何应用层都不提供纯纯的毛坯房GitHub星标已超20万，社区插件增长迅速，是目前最热门的开源Agent框架之一一切皆插件：DSH的核心理念第三章·16DSH官网最醒目的第一句话就是"一切皆插件"——这是它与Codex、ClaudeCode最大的不同一切皆插件可以插件化的核心模块模型层可随意切换模型支持接入第三方模型AgentLoop思考-执行循环可替换自定义调度逻辑工具系统工具通过插件扩展按需安装所需能力UI界面创造模式可改界面自定义画布和组件这意味着什么DSH本体功能极简，连文件浏览、记忆这些别人默认就有的功能，出厂都可能没有但它有无限大的可能性——缺什么功能，就装什么插件；没有的插件，创造模式里说清楚，现场造这带来的改变，在企业落地等方面，可能是颠覆性的毛坯房vs精装房：DSH与其他Agent产品的本质差异第三章·17用房子比喻理解DSH与Codex、ClaudeCode等产品的核心差异精装房（Codex/ClaudeCode）一切都配套好了，可以直接用文件浏览、记忆、搜索默认就有界面固定，流程标准化优点：开箱即用，体验稳定缺点：不能改界面、流程、能不能接内部系统都得等官方优化、更新你是用户，不是产品的主人产品是人家的毛坯房（DeepSeekHarness）只用本体时，功能少得惊人连文件浏览、记忆出厂都可能没有需要什么，自己装插件优点：无限大的可能性缺哪块零件，装哪块没有的，创造模式现场造Harness开源，可深度定制毛坯不是没做完是把产品层让给你DSH走的是第三种更加"中庸"的道路：Harness开源给基建能力，但应用层完全交给用户和社区DSH核心特性：六大差异化能力第三章·18DeepSeekHarness相比其他Agent产品的六大核心差异化特性1.一切皆插件模型、AgentLoop、工具、UI全部可插件化本体极简，功能全靠插件扩展社区插件已超1万个，增长速度惊人2.开源HarnessHarness层完全开源，可深度定制企业可基于此构建专属Agent系统不用从零造轮子，也不用求大厂排期3.多模型支持内置Flash/Pro/Flash-Vision可随意切换第三方模型模型不是绑定的选择最适合任务的模型4.四种模式标准/PTC/极简/创造四套开箱模板不是四个产品只是预装的工具不同5.轨迹模式展示Agent内部执行全过程上下文、工具调用、提示词理解AI为什么能/不能解决发现token浪费和跑偏6.创造模式：标准能力+能改自己——告诉它需要画布，它能在Web页面上改出来，这是DSH最特别的地方DSH与主流Agent产品对比第三章·19DeepSeekHarness与ClaudeCode、Codex、WorkBuddy等主流Agent产品的核心差异对比维度DSHCodexClaudeCodeWorkBuddy架构模式毛坯房+插件精装房精装房精装房开源程度Harness开源闭源闭源闭源模型选择多模型可切换GPT系列Claude系列多模型可定制性极高（插件+创造）低低中开箱体验需装插件开箱即用开箱即用开箱即用企业落地灵活定制受限于官方受限于官方中等灵活第三章小结：DSH是Agent产品的第三种道路第三章·20DSH不是又一个Codex——它是开源Harness+一切皆插件的全新Agent范式核心理念一切皆插件模型可换AgentLoop可换工具可扩展UI可改毛坯房模式本体功能极简功能全靠插件产品层让给用户核心特性开源Harness多模型支持四种模式标准/PTC/极简/创造轨迹模式内部执行全透明创造模式能改自己的界面社区插件1万+差异化优势vs精装房产品可深度定制不用等官方更新vs从零开发不用造轮子基建能力现成企业落地首选灵活、可控、低成本04上手教程：手把手安装与使用一行命令安装，WebUI操作，四种模式可选，轨迹模式看透AI内部——跟着做就能上手。安装步骤：一行命令启动DSH第四章·22安装DSH非常简单，终端里一行命令即可启动前置要求Node.js版本需22.19及以上（或>=24），奇数版本不支持终端安装与运行DSH快速启动（推荐）npx@deepseek-ai/dshweb全局安装方式1.npminstall-g@deepseek-ai/dsh2.dsh--version验证安装3.dshweb启动WebUI4.浏览器自动打开:3080注意事项工具本身免费，花钱的是模型API第一次打开需填写DeepSeekAPIKey已有Codex/ClaudeCode可让它帮你安装Node和pnpm版本必须匹配WebUI界面介绍：标准三段式布局第四章·23DSH是一个标准的WebUI，界面布局清晰，操作直观左侧：对话历史历史会话列表可新建/切换会话会话自动保存支持搜索历史工作区选择插件管理入口设置入口中间：任务区对话和任务执行区域显示AI思考过程工具调用过程可见文件操作实时展示终端输出内嵌显示轨迹模式入口可展开查看完整执行链支持中断和重试右侧/底部底部：输入框输入需求和指令支持多行输入@引用文件权限选择（左下角）模型选择模式切换思考强度调节安装插件后界面可扩展：侧边栏文件树、代码编辑器、内置终端、Git面板等都可通过插件获得工作区与权限：三档权限管理第四章·24选择工作区限定Agent操作范围，三档权限控制Agent能做什么工作区设置点「选择工作区」，添加一个文件夹——这就是Agent能操作的项目文件范围建议为每个项目单独设置工作区，避免Agent误操作其他项目文件三档权限（对话框左下角切换）ReadOnly只能看，不能改适合：阅读代码、分析文档、了解项目结构最安全，不会有任何修改WorkspaceWrite只能在当前工作区里写日常就用这一档注意：限制的是写，不是看——它仍可看到工作区外的文件FullAccess全部系统都可访问不建议开始就用仅在需要系统级操作时临时开启用完切回WorkspaceWrite模型选择：内置多模型，支持接入第三方第四章·25DSH内置多款DeepSeek模型，也可以随意接入第三方模型，按任务选择最合适的内置模型模型特点适用场景成本Flash速度快、性价比高日常任务、知识整理低Pro推理能力强、代码能力好复杂编程、深度推理中Flash-Vision-Exp带视觉能力，可看图截图分析、图片理解中第三方模型接入DSH不绑定模型——可以把Kimi、Qwen、Claude、GPT等第三方模型接进来在设置中配置第三方模型的APIKey和接口地址即可使用建议搭配：DSH+KimiK3+DeepSeekFlash做知识数理类任务四种模式：四套开箱模板，不是四个产品第四章·26四种模式只是预装的工具组合不同，绝大多数情况无脑选标准即可1.标准模式完整干活套装：文件、命令、搜索、Skills、计划、子Agent都预设好了第一次用无脑选它，绝大多数场景直接用理解成DeepSeek版Codex即可2.PTC模式标准能力都有，区别是让模型通过写代码把多步工具压进一次跑步骤特别碎的时候才用小白先别碰3.极简模式只留终端和改文件官方拿来测模型裸能力的日常工作基本不用开，基本上没法用方便测试不同模型的基础能力4.创造模式标准能力都有，还能改自己——没错，就是改自己觉得需要画布看文档，告诉它，能在Web页面上改出来DSH最特别的地方轨迹模式：看透AI内部执行全过程第四章·27轨迹模式是DSH最有价值的功能之一——把Agent内部的所有执行过程都展示出来把一个需求在Agent内部的所有执行过程展示出来：上下文、工具调用、提示词等所有细节每个用AI工作的人都应该去看一看、理解一下轨迹模式的四大价值1.理解Agent为什么能解决问题看到完整的思考-工具调用-结果反馈链条，理解Agent的工作逻辑2.了解模型能力边界知道当前模型在哪些任务上表现好，哪些地方会卡住3.发现模型跑偏的地方看到Agent在哪个步骤走偏了，及时纠正或调整Prompt4.发现浪费token的地方识别不必要的工具调用和重复操作，优化使用成本多看轨迹，就懂了——现在用AI，会用和用好，就这么个区别。DSH是大家用好AI的绝佳机会实用技巧：提升DSH使用效率的6个建议第四章·28基于实践经验总结的6个实用技巧，帮助你更高效地使用DSH01让Agent自己装插件直接发Prompt告诉它安装哪些插件比手动找GitHub地址方便安装完重启dshweb生效02用@引用文件安装dsh-at-file插件后输入@即可搜索文件快速引用需要的文件03善用轨迹模式复杂任务后查看轨迹理解执行过程和问题优化Prompt和工作流04按任务选模型日常用Flash省钱复杂任务切Pro需要看图用Vision05写清楚规矩修改后跑测试不要改哪些文件代码注释用什么语言06权限从低到高先用ReadOnly了解再用WorkspaceWriteFullAccess最后才开常见问题：安装与使用FAQ第四章·29使用DSH过程中最常见的问题及解决方案Q:启动报错"engineunsupported"怎么办？A:Node.js版本不对。dsh要求^22.19或>=24，奇数版本（如23）不支持，升级到最新LTS版即可Q:插件装了但没生效？A:安装插件后需要重启dshweb才生效。可用dsh--dump-config查看完整插件树，排查插件状态Q:pnpminstall报引擎不兼容？A:Node和pnpm版本必须匹配。建议使用Node22LTS+对应版本pnpm，或直接用npx方式启动Q:APIKey填了但无法使用？A:确认APIKey有效且有余额。工具本身免费，消耗的是模型API费用，去DeepSeek平台充值即可Q:当前是开发者预览版，官方声明会有破坏兼容的变更，生产环境建议暂缓使用第四章小结：从安装到精通的完整路径第四章·30安装简单、界面直观、模式清晰——轨迹模式是理解AI的最佳窗口安装与界面一行命令启动npx@deepseek-ai/dshwebNode22.19+WebUI三段式布局左：对话历史中：任务区底：输入框:3080配置与模式工作区限定范围三档权限管理日常用WorkspaceWrite多模型可切换Flash/Pro/Vision支持第三方模型四种模式标准模式日常首选进阶技巧轨迹模式看透内部理解AI工作逻辑发现跑偏和浪费让Agent自己装插件@引用文件写清楚规矩权限从低到高按任务选模型05插件生态：必备插件与产业意义插件不是装饰，插件是零件——Agent产品第一次有了供应链。社区插件已超1万个。插件安装方法：三种方式，推荐让Agent自己装第五章·32DSH插件支持多种安装方式，最简单的是直接告诉Agent帮你安装方式一：让Agent自己装（推荐）为我安装插件：/omdsh-dev/dsh-at-file/omdsh-dev/dsh-genui插件化：像拼乐高一样构建AI能力方式二：命令行安装dshplugin--profilewebadd<插件名或GitHub地址>方式三：插件市场安装安装dsh-market插件后，通过可视化市场浏览安装重要提示安装完插件必须重启dshweb才生效官方插件库：/topics/dsh-plugin用dsh--dump-config查看插件状态支持npm包名、GitHub地址、本地路径必备插件推荐（一）：文件、UI、侧边栏第五章·33社区大佬持续开发有价值的插件，以下是几个无脑装的必备插件dsh-at-file输入@即可搜索文件，快速找到想要引入的文件类似IDE中的文件引用功能，大幅提升操作效率/omdsh-dev/dsh-at-filedsh-genui让DSH可以展示图表和画布样式数据可视化、流程图、仪表盘等都可以在对话中直接渲染/omdsh-dev/dsh-genuiDSH-better-sidebar增加VSCode风格侧边工作台：文件树、代码编辑器、内置终端还支持Git、Diff查看、内嵌浏览器、子代理状态面板/omdsh-dev/DSH-better-sidebar必备插件推荐（二）：搜索、市场与更多第五章·34更多实用插件，扩展搜索能力、提供插件市场、增强视觉识别modsearch扩展搜索源，让联网搜索获得更多更精确的信息支持多搜索引擎聚合提升信息检索的全面性和准确性/liustack/modsearchdsh-market类似Codex、WorkBuddy的插件市场可视化浏览和安装插件不用再手动找GitHub地址/2BingLing/dsh-market更多热门插件类别类别代表插件功能视觉识别modlens让DSH具备识图能力模型路由各类model-router插件按任务自动选择最优模型长期记忆memory类插件跨会话记忆和知识积累插件生态的产业意义：不是热闹，是供应链第五章·35DSH插件生态的真正价值不是社区热闹，而是Agent产品第一次有了供应链插件不是装饰，插件是零件三种AI落地路径对比精装房模式用现成Agent产品Codex/ClaudeCode只能住，不能改界面流程固定接内部系统等官方你是用户不是主人从地基建从零写一套Agent贵、慢技术一更新框架得改大工程任何纰漏都得重来成本高、周期长DSH中庸道路Harness开源给基建应用层自己装插件缺哪块装哪块没有的创造模式造不用造轮子不用求大厂排期灵活、可控、低成本未来复杂流程拆解为模块，插件化拼凑，就是独属于你的产品——这就是供应链的力量Agent产品供应链：像拼乐高一样构建AI工作流第五章·36插件生态让Agent产品第一次有了供应链——每个复杂流程都可以拆解为插件模块供应链的核心逻辑复杂流程企业级业务需求多步骤自动化工作流→拆解模块数据采集、处理分析、输出各环节→插件化每个模块做成插件可复用、可组合→专属产品拼凑组合公司级交付供应链带来的变革对公司不用从零造轮子，也不用求大厂排期缺哪块零件，装哪块插件没有的插件，创造模式里说清楚现场造交付成本大幅降低，周期大幅缩短对开发者擅长交付的人，一天几十块钱就能搓出三个插件开源出去获得社区反馈从做Skills转向做插件成为趋势插件开发者成为Agent生态的重要角色第五章小结：插件生态是DSH的核心壁垒第五章·37毛坯不是没做完，是把产品层让给你——插件生态让Agent产品有了供应链必备插件dsh-at-file：@引用文件dsh-genui：图表画布better-sidebar：侧边栏modsearch：搜索增强dsh-market：插件市场modlens：视觉识别让Agent自己装最方便装完必须重启生效生态数据GitHub星标20万+社区插件1万+增长速度惊人内测时大家都在写插件从Skills转向插件插件类别丰富UI、模型、记忆、搜索Workflow、工具、计费产业意义插件是零件不是装饰Agent产品第一次有供应链企业落地第三种道路不用造轮子不用求大厂排期复杂流程插件化拼凑成专属产品像拼乐高一样工作06总结展望：落地路径与未来把DSH玩起来——除了好玩之外，它的能力和应用场景远远不止"毛坯房"那么简单。企业落地：DSH提供的第三种道路第六章·39对于企业AI落地，DSH提供了介于"用现成产