🧩 DeepSeek Harness 初体验：一切皆插件的 Agent 框架

DeepSeek 最近不只是发模型，也开始往 Agent 工具链 里伸手了。
这次看到 deepseek-ai/deepseek-harness，第一反应是：

这不是一个普通聊天壳子，而是 DeepSeek 想做一套可扩展的 Agent 运行框架。⚙️🤖

官方给它的定位是 open-source agent harness，也就是“智能体运行框架 / Agent 外骨骼”。
简单说，它不是模型本身，而是让模型能接工具、跑任务、管理会话、操作工作区的一套底座。

🚀 先说结论

如果你懒得看完整篇，我先把重点压缩一下：

一句话总结：

DeepSeek Harness 更像是 DeepSeek 给 Agent 时代准备的“插件化工作台”，现在能玩，但还不适合当成稳定生产系统闭眼上。 🧰⚡

🧠 它到底是个啥？

DeepSeek Harness 的命令叫 dsh。
它做的事情，可以理解成给大模型准备一个“可执行任务环境”：

• 💬 管理对话和 session
• 🛠️ 给 Agent 接工具
• 📁 选择工作区，让模型能读写项目文件
• 🧪 支持运行命令、委派任务、维护计划
• 🔌 通过插件扩展能力
• 🧱 把 Web UI、headless runner、模型适配器等都组合起来

它最关键的一句话是：

Everything is a Plugin. 🔌

这意思不是“我有很多插件市场按钮”，而是更底层：
模型适配、工具注册、会话日志、Agent loop、权限策略、Web 应用这些东西，都可以作为插件树的一部分被组合、替换、扩展。

说人话就是：
它不是把 Agent 能力焊死在一个大程序里，而是希望你以后能像搭积木一样换模块。🧱

🖥️ Web UI 大概长这样

从官方 README 看，它现在已经给了两种运行方式：

• ⚡ npm 快速运行
• 🧬 源码克隆运行

这点挺友好，不需要你一上来就 clone 一大坨源码。

不过注意：官方 README 写得很直白，它目前是 developer preview。
也就是说：

今天能跑，不代表下个月配置还一模一样。🧪

所以别急着把它当“稳定生产平台”，更适合先拿来研究 DeepSeek 的 Agent 方向。

🛠️ 安装部署方式一：npx 快速启动

如果你只是想先看看 Web UI，可以用最快的方式：

1

npx @deepseek-ai/dsh web

跑起来之后，默认 Web UI 地址是：

1

http://127.0.0.1:3080

这个方式适合：

• 🧪 只是想看界面
• 🧑‍💻 临时试一下 Agent 工作流
• 🧰 不想 clone 源码
• ⚡ 快速判断值不值得继续折腾

不过它依然需要你本机有 Node.js。
如果命令直接报 Node 版本问题，别硬怼，先升级 Node。

🧬 安装部署方式二：从源码运行

如果你想研究代码、改插件、看架构，建议从源码跑：

1
2
3
4
5

git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
pnpm install
pnpm run build
pnpm dsh web

仓库 package.json 里写得比较明确：

1
2

Node.js: ^22.19.0 || >=24.0.0
pnpm: 11.7.0

所以推荐准备环境：

1
2
3

node -v
corepack enable
pnpm -v

如果 pnpm 版本不对，可以让 Corepack 接管：

1
2

corepack enable
corepack prepare pnpm@11.7.0 --activate

然后再执行：

1
2
3

pnpm install
pnpm run build
pnpm dsh web

源码方式更适合：

• 🧩 想研究插件机制
• 🏗️ 想看 Agent loop 怎么组织
• 🧑‍🔬 想改源码或贡献 PR
• 🔍 想理解 DeepSeek 的 Agent 工程路线

⚙️ Web UI 跑起来后怎么配？

Web UI 不是打开就能直接开干。
官方文档里提到，新开的 Web UI 一开始没有选 workspace，需要你自己配置。

大致流程是这样：

1
2
3
4
5
6
7
8
9

🖥️ 启动 Web UI
      ↓
⚙️ Settings -> Models
      ↓
🔑 填入 DeepSeek API Key
      ↓
📁 Choose workspace
      ↓
💬 新建 session，开始给 Agent 派活

1. 配置模型 🔑

打开：

1

Settings -> Models

填入你的 DeepSeek API Key，保存后模型路由就可以用了。
官方文档说这里不需要重启服务器，保存后即可生效。

2. 选择工作区 📁

点击：

1

Choose workspace

把你想让 Agent 操作的项目目录加进去。
如果不选 workspace，会话输入区会不可用。

这个设计其实合理：
Agent 如果要读文件、改代码、跑命令，总得先知道自己在哪个目录里干活。🧑‍💻

3. 试一个任务 💬

可以先丢一个低风险任务：

1

Summarize this repository and identify its main packages.

也可以中文一点：

1

总结一下这个项目结构，告诉我主要包分别负责什么。

