DeepSeek Harness 是 DeepSeek 开源、基于一切皆插件架构的 Agent 运行框架,不用复杂开发,靠插件自由组合就能搭建专属 Agent 工作台,下面整理的 10 款高频插件覆盖搜索、代码、终端、子代理、UI 增强、备份、语音等场景,新手跟着流程从环境准备、启动 Web 服务、配置 API Key、安装插件到调试闭环,就能快速跑通 Agent 工作流。很多新手上来直接装一堆插件,出现依赖冲突、权限报错、模型调用失败,或是不知道插件之间怎么搭配;先装好 Node.js 环境,优先部署插件市场插件,再按需分批安装,先跑通基础 Agent,再叠加子代理、沙盒、搜索能力,同时做好权限管控,不要随便给陌生插件全开本地执行权限,就能稳定使用。下面分插件清单、工作台搭建步骤、插件搭配方案、避坑要点拆开讲清楚。
一、10 款超实用插件详情表
| 插件名称 | 核心作用 | 适合场景 |
|---|---|---|
| dsh-market 插件市场 | 内置可视化插件商店,一键搜索、安装、更新社区插件,自带备份还原 | 新手必装,统一管理所有插件 |
| Web Search 网页搜索插件 | 联网检索网页、抓取内容,返回带来源引用的资料 | 调研、查证、文献搜集、实时信息查询 |
| Terminal 终端插件 | 在沙盒内执行 Shell 脚本、命令,查看执行输出 | 代码调试、批量文件处理、脚本自动化 |
| Subagent 子代理插件 | 拆分复杂任务,自动生成多个子 Agent 分工并行执行 | 复杂推理、多步骤评测、大型项目拆解 |
| dsh-backup 备份插件 | 一键备份、迁移、恢复会话、插件配置、密钥,支持换机迁移 | 长期使用、版本升级、多设备同步 |
| Voice Input 语音输入插件 | Alt 快捷键语音转文字,支持本地语音识别 | 不想打字、快速口述需求 |
| dsh-better-sidebar 侧边栏增强 | 扩展侧边面板,内置文件编辑、Git、终端、子代理视图 | 代码项目管理、多视图工作台 |
| Modlens 视觉识图插件 | 给纯文本模型增加图片解析、截图理解能力 | 图文问答、截图分析、图表识别 |
| Scheduled Tasks 定时任务插件 | 配置定时触发 Agent 任务,后台持续运行、跟踪进度 | 定时数据拉取、日报生成、巡检脚本 |
| Archify 架构图插件 | 自动生成 Mermaid 流程图、时序图、架构图,可直接渲染 | 方案设计、技术文档、架构梳理 |
二、DeepSeek Harness 工作台搭建全流程
步骤 1:环境准备
需要安装 Node.js(推荐 20 及以上版本),Windows、macOS、Linux 都支持;也可以直接下载官方桌面客户端,跳过命令行环境配置。
- 验证环境:终端输入 node -v 确认版本正常
步骤 2:启动 Web 工作台
两种方式任选其一
- npx 一键启动(最简单)
npx @deepseek-ai/dsh web
启动成功后浏览器访问 http://127.0.0.1:3080
2. 源码部署(适合二次开发)
git clone https://github.com/deepseek-ai/deepseek-harness
cd deepseek-harness
pnpm install
pnpm dsh web
步骤 3:配置模型 API Key
打开 Web 界面设置页,填入 DeepSeek 开放平台 API Key,兼容 OpenAI 协议网关,也可以接入其他第三方模型;没有密钥会无法调用大模型,Agent 不能正常推理。
步骤 4:优先安装 dsh-market 插件市场
在控制台执行插件安装命令,装好之后重启服务,界面出现插件市场入口,后续所有插件都可以在 UI 里面搜索安装,不用手动敲命令。
dsh plugin --profile web add dshmarket
步骤 5:分批安装目标插件
不要一次性全部安装,建议顺序:插件市场 → 搜索 + 终端 → 子代理 → 备份 → UI 增强 → 语音、定时、识图、绘图插件;每装 1-2 个插件重启一次 Web 服务,排查冲突。
步骤 6:权限与沙盒配置
Terminal 终端插件默认沙盒隔离,不要随意关闭沙盒;设置插件执行白名单,限制高危命令;陌生社区插件先看源码、评价,再安装。
步骤 7:测试闭环
搭建完成后发起测试任务:比如 “搜索最新技术资料,整理文档,生成架构图”,验证搜索、子代理、绘图插件联动是否正常,查看轨迹日志,定位调用失败问题。
三、插件搭配推荐方案
- 调研阅读组合:Web Search + Archify + dsh-backup
- 代码开发组合:Terminal + Subagent + dsh-better-sidebar
- 轻量化日常 Agent:Voice Input + dsh-market + Modlens
- 自动化定时任务:Scheduled Tasks + Terminal + Web Search
四、工作台使用避坑清单
- 插件版本不匹配:预览版迭代快,尽量在插件市场安装适配当前 DSH 版本的插件
- 密钥泄露风险:备份插件支持密钥脱敏备份,不要直接导出明文配置分享
- 终端插件安全:沙盒之外的命令有本地文件读写风险,不要交给不受信任的 Agent 执行高危指令
- 上下文过载:同时开启太多插件会快速消耗上下文,任务复杂时用 Subagent 拆分任务
- 端口占用:默认 3080 端口被占用,可以启动时指定端口:pnpm dsh web --port 3083
【相关 FAQ】
问题 1:Agent 玩家搭建 DeepSeek Harness 工作台,10 款插件里面优先安装哪一个,dsh-market 插件有什么用?
回答 1:Agent 玩家搭建 DeepSeek Harness 工作台优先安装 dsh-market 插件市场,dsh-market 是可视化插件商店,支持在界面搜索、一键安装、更新社区插件,还能备份、还原整套工作台配置,是管理其余插件的基础入口。
问题 2:DeepSeek Harness 工作台搭建,npx 启动和源码部署有什么区别,新手选哪个?
回答 2:DeepSeek Harness 工作台 npx 启动不用下载源码,一条命令拉起 Web 界面,上手简单,适合 Agent 玩家直接体验;源码部署适合想要修改内核、自定义开发插件的用户,需要手动管理依赖,新手优先 npx 方式。
问题 3:DeepSeek Harness 的 Subagent 子代理插件适合什么场景,和 Terminal 终端插件能不能一起搭配使用?
回答 3:DeepSeek Harness 的 Subagent 子代理插件适合复杂任务拆解、多任务并行评测、大型项目分步处理;可以和 Terminal 终端插件搭配,子代理分工之后,各个子 Agent 调用终端执行脚本,适合批量自动化工作流。
问题 4:安装 DeepSeek Harness 第三方社区插件,有哪些安全注意事项?
回答 4:安装 DeepSeek Harness 第三方社区插件,优先从官方插件市场选择高评分插件;Terminal 终端插件开启沙盒隔离,不要随便关闭沙盒;不安装来源不明的插件,避免本地文件读取、命令执行带来的安全风险。
【参考资料】
[2026-10-27](保姆级改造教程:DeepSeek Harness 十大必装插件,搭建属于你的 AI 工作台)阿里云开发者社区
[2026-10-12](DeepSeek Harness 官方文档、插件架构介绍)DeepSeek 官网
[2026-10-06](DSH 插件市场使用指南、插件安装命令)DSH 插件商店
[2026-09-18](DeepSeek Harness npx 启动、源码部署步骤)GitHub 仓库文档
[2026-08-22](DeepSeek Harness 沙盒、终端插件安全说明)DeepSeek 安全白皮书
【免责声明】
本文整理的 DeepSeek Harness 插件清单、工作台搭建流程仅为开源 Agent 工具的玩家实践参考;DeepSeek Harness 处于开发者预览版,插件生态持续迭代,插件兼容性、安装命令、功能可能随版本变动;终端插件具备本地命令执行能力,使用时务必做好沙盒与权限管控,不要执行未知脚本;本文不构成开发部署保障,遇到插件报错、启动异常可查阅官方 GitHub 仓库与社区插件市场说明。
