DeepSeek Harness保姆级教程(下载+安装+配置,附带10款常用插件)

DeepSeek Harness（简称 DSH）是 DeepSeek 在 2026 年 8 月开源的 AI Agent 运行框架，采用 MIT 协议。与 Claude Code、Codex 这类开箱即用的成品 Agent 不同的是，DSH 把模型、工具、会话、沙箱、UI 等都做成可替换的插件，开发者可以自由组装出自己的 Agent。它提供了一套可复用的 Agent 底层能力——会话管理、工具调用、记忆与沙箱隔离都以插件形式提供，按需启用。DSH 也支持市面上所有主流大模型，包括本家的 DeepSeek 和 Anthropic、OpenAI 等。DSH 以本地 Web UI 运行，在浏览器里配置好模型与插件即可开始使用。本文也提供了一个插件，可以桌面应用的形式使用 DSH ，不需要单独安装 Node.js、pnpm 或 DSH。

下载DeepSeek Harness

DSH 通过 npm 分发，无需下载传统安装包，本文提供的是 DSH 桌面插件，即 DeepSeek Harness 桌面端。DeepSeek Harness桌面端下载地址：

https://www.54benniao.com/a/ca784y.html（点击文末的「阅读原文」可以直达链接）

DSH-Desktop-2.0.0-x64-Setup-public.exe：适配 x64 架构的 Windows 系统电脑的安装包。
DSH Desktop-2.0.0-arm64-public.dmg：适配 Apple 芯片的 macOS 系统电脑的安装包。

安装DeepSeek Harness（两种方式）

1. 桌面端安装（社区维护）

此桌面端安装程序是 DeepSeek 官方社区中的 DeepSeek Harness Desktop 项目制作的插件，是社区维护的开源项目，并非 DeepSeek 官方产品。它把官方 DeepSeek Harness 的本地 Web UI 带到原生桌面。应用自动启动和管理本地 Harness 服务，集成系统托盘与桌面窗口，无需安装 Node.js 或执行命令。1) 下载 DeepSeek Harness 桌面端安装包，双击 DSH-Desktop-2.0.0-x64-Setup-public.exe，开始安装：

2) 点击“下一步”：

3) DSH 桌面端默认安装在系统盘，建议安装在 D 盘等非系统盘。点击“浏览”：

4) 在安装目录下（本文中为“D:\Programs”），创建新文件夹，并命名为“DeepSeek Harness”，点击“确定”：

5) 确认安装目录，点击“安装”：

6) 等待安装：

7) 点击“完成”：

8) 程序正常启动，安装完成：

2. npm安装（官方维护）

npm 安装需要再电脑中安装 Node.Js，如果没有安装，可以参照这里：

https://www.54benniao.com/a/h4xg47.html1) 在键盘按下 Win + R，输入 cmd 回车，打开命令行终端：

2) 在命令行中输入或粘贴以下命令，并回车，安装 DSH ：

npx @deepseek-ai/dsh web

PS：如果提示“'npx' 不是内部或外部命令，也不是可运行的程序或批处理文件。”说明没有安装 Node.js，请先安装 Node.js。

3) 输入“y”回车，开始安装（安装时间还挺长的）：

4) 等待安装完成后，命令行会显示 DSH Web UI 的访问链接：

5) 复制链接并在浏览器打开，网址通常是 http://127.0.0.1:3080，此时 DSH 还在内测，点击“继续”：

PS：注意使用时，不能关闭 cmd 窗口。

6) 填写 DeepSeek API Key，点击“保存并继续”；也可以点击“稍后配置”后续再填写 DeepSeek 或其他平台的 API Key：

配置API Key

DSH 可以使用 DeepSeek 自己的 API Key，也可以使用其他国内或国外的模型的 API Key：1) 点击左下角的设置按钮：

2) 点击“模型”，再点击右侧的“添加提供方”：

3) 在“提供方”的下拉菜单中选择提供方，并填写“API 密钥”；在“自定义设置”中点击“获取可用模型”：

4) 勾选要添加的模型，点击“添加所选”：

5) 点击“保存”：

6) 保存后，模型提供方配置就完成了，只要 API Key 对应的账号里有余额即可使用了：

一些好用/好玩的插件

下面整理了社区里一些好用、好玩的 DSH 插件，按用途分成功能增强与界面美化两类：

功能增强类

插件	链接	简介
DeepSeek Harness Desktop	https://github.com/anywhere-labs/deepseek-harness-desktop	开源桌面客户端，把 DSH 本地 Web UI 装进原生应用，集成系统托盘与桌面窗口，无需安装 Node.js 或执行命令。
DSH-Plugins-Marketplace	https://github.com/bradeGithub/DSH-Plugins-Marketplace	DSH 插件市场，在 Web GUI 中一键浏览、安装与更新 GitHub 上的 dsh-plugin，自动收录 3900+ 插件并带安全护栏。
ModLens	https://github.com/liustack/modlens	为纯文本模型（如 DeepSeek）外挂视觉能力，粘贴图片即得结构化 JSON 证据，零配置、支持多引擎故障转移。
dsh-genui	https://github.com/omdsh-dev/dsh-genui	在助手回复中内联渲染交互式 UI 组件，内置 30+ 组件、事件循环与面板持久化，让回复不只是文字。
DSH Vision Toolkit	https://github.com/Anionex/dsh-vision-toolkit	让纯文本模型具备看图能力，粘贴即用、内置免费视觉，支持意图问答、截图 OCR 与 UI 还原。
dsh-browser	https://github.com/Lum1104/dsh-browser	让 DSH 直接控制 Chrome 浏览器，无需视觉能力即可操作网页，保留登录态并对敏感信息做掩码。

界面美化类

插件	链接	简介
dsh-web-ui	https://github.com/zhu1090093659/dsh-web-ui	DSH Web GUI 的插件与皮肤集合，含任务看板、Git 图谱、右侧面板、移动端与皮肤中心等。
dsh-deep-whale	https://github.com/Small-tailqwq/dsh-deep-whale	DSH Web 鲸鱼娘主题皮肤系列（深海女仆工坊），双女仆背景、深海蓝蕾丝界面与 Q 版侧栏，CC BY-NC-SA 4.0。
DSH-Transparent-UI-Plugin（Aqua）	https://github.com/WYH66666666/DSH-Transparent-UI-Plugin	高自由度玻璃质感主题，顶栏/侧边栏/输入框变磨砂玻璃，模糊度、壁纸、背景亮度均可调，关掉即回原生界面。
dsh-TUI	https://github.com/ccch1mneyyy/dsh-TUI	Claude Code 风格终端界面插件，增强终端交互：鲸鱼顶栏、实时状态、流式思考、双击 Esc 回溯上下文。

DeepSeek Harness常见使用问题解答

1) 标准模式、PTC 模式这些都是什么？

标准模式，提供完整的工具组合；
PTC 模式，通过模型生成的一段代码组合多轮工具调用；
极简模式，仅保留一个 shell 工具与一个文件编辑工具，用于最小化环境下的模型基准测试；
创造模式，可以检查当前运行时、在内存中试验 Cordis 插件，并据此组合和创作新的模式。

2) 插件怎么安装？插件的 Github 页面一般会说明如何安装，如果没有网络条件访问该页面，直接把链接给模型，给出命令让模型安装即可。

总结

DeepSeek 自家出的 Agent 工具 dsh 已经能用了，按文章里的步骤简单弄一下，就能让它帮你读读仓库、跑跑任务，感兴趣的话现在就去试试吧 (｡•̀ᴗ-)✧