前置说明： DSH = DeepSeek Harness，一切皆插件开源 Agent 运行时，当前处于开发者预览版，社区插件爆发式增长、版本变动频繁，存在兼容性坑；所有插件本身开源免费，成本仅为你调用大模型 API 费用。

基础命令参考：

npx -y @deepseek-ai/dsh plugin add 插件包名
npx -y @deepseek-ai/dsh plugin list

一、核心能力插件（必看，生产力核心）

1. ModLens｜视觉读图插件⭐⭐⭐⭐⭐

作用：给 DeepSeek V4 Pro 纯文本模型增加识图、OCR 能力，粘贴截图 / 图片自动解析为结构化文本。 ✅ 优点

• 完美补齐原生短板：DSH 本体模型无法看图；
• 输出版面结构、表格文本、UI 布局，前端调试、识别截图报错、读取设计稿刚需；
• 支持外接 GLM-4V、Gemini、Claude 视觉接口，可选择本地 / 云端视觉推理。 ❌ 缺点
• 需要额外配置视觉 API Key，增加调用成本；
• 大图解析耗时较长，连续多张图片容易触发模型轮次溢出；
• 复杂手写体 OCR 准确率一般。 适合人群：前端开发者、经常传截图调试、产品看 UI 原型。

2. ModSearch｜增强联网检索插件⭐⭐⭐⭐

作用：替代内置简易搜索，接入 Tavily/Exa/Firecrawl，支持网页深度精读、批量读取页面。 ✅ 优点

• 内置搜索只适合简单问答；ModSearch 支持read_page完整抓取网页正文；
• 自动去重、标注信息来源，写调研报告、查技术文档可信度更高；
• 可开启 x_search 追踪海外社区动态（HackerNews、Github 讨论）。 ❌ 缺点
• 第三方搜索引擎额度需要单独购买；
• 长网页全文读取极易暴涨上下文 token；
• 部分动态 JS 渲染网页抓取不全。 适合人群：技术调研、竞品分析、文献资料搜集。

3. dsh-agent-teams｜多 Agent 团队插件⭐⭐⭐⭐

作用：单会话内自动生成多个子 Agent，任务拆分、分工协作、互相校验结果。 ✅ 优点

• 复杂工程任务自动分工：调研、编码、测试、文档分开执行；
• 子 Agent 之间消息互通，支持设置任务依赖；
• 大型项目显著降低单一 Agent 遗漏漏洞概率。 ❌ 缺点
• Token 消耗暴涨，长任务成本明显上升；
• 任务调度逻辑复杂，偶尔出现子任务循环卡死；
• 在低配电脑上运行延迟很高。 适合人群：大型软件开发、长文档撰写、系统性调研。

4. dsh-at-file｜文件快速引用插件⭐⭐⭐⭐⭐（入门首装）

作用：输入框支持 @文件名 直接定向引用本地文件，不用让 AI 全盘扫描工作区。 ✅ 优点

• 解决痛点：大型项目 DSH 遍历全部文件夹缓慢、容易引入无关代码污染上下文；
• 精准指定源码、配置文件，大幅节省 token；
• 和 dsh-files 文档插件完美兼容。 ❌ 缺点
• 不支持多级目录模糊匹配，需要准确路径；
• Windows 路径分隔符偶尔存在解析 bug。 适合人群：所有代码开发者，强烈推荐第一个安装。

5. dsh-files｜多格式文档解析插件⭐⭐⭐⭐

作用：原生增强文件读取，支持 PDF、docx、xlsx、md 分页解析。 ✅ 优点

• 内置工具仅支持文本文件，此插件解锁 Office/PDF；
• 自动识别表格、分段，批量读取资料做总结； ❌ 缺点
• 加密 PDF 无法解析；
• 超大 Excel 会截断内容；
• 读取扫描版 PDF 需要搭配 ModLens。

二、UI 交互类插件（改善操作体验）

1. dsh-web-ui｜Web 前端界面全家桶 ⭐⭐⭐⭐

作用：官方基础 WebUI 增强包，任务看板、会话管理、皮肤系统、鲸鱼桌宠。 ✅ 优点

• 提供可视化任务进度、Trajectory 完整执行链路追踪；
• 内置多款主题，支持移动端远程访问；
• 右下角鲸鱼桌宠，实时展示 Agent 思考状态。 ❌ 缺点
• 资源占用偏高；
• 部分第三方插件和自定义皮肤存在样式冲突；
• 重度使用浏览器内存持续上涨。

2. dsh-tui｜终端极简界面 ⭐⭐⭐

作用：纯命令行 TUI 界面，不需要浏览器，服务器无图形环境首选。 ✅ 优点

• 服务器部署、SSH 远程操作必备；
• 占用资源极低。 ❌ 缺点
• 不支持图片预览、拖拽交互；
• 新手交互门槛高。

