DeepSeek Harness五大实用插件作用及安装教程详解

时间：2026-08-20 18:16

引言 DeepSeek Harness（简称DSH）是 DeepSeek 官方开源的 Agent 运行时（harness），于2026年8月13日正式发布，采用 MIT 开源协议。它的核心设计理念是“万物皆插件”：无论是模型适配器、工具注册表、会话日志，还是 Agent 循环本身，都可以作为可替换插

引言

DeepSeek Harness（简称DSH）是 DeepSeek 官方开源的 Agent 运行时（harness），于2026年8月13日正式发布，采用 MIT 开源协议。它的核心设计理念是“万物皆插件”：无论是模型适配器、工具注册表、会话日志，还是 Agent 循环本身，都可以作为可替换插件存在，底层则基于 Cordis 插件框架构建。DSH 默认以本地 Web 应用形式运行，访问地址为https://127.0.0.1:3080，目前官方并未提供原生终端界面[¹][²]。

DeepSeek Harness五大实用插件：作用与安装方法详解

也正因为官方目前只提供了一个相对“裸”的基础界面，DeepSeek Harness 插件生态在发布后的短时间内迅速爆发。本文精选了五个社区中最常被推荐、同时也最容易安装出错的 DSH 插件，逐一说明它们有什么作用以及具体怎么安装，帮助你快速完成 DeepSeek Harness 插件配置。

安装前的准备工作

无论你准备安装哪个 DeepSeek Harness 插件，建议先检查并完成以下环境准备：

Node.js ≥ 18（部分插件要求 ≥ 20）：可通过 node --version 检查当前版本[²]。
安装 DSH 本体：执行 npm install -g @deepseek-ai/dsh，并提前配置好 DEEPSEEK_API_KEY 环境变量[²]。
先运行一次 dsh web：让程序初始化 ~/.dsh/profiles/web 这个 profile 目录，否则后续安装插件时通常会提示“找不到 profile 目录”[³]。
确保 pnpm 可用：DSH 的插件安装命令底层由 pnpm 处理。如果遇到 pnpm not found，通常执行 corepack enable 后重新打开终端即可恢复[⁴]。

DSH 插件安装的通用命令格式如下：

# npm 包形式
dsh plugin --profile web add 
# GitHub 源码形式
dsh plugin --profile web add git+https://github.com/<作者>/<仓库>.git

安装完成后，可以通过 dsh plugin --profile web list 查看已安装的插件依赖，再通过 dsh --profile web --dump-config 检查插件是否已经写入最终配置[⁴]。

安全提醒：DSH 插件会以当前 dsh 进程权限运行，安装过程中也可能执行代码。安装第三方插件前，务必检查源码仓库、作者信息和许可证；如果你希望实现可复现安装，建议固定 commit 哈希[⁵]。

一、ModLens：给纯文本模型装上"眼睛"（视觉插件）

你提到的"MOALENS"实际名称是 ModLens，对应仓库为 liustack/modlens，其定位是“全网最强 DeepSeek Harness 外挂视觉插件”[⁶][⁷]。

作用

DeepSeek 和 GLM 的旗舰聊天模型本质上是纯文本模型，原生并不具备图像识别能力。ModLens 作为一个即插即用的视觉插件，主要提供以下能力[⁶]：

直接粘贴图片识图：可将图片直接粘贴到对话框中，无需先保存文件再输入路径；
提供原生 modlens_read_image 工具，可输出结构化 JSON 证据，包括 OCR、版面分析和语义信息；
自动发现所有使用纯文本 DeepSeek/GLM 模型的路由，并在模型选择器中生成 (modlens vision) 变体（如 DeepSeek-V4-Flash (modlens vision)）；选中后粘贴图片时，缩略图会保留在消息中，整体体验接近 Codex；
视觉引擎可复用本机已有的 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 实际安装到的可能仍是前一天的旧版本。后续更新时，直接在同一条命令中替换版本号即可[⁶]。

