DeepSeek Harness 部署教程：官方开源 AI Agent 框架 Windows 安装配置详解

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 服务）

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

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

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

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

三、环境要求

四、部署步骤

步骤 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 较慢，适合开发插件。

五、使用流程

六、设置面板详解

• 通用设置：语言（中文）、外观（浅色/深色/跟随系统）、权限模式、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、本地部署