GitHub 68k StarDeepSeek Harness从零部署完整教程 · 新手照着做就能跑起来 · 效率工具指南 · 原创教程本文介绍 DeepSeek Harnessdsh在 Windows 环境下的安装配置教程。dsh 是 DeepSeek 官方开源的 AI Agent 智能体框架架构「一切皆插件」6.8 万 StarMIT 免费可商用。本地部署一行 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.js22.19 或 24实测 v24.14.0pnpm仅源码方式需要11.7.0模型 API Key跑任务时配模型用四、部署步骤步骤 1检查 Node 版本node--version# 需 22.19 或 24低于会报 engines 不满足步骤 2npx 直接运行推荐npmconfigsetregistry https://registry.npmmirror.com# 国内加速可选npx deepseek-ai/dsh web首次自动下载deepseek-ai/dsh包实测 0.1.0-rc.6启动后浏览器打开 http://127.0.0.1:3080。步骤 3从源码运行进阶gitclone https://github.com/deepseek-ai/deepseek-harness.gitcddeepseek-harness corepackenablepnpminstallpnpmrun buildpnpmdsh web这是 monorepopnpm install 依赖多、build 较慢适合开发插件。五、使用流程配模型设置 → 模型选提供方默认 DeepSeek填 API Key选工作区Choose workspace添加项目目录并选中跑任务新建会话发指令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、本地部署 
长河君 · 2026/9/4 8:26:09 · 阅读 1.2k DeepSeek Harness 部署教程：官方开源 AI Agent 框架 Windows 安装配置详解
GitHub 68k StarDeepSeek Harness从零部署完整教程 · 新手照着做就能跑起来 · 效率工具指南 · 原创教程本文介绍 DeepSeek Harnessdsh在 Windows 环境下的安装配置教程。dsh 是 DeepSeek 官方开源的 AI Agent 智能体框架架构「一切皆插件」6.8 万 StarMIT 免费可商用。本地部署一行 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.js22.19 或 24实测 v24.14.0pnpm仅源码方式需要11.7.0模型 API Key跑任务时配模型用四、部署步骤步骤 1检查 Node 版本node--version# 需 22.19 或 24低于会报 engines 不满足步骤 2npx 直接运行推荐npmconfigsetregistry https://registry.npmmirror.com# 国内加速可选npx deepseek-ai/dsh web首次自动下载deepseek-ai/dsh包实测 0.1.0-rc.6启动后浏览器打开 http://127.0.0.1:3080。步骤 3从源码运行进阶gitclone https://github.com/deepseek-ai/deepseek-harness.gitcddeepseek-harness corepackenablepnpminstallpnpmrun buildpnpmdsh web这是 monorepopnpm install 依赖多、build 较慢适合开发插件。五、使用流程配模型设置 → 模型选提供方默认 DeepSeek填 API Key选工作区Choose workspace添加项目目录并选中跑任务新建会话发指令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、本地部署