DeepSeek 官方放出了 Harness 工具——一个基于 Cordis 插件体系的 Agent 开发框架。简单说，它把 Agent 的各个能力拆成独立插件，开发者可以按需组装，不用动框架源码。这东西目前还在 RC 阶段，但对想提前摸一摸 DeepSeek Agent 生态的开发者来说，已经值得装来玩玩了。

接下来咱们直接上手——从环境准备到跑通第一个 Agent 会话，每一步都讲清楚，顺带把我踩的坑也标出来。

一、Cordis 插件体系：为什么 Harness 值得关注

首先，什么是harness。

Harness 是指将大语言模型（LLM）转化为实际可执行的智能体（Agent）的框架、工具集或“执行神经系统”。

模型 + Harness = Agent 如果用马车打个比喻，马就是模型，harness就是与马车相关的驾车人、马鞍、缰绳、车等一系列的总和。

先说架构，这部分对理解后续用法很重要。

Harness 的底层是 Cordis 元框架，它只管两件事：插件的加载与卸载，以及插件间的依赖解析。除此之外，Harness 的所有具体组件——对话引擎、文件操作、命令执行、上下文管理——全部以 Cordis 插件形式存在。

这个设计带来的直接好处是：你不需要 fork 框架源码来定制行为。想换一个代码补全引擎？装个新插件就行。想加一条自定义工具链？写个 Cordis 插件挂上去。组件之间通过 Cordis 的服务和事件总线通信，在配置层面自由组合。

官方管这个理念叫"一切皆插件"。翻译成开发者能直接听懂的话：这是一个可插拔的 Agent 框架，不是一坨绑死的大而全工具。扩展性内置在架构里，而不是靠你改源码硬怼。

二、环境准备：先把地基打好

Harness 依赖 Node.js 运行时。打开终端，先确认环境：

node --version

返回 v18 或更高版本，说明环境没问题。没装的话，去 nodejs.org 下 LTS 版本，一路下一步装好再回来。但是问题是这样：
好在有workbuddy直接可以解决这个问题。
三、全局安装 DSH 命令行工具
环境就绪，一行命令搞定安装：
npm install -g @deepseek-ai/dsh

装完验证一下：

dsh --version

当前版本是 0.1.0-rc.6。看到版本号正常输出就说明安装链路通了。

如果你在国内网络环境，npm 下载速度不理想，可以临时切个镜像源加速：

装完 DSH 后记得

四、启动本地 Web 服务

dsh web

DSH 自带一个本地 Web 界面，启动方式很简单：

