引言

DeepSeek Harness（简称DSH）是DeepSeek官方开源的Agent运行时（harness），于2026年8月13日发布，遵循MIT协议。

它的核心理念是“万物皆插件”。模型适配器、工具注册表、会话日志，甚至Agent循环本身都是可替换的插件，底层基于Cordis插件框架构建。

DSH默认以本地Web应用的方式运行，地址为http://127.0.0.1:3080，没有官方终端界面[¹][²]。

正因为官方只提供了一个"裸界面"，社区插件生态在发布后几天内就爆发了。

本文挑了五个最常被推荐、也最容易装错的插件，逐一讲清楚它们是干什么的以及怎么装。

安装前的准备工作

无论安装哪个插件，都建议先确认以下环境：

• 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 进程的权限运行，安装时可能执行代码。安装第三方插件前请检查源码仓库和许可证；如需可复现安装，建议固定 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 协议）可以把它快速变成"完整产品"。它是一个聚合包，支持一次装齐多项增强功能[⁵]：

• 任务看板（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"。

安装它后，不会出现在你的 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 模型的人。

如果你只想增强 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 生态里最火的界面增强插件之一。

安装这一个插件，就能获得一套完整工作台[³][¹⁵]：

• 右侧栏 + 底部面板双工作区，支持拖拽重排 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 理解	常贴截图、看 UI、需要 OCR 的人	npx -y @deepseek-ai/dsh plugin --profile web add @liustack/modlens@3.18.3
dsh-web-ui	界面全家桶	任务看板、Git 图谱、皮肤、移动端远程等一站式界面增强	重度使用 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

推荐安装顺序

这五个插件各有其独特的功能和适用场景，相互之间并不冲突，即便全部安装也不会有问题。

按照社区中广泛流传的建议，安装顺序可以参考下面这个列表：

• 首先安装dsh-web-ui，让界面更加舒适宜人；
• 接着安装ModLens，弥补视觉方面的不足；
• 然后安装better-sidebar，获得更方便的工作台；
• 再之后安装dsh-genui，起到锦上添花的作用；
• 最后是否安装deepTide，则完全取决于你对终端的喜好程度。

最后提醒

DSH 目前仍是 developer preview（官方明确说"会有破坏性变更"），插件迭代极快，装完过几天跟着升一次级属于常态。

安装命令中的版本号以各仓库 README 最新说明为准。