DeepSeek Harness 零基础上手全攻略：Agent = Model + Harness10分钟跑通官方开源智能体框架

DEEPSEEKHARNESS·零基础教程DeepSeekHarness零基础上手全攻略Agent=Model+Harness10分钟跑通官方开源智能体框架官方开源Agent框架·一切皆插件·完整实测2026年8月发布·MIT协议·开发者预览版v0.1好马配好鞍：Harness是套在模型上的“马具”模型决定上限，Harness决定落地方式目录CONTENTS01开篇：同一模型，换副马具差别多大开源背景·争议·三工具实测·关键数据02核心概念：Agent=Model+Harness公式·分工·一切皆插件·Cordis内核03适用场景：谁该用DeepSeekHarness三种人适合·小任务选省心0410分钟上手：三步跑起来准备·启动·对话·四种模式05插件生态：一切皆插件落地三个插件·插件市场·生态现状06展望与总结三个比喻·“阶梯是Agent”·三句话总结DeepSeekHarness零基础上手全攻略·Agent=Model+Harness01开篇：同一模型，换副马具差别多大开源背景·两极争议·三工具实测·关键数据DeepSeekHarness·开篇实测01开篇实测背景：开源一天，GitHub收藏逼近10万发布时间2026-08-13发布v0.1开发者预览版·MIT协议全开源社区热度100k一天内GitHub收藏逼近10万项目定位官方开源的Agent运行框架命令行工具名：dsh核心口号“一切皆插件”EverythingisaPlugin与DeepSeekV4Pro正式版同期发布，被社区称为“让模型真正干活的框架”。01开篇实测刚上线就两极分化：捧它的人，和喷它的人一种声音·捧“Agent时代的安卓”开放、可组合、可自由扩展另一种声音·喷“半成品，太拉了”环境安装、命令、插件都还粗糙转折：有人让Harness给自己造出一个新模式，换个项目直接复用——三轮一共只花了1.92元。这篇我们怎么做？不只看概念——直接从0安装、跑任务、测模式，看它到底夯不夯，普通人值不值得折腾。01开篇实测实测设计：同一个模型，放进三个不同的工具测试任务复刻Harness官方风格，做一款AIPPT工具三个工具WorkBuddy·Codex·DeepSeekHarness（DSH）同一模型均使用DeepSeekFlash，控制变量对比维度速度·效果·成本·缓存命中三工具横向实测·同一模型对照01开篇实测实测结果对比：同一个Flash，三个工具三种表现工具速度效果成本/缓存WorkBuddy最快，几分钟交第一版可手动修改，网页内直接打开缓存命中不可见Codex约半小时多模态出UI，PPT可编辑、可接APIKey需Codex模型生成图片DSH+Flash约10分钟功能相对全面缓存命中约99%DSH+V4Pro优化后更好功能更全，无质变正式场景推荐注意：DSH效果目前与同类工具接近，长期优势在“缓存看得见、可优化、成本更省”。01开篇实测三个关键数字：为什么说“长期最省Token”99%缓存命中率在DSH里，DeepSeek可达约99%缓存命中，重复内容基本不再计费。30倍缓存价差有没有命中缓存，价格可差约30倍，优化命中率直接决定成本。32元两天实测花费作者两天高强度使用DeepSeek，总花费约32元，成本可控。结论：先不管效果，长期来看，最省DeepSeekToken的方式，是在DSH里使用。01开篇实测·小结同一个模型，换副“马具”差别有多大同一个模型DeepSeekFlash装上不同的Harness（马具）WorkBuddy/Codex/DSH产出结果各不相同效果、速度、成本都不同这就是套在AI模型上的Harness（马具）——它决定模型能不能找到文件、用对工具、看懂报错、再改一轮。官方公式很短：Agent=Model+Harness好马配好鞍，放到这里正合适。读到这，你对DeepSeekHarness的理解已经超过25%的人了。02核心概念：Agent=Model+Harness公式·分工·一切皆插件·Cordis内核·能力对比DeepSeekHarness·核心概念02核心概念官方定义：Agent=Model+HarnessAgent=Model+HarnessModel·大脑负责理解、推理与判断决定“怎么想、想什么”例：DeepSeekV4Pro、FlashHarness·身体接文件/终端/搜索/工具/权限/任务记录决定“能不能真的动手”例：DeepSeekHarness、ClaudeCode模型管“聪明不聪明”，Harness管“能不能动手、动了手能不能把事情做成”。02核心概念谁负责什么：Model与Harness的分工Model·大脑理解用户意图与上下文把任务拆解成可执行的步骤推理、规划、判断下一步决定何时停下来、何时问人生成最终的回复或结果Harness·身体找到模型需要的文件调用正确的工具与命令读取并理解报错信息执行修改后继续下一轮记录任务过程与Token消耗缺了大脑，工具不会自己动；缺了身体，再聪明的模型也只是“纸上谈兵”。02核心概念聊天停在“回答”，Agent在一个循环里干活普通聊天模型停在“回答”这一步把建议丢给你，剩下的你自己做Agent循环思考→调用工具→执行→检查循环直到任务完成，再给你结果关键差异：谁在动手、何时停、过程是否可见。思考-行动-检查的闭环循环02核心概念背后的模型：V4Pro0813为什么适合做AgentResponsesAPI面向Agent的标准交互接口更适合多轮工具调用Anthropic兼容兼容主流Agent生态接口降低接入成本完整工具调用FunctionCalling能力完备支持结构化输出100万上下文百万Token长文档、长任务也能从容处理模型越强，同样的Harness能跑出更好的结果；但模型不会替你“动手”，动手的事依然交给Harness。02核心概念“一切皆插件”：和传统工具式的区别传统工具式能力写死在内核里，想加一个工具就要改框架、跟着升级，自定义成本高。DeepSeekHarness模型、工具、技能、会话、沙箱、存储、循环、调度、UI全部插件化，配置层自由替换，没有特权内核。想加能力？装一个插件即可，不用动框架本身。02核心概念内核很“薄”：Cordis只干三件事Cordis内核（来自Koishi生态）加载把插件接进来卸载把插件移出去依赖管理理顺插件间关系内核只管插件的生命周期；其余功能——模型、工具、UI、存储——全部由插件各自实现、自由组合。配套学术论文：《AProgrammingParadigmforSpatiotemporalComposability》02核心概念和ClaudeCode、Codex放一起看对比项DeepSeekHarnessClaudeCodeCodex官方归属DeepSeek官方AnthropicOpenAI开源MIT全开源不开源不开源可扩展性一切皆插件有限扩展有限扩展运行形态Web/Headless/ACP等CLI为主CLI/IDE三者定位类似，DSH的差异化在于：开源、插件化、可完全掌控配置与过程。03适用场景：谁该用DeepSeekHarness三种人适合·小任务选省心·成本视角DeepSeekHarness·适用场景03适用场景先泼冷水：这几种情况，先别用DSH只做轻量问答、随手任务小任务选省心，杀鸡不必用牛刀，普通对话工具更顺手。不想折腾环境需要装Node.js、用命令行、申请APIKey，有一定上手门槛。一次性的小事没有多少可复用、可优化的空间，投入不划算。需要成熟插件市场生态仍在早期，还没有成熟的应用商店，开箱即用的插件偏少。03适用场景反过来：这3类人，DSH是真主场1任务量大的人每天批量处理资料缓存命中率直接影响成本省Token就是省钱2想把过程看清楚的人用了哪个模型调了什么工具、花多少Token全程可追踪3喜欢DIY定制的人模型、工具、插件工作模式自由组合造自己的Agent一句话：小任务选省心；量大、在意成本、还想搭积木，才是DSH的主场。03适用场景怎么用都行：DSH的四种运行形态Web形态浏览器里可视化操作，适合普通用户日常使用，也是入门首选。Headless无界面运行，适合脚本化、自动化与批量任务。ACP接入作为AgentClient协议接入，让其他Agent也能调用它的能力。PythonSDK程序化调用，适合开发者嵌入自己的应用或工作流。一个框架，既能给小白用Web，也能给开发者用SDK，覆盖不同层级的用户。0410分钟上手：三步跑起来准备·启动·对话·排障·接入模型·四种模式DeepSeekHarness·10分钟上手0410分钟上手三步总览：装好环境就能跑1第①步·准备装Node.jsLTS，去DeepSeek开放平台建APIKey（别外泄）。2第②步·启动运行启动命令，浏览器打开本地地址，界面就起来了。3第③步·对话填APIKey、选模型，发第一条消息，验证跑通。全程不超过10分钟，下面逐页展开每一步的细节。0410分钟上手·第①步第①步·准备：Node.js与APIKey环境要求Node.jsLTS版本要求：^22.19或>=24自带npm，用于安装dshWindows/macOS/Linux均支持APIKey在DeepSeek开放平台创建Key为write-only，仅显示一次默认存于~/.dsh/.credentials.yaml务必保管好，不要外泄进阶技巧：让Codex或WorkBuddy用一段提示词帮你代装（npminstall-g@deepseek-ai/dsh+dsh--profileweb），免去手动敲命令。提示：装完可随时执行dsh--version检查是否成功。0410分钟上手·第②步第②步·启动：一条命令拉起服务Windowsnpx.cmd@deepseek-ai/dshwebmacOSnpx@deepseek-ai/dshweb首次运行会询问是否下载，输入y回车，等待组件就绪。打开界面看到:3080出现后，浏览器打开即可进入Web界面。停止运行终端窗口不要关，使用中保持运行；需要停止时按Ctrl+C。常见报错提示“禁止运行脚本”时，改用npx.cmd即可；这是Windows的执行策略提示。0410分钟上手遇到问题先查：排障清单现象可能原因解决办法一直转圈不回复APIKey未填或填写不完整检查设置中的Key是否完整提示余额不足账户余额已用完到开放平台充值模型灰色、不可选对应模型未配置设置→模型，确认绿色可用启动报“禁止运行脚本”PowerShell执行策略限制改用npx.cmd启动排查顺序建议：先看Key是否完整，再看余额，最后看模型配置；多数问题出在前两项。0410分钟上手·第③步第③步·对话：发第一条消息验证填写配置在界面填入刚才创建的APIKey选择模型：DeepSeekFlash或V4Pro判断标准模型正常回复，即代表跑通没回复按上一页排障清单排查推荐第一条测试消息“你好，请回复DSH已经跑起来了。然后再告诉我要查天气，你可以看文件、搜索网页、执行命令。”看到它真的去调用工具、再给出答案，你对DSH的认识就到位了。0410分钟上手不只是DeepSeek：DSH还能接入其他模型支持的提供方AnthropicOpenAIBedrock/Azure/Vertex自定义OpenAI兼容端点本地模型（Ollama等）接入流程示例·Kimi设置→模型→添加提供方获取可用模型列表选择kimi-coding/kimik3填入对应APIKey即可注意：手填自定义模型默认按纯文本处理；若要用视觉模型，需在settings.yaml中补充视觉相关配置。0410分钟上手安全边界：权限与工作区怎么设权限默认值默认workspace-write危险操作需要人工审批日常建议尽量Fullaccess提效批量删除等操作建议人工确认工作区选择新建一个空文件夹作为工作区不要把整个桌面或硬盘交出去核心原则给Harness最小必要权限把它约束在项目目录之内权限给得越窄越安全，也越不容易误删数据。0410分钟上手四种工作模式，先看懂再选模式适用场景特点标准模式绝大多数日常任务读写文件、搜索、规划全开，先选它PTC模式文件多、步骤多、批量处理用一段TypeScript程序组合多步操作极简模式研究评测、控制变量只保留bash和编辑器两个工具创造模式做插件、改工具、存工作方式把做事方法存成新的Agent预设新手从标准模式开始；跑熟了再试PTC提速、极简做评测、创造模式沉淀自己的玩法。05插件生态：一切皆插件落地三个插件·插件市场·生态现状DeepSeekHarness·插件生态05插件生态三个插件，正好改三个位置改输入·dsh-at-file敲@搜索当前工作区文件，不用把整个硬盘喂给模型。改能力·ModLens给纯文本DeepSeek借一副“眼镜”，读截图、看布局再判断。改输出·dsh-genui把答案渲染成统计卡、图表、表单，还能继续点击。插件化架构：像搭积木一样组合能力05插件生态插件①·dsh-at-file：把文件“@”给模型解决的问题想让模型处理某个文件，却不知道它叫什么、在哪，传统方式只能描述。怎么用输入时敲一个@，弹出当前工作区的文件搜索，选中即引用。价值只把相关文件喂给模型，上下文更干净、Token更省，结果更准。一句话理解就像在群里@人一样，把文件精确地“@”给模型。05插件生态插件②·ModLens：给模型借一副“眼镜”没有ModLens时DeepSeek是纯文本模型看不了图片和界面截图UI类任务只能靠文字描述，效率低有ModLens时外部视觉引擎先读截图把文字、布局转成文本再交给DeepSeek判断相当于借了一副眼镜收益：纯文本模型也能处理截图类任务，能力边界被插件撑开。05插件生态插件③·dsh-genui：把答案变成能点的界面纯文字回答一堆文字，看完就散GENUI可交互组件统计卡、图表、表单、按钮从“读文字”到“用界面”结果不再是一段话，而是一个能看、能点、能操作的界面，交互感拉满。适合谁做分析、做报表、做工具的人；把AI结果直接做成小应用。三个插件共同说明一件事：DSH的能力边界，由插件决定，而不是由内核决定。05插件生态插件去哪找：生态的现状与渠道生态现状暂无成熟的应用商店类似早期AI绘画StableDiffusion安装可能遇到依赖问题社区在等“傻瓜安装包”怎么找GitHub仓库加dsh-plugin标签到对应topic页浏览相关项目社区发布24小时就涌现数百个插件给贡献者的建议：给插件仓库打上dsh-plugin标签，方便别人发现和复用。06展望与总结三个比喻·“阶梯是Agent”·现状与未来·三句话总结DeepSeekHarness·展望与总