你有没有过这种感觉——用 AI 工具越久,越觉得自己被"框"在里面。
厂商给你配好了一套 Agent:选好了工具、定好了流程、设好了权限边界。
你输入要求,它沿着既定路线跑完。
想换个模型?想自己加个工具都没办法。
DeepSeek 最近开源了一个项目,叫 DeepSeek Harness,简称DSH。
它干的事特别直白:把 Agent "拆开",模型、工具、界面、权限,你统统能自己换、自己拼。
上线没多久,GitHub 星标就冲到了 14.6 万。

这篇文章,我带你从零把它跑通一遍,没有编程基础也能跟着做。
Harness 到底是什么
先把这个名字讲清楚。一个能干活儿的 AI 员工(也就是 Agent),本质就是两样东西拼起来的:
大模型负责"想"——理解你这句话、推理下一步、生成文字。
Harness 负责"搭台子"——给模型配工具、给文件权限、准备上下文、安排任务循环、管插件和执行记录。
同一个模型,放进不同的 Harness,干出来的活儿能差出很远。
差在哪?模型能看到哪些信息、能调什么工具、失败了怎么重试、每一步有没有被权限卡住。
所以 DSH 的重点根本不是"换个聊天框",而是让你能自己组装和管理 Agent。
官方一句话概括得很到位:Everything is a Plugin,一切皆插件。模型接入、工具、界面、运行能力,全都能用插件拼出来。

驱动这套插件体系的心脏,叫 Cordis。
这名字你先记着,后面还会反复出现。
装之前,先把两样东西备齐
最省事的官方装法,就两样:Node.js 和 DeepSeek 的 API Key。
Node.js 是跑 DSH 的运行环境。去 Node.js 官网下个长期支持版(LTS),按安装向导一路点完就行。

API Key 去 DeepSeek 开放平台创建,它相当于"调用模型的凭证",后面每次请求都会产生 API 费用。

别把 Key 发进群聊、截图发朋友圈,也别写进要传 GitHub 的文件。
两样备齐,打开终端:
Mac 按 Command+空格搜"终端",Windows 用 PowerShell 或命令提示符。
输入官方这条命令:
npx @deepseek-ai/dsh web
第一次会下载依赖,等一小会儿。
启动成功,终端会打印一个 Web 地址,默认是 http://127.0.0.1:3080。复制到浏览器打开,就进 DSH 了。

如果你已经在用 Codex、Claude Code 或者 WorkBuddy,也可以直接把官方仓库地址甩给它,让它帮你检查 Node 环境、执行启动命令。
手动敲命令省了,最后照样要看终端给的本地地址。
第一次打开,先干三件事
进 Web UI 后,先到设置里的 Models 页面,找到 DeepSeek,把 API Key 填进去保存。

官方文档说保存后下一次请求才生效,不用重启。
接着选一个本地文件夹当"工作区"。
Agent 后面读写的文件都放这儿。

第一次玩,建议新建一个空文件夹,别直接选桌面、文档目录,或者正在用的项目。免得改乱了重要东西。
然后看权限设置。
DSH 会按当前权限策略,决定哪些操作能直接执行、哪些要先问你同意。刚上手先把"审批提示"开着,等你看懂它调了哪些工具,再慢慢放开。

发第一个任务试试:请在工作区新建一个 deepseek-harness.txt,写入"DeepSeek Harness",完成后告诉我文件在哪。
它能建出来、写进去,说明模型、工作区、基础写入都通了。

四种模式,别选错
标准模式:日常任务首选。整理文件、改文档、分析资料、写代码,都从这儿开始。
PTC 模式:步骤多、要批量干的活儿。比如批量读文件、按同一规则处理数据、连续做一串标准动作。
极简模式:预设极少,更接近"裸看模型怎么干活"。主要是开发者测试用,普通用户基本用不上。
创造模式:把插件组合能力全放开。你能装社区插件,也能让 Agent 照着开发文档给你做一个新插件。

记一句:日常任务先标准,真遇到默认能力搞不定的,再进创造模式。
Cordis 怎么管插件
DSH 把插件看得极重。
按官方架构,插件能注册工具、监听事件、挂其他服务。
插件卸载时,它注册的那一堆东西会自动清理;依赖的服务没就绪,框架会等它好了再加载。
听着抽象?
拿"图片翻译 Agent"举例就清楚了。
用户传一张带外文文字的图,Agent 先识别图里文字,翻成中文,最后存成文档。
你要做的时候,DSH 会先跟你确认:最终交付形式是什么?你明确告诉它——做一个能安装、能复用的插件。
这里有个坑得提前说:DeepSeek 自己的对话接口是按纯文本模型处理的,带图片的请求发出去之前就会被拦掉。
要做图片翻译,得接一个支持图片的模型,或者装个视觉插件。
视觉插件负责认字,翻译插件负责翻中文,导出插件负责存文档。
Cordis 负责把这些插件的加载、依赖、清理串起来,让它们在一个 Agent 里按顺序干活。
如果翻译插件声明"我依赖视觉识别服务",视觉插件没好,翻译就等着,导出也不会抢跑。
好处是:增删功能,不用每次推倒重做整个 Agent。
DSH 还留着会话和工具执行记录。
你说了啥、模型怎么回、调了哪个工具、工具返回了啥,都能顺着记录查。插件一出错,开发者能从具体那一步开始排查,不用只看最后那句"失败"。
去哪找现成插件
开源的好处,就是别人做好的能力你能直接拿来用。
社区有人把散落在 GitHub 上的插件整理成了一个叫 DSH 1024Store 的目录(主站 deepseek1024.com)。
截至 2026 年 8 月 17 日,它汇总了 4120 个插件,有开发者主动 PR 提交的,也有从 GitHub 的 dsh-plugin 话题里自动抓的。

除了列插件,它还提供在线市场、搜索入口、公开查询 API,和定期更新的目录。
想给 Agent 加主题、通知、文件处理、外部服务连接,先按名字、作者、功能搜一圈,看社区有没有接近的,再决定直接装还是照着改一份。
不过——收录多只代表选择多,不代表每个都过了安全审核。
装社区插件前,多做一步安全检查。
官方 CLI 专门提醒过:从 GitHub 装的插件,安装阶段可能执行 prepare 构建脚本。
pnpm 默认会拦这种脚本,只有把插件明确加进 allowBuilds 才放行。
只装来源可信的,最好锁定具体 commit。来路不明的仓库,截图再好看也别急着跑。
这东西,到底适合谁
如果你只想装好就用,不想折腾 Node、API Key、插件来源和版本,那 WorkBuddy、Codex 这类成熟 Agent 产品省事得多。
如果你已经有个明确需求,现成的 Agent 又缺某项能力,DSH 就很有意思了。
你能装别人的插件,也能让 Agent 照官方文档给你做一个。
模型、工具、界面都能继续调,做出来的东西更贴你自己的活儿。
当然短板也明显:项目还在开发者预览阶段,界面和配置可能变;社区插件质量参差不齐;装外部代码还有安全风险;自制插件能生成出来,也得测、得维护。
所以第一次上手,别急着拼个"万能 Agent"。
先完成一个小任务:装好 DSH,选个空工作区,跑通模型配置。
然后装一个来源可信的插件,看它加了什么能力。
等这两步稳了,再做一个只解决单一问题的插件。
走完这一遍,你就掌握了 DSH 最基础的使用路径。
END

平台陆续上线了无限画布、AI漫剧、AI编程、AI企培、IP陪跑等产品
夜雨聆风