3. dsh-genui｜动态交互式渲染插件 ⭐⭐⭐

作用：让模型输出直接渲染交互式组件（表格、按钮、简易表单）。 ✅ 优点

• 输出结果不再是纯 markdown，可以简单交互操作； ❌ 缺点
• 支持组件有限，自定义开发门槛高；
• 大量模型不擅长主动调用 UI 组件。

三、自动化 & 浏览器插件

AgentBrowser /browser-bridge｜浏览器自动化 ⭐⭐⭐⭐

作用：操控本地 Chrome，打开网页、点击、输入、抓取页面数据、截图。 ✅ 优点

• 实现完整线上自动化：爬取文档、网页测试、字幕抓取；
• 可配合 ModLens 对网页截图自检前端页面。 ❌ 缺点
• Windows 权限管控严格，容易出现浏览器启动失败；
• 网站反爬机制容易阻断执行；
• 连续自动化任务容易中途中断。 典型场景：自动抓取开源项目文档、网页功能自动化测试。

dsh-deep-research｜深度调研工作流插件 ⭐⭐⭐⭐

作用：封装自动化调研流程：拆解问题→多轮搜索→信息交叉验证→生成完整报告。 ✅ 优点

• 开箱即用调研模板，不用自己写复杂 prompt；
• 自动识别信息缺口，主动补充检索； ❌ 缺点
• 极度消耗 token；
• 调研深度很难精细调控，容易无限循环搜资料。

四、记忆 & 模型调度插件

claude-mem /dsh-persist-memory｜长期记忆插件 ⭐⭐⭐

作用：跨会话持久记忆项目信息，新开对话不用重复交代背景。 ✅ 优点

• 长期项目避免反复输入项目上下文； ❌ 缺点
• 记忆容易累积冗余信息，越用越容易产生幻觉；
• 没有智能遗忘机制，需要定期清理记忆库。

dsh-llm-router｜多模型调度插件 ⭐⭐⭐⭐

作用：一个 DSH 实例接入 DeepSeek、Claude、GPT、Gemini 多模型，根据任务自动路由。 ✅ 优点

• 灵活切换模型，推理任务用 DeepSeek，长文档用 Claude；
• 统一管理全部 API 密钥； ❌ 缺点
• 配置繁琐；不同模型工具调用格式存在兼容问题。

五、小众实验向插件（谨慎生产使用）

1. dsh-anchored-standard：伪装极简模式发起首次请求，社区传言提升 DeepSeek 模型推理质量；无官方验证，玄学插件，不推荐重度依赖。
2. dsh-lazyfish：摸鱼侧边栏、内嵌多媒体播放器，娱乐向。
3. PPT 生成插件：wanghong-handwritten-ppt，AI 直接输出 PPT 文件，排版能力中等。

综合分级推荐清单

✅ 新手优先安装（稳定、收益最高）

1. dsh-at-file
2. ModLens（如果你需要看图）
3. ModSearch（需要联网查资料）
4. dsh-web-ui

✅ 开发者进阶组合（软件开发 Agent）

dsh-at-file + ModSearch + AgentBrowser + dsh-agent-teams

✅ 调研 / 内容创作组合

ModSearch + dsh-deep-research + dsh-files

通用踩坑总结（非常重要）

1. 插件版本冲突：预览版迭代快，尽量锁定插件版本，不要无脑 latest；升级前备份配置。
2. 权限风险：DSH 插件拥有读写本地文件、执行 Shell 能力，不要随意安装不知名第三方插件。
3. Token 管控：多 Agent、持续网页精读、长期记忆插件会极大增加消耗，复杂任务建议设置轮次上限。
4. 模式冲突：Minimal 极简模式、标准模式、创造模式可用插件范围不同；部分插件仅支持标准模式。
5. Windows 兼容性弱于 Linux/macOS，路径、浏览器自动化更容易报错。

和 Claude Code 简单横向对比

DSH 优势：完全开源、插件自由组合、可切换任意大模型； 短板：生态较新，插件良莠不齐，需要自行搭配调试，开箱即用程度低于 Claude Code。

DeepSeek Harness 除核心能力之外的全类别功能插件测评

先界定范围：核心能力插件 = 文件读写、联网搜索、识图、多 Agent 团队、浏览器自动化；下文全部为辅助扩展插件，分为 UI 工作台增强、代码工程工具、数据与数据库、记忆 / 会话管理、模型调度优化、通知 & 生态互通、工作流 / 调试工具、创意多媒体、市场与迁移工具、实验小众插件十大类，附带实测优缺点、适用人群。

安装通用命令

npx -y @deepseek-ai/dsh plugin add [插件名]
# 指定配置文件
npx -y @deepseek-ai/dsh --profile web plugin add [插件名]