执行后，服务会跑在 127.0.0.1:3080。正常情况下浏览器会自动弹出，如果没弹，手动在地址栏输入这个地址即可。
默认监听 3080 端口。如果这个端口被占用（比如你本地还跑着别的开发服务），DSH 目前不会自动换端口。遇到端口冲突，先排查一下谁在用 3080：
五、首次配置：API Key 是入场券
第一次打开 Web 界面，会弹出一个内测声明。Harness 还在快速迭代期，接口随时可能调整，点"继续"进去就行。
进来之后第一件事：配置 DeepSeek API Key。界面上的配置入口很显眼，点进去，把你在 DeepSeek 开放平台申请的 API 密钥填进去，保存。
没有Key 的，去platform.deepseek.com注册账号，在控制台创建一个 API Key。新用户有免费额度，足够你把整个流程跑通好几轮。
保存之后，界面状态会变成"已连接"，这时候就可以正式开始用了。
六、选择运行模式：极简 vs 标准
点左侧"新会话"按钮，新建对话时会让你选运行模式。Harness 目前提四种：
极简模式：纯对话+代码辅助。你提问，它写代码、解释概念、做代码审查。不碰你的文件系统，不执行终端命令。适合日常编码问答、代码片段生成这类轻量场景。
标准模式：完整Agent能力开放。它可以读写本地文件、执行终端命令、做多步骤的开发任务。比如你说"帮我初始化一个Express项目并写一个用户注册接口"，它会从建项目到写代码到跑起来一条龙搞定。
PTC 模式：工具不再是离散的"调用"，而是代码里的函数。具备标准模式的全部能力，但所有工具通过 Code Mode SDK 暴露成 TypeScript 库，模型可以在沙箱里写一个完整的程序来组合多步操作。
适合：需要把多个工具调用编排成流程、避免上下文被中间结果污染的场景。比如做数据分析时，模型会写一段 TS 程序：先 fetch 拉数据 → filter + groupBy 聚合 → 同步调可视化 → 一次性返回结果，而不是一次次调用工具、一大堆中间结果塞回上下文。
创造模式：不是"用 Agent"，而是"造 Agent"。具备标准模式的全部能力，但额外开放了 preset 创建、运行时检查、插件实验 三件套，用来打造可复用的自定义 Agent。
适合：想把团队最佳实践、专属工具链、个性化工作流沉淀成 preset 的场景。比如你做了一套"前端PR审查 Agent"（自动跑 lint、看diff、生成评审意见），把它配成 preset，下次任何工作区一键启用；团队成员之间也能直接共享。
怎么选？如果你只是想体验DeepSeek的编码能力，极简模式足够了。如果你要让它帮你干实际的开发活，直接上标准模式。但注意一点：标准模式有文件系统和命令执行权限，用之前确保你清楚它在做什么操作，别让它把你的工作目录搞乱。
七、跑通第一个会话
模式选好之后，在输入框里输入需求就能开始对话了。拿一个简单的例子试水：
用 Python 写一个函数，输入一个列表，返回其中所有偶数的平方
报了一个错误，猜想不支持中文。果然去掉了开发中文二字即可正常运行。
回车后，DeepSeek 会生成代码并返回结果。
极简模式下就是一个标准的对话交互；标准模式下你可以进一步让它把代码直接写到本地文件里，甚至帮你跑一下看看输出。到这一步，从安装到使用的完整链路就跑通了。
八、实际使用中会踩的几个坑
1. API Key 填了但不生效
保存后刷新一下页面。有用户反馈首次保存后状态没及时更新，刷新后恢复正常。如果刷新还不行，检查 Key 前后有没有多余空格。
2. 标准模式下命令执行报权限错误
Windows 用户尤其注意，某些终端命令在 DSH 的执行环境里可能没有权限。遇到这种情况，检查 DSH 进程的运行权限，必要时用管理员身份启动终端再跑 dsh web。
3. 中文目录不支持。
开始对话时要求新建一个目录，结果选择了之前一个带中文的目录，报错，果断改为英文后正常可用。
写在最后
官方仓库在 github.com/deepseek-ai/deepseek-harness，Issue 和 Discussion 区都比较活跃，遇到问题可以直接去搜。另外官方 Discord 社区也有人值守，响应速度不错。
Harness 的核心价值不在于它现在能做什么——RC 阶段的功能完整度还撑不起生产场景。它的价值在于架构本身：Cordis 插件体系把 Agent 的能力边界打开了一道口子。等社区插件生态起来之后，这个框架的天花板会比现在高得多。
如果你打算试水，强烈建议在一个独立环境里跑，别直接接进现有工作流。玩透了，确认稳定了，再考虑正式接入。
workbuddy到现在还有很多人不会下载蓝皮书，考虑再三还是建个群分享吧。群内定期开展workbuddy的群服务，满50人入群费用10元，抓紧入群。

焦虑时代做一个明白的教师

每一棵小苗都能长成参天大树。

每一次努力都应该被记得。

每一种奉献都应该被尊重；

每一种声音，都应该被听见。

我虽然渺小，但我有梦想，我虽然笨拙，但我从不放弃奔跑，我虽然还不如你，但我依然努力，长按下图识别二维码关注，

我们的故事，就开始了...