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

引言

DeepSeek Harness（简称DSH）是DeepSeek官方开源的Agent运行时（harness），于2026年8月13日发布，遵循MIT协议。它的核心理念是“万物皆插件”，模型适配器、工具注册表、会话日志，甚至Agent循环本身都是可替换的插件，底层基于Cordis插件框架构建。DSH默认以本地Web应用的方式运行，地址为http://127.0.0.1:3080，没有官方终端界面[¹][²]。

正因为官方只提供了一个"裸界面"，社区插件生态在发布后几天内就爆发了。本文挑了五个最常被推荐、也最容易装错的插件，逐一讲清楚它们

以及。

安装前的准备工作

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

1. Node.js ≥ 18
   （部分插件要求 ≥ 20）：用 node --version 检查[²]。

2. 安装 DSH 本体
   ：npm install -g @deepseek-ai/dsh，并设置 DEEPSEEK_API_KEY 环境变量[²]。

3. 先跑一次 dsh web
   ：让它初始化 ~/.dsh/profiles/web 这个 profile 目录，否则安装插件时会报"找不到 profile 目录"[³]。

4. 确保 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 插件目录收录，但它严格来说，而是一套——名字取自 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" 这种一次性命令模式[¹¹]。

安装方法

curl -fsSL https://deeptide.sh/install.sh | sh

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 协议）让模型

[¹²][¹³]：

• 原理：模型把界面描述写成一种叫 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

装完

（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 目前仍是

（官方明确说"会有破坏性变更"），插件迭代极快，装完过几天跟着升一次级属于常态。安装命令中的版本号以各仓库 README 最新说明为准。