安装完成后，在模型选择器中选择带有 (modlens vision) 后缀的模型变体，即可直接粘贴图片进行提问。相关引擎配置默认保存在 ~/.modlens 目录中[⁸]。

二、dsh-web-ui：Web 界面"全家桶"

作用

DSH 官方 Web 界面整体偏简洁，dsh-web-ui（仓库 zhu1090093659/dsh-web-ui，Apache-2.0 协议）可以理解为把 DeepSeek Harness Web 界面快速升级为“完整产品”的一条捷径——通过一个聚合包一次性安装多项界面增强功能[⁵]：

任务看板（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#[⁵]。

三、deepTide：独立运行的终端 AI 编程助手

特别说明：deepTide（仓库 paean-ai/deeptide）虽然带有 dsh-plugin 的 GitHub 标签，也被不少 DSH 插件目录收录，但从严格意义上说，它并不是一个挂载到 DSH Web 中的插件，而是一套独立运行的跨平台终端 AI 编程 Agent。它的名称来自 DeepSeek + tide（terminal IDE），口号是“Built by DeepSeek, for DeepSeek”。安装 deepTide 后，它不会出现在你的 DSH 插件列表中，而是为你提供一套独立的命令行工具[¹⁰][¹¹]。

作用

deepTide 目前主要提供三种形态[¹¹]：

形态	平台	特点
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 和老旧设备

其核心使用方式是终端中的交互式 REPL：登录后进入代码仓库目录，直接与 Agent 对话并让其读写代码；同时也支持类似 tide -p "explain this repo" 这样的一次性命令模式[¹¹]。

安装方法

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 模型进行 AI 编程的人。如果你的目标只是增强 DSH 的 Web 界面，那么其实不必安装它。

四、dsh-genui：让回答里"长出"可交互界面

作用

在默认情况下，模型回复通常只是一段 Markdown 文本。遇到数据对比、流程展示、表单填写这类内容时，纯文字阅读和操作体验往往较差。dsh-genui（仓库 omdsh-dev/dsh-genui，MIT 协议）可以让模型直接在回复中渲染可交互的 UI 组件[¹²][¹³]：

原理：模型将界面描述写成名为 dsh-ui fence 的特殊代码围栏，浏览器端再解析并渲染成真实组件；
支持 30+ 类组件：包括卡片、表格、图表、表单、标签页、文件树、时间线、Diff 对比、Mermaid 流程图、测验题，甚至 3D 场景；函数曲线还支持拖动滑块实时重绘；
事件闭环：点击按钮、提交表单等操作会回传给模型，模型再基于你的操作继续生成回复——不仅能“渲染”，还能够“交互”；
具备组件白名单与规格校验机制，配置错误的图表不会直接渲染到页面；从 0.7.2 起还支持流式渲染，组件会随着模型输出实时出现[¹²][¹³]。

安装方法

dsh plugin --profile web add git+https://github.com/omdsh-dev/dsh-genui.git

也可以选择 npm 包方式安装（@omdsh-dev/dsh-genui）[¹⁴]：

npx -y @deepseek-ai/dsh plugin --profile web add @omdsh-dev/dsh-genui

安装完成后，记得重启 dsh web 并硬刷新页面（Cmd/Ctrl + Shift + R）。然后新建会话，直接输入“用 dsh-ui 做一个项目进度看板，包含统计卡、风险表和可点击筛选”，即可快速体验其交互式界面生成能力[¹³]。

五、DSH-better-sidebar：VS Code 风格的侧边栏工作台

作用

DSH-better-sidebar（仓库 omdsh-dev/DSH-better-sidebar）是当前 DSH 生态中热度很高的界面增强插件之一，安装一个插件就能获得接近完整 IDE 工作台的体验[³][¹⁵]：

