DeepSeek Harness 插件生态搜索与使用指南
289 个社区插件 · 11 大分类 · 从搜索到安装的完整教程
一、插件生态全景:289 个插件 11 大分类
DeepSeek Harness(DSH)于 2026 年 8 月 13 日以 MIT 协议开源发布,核心理念是"万物皆插件"——模型适配器、工具注册表、会话日志甚至 Agent 循环本身都是可替换插件。正因为官方只提供了一个"裸界面",社区插件生态在发布后几天内就爆发了[1]。
据 2026-08-17 目录快照,社区插件目录(DSH 插件库)共收录 289 个插件,横跨 11 大分类,涵盖从界面美化到开发工具、从视觉能力到记忆系统的全链路增强[1]。以下是各分类的插件数量分布:
去哪搜索? 社区插件目录(DSH 插件库)地址:deepseek-harness-plugin.com。可以按名称、维护者或关键词搜索,也可按功能分类筛选并根据星标、名称或收录时间排序[1]。
二、热门插件 TOP 20 速览
以下按社区星标数从高到低排列,是 DSH 生态中最受欢迎的 20 个插件[1]:
三、五大实用插件深度详解
以下五个插件来自社区博客推荐,覆盖视觉、界面、终端、交互渲染、工作台五大场景,互不冲突,全装也无问题[2]。
DeepSeek 和 GLM 的旗舰聊天模型是纯文本模型,原生无法读图。ModLens 是一个即插即用的视觉引擎[2]:
- 直接粘贴识图:图片粘进对话框即可,不用先存文件再传路径
- 提供原生
modlens_read_image工具,输出结构化 JSON 证据(OCR、版面、语义) - 自动发现所有搭载纯文本 DeepSeek/GLM 模型的路由,在模型选择器里生成
(modlens vision)变体 - 视觉引擎可复用本机已有的 Claude Code、Codex、OpenCode 等登录态,也可配置免费的 Gemini API key 或任意 OpenAI 兼容端点
npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modlens@3.18.3
注意:官方刻意锁定版本号而不是用 @latest——因为 pnpm 11 会拦截发布不足 24 小时的版本,@latest 实际装到的可能是一天前的旧版。更新时用同一条命令换个新版本号即可[2]。
装完后,在模型选择器里选带 (modlens vision) 后缀的模型变体,直接粘贴图片提问即可。引擎配置存放在 ~/.modlens 目录[2]。
常贴截图、看 UI、需要 OCR 的人。
DSH 官方 Web 界面比较朴素,dsh-web-ui 是把它变成"完整产品"的捷径——一个聚合包一次装齐[2]:
- 任务看板(task-board):多列看板视图管理 Agent 任务
- Git 图谱(git-graph):可视化提交历史
- 右侧面板与移动端远程访问(remote-web-ui):手机上也能盯长任务
- 实时 Token 统计(live-stats)
- 鲸鱼娘电子宠物(pet)与皮肤中心(skin-center)
- 外挂了
dsh-better-sidebar侧栏插件与皮肤全家桶
dsh plugin add github:zhu1090093659/dsh-web-ui
# 如需可复现安装,可固定 commit 哈希:
dsh plugin add github:zhu1090093659/dsh-web-ui#<commit>
重度使用 dsh web 的人,想要一站式界面增强。
默认情况下模型回复就是一堆 Markdown,碰上数据对比、流程图、表单这类内容,纯文字很费眼。dsh-genui 让模型直接在回复里渲染可交互的 UI 组件[2]:
- 模型把界面描述写成一种叫
dsh-uifence 的特殊代码围栏,浏览器端解析渲染成真实组件 - 支持 30+ 种组件:卡片、表格、图表、表单、标签页、文件树、时间线、Diff 对比、Mermaid 流程图、3D 场景
- 事件闭环:点按钮、提交表单的操作会回传给模型,模型基于你的操作继续回复——不只是"渲染",而是真正的"交互"
- 组件白名单 + 规格校验,写坏的图表不会上屏;0.7.2 起支持流式渲染
dsh plugin --profile web add git+https://github.com/omdsh-dev/dsh-genui.git
# 也可以使用 npm 包形式:
npx -y @deepseek-ai/dsh plugin --profile web add @omdsh-dev/dsh-genui
装完重启 dsh web 并硬刷新页面(Ctrl + Shift + R),新建会话后直接说"用 dsh-ui 做一个项目进度看板,包含统计卡、风险表和可点击筛选"即可体验[2]。
做数据分析、演示、教学的人,想要更直观的交互式输出。
目前 DSH 生态里最火的界面增强插件之一,一个插件装出一套完整工作台[2]:
- 右侧栏 + 底部面板双工作区,支持拖拽重排 Tab 和分栏
- 内置文件管理、CodeMirror 编辑与预览(Office 三件套 / PDF / 图片 / Markdown 内联预览)
- 沙箱内嵌浏览器、xterm + node-pty 真实终端
- Git 面板与后台任务 / 子代理状态页
- 服务化基座:从 v0.4.0 起暴露
ctx.betterSidebar服务,第三方插件可以注册自己的侧边栏 Tab 和文件预览器 - 重依赖按需分块加载,启动只拉约 325 KB 核心;适配窄屏,中英双语
已装好 DSH(dsh web 能正常运行)、Node.js ≥ 20、pnpm ≥ 10[2]。
dsh plugin --profile web add dsh-better-sidebar@latest
# 如果系统里没有全局 dsh 命令:
npx -y --package @deepseek-ai/dsh dsh plugin --profile web add dsh-better-sidebar@latest
装完硬刷新浏览器(Ctrl + Shift + R)即可看到侧边栏——DSH 对 client 端改动支持热加载,无需重启;只有 host 半更新时才需要重启 DSH[2]。
想要 VS Code 式体验的所有人。
deepTide 虽然打着 dsh-plugin 的 GitHub 标签、也被多个 DSH 插件目录收录,但它严格来说不是一个挂载进 DSH Web 的插件,而是一套独立运行的跨平台终端 AI 编程 Agent——名字取自 DeepSeek + tide(terminal IDE),口号是"Built by DeepSeek, for DeepSeek"。装它不会出现在你的 DSH 插件列表里,而是给你一套独立的命令行工具[2]。
| 形态 | 平台 | 特点 |
|---|---|---|
| DeepTide for macOS | macOS 15+ | Swift 6 原生应用,空闲仅约 15 MB 内存 |
DeepTide CLI(deeptide / tide) | Linux / Windows / macOS | 基于 Bun 的跨平台终端 CLI,插件生态最丰富 |
DeepTide CLI Rust(deeptide-rs) | 跨平台 | 原生 Rust 单二进制,约 10 MB,适合 CI 和老机器 |
macOS(推荐,原生版本)
curl -fsSL https://deeptide.sh/install.sh | sh
Linux / Windows(CLI 版本,需先装好 Bun)
bun add -g deeptide # 推荐,安装最快
# 或
npm install -g deeptide # 运行时仍需要 Bun
# 或
pnpm add -g deeptide
装完后会获得 deeptide 和 tide 两个命令,常用流程:
tide auth login # Paean OAuth 登录
tide login # 或直接保存 DeepSeek API key
tide # 启动交互式 REPL
tide doctor # 诊断安装与网络
习惯 Claude Code / Codex CLI 那种终端工作流、又主要用 DeepSeek 模型的人。如果你只想增强 DSH 的 Web 界面,则不需要装它[2]。
五大插件总结对比
| 插件 | 类型 | 解决什么问题 | 适合谁 |
|---|---|---|---|
| ModLens | 视觉能力 | 纯文本 DeepSeek/GLM 模型读图、OCR、UI 理解 | 常贴截图、看 UI、需要 OCR 的人 |
| dsh-web-ui | 界面全家桶 | 任务看板、Git 图谱、皮肤、移动端远程等一站式界面增强 | 重度使用 dsh web 的人 |
| dsh-genui | 交互渲染 | 回复内嵌图表、表单、Mermaid、3D 等可交互组件 | 做数据分析、演示、教学的人 |
| DSH-better-sidebar | 侧边栏工作台 | 文件、终端、Git、内嵌浏览器、子代理一站式工作台 | 想要 VS Code 式体验的所有人 |
| deepTide | 独立终端 Agent | 在终端里用 DeepSeek 模型做 AI 编程 | 习惯 Claude Code 式 CLI 工作流的人 |
推荐安装顺序:先装 dsh-web-ui 把界面搞舒服 → 再装 ModLens 补上视觉短板 → DSH-better-sidebar 提供工作台 → dsh-genui 锦上添花 → deepTide 则看你爱不爱终端[2]。
四、浏览器操作插件专题
你在对话中提到"如何让 DeepSeek Harness 可以操作浏览器",以下是与浏览器操作直接相关的插件:
浏览器操作方案对比
| 方案 | 原理 | 需要视觉能力 | 适合场景 |
|---|---|---|---|
| dsh-browser | Chrome 扩展 API 直接控制浏览器 | 否 | 自动化网页操作(填表、点击、截图) |
| DSH-better-sidebar 内嵌浏览器 | DSH Web 侧边栏沙箱浏览器 | 否 | 边对话边浏览,Agent 上下文联动 |
| agent-vision-toolkit | 视觉识别 + GUI 自动化 | 是(自带视觉链路) | 需要"看"屏幕并操作 UI 的场景 |
| dsh-vision-router | 免费视觉链路 + 像素级工具 | 是(免费内置) | 无需密钥的轻量视觉+UI 操作 |
最快上手浏览器操作:如果你只是想让 DSH 能操控浏览器做自动化,dsh-browser 是最直接的选择——它是 Chrome 扩展,不需要视觉能力,通过扩展 API 直接操作页面。安装方法:dsh plugin --profile web add dsh-browser,然后在 Chrome 中加载扩展即可。
五、插件安装与管理完全指南
5.1 安装前的准备工作
无论装哪个插件,都建议先确认以下环境[2]:
确认 Node.js 版本
Node.js ≥ 18(部分插件要求 ≥ 20)。检查方法:
node --version
安装 DSH 本体
如果还没安装:
npm install -g @deepseek-ai/dsh
并设置 DEEPSEEK_API_KEY 环境变量。
先跑一次 dsh web
让它初始化 ~/.dsh/profiles/web 这个 profile 目录,否则安装插件时会报"找不到 profile 目录"。
dsh web
确保 pnpm 可用
DSH 的插件命令底层交给 pnpm 处理。遇到 pnpm not found,通常运行 corepack enable 后重开终端即可。
corepack enable
pnpm --version
5.2 通用安装命令格式
# npm 包形式
dsh plugin --profile web add <npm包名>
# GitHub 源码形式
dsh plugin --profile web add git+https://github.com/<作者>/<仓库>.git
# GitHub 简写形式
dsh plugin add github:<作者>/<仓库>
# 固定 commit 哈希(可复现安装)
dsh plugin add github:<作者>/<仓库>#<commit>
安全提醒:插件以当前 dsh 进程的权限运行,安装时可能执行代码。安装第三方插件前请检查源码仓库和许可证;如需可复现安装,建议固定 commit 哈希[2]。
5.3 装完后的验证与管理命令
# 查看已安装插件列表
dsh plugin --profile web list
# 确认插件是否进入最终配置
dsh --profile web --dump-config
# 卸载插件
dsh plugin --profile web remove <插件名>
# 更新插件(重新安装同包的新版本即可)
dsh plugin --profile web add <插件名>@latest
5.4 命令速查卡
| 操作 | 命令 | 说明 |
|---|---|---|
| 安装(npm) | dsh plugin --profile web add <包名> | 从 npm registry 安装 |
| 安装(GitHub) | dsh plugin add github:<作者>/<仓库> | 从 GitHub 仓库安装 |
| 安装(固定版本) | dsh plugin --profile web add <包名>@<版本号> | 锁定版本避免自动升级 |
| 查看已装 | dsh plugin --profile web list | 列出当前 profile 下所有插件 |
| 导出配置 | dsh --profile web --dump-config | 查看最终生效配置 |
| 卸载 | dsh plugin --profile web remove <包名> | 移除插件 |
| 启动 Web | dsh web | 启动 Web 界面(默认 127.0.0.1:3080) |
| 硬刷新 | Ctrl + Shift + R | 装完界面类插件后刷新浏览器 |
六、常见问题速查表
| 现象 | 原因与解决 |
|---|---|
报 Ignored build scripts |
pnpm 11 拦截了构建脚本。在 ~/.dsh/profiles/web 下运行 pnpm approve-builds --all |
报 minimum release age / 版本不足 24h |
等 24 小时或重跑一次,pnpm 会自动补排除项 |
| 找不到 profile 目录 | 先跑一次 dsh web 完成初始化 |
| 页面出现两个侧边栏 | 双挂载:删掉 ~/.dsh/profiles/web/cordis.patch.yml 里残留的手动挂载行 |
| Windows 下终端无法使用 | node-pty 需要预编译二进制,缺产物时需装 VS Build Tools 编译工具链 |
| 终端提示 node-pty 加载失败 | 在 ~/.dsh/profiles/web 下执行 pnpm approve-builds --all && pnpm rebuild node-pty,重启 DSH |
PowerShell 执行策略阻止 pnpm.ps1 |
运行 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser 并确认 Y,或使用 pnpm.cmd 替代 |
pnpm: command not found |
运行 corepack enable 激活 pnpm,重开终端 |
| 前端 dist 未构建错误 | 在项目根目录运行 pnpm run build 生成 dist 和 lib 文件后再 dsh web |
| 插件装完没效果 | 硬刷新浏览器(Ctrl + Shift + R);如果改了 host 半需要重启 dsh web |
最后提醒:DSH 目前仍是 developer preview(官方明确说"会有破坏性变更"),插件迭代极快,装完过几天跟着升一次级属于常态。安装命令中的版本号以各仓库 README 最新说明为准[2]。
「A0清风远技术服务」
技术交流 · 反馈
个人观点,仅供参考,如有不对之处,请多包涵,欢迎指出。本文由AI协助完成!
欢迎扫码关注公众号与作者微信,获取更多实用干货

