夜雨聆风开源Agent框架 · 一切皆插件 · 10分钟跑通
✦ ✦ ✦
上周三，DeepSeek 把自己憋了一年的大招放出来了——不是新模型，是一个叫 Harness 的开源 Agent 框架。
但比这更让我意外的，是它装起来居然这么简单。
一行命令，10 分钟，一个浏览器，我手里的 DeepSeek 从一个聊天机器人变成了能读文件、能跑命令、能自己规划任务的真 Agent。
这篇文章就是我的安装实录。所有截图都是真的，所有命令我跑过。
✦ ✦ ✦
一、先搞懂：Harness 到底是个什么东西
讲安装之前，得先回答一个问题：它是什么？
有个公式能让你秒懂——Agent = Model + Harness。
大模型本身只会生成文字。它不会读文件，不会跑命令，也记不住上一轮对话。真正让模型"动起来"的那一层——文件系统接入、工具调用、沙箱权限、会话记忆、任务循环——就是 Harness（执行脚手架）。
DeepSeek Harness，2026 年 8 月 13 日 DeepSeek 开源，MIT 协议（商用免费），开发者预览版 v0.1.0-rc.6。
它的核心理念就八个字：一切皆插件。
• 模型是插件
• 工具是插件
• UI 是插件
• 甚至连 Agent 主循环本身，都是插件
它内置了 159 个插件，开发者可以自由组装、自由替换、自由二次开发。
这不是又一个聊天工具，是真正能"干活"的脚手架——读写文件、执行命令、任务规划、子代理委派、会话轨迹回放，全都给。
✦ ✦ ✦
二、它和 Claude Code、Codex 有什么不同
和 Claude Code、OpenAI Codex 这类竞品比，DeepSeek Harness 最大的不同是：把"插件化"做到了极致。
官方把它拆成 8 层：
1. Inference 层 — 模型适配（DeepSeek、Anthropic、OpenAI、Bedrock、Vertex、Azure 都支持）
2. Tools 层 — 工具注册、策略管控、结果处理
3. State 层 — 会话状态、追加式日志、回放与分叉
4. Control 层 — Agent 循环控制（目标、回合、步骤管理）
5. Execution 层 — 文件系统、Shell、子进程、沙箱
6. Composition 层 — 配置组合（Profile、Bundles、Patches）
7. Experience 层 — UI 体验（Web 界面、对话节点、设置面板）
8. Framework 层 — 底层 Cordis 插件框架本身（这个也是插件）
什么叫"激进"？这 8 层全部可以换。
你可以换模型、换执行环境、换记忆系统，连 Agent 主循环都能替换。MIT 协议意味着你 fork 之后商用，不用问 DeepSeek 同意，也不用付一分钱。
这是开源世界目前最激进的 Agent 模块化设计。
✦ ✦ ✦
三、四种运行模式，先选一个再开工
第一次启动会让你选运行模式，目前有四种：
模式 · 干啥的
**标准模式**｜全套工具加载：文件编辑、Shell、网页搜索、子 Agent、Skills、规划、工作流
日常开发首选，**新手直接选这个**
**PTC 模式（Code 模式）**｜把多步工具调用写成一段 TypeScript 程序一次性执行
步骤多、批量任务、自动化流程
**极简模式**｜只留 Bash + 文件编辑两个工具
DeepSeek 官方跑模型评测用，普通用户基本用不到
**创造模式**｜标准模式全套能力 + 运行时检查 + 插件试验 + 预设创作
想自己造模式、定制 Agent 的人
绝大多数人，选标准模式就够了。等你熟了，再去试 PTC 和创造模式。
✦ ✦ ✦
四、安装实录（Windows 11 实操）
下面是完整安装步骤。我用的版本是 0.1.0-rc.6，系统是 Windows 11。
### 步骤 1：装 Node.js
Harness 要求 Node.js 22.19+ 或 Node 24。先确认一下：
如果你看到的版本号低于 22.19，去 https://nodejs.org/ 下载 LTS 版本装上。
### 步骤 2：全局安装 dsh
打开终端（PowerShell 或者 cmd 都行），输入：
等待它装完，会显示 added 530 packages in 7m。
### 步骤 3：验证安装
装完顺手验证一下：
看到版本号 0.1.0-rc.6，就说明成功了。
### 步骤 4：看一眼官方页面
浏览器打开 DeepSeek 官网，能看到 Harness 的发布页。
页面上的"一键使用"窗口里那条命令 npx @deepseek-ai/dsh web，就是下面要跑的。
### 步骤 5：理解设计理念
如果你想知道"一切皆插件"是什么意思，往下翻能找到设计文档。
页面讲得很清楚：模型、工具、技能、会话、沙箱、循环、调度、UI 八个 Agent 能力均插件化，并通过 Cordis 服务与事件驱动协作。开发者无源码改动即可在配置层组合。
### 步骤 6：启动服务
回到终端，输入：
它会在本地启动一个 Web 服务，默认地址是 http://127.0.0.1:3080</span。>
小贴士：dsh 只服务本机，传 --host 0.0.0.0 会被它直接拒绝——官方没把它设计成对外托管的服务。
### 步骤 7：填 API Key
浏览器打开 127.0.0.1:3080，第一次进入会让你填一个 API Key。
填上你的 DeepSeek 官方 API Key（从 https://platform.deepseek.com 创建），点"保存并继续"。
### 步骤 8：选工作区 + 选运行模式
进入主页后，先在左侧选一个你电脑上的项目目录作为"工作区"，再在右侧的"标准模式"下拉里选一个运行模式。
新手直接选"标准模式"。
### 步骤 9：检查插件（可选但推荐看一眼）
设置 → 插件里可以看到 159 个内置插件，每个都可以启用或禁用。
如果你不知道干嘛的，先保持默认就行。等你用熟了，再根据需要开关。
### 步骤 10：开干
到这儿，DeepSeek Harness 已经装好了。
试着对它说一句：
"帮我看看这个项目里有哪些模块？"
看它怎么读文件、怎么规划、怎么一步步执行——这才是 Harness 真正有意思的地方。
✦ ✦ ✦
小结
• DeepSeek Harness 是 DeepSeek 8月13日开源的 Agent 框架，MIT 协议商用免费
• 核心理念是"一切皆插件"，8 层全部可替换，连框架本身也是插件
• 模型中立——DeepSeek、Anthropic、OpenAI、Bedrock、Vertex、Azure 都支持
• 安装只需一行命令 npm install -g @deepseek-ai/dsh，启动 dsh web
• 浏览器打开 127.0.0.1:3080，填 API Key → 选工作区 → 选模式 → 开干
• 159 个内置插件，四种运行模式（标准 / PTC / 极简 / 创造），开箱即用又能深度定制
你装上了吗？跑通了吗？