GitHub 68k Star：DeepSeek Harness

从零部署完整教程 · 新手照着做就能跑起来 · 效率工具指南 · 原创教程

---

本文介绍 DeepSeek Harness（dsh）在 Windows 环境下的安装配置教程。dsh 是 DeepSeek 官方开源的 AI Agent 智能体框架，架构「一切皆插件」，6.8 万 Star，MIT 免费可商用。本地部署一行 npx 命令，配好 API Key 即可让 AI 读写文件、运行命令。

一、为什么值得用

开源优势

• 官方背书：DeepSeek AI 官方开源，6.8 万 Star，质量与热度双高；
• 免费可商用：MIT 协议，可自由使用、二次开发、商用；
• 架构先进：「一切皆插件」，灵活可扩展，插件生态丰富。

本地部署好处（对比云 Agent 服务）

对比项	云 Agent 服务	本地 dsh
数据安全	代码/文件需上传	数据不出本机
掌控度	受平台限制	自定义模型、插件、权限
扩展性	受限	dsh-plugin 插件生态

二、核心特色：一切皆插件

dsh 基于自研的 Cordis 插件框架，产品的每一部分都是插件：

组成	说明
模型适配器	插件，可换成任何模型
工具注册表	插件，Agent 能用的工具
会话日志	插件，对话记录
Agent 主循环	也是插件，可替换

关键含义：dsh 没有「特权核心」，想改任何功能，挂载一个插件并排即可，卸载时自动撤销不留痕迹。

三个架构概念（进阶）：Profile（配置组合，命名组合列出插件树）、Bundle（分发单元）、Capability Seam（能力接缝，换提供者即可改变整个产品行为）。

三、环境要求

项目	要求
Node.js	22.19+ 或 24+（实测 v24.14.0）
pnpm	仅源码方式需要（11.7.0）
模型 API Key	跑任务时配模型用

四、部署步骤

步骤 1：检查 Node 版本

node --version   # 需 22.19+ 或 24+，低于会报 engines 不满足

步骤 2：npx 直接运行（推荐）

npm config set registry https://registry.npmmirror.com  # 国内加速（可选）
npx @deepseek-ai/dsh web

首次自动下载 @deepseek-ai/dsh 包（实测 0.1.0-rc.6），启动后浏览器打开 http://127.0.0.1:3080。

步骤 3：从源码运行（进阶）

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

这是 monorepo，pnpm install 依赖多、build 较慢，适合开发插件。

五、使用流程

1. 配模型：设置 → 模型，选提供方（默认 DeepSeek），填 API Key；
2. 选工作区：Choose workspace，添加项目目录并选中；
3. 跑任务：新建会话发指令，Agent 会读文件、改代码、跑命令。

六、设置面板详解

• 通用设置：语言（中文）、外观（浅色/深色/跟随系统）、权限模式、Agent 预设、Enter 键行为；

• 

• 模型：填 API 密钥，提供方下拉支持 30+ 家（DeepSeek/OpenAI/Anthropic/Google/Groq/月之暗面/MiniMax/HuggingFace 等）；

• 

• 插件：有插件列表，可浏览、搜索插件，从列表选择要安装的插件，已装的显示「已挂载/已启用」；

• 

• Agent 预设：选择工作模式，对之后新建的会话生效。
  

七、插件机制与 CLI

• 装插件：GitHub 搜 dsh-plugin 话题找社区插件；自己开发用 Cordis 教程（插件=Service、Context=服务仓库、inject 依赖、Typed Events、可逆 effect）。
• CLI 命令：

dsh web          # Web 界面
dsh plugin       # 插件管理
dsh profile      # 配置文件
dsh dump-config  # 导出配置

八、踩坑与解决

⚠️ Node 版本太低：低于 22.19 报 engines 不满足，升级到 22.19+ 或 24+。

💡 开发者预览版：版本迭代快（实测 rc.5→rc.6），可能有破坏性变更，遇到奇怪报错属正常。

九、总结

DeepSeek Harness 部署极简（一行 npx），价值在「一切皆插件」的架构和灵活使用。作为 DeepSeek 官方开源的 Agent 框架，值得一试。

项目地址：[deepseek-ai/deepseek-harness] (https://github.com/deepseek-ai/deepseek-harness)

标签：DeepSeek、AI Agent、dsh、开源框架、Windows、本地部署