夜雨聆风8月13日，DeepSeek 开源了自家的 Agent 框架——DeepSeek Harness（命令行名称 dsh），采用 MIT 协议。它采用"一切皆插件"的架构：模型适配、工具注册表、会话日志乃至 Agent 循环本身都是可替换的插件。
这篇文章带你从零跑起来。
---
一、它是什么？
DeepSeek Harness 是一个开源的 agent harness（智能体运行框架）。如果你用过 Claude Code 或 Codex，它们本质上也是 harness——模型外面那一层：工作区、工具、权限、会话记忆，以及驱动任务执行的循环。
dsh 的区别在于：**没有需要打补丁的特权内核**，一切皆插件，你可以自由组合出自己需要的 Agent 形态。
> ⚠️ 注意：目前处于开发者预览阶段，官方明确说明后续会有破坏性兼容变更，不建议直接用于生产环境。
---
二、环境准备
在开始之前，确认三件事：
1. 安装 Node.js
版本要求：^22.19 || >=24（奇数版本如 Node 23 不在支持范围内，会直接启动失败）
验证安装：
node -v2. 准备 DeepSeek API Key
打开 platform.deepseek.com 注册 创建 API Key，复制保存（只显示一次） 确保账户有余额或可用额度 3. 从源码构建的话，还需要 Git 和 pnpm
三、安装方式
### 方式一：npx 一键启动（推荐新手）
一条命令搞定：
npx @deepseek-ai/dsh web执行后：- npx 自动下载 `@deepseek-ai/dsh` 包- 启动 Web UI，浏览器打开默认地址 `http://127.0.0.1:3080`- 首次运行会在 `~/.dsh` 下自动初始化配置目录
升级也很简单：重新执行这条命令即可拉取最新版本。
### 方式二：从源码构建（适合开发者）
想改源码、读源码、参与贡献的选这个：
```bashgit clone https://github.com/deepseek-ai/deepseek-harness.gitcd deepseek-harnesspnpm installpnpm run buildpnpm dsh web```
升级时进入目录执行 `git pull` 后重新构建。
> 💡 Windows 用户无需额外配置，dsh 会自动使用 PowerShell 执行环境。
---
四、首次启动后的配置
**第 1 步：配置模型**
打开 Web UI → Settings → Models，在 DeepSeek 卡片里填入 API Key 并保存。改完立即生效，无需重启服务。
**第 2 步：选择工作区**
首次启动后会话输入框不可用，需要先在界面中选择（或添加）一个工作区——这是官方 quickstart 流程的第一步。
**第 3 步（可选）：验证 CLI 链路**
用一次性任务模式验证整个链路：
```bashdsh --profile headless "Say hello in one line."```
成功后进程会打印 agent 的最终回答并退出（退出码 0）。
---
五、它在你机器上放了什么？
无论哪种安装方式，你的个人数据都统一存放在 `$DSH_HOME`（默认 `~/.dsh`）：
```~/.dsh/├── profiles/ # 各 profile 的配置组合├── sessions/ # 会话日志├── storages/ # 插件持久数据├── settings.yaml # 设置（默认预设、默认模型等）└── .credentials.yaml # 凭据（明文 API 密钥）```
备份 = 备份这个目录。
---
六、常见问题
**npx 卡住装不上？**
九成是网络问题。npx 要从 npm 拉包，可以换国内镜像源，或者直接走源码构建方式。
**启动报错？**
先检查 Node 版本，必须满足 `^22.19 || >=24`，Node 23 这种奇数版本不行。
**能对外提供服务吗？**
不能。dsh 只服务本机，传 `--host 0.0.0.0` 会被 CLI 拒绝并退出，官方没把它设计成对外托管的服务。
---
七、相关链接
- 官方仓库：https://github.com/deepseek-ai/deepseek-harness- 官方中文文档：https://github.com/deepseek-ai/deepseek-harness/blob/master/README.zh.md- Quickstart 指南：https://deepseek-harness.github.io/deepseek-harness/guide/quickstart
---