右侧栏 + 底部面板双工作区，支持 Tab 拖拽重排和分栏布局；
内置文件管理、CodeMirror 编辑与预览（Office 三件套 / PDF / 图片 / Markdown 内联预览）、沙箱内嵌浏览器、xterm + node-pty 真实终端、Git 面板以及后台任务 / 子代&理状态页；
服务化基座：从 v0.4.0 起暴露 ctx.betterSidebar 服务，第三方插件可以注册自己的侧边栏 Tab 与文件预览器（例如划词提问插件 dsh-sidebar-qa 就依赖它）；
重依赖采用按需分块加载，启动阶段仅拉取约 325 KB 核心资源；同时适配窄屏场景，并支持中英双语[³][¹⁶]。

安装方法

前置条件：已经安装好 DSH（即 dsh web 能正常启动）、Node.js ≥ 20、pnpm ≥ 10[³]。

dsh plugin --profile web add dsh-better-sidebar@latest

安装完成后，直接硬刷新浏览器（Cmd/Ctrl + Shift + R）即可看到新的侧边栏工作区——DSH 对 client 端改动支持热加载，因此通常无需重启；只有涉及 host 半更新时，才需要重新启动 DSH。插件更新同样使用这一条命令即可[³]。

如果当前系统中没有全局 dsh 命令，也可以使用：

npx -y --package @deepseek-ai/dsh dsh plugin --profile web add dsh-better-sidebar@latest

常见问题速查

现象	原因与解决
报 `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

（以上内容整理自官方 README 的常见问题说明表。）

总结：一张表看清五个插件

插件	类型	解决什么问题	适合谁	安装命令
ModLens	视觉能力	让纯文本 DeepSeek/GLM 模型具备读图、OCR、UI 理解能力	经常贴截图、分析界面、需要 OCR 识别的人	`npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modlens@3.18.3`
dsh-web-ui	界面全家桶	任务看板、Git 图谱、皮肤、移动端远程等一站式 Web 界面增强	重度使用 dsh web 的用户	`dsh plugin add github:zhu1090093659/dsh-web-ui`
deepTide	独立终端 Agent（非 DSH 内插件）	在终端中使用 DeepSeek 模型完成 AI 编程与代码操作	习惯 Claude Code 风格 CLI 工作流的人	`npm install -g deeptide`（macOS 推荐 `curl -fsSL https://deeptide.sh/install.sh \| sh`）
dsh-genui	交互渲染	在回复中嵌入图表、表单、Mermaid、3D 等可交互组件	适合数据分析、演示展示、教学场景用户	`dsh plugin --profile web add git+https://github.com/omdsh-dev/dsh-genui.git`
DSH-better-sidebar	侧边栏工作台	提供文件、终端、Git、内嵌浏览器、子代&理等一体化工作台	希望获得 VS Code 式体验的用户	`dsh plugin --profile web add dsh-better-sidebar@latest`

这五个 DeepSeek Harness 插件各自针对不同使用需求，功能之间基本不存在冲突，因此即使全部安装通常也没有问题。按照社区里广泛流传的推荐顺序，通常可以先安装dsh-web-ui，优先提升 Web 界面的完整度与易用性；接着安装ModLens，补齐模型读图和 OCR 能力；然后安装better-sidebar，进一步获得更强的工作台体验；之后再安装dsh-genui，为对话结果增加更丰富的交互展示；最后，deepTide是否需要安装，则主要取决于你是否偏好终端式 AI 编程工作流。

最后提醒一点：DSH 目前仍处于 developer preview 阶段（官方已明确说明“会有破坏性变更”），因此插件更新频率很高，安装完成后隔几天跟进升级一次是常态。实际安装时，命令中的版本号应以各插件仓库 README 的最新说明为准。

来源：https://www.jb51.net/ai/1038745.html

DeepSeek

上一篇DeepSeek Harness本地搭建AI Agent开发环境实战指南 下一篇DeepSeek Harness插件开发完整指南与实战教程

本站内容用于信息整理与展示，如有侵权或内容问题请及时联系处理。