一、UI 工作台增强插件（提升操作体验，开发首选）

1. dsh-better-sidebar ⭐⭐⭐⭐⭐

作用：VSCode 风格一体化侧边工作台，文件树、内嵌终端、Git 面板、Diff 预览、内嵌浏览器、子 Agent 状态管理。 ✅ 优点

• 告别频繁切窗口；直接在 DSH 内浏览 / 编辑源码、执行 shell、查看代码变更
• 和 dsh-at-file 完美联动，点击文件一键 @引用 ❌ 缺点
• WebUI 内存占用上升；旧版主题存在样式冲突
• Windows 下内嵌终端偶尔出现编码乱码 适合：全职代码开发、长期本地项目调试

2. dsh-tui（终端 TUI）⭐⭐⭐⭐

作用：纯字符终端交互界面，无需浏览器，SSH 服务器专用 ✅ 优点：服务器无图形环境部署首选，资源占用极低 ❌ 缺点：不支持图片预览、拖拽、可视化组件；新手学习成本高 适合：Linux 服务器远程跑 DSH 自动化任务

3. dsh-web-ui（官方 WebUI 增强包）⭐⭐⭐⭐

作用：原生网页界面强化，任务看板、Token 实时统计、多主题、移动端适配、会话分组、鲸鱼桌宠 ✅ 优点：开箱即用，一站式美化基础界面 ❌ 缺点：自带组件较多，和第三方侧边栏插件容易冲突；不建议同时装 better-sidebar

4. dsh-genui / generate-ui ⭐⭐⭐

作用：支持模型直接输出交互式 HTML 卡片、表单、图表、Mermaid 渲染 ✅ 优点：回复不再只是 Markdown，可简单交互 ❌ 缺点：DeepSeek 模型不会主动调用，需要额外 Prompt 引导；自定义组件开发门槛高

二、代码工程 & Git / DevOps 工具插件

1. dsh-git-helper

作用：增强 Git 工具链，自动生成 commit 信息、分支管理、冲突辅助解决、仓库变更扫描 ✅ 优点：Agent 自动感知代码改动，推荐规范提交注释 ❌ 缺点：无法处理复杂合并冲突，仅辅助提示

2. dsh-docker-helper ⭐⭐⭐⭐

作用：让 Agent 操作 Docker，构建镜像、启动容器、查看日志、编写 Dockerfile/Compose ✅ 优点：后端运维、容器化项目刚需 ⚠️ 风险：授予容器操作权限，不要在公网不受控环境使用

3. dsh-lint-runner

作用：自动执行 ESLint、Prettier、PyLint 等静态检查，代码修改后自动校验错误 ✅ 优点：减少写出不合规范代码；自动收集报错交给 Agent 修复 ❌ 缺点：需要本地安装对应 lint 工具；大型项目扫描较慢

4. pi-deepseek-optimized（模型代码优化套件）⭐⭐⭐⭐

作用：一套优化模块：哈希行精准编辑、循环防卡死、缓存增强、工具调用错误修复 ✅ 优点：大幅降低 Agent 改代码 “大面积乱删” 问题，提升代码编辑稳定性 ❌ 缺点：仅针对 DeepSeek 系列模型生效，切换 Claude/GPT 后功能失效

三、数据库 & 数据处理插件

dsh-data-agent ⭐⭐⭐⭐

作用：数据库连接器，支持 MySQL / Postgres / SQLite / Oracle / Hive ✅ 优点：Agent 读取表结构、自然语言生成 SQL、执行查询、导出结果 ❌ 缺点

• 高危：默认支持 DML 写入操作，有删改数据风险
• 复杂多表关联查询容易写出低效 SQL 适合：数据分析、后台业务表调试；务必开启只读模式

四、会话、持久记忆、上下文管理插件

1. dsh-persist-memory / dsh-memory-evolve ⭐⭐⭐

作用：跨会话长期记忆，自动提取项目关键信息，新开对话自动加载背景 ✅ 优点：大型项目不用反复交代需求、架构背景 ❌ 缺点

• 长期累积冗余信息，容易产生幻觉、上下文污染
• 无自动遗忘机制，需要定期清理记忆库

2. context-vista ⭐⭐⭐⭐

作用：上下文 Token 可视化分析插件，查看哪些文件、对话占用大量 token ✅ 优点：排查会话超限、优化成本，定位臃肿引用 ❌ 缺点：只做监控，无法自动裁剪上下文

3. dsh-undo /rewind 快照插件

作用：基于 Git / 内存创建文件快照，Agent 改错代码一键回滚 ✅ 优点：避免 Agent 破坏性修改难以恢复 ❌ 缺点：依赖 Git 环境，未初始化 Git 目录下功能受限

