安装前的准备工作

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

1. Node.js ≥ 18（部分插件要求 ≥ 20）：用 node --version 检查[2]。
2. 安装 DSH 本体：npm install -g @deepseek-ai/dsh，并设置 DEEPSEEK_API_KEY 环境变量[2]。
3. 先跑一次 dsh web：让它初始化 ~/.dsh/profiles/web 这个 profile 目录，否则安装插件时会报"找不到 profile 目录"[3]。
4. 确保 pnpm 可用：DSH 的插件命令底层交给 pnpm 处理。遇到 pnpm not found，通常运行 corepack enable 后重开终端即可[4]。

DSH 插件安装的通用格式是：

装完后可以用 dsh plugin --profile web list 查看已安装依赖，用 dsh --profile web --dump-config 确认插件是否进入最终配置[4]。

安全提醒：插件以当前 dsh 进程的权限运行，安装时可能执行代码。安装第三方插件前请检查源码仓库和许可证；如需可复现安装，建议固定 commit 哈希[5]。

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

你提到的"MOALENS"实际名称是 ModLens，仓库为 liustack/modlens，自称"全网最强 DeepSeek Harness 外 挂视觉插件"[6][7]。

作用

DeepSeek 和 GLM 的旗舰聊天模型是纯文本模型，原生无法读图。ModLens 是一个即插即用的视觉引擎，核心能力包括[6]：

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

安装方法

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

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

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

作用

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

• 任务看板（task-board）：多列看板视图管理 Agent 任务；
• Git 图谱（git-graph）：可视化提交历史；
• 右侧面板与移动端远程访问（remote-web-ui）：手机上也能盯长任务；
• 实时 Token 统计（live-stats）；
• 鲸鱼娘电子宠物（pet）与皮肤中心（skin-center）：界面美化；
• 还外 挂了 dsh-better-sidebar 侧栏插件与皮肤全家桶[5][9]。

插件既可单独安装，也可以用聚合包一键装齐[5]。

安装方法

如需可复现安装，可固定 commit 哈希：dsh plugin add github:zhu1090093659/dsh-web-ui#<commit>[5]。

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

特别说明：deepTide（仓库 paean-ai/deeptide）虽然打着 dsh-plugin 的 GitHub 标签、也被多个 DSH 插件目录收录，但它严格来说不是一个挂载进 DSH Web 的插件，而是一套独立运行的跨平台终端 AI 编程 Agent——名字取自 DeepSeek + tide（terminal IDE），口号是"Built by DeepSeek, for DeepSeek"。装它不会出现在你的 DSH 插件列表里，而是给你一套独立的命令行工具[10][11]。

作用

deepTide 提供三种形态[11]：

核心用法是终端里的交互式 REPL：登录后在代码库目录里直接对话、让 Agent 读写代码，也支持 tide -p "explain this repo" 这种一次性命令模式[11]。

安装方法

macOS（推荐，原生版本）：

Linux / Windows（CLI 版本，需先装好 Bun）：

装完后会获得 deeptide 和 tide 两个命令，常用流程[11]：

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

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

作用

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

• 原理：模型把界面描述写成一种叫 dsh-ui fence 的特殊代码围栏，浏览器端解析渲染成真实组件；
• 支持 30+ 种组件：卡片、表格、图表、表单、标签页、文件树、时间线、Diff 对比、Mermaid 流程图、测验题，甚至 3D 场景，函数曲线还能拖滑块实时重绘；
• 事件闭环：点按钮、提交表单的操作会回传给模型，模型基于你的操作继续回复——不只是"渲染"，而是真正的"交互"；
• 组件白名单 + 规格校验，写坏的图表不会上屏；0.7.2 起支持流式渲染，组件随模型书写实时冒出来[12][13]。

安装方法

也可以使用 npm 包形式（@omdsh-dev/dsh-genui）[14]：

装完重启 dsh web 并硬刷新页面（Cmd/Ctrl + Shift + R），新建会话后直接说"用 dsh-ui 做一个项目进度看板，包含统计卡、风险表和可点击筛选"即可体验[13]。

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

作用

DSH-better-sidebar（仓库 omdsh-dev/DSH-better-sidebar）是目前 DSH 生态里最火的界面增强插件之一，一个插件装出一套完整工作台[3][15]：

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

安装方法

前置条件：已装好 DSH（dsh web 能正常运行）、Node.js ≥ 20、pnpm ≥ 10[3]。

装完硬刷新浏览器（Cmd/Ctrl + Shift + R）即可看到侧边栏——DSH 对 client 端改动支持热加载，无需重启；只有 host 半更新时才需要重启 DSH。更新也是同一条命令[3]。

如果系统里没有全局 dsh 命令，可用：

常见问题速查

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

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

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

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