先别上来就让它删文件、改大项目。
毕竟 developer preview 阶段，先让它读读项目、总结结构、跑小命令，比较稳。🧯

🔌 “一切皆插件”到底香在哪？

DeepSeek Harness 底层用的是 Cordis。
它的思路是插件向共享上下文贡献服务、事件和可回滚的 effect。

听起来有点抽象，换成人话就是：

• 🧠 模型适配器可以换
• 🛠️ 工具注册可以扩展
• 🧾 session 日志可以被管理
• 🔁 Agent loop 可以观察和拦截
• 🧱 Web / headless 这些运行形态可以组合

这比“写死一个 Agent 主循环”更工程化。
如果未来生态起来了，插件可以围绕这些方向生长：

这也是我觉得它值得关注的地方：
它不是只做一个“DeepSeek 版 ChatGPT 网页”，而是在搭 Agent 基础设施。🏗️

👀 但 DeepSeek 现在还是“文字强者，图像瞎子”

这里必须调侃一句：
DeepSeek 推理、代码、数学这些确实挺能打，但图片能力这块，目前还不是它的舒适区。

所以你给它一张图，期待它像 Gemini 那样一眼看懂布局、细节、人物、UI 问题，那就有点为难它了。

说难听点：

DeepSeek 在看图这件事上，暂时像个“瞎子”：脑子很好，眼睛还没配上。 👀❌🧠✅

当然这不是说它没价值。
恰恰相反，Harness 这种项目说明 DeepSeek 可能更想先把 Agent 执行能力、工具调用能力、工程化能力 做扎实。

看图可以以后补眼睛。
但 Agent 底座如果先搭好，后面接视觉模型、浏览器、文件系统、代码工具，想象空间会更大。🧩

🧪 适合谁现在去折腾？

我觉得现在适合这些人：

• 🧑‍💻 开发者：想看 DeepSeek 的 Agent 框架设计
• 🔌 插件作者：想研究以后怎么给 dsh 写插件
• 🧪 AI 工具折腾党：喜欢试新框架、新 Web UI、新 Agent
• 🏗️ 工程化玩家：关注会话日志、权限、工具链、工作区这些底层能力
• 📚 学习型用户：想看看一个 Agent 系统怎么拆模块

不太适合这些人：

• 🙅 只想找一个稳定聊天软件的人
• 🙅 不想碰命令行的人
• 🙅 对 Node / pnpm / Git 完全不熟的人
• 🙅 想要成熟商业产品体验的人

现阶段它更像实验室里的工具台，不是已经装修好的办公室。🔬

⚠️ 注意事项

1. 它还在 developer preview 🧪

官方明确写了：

未来会出现破坏兼容性的变更。

所以现在写插件、写配置、做二开，都要有心理准备：
版本一变，配置可能要跟着改。

2. API Key 不要乱放 🔐

Web UI 里要填 DeepSeek API Key。
这种东西别写进文章、别提交到 GitHub、别截图泄露。

尤其是你如果在服务器上部署，一定要注意：

• 🔒 不要把管理界面裸奔公网
• 🧱 最好加反向代理认证
• 🧯 不要让陌生人随便操作你的 workspace
• 🧾 重要目录先别开放给 Agent

3. 先从只读任务开始 📖

第一次用，不建议直接让它改项目。

推荐顺序：

1
2
3
4
5

📖 总结项目
🧭 解释目录结构
🔍 查找某个函数
🧪 跑一个只读检查
✍️ 再尝试小范围编辑

Agent 工具越强，越要慢慢放权限。
这不是怂，是工程基本素养。🛡️

🧭 我的评价

DeepSeek Harness 现在最吸引我的不是“它能不能马上替代 Codex / Claude Code”，而是它背后的方向：

DeepSeek 可能不满足于只做模型 API，而是想把模型接进真实工程任务里。🚀

从产品完成度看，它还早。
从技术路线看，它挺值得盯。

如果未来插件生态能跑起来，dsh-plugin 这类插件仓库逐渐多起来，那它就有机会从“DeepSeek 的 Agent 实验项目”变成一个真正可组合的 Agent 平台。

不过现在嘛，我对它的态度是：

可以折腾，可以学习，可以关注，但别急着把生产任务全押上去。 🧪🧰

🔗 相关链接

• 🧩 DeepSeek Harness 仓库：https://github.com/deepseek-ai/deepseek-harness
• 📘 Web UI 指南：https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/user/guide/index.md
• 🏗️ 架构文档：https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/architecture.md
• 🛠️ 开发指南：https://github.com/deepseek-ai/deepseek-harness/blob/master/docs/development.md

✅ 最后一句

DeepSeek Harness 不是“又一个 AI 聊天网页”，它更像 DeepSeek 给 Agent 准备的工具骨架。

模型负责动脑，Harness 负责把手脚接上。
至于眼睛嘛……DeepSeek 先别急，咱们先承认一下：你现在看图确实还挺“瞎”的。👀🤣