DeepSeek Harness（简称 DSH）是 DeepSeek 推出的开源 AI 智能体底座，核心特点是 “一切皆插件”，模型、工具、沙箱、存储、UI 全部都可以插件化替换，不用修改内核源码就能自由组合 Agent 能力，2026 开发者预览版已经支持 npx 一键启动、桌面客户端、源码编译三种部署方式，新手优先 npx 快速跑通 WebUI，再配置 DeepSeek 或者第三方模型 API，最后按需安装社区插件，用来做代码工程、文档分析、批量任务、多智能体协作，同时这个版本还处在快速迭代阶段，部分插件存在版本兼容问题，配置的时候要留意内核版本匹配。
一、环境前置要求
| 依赖项 | 版本要求 | 说明 |
|---|---|---|
| Node.js | 22 及以上 | npx、npm 安装方式必须依赖 |
| 内存 | ≥8G | 简单对话 Agent；跑复杂多插件建议 16G 以上 |
| 网络 | 可访问 npm 仓库、模型 API | 国内可配置镜像加速 |
| 系统 | Windows/macOS/Linux 全支持 | Windows 推荐 WSL2，稳定性更好 |
二、三种下载部署方式
方式 1：npx 一键启动（新手首选，不全局安装）
终端直接执行命令，自动拉取包并启动 Web 服务，不用本地存代码
npx @deepseek-ai/dsh web
启动成功后默认地址：http://127.0.0.1:3080
方式 2：npm 全局安装（高频长期使用）
npm install -g @deepseek-ai/dsh
dsh --version
dsh web
全局安装后任意目录都可以调用 dsh 全部命令，适合经常调试插件、批量跑任务
方式 3：源码编译部署（二次开发、自定义内核）
git clone https://github.com/deepseek-ai/deepseek-harness.git
cd deepseek-harness
corepack enable
pnpm install
pnpm run build
pnpm dsh web
适合需要修改内核、自研插件的开发者，编译耗时更长
三、核心配置步骤
- 进入 WebUI 设置页面，找到模型提供商配置，填入 DeepSeek API Key，也可以切换硅基流动、百炼等兼容 OpenAI 格式的模型源
- 持久化配置文件路径：~/.dsh/settings.yaml，密钥单独存放在~/.dsh/.credentials.yaml，建议执行权限加固命令chmod -R 700 ~/.dsh保护密钥不泄露
- 沙箱权限配置：按需开启本地文件读写、终端执行权限，生产环境建议关闭自动执行脚本，增加人工确认
- 会话存储配置：默认本地存储会话记录，也可以安装存储插件切换数据库持久化
- 重启服务：修改 yaml 配置文件之后，必须关闭当前 web 进程，重新执行dsh web加载新配置
四、附赠常用精选插件清单
| 插件名称 | 作用 | 安装命令示例 |
|---|---|---|
| billion-context | 上下文自动压缩，大幅降低 token 消耗，长会话首选 | dsh plugin --profile web add @ranxianglei/billion-context |
| dsh-vision-router | 识图插件，自带免费识图通道，上传图片解析 | dsh plugin --profile web add @ysr666/dsh-vision-router |
| dsh-memory-evolve | 跨会话长期记忆插件，支持待办、记忆检索 | dsh plugin --profile web add github:Fishsb/dsh-memory-evolve |
| dsh-prompt-enhancer | 提示词一键优化，自动补全指令、约束边界 | dsh plugin --profile web add github:Fishsb/dsh-prompt-enhancer#v3.1 |
| dsh-usage | 用量面板，实时查看 token 消耗、API 余额统计 | dsh plugin --profile web add @Aisland-SJL/dsh-usage |
查看已经安装插件：dsh plugin list
卸载插件：dsh plugin --profile web remove 插件包名
五、常见踩坑点
- Node 版本过低：低于 22 版本会直接启动报错，升级 Node 再重试
- API 连通失败：检查 Key、baseURL、网络代理，国内访问 DeepSeek 官方 API 需要确认网络条件
- 插件不生效：插件版本和 DSH 内核版本不匹配，优先选择标注适配当前预览版的插件，安装后重启 web 服务
- 端口占用：3080 端口被占用，可以启动时指定端口dsh web --port 3081
- 沙箱风险：不要随意开启无限制终端执行插件，避免恶意脚本读取本地文件
【相关 FAQ】
问题 1：DeepSeek Harness 下载部署，npx 方式和源码安装有什么区别？
回答 1：DeepSeek Harness 下载部署，npx 方式适合新手快速体验，不需要本地保存源码，一条命令启动；源码安装适合二次开发、修改内核、自研插件，编译流程更复杂，适合开发者。
问题 2：DeepSeek Harness 配置模型的时候，除了 DeepSeek 官方 API 还能接入其他模型吗？
回答 2：DeepSeek Harness 配置支持兼容 OpenAI 格式的模型接口，硅基流动、阿里云百炼等平台都有对应的适配插件，在 settings.yaml 里面新增 provider 配置项即可切换模型源。
问题 3：DeepSeek Harness 常用插件 billion-context 主要解决什么问题？
回答 3：DeepSeek Harness 常用插件 billion-context 是上下文压缩插件，自动识别、裁剪会话内冗余内容，降低 token 消耗，长周期 Agent 任务、大型代码仓库分析场景非常实用。
问题 4：DeepSeek Harness 配置完 yaml 文件之后，为什么修改不生效？
回答 4：DeepSeek Harness 配置写入 settings.yaml 之后，必须停止当前 dsh web 进程，重新执行启动命令加载配置，修改配置不会自动热重载，密钥文件权限配置不当也会读取失败。
【参考资料】
[2026-11-13]（DSH 插件市场安全扫描与沙盒安装实测）dsh.so
[2026-11-06]（12 个热门 DeepSeek Harness 社区插件实测）阿里云开发者社区
[2026-10-26]（从零开始 30 分钟上手 DeepSeek Harness）华为云开发者社区
[2026-09-29]（DeepSeek Harness 保姆级安装与配置实操）阿里云开发者社区
[2026-08-18]（SiliconFlow 适配器插件接入 DeepSeek Harness）SiliconFlow 文档
[2026-08-12]（DeepSeek Harness 官方开发者预览文档）DeepSeek 官网
【免责声明】
以上内容为 2026 年 DeepSeek Harness 开发者预览版公开资料整理，DeepSeek Harness 仍处于迭代阶段，插件、命令、配置格式后续版本可能变更；第三方社区插件非官方维护，存在安全、兼容风险，加载陌生插件前做好安全校验；本内容不构成生产环境部署建议，开启终端、文件沙箱权限请自行评估风险，API 密钥请妥善保管，不要提交到公网仓库。