DeepSeek 最近开源了一个值得关注的项目——DeepSeek Harness（DSH），一个高度可插拔的自主 Agent 框架。它能让 AI 模型像"数字员工"一样独立完成写代码、重构项目、调用工具等复杂任务。
上手安装的过程并不一帆风顺，踩了几个坑才成功跑起来。下面是完整的安装流程，帮你少走弯路。
安装之前先搞清楚 DSH 的定位：
特性DSHDify
| 定位 | 可插拔的智能体 Agent 框架 | 低代码 AI 应用开发平台 |
| 用户 | 开发者、极客 | 开发者、企业业务人员 |
| 方式 | 命令行 + 高度定制 | 可视化拖拽编排 |
| 特点 | "一切皆插件"，自主干活能力强 | 开箱即用，RAG 流水线成熟 |
简单说：Dify 是搭积木做应用，DSH 是造一个能自己干活的"AI 同事"。
环境准备
1. 检查 Node.js 版本
DSH 需要 Node.js v22.11.0 或更高版本，注意不是所有 v22.x 都可以。
检查当前版本：
node --version我一开始用的是 v22.14.0，结果报了 SyntaxError: The requested module 'node:zlib' does not provide an export named 'createZstdDecompress'。这是因为 API 是在较新的 v22 分支才加入的。解决方案是直接升级到最新的 LTS 版本（v24.x 或更高）。
2. 设置 npm 镜像源
npm 默认源在国外，不设置的话大概率会卡住。建议换成淘宝镜像源：
npm config set registry https://registry.npmmirror.com安装 DSH
方式一：npx 一键运行（推荐快速体验）
npx @deepseek-ai/dsh web首次运行会提示安装依赖，输入 y 回车即可。正常情况下 1-3 分钟就能下载完成。
方式二：全局安装（推荐长期使用）
npm install -g @deepseek-ai/dsh --registry=https://registry.npmmirror.com
dsh web全局安装的好处是以后在任何目录下直接输入 dsh web 就能启动，不用每次都走 npx 临时下载。
常见问题排查
问题 1：npx 下载卡住不动
原因：网络问题导致下载超时。
解决：
- 1. 按
Ctrl + C终止进程 - 2. 设置镜像源后重试：
npm config set registry https://registry.npmmirror.com
npx @deepseek-ai/dsh web问题 2：报错 createZstdDecompress 不存在
原因：Node.js 版本不够新。
解决：升级到 Node.js v24.x 或更高版本，然后清理 npx 缓存：
rm -rf ~/Library/Caches/npm-cache/_npx # macOS
# 或 Windows: rmdir /s /q %LOCALAPPDATA%\npm-cache\_npx
npx @deepseek-ai/dsh web问题 3：全局安装也慢
加上 --verbose 参数查看详细日志：
npm install -g @deepseek-ai/dsh --registry=https://registry.npmmirror.com --verbose启动成功！
当终端出现以下提示时，说明启动成功：
Server is running at http://127.0.0.1:3080打开浏览器访问 http://127.0.0.1:3080，就能看到 DSH 的 Web 界面。
首次使用配置
- 1. 配置 API Key：在设置页面填入你的 DeepSeek API Key（去 DeepSeek 开放平台注册获取）
- 2. 选择工作区：在首页选择一个文件夹作为 AI 可操作的工作目录
- 3. 选择 Agent 模式：新手推荐从"标准模式（Standard）"开始
完整安装命令汇总
# 1. 检查 Node.js 版本（确保 >= v22.11.0）
node --version
# 2. 设置镜像源
npm config set registry https://registry.npmmirror.com
# 3. 清理旧缓存（如果之前安装失败过）
rm -rf ~/Library/Caches/npm-cache/_npx
# 4. 全局安装 DSH
npm install -g @deepseek-ai/dsh --registry=https://registry.npmmirror.com
# 5. 启动！
dsh web总结
DSH 目前还是开发者预览版，迭代很快，但"一切皆插件"的设计理念非常灵活，社区插件生态也在快速成长——发布不到 24 小时就收录了 288+ 个插件。
如果你是开发者，想深入 Agent 的内部机制，或者需要构建一个能够自主规划、调用代码、完成复杂开发任务的"AI 同事"，DSH 绝对值得一试。
