在 DSH (DeepSeek Harness) 环境中进行开发时，频繁切换窗口去查看代码、文档或编辑文件会影响效率。dsh-preview-ui 插件在浏览器内直接集成了文件树浏览、多格式预览、在线编辑以及版本管理功能，使所有操作均可在当前 Web 界面完成。
这是一个由 xusuyang030218 维护的 DSH 客户端插件。它允许用户在浏览器中浏览当前工作区的文件树，预览包括代码、Markdown、图片、PDF、Office 文档、HTML 在内的多种格式，支持在线编辑文本文件，并自动保留本地版本历史。
安装与启用¶
使用 pnpm 安装插件。
# 本地链接安装（实时同步）
pnpm dsh plugin --profile web add "dsh-preview-ui@link:d:/dsh-preview-ui"
# 或从 GitHub 安装
pnpm dsh plugin --profile web add "github:xusuyang030218/dsh-preview-ui"
安装后进入项目目录进行构建：
cd d:\dsh-preview-ui
pnpm install
pnpm run build
重启 DSH Web 服务，访问 http://127.0.0.1:3080，在输入框左侧会出现「预览」按钮。该插件通过 /plugins/dsh-preview-ui/client.js 提供。
核心功能¶
- 文件树浏览：以树形结构展示工作区目录，支持按文件名过滤和懒加载子目录。
- 多格式预览：
- 代码与文本：支持语法高亮。
- Markdown：渲染标题、列表、表格、代码块等。
- 图片：支持 PNG、JPG、GIF、SVG、WebP、BMP、ICO。
- PDF：使用浏览器原生查看器。
- Office：支持 DOCX、XLSX、PPTX 解析。
- HTML：在 iframe 沙箱中预览，禁用脚本执行。
- 二进制：显示前 4KB 的十六进制转储。
- 在线编辑：使用带高亮遮罩层的 textarea 进行编辑。按下
Ctrl+S保存时，系统会自动创建版本快照。 - 版本历史：快照存储在
.dsh-preview-ui/versions/目录下。支持回滚操作，单个文件最多保留 50 个版本。 - 全文搜索：支持按文件名或文件内容搜索工作区内的文件。
- 拖入预览：支持将文档或整个项目文件夹拖入面板，递归生成文件树并预览。
- Agent 工具：插件注册了
list_files和preview_file工具，Agent 可以主动触发预览面板。
典型用法¶
- 重启服务后，在
http://127.0.0.1:3080界面左侧找到「预览」按钮。 - 将本地文档或项目文件夹直接拖入预览面板，系统会自动解析文件树。
- 在编辑器模式下编辑文本文件，按
Ctrl+S保存，系统会自动保存前创建版本快照。 - 在 DSH Agent 中调用
list_files或preview_file工具，可主动打开预览面板。
安全与注意¶
插件的所有 API 均锚定在 DSH 配置的工作区根目录。系统拒绝绝对路径、路径穿越攻击以及直接访问版本快照目录。HTML 预览使用了无脚本权限的 iframe 沙箱，raw 端点返回安全 MIME 类型并附带 X-Content-Type-Options: nosniff 头部。
作为运行在当前 DSH 进程权限下的插件，安装前请检查源码与许可证（MIT）。
生态背景¶
DSH 的设计理念是「一切皆插件」。该插件收录于社区目录，与 DeepSeek 或幻方没有官方从属关系。