五、模型调度、多模型路由插件

1. dsh-llm-router ⭐⭐⭐⭐

作用：统一管理多家模型 API（DeepSeek/Claude/Gemini/OpenAI/ 本地模型），按任务自动分发 示例：复杂编码→DeepSeek V4 Pro；长文档摘要→Claude；识图任务路由视觉模型 ✅ 优点：一套 DSH 实例自由切换模型 ❌ 缺点：配置繁琐；各家模型工具调用格式存在兼容性 Bug

2. dsh-local-llm-bridge

作用：对接 Ollama、LM Studio 本地大模型，离线运行 DSH Agent ✅ 优点：隐私优先、无外网调用成本 ❌ 缺点：本地模型工具调用能力普遍偏弱，复杂 Agent 任务容易失效

六、迁移、导入导出、生态互通插件

1. dsh-claude-move ⭐⭐⭐⭐

重磅实用插件：迁移 Claude Code 全部会话、记忆、CLAUDE.md、项目工作区，无缝把 Claude 工程迁移到 DSH 继续运行 ✅ 优点：从 Claude Code 转向 DSH 必备，不用重新搭建项目环境 ❌ 缺点：部分私有 Skill 无法迁移；大会话导入耗时较长

2. dsh-obsidian-export

作用：对话、方案、代码成果一键导出至 Obsidian 知识库 适合：知识沉淀、长期项目文档管理

3. dsh-share

作用：一键生成会话分享链接，共享完整 Agent 对话轨迹

七、通知、机器人联动插件（自动化告警）

• dsh-notification：任务完成、报错触发系统桌面通知
• dsh-lark /dsh-qqbot：任务结果推送飞书 / QQ ✅ 适合：长时间后台自动化任务，不用一直盯着页面 ❌ 缺点：需要配置机器人 Token；第三方 IM 插件更新不稳定

八、工作流、调试、回放工具

1. dsh-record-replay

作用：录制你手动执行的操作序列，Agent 自动复现操作流程 ✅ 优点：录制操作模板，重复任务自动化 ❌ 缺点：环境变动后录制脚本容易失效

2. dsh-sentinel / dsh-loop-enhance

作用：增强 Agent 主循环，支持定时任务、文件变动触发、Webhook 唤醒 Agent ✅ 优点：实现持续运行的自动化 Agent ⚠️ 注意：长时间循环极易消耗大量 API 额度，建议设置执行上限

九、创意、设计多媒体插件

1. dsh-openpencil / iPolloWork

作用：内置交互式画布，Agent 直接绘制流程图、简易 UI 草图，不只生成图片 ✅ 优点：产品原型、架构草图协作 ❌ 缺点：画布功能偏基础，无法替代 Figma

2. ppt-generator（wanghong-handwritten-ppt）

作用：直接生成 .pptx 文件 ✅ 优点：快速产出汇报初稿 ❌ 缺点：自动排版比较朴素，重度 PPT 仍需要手动微调

十、辅助基础设施类插件

1. dsh-market ⭐⭐⭐⭐（强烈推荐优先安装）

作用：DSH 图形化插件市场，类似 VSCode 扩展商店 ✅ 优点：界面搜索、一键安装、更新、卸载插件，不用记忆命令行 ❌ 缺点：社区插件鱼龙混杂，注意甄别不知名第三方插件安全风险

2. sandbox-enhance 沙箱增强插件

作用：限制 Shell / 文件操作权限，降低 Agent 误删文件风险 ✅ 优点：生产环境提升安全；多人共用 DSH 必装 ❌ 缺点：过严格策略会导致正常任务执行失败

分级安装推荐清单

✅ 高性价比、稳定优先安装

1. dsh-market（插件管理器）
2. dsh-better-sidebar（开发工作台）
3. context-vista（上下文监控）
4. pi-deepseek-optimized（代码优化）
5. dsh-llm-router（多模型调度，如果你有多套 API）

✅ 运维 / 数据方向补充

dsh-docker-helper + dsh-data-agent（务必开启数据库只读）

✅ 自动化 / 后台任务补充

dsh-notification + dsh-sentinel

⚠️ 谨慎安装（实验性、有明显短板）

长期记忆插件、dsh-genui、各类 IM 机器人插件；不建议一次性全部加载，插件越多越容易出现加载冲突。

通用避坑要点

1. 插件冲突大户：dsh-web-ui 和 dsh-better-sidebar 不要同时启用；
2. 权限红线：数据库、Docker、Shell 相关插件，尽量限制工作目录、开启只读；
3. 性能问题：UI 类插件大幅增加浏览器内存占用，长时间运行建议定期重启 DSH；
4. 版本策略：预览版迭代快，重要配置环境锁定插件版本，不要持续拉 latest。