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

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 是一个即插即用的视觉引擎，核心能力包括[⁶]：

1. 直接粘贴识图：图片粘进对话框即可，不用先存文件再传路径；
2. 提供原生 modlens_read_image 工具，输出结构化 JSON 证据（OCR、版面、语义）；
3. 自动发现所有搭载纯文本 DeepSeek/GLM 模型的路由，在模型选择器里生成 (modlens vision) 变体（如 DeepSeek-V4-Flash (modlens vision)），选中后粘贴图片时缩略图保留在消息里，体验接近 Codex；
4. 视觉引擎可复用本机已有的 Claude Code、Codex、OpenCode 等登录态，也可配置免费的 Gemini API key 或任意 OpenAI 兼容端点[⁶][⁸]。

安装方法

npx -y @deepseek-ai/dsh plugin --profile web add @liustack/[email protected]

注意：官方刻意锁定版本号而不是用 @latest——因为 pnpm 11 会拦截发布不足 24 小时的版本，@latest 实际装到的可能是一天前的旧版。更新时用同一条命令换个新版本号即可[⁶]。

装完后，在模型选择器里选带 (modlens vision) 后缀的模型变体，直接粘贴图片提问即可。引擎配置存放在 ~/.modlens 目录[⁸]。

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

作用

DSH 官方 Web 界面比较朴素，dsh-web-ui（仓库 zhu1090093659/dsh-web-ui，Apache-2.0 协议）是把它变成"完整产品"的捷径——一个聚合包一次装齐[⁵]：

1. 任务看板（task-board）：多列看板视图管理 Agent 任务；
2. Git 图谱（git-graph）：可视化提交历史；
3. 右侧面板与移动端远程访问（remote-web-ui）：手机上也能盯长任务；
4. 实时 Token 统计（live-stats）；
5. 鲸鱼娘电子宠物（pet）与皮肤中心（skin-center）：界面美化；
6. 还外 挂了 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 提供三种形态[¹¹]：

核心用法是终端里的交互式 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 keytide              # 启动交互式 REPLtide doctor       # 诊断安装与网络

适合谁：习惯 Claude Code / Codex CLI 那种终端工作流、又主要用 DeepSeek 模型的人。如果你只想增强 DSH 的 Web 界面，则不需要装它。

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

作用

默认情况下模型回复就是一堆 Markdown，碰上数据对比、流程图、表单这类内容，纯文字很费眼。dsh-genui（仓库 omdsh-dev/dsh-genui，MIT 协议）让模型直接在回复里渲染可交互的 UI 组件[¹²][¹³]：

1. 原理：模型把界面描述写成一种叫 dsh-ui fence 的特殊代码围栏，浏览器端解析渲染成真实组件；
2. 支持 30+ 种组件：卡片、表格、图表、表单、标签页、文件树、时间线、Diff 对比、Mermaid 流程图、测验题，甚至 3D 场景，函数曲线还能拖滑块实时重绘；
3. 事件闭环：点按钮、提交表单的操作会回传给模型，模型基于你的操作继续回复——不只是"渲染"，而是真正的"交互"；
4. 组件白名单 + 规格校验，写坏的图表不会上屏；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 生态里最火的界面增强插件之一，一个插件装出一套完整工作台[³][¹⁵]：

1. 右侧栏 + 底部面板双工作区，支持拖拽重排 Tab 和分栏；
2. 内置文件管理、CodeMirror 编辑与预览（Office 三件套 / PDF / 图片 / Markdown 内联预览）、沙箱内嵌浏览器、xterm + node-pty 真实终端、Git 面板与后台任务 / 子代&理状态页；
3. 服务化基座：从 v0.4.0 起暴露 ctx.betterSidebar 服务，第三方插件可以注册自己的侧边栏 Tab 和文件预览器（如划词提问插件 dsh-sidebar-qa 就依赖它）；
4. 重依赖按需分块加载，启动只拉约 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

常见问题速查

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

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

这五个插件互不冲突、场景错开，全装也没问题。社区普遍的安装顺序建议是：先装 dsh-web-ui 把界面搞舒服，再装 ModLens 补上视觉短板，better-sidebar 提供工作台，dsh-genui 锦上添花，deepTide 则看你爱不爱终端。

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