前言¶
DeepSeek Harness（DSH）右侧栏自带 Markdown、代码、图片、PDF、Office 等文档预览。智能体或本地工作流里常出现 STL 模型、ZIP 交付物、Intel HEX、KiCad 工程、VCD 波形等文件，若只能下载到系统默认应用打开，排查和交付核对都要多切一层窗口。下面介绍社区客户端插件 dsh-preview-extra（维护者 LeiYuXingZhou），它把这些格式注册进与内置预览同一套「文件 tab / 路径头 / 刷新 / 打开方式」流程，在浏览器内完成查看。
这是什么¶
dsh-preview-extra 是纯客户端 DSH 插件（当前发布版本 0.1.0，MIT 许可证）。仓库根目录即插件包（package.json + lib/ + cordis.patch.yml），面向 DSH 文档中说明的 DeepSeek Harness 0.2.0-rc.2 一侧的 @deepseek-ai/dsh-client-ui-sidebar-documentpreview 扩展点。插件不引入第三方 npm 依赖，预览过程无额外网络请求；解析与渲染依赖 Web 标准 API 与手写 bundle（lib/client.js）。
核心功能¶
新增预览均挂在右侧栏文档预览 tab，与内置类型共用打开方式。聊天里的文件卡片、交付物卡片也会走同一预览链路。
3D 模型¶
后缀：stl（ASCII/二进制）、obj、ply（ASCII / binary_little_endian）、gltf、glb。
Canvas2D 软件渲染：拖拽旋转、滚轮缩放、右键或 Shift 平移、双击复位、线框开关；显示包围盒、三角形与顶点统计。glTF/GLB 读取内嵌 buffer 与节点变换；超过约 30 万三角形时自动抽样降级。
压缩包¶
可解析：zip、jar、war、apk、tar、gz、tgz、tar.gz。展示条目树（名称、大小、时间、方法）；点击条目可查看带行号的文本（最多 200KB）、内嵌图片或二进制说明；GBK 文件名兜底；带防 zip bomb 限额。
仅识别并提示：7z、rar、xz、bz2、zst —— 浏览器端无对应解压 API，界面提示先解压为 zip/tar。
音视频与字体、字幕¶
- 音频：
mp3、wav、ogg、oga、m4a、aac、flac、opus—— 原生<audio>，附带大小与 MIME。 - 视频：
mp4、webm、m4v、mov、mkv—— 原生<video>，附带大小与 MIME。 - 字体：
ttf、otf、woff、woff2—— FontFace 加载后的样张（中英文 pangram、字母表、标点、字号阶梯）。 - 字幕：
srt、vtt、ass、ssa—— 时间轴列表、条数/编码/总时长，可切换原始文本。
配置与工程类文本¶
| 格式 | 后缀 | 预览要点 |
|---|---|---|
| TOML | toml |
按表展开键、类型与值；支持数组、内联表、[表] 与 [[表数组]] |
| Intel HEX | hex |
记录校验、线性/段地址合并、入口地址、按地址分段十六进制转储 |
| JCAMP-DX | jdx、dx |
谱图折线、峰表、PAC 压缩与表头 |
| VCD | vcd |
数字波形：时间刻度、作用域、0/1/x/z 与总线值 |
| KiCad | kicad_sch、kicad_pcb |
原理图或 PCB：导线/符号/走线/过孔等；滚轮缩放、拖拽平移 |
| DFU | dfu |
USB DFU 后缀字段与 DfuSe 多镜像地址、大小 |
仓库 README 中记录了契约静态校验 34/34、3D/压缩包/新格式解析单测，以及无头 Chrome CDP 驱动的真实 GUI E2E 截图（目录 shots/）。
安装与启用¶
DSH「设置 → 插件 → 添加插件」支持包名、GitHub 仓库地址或本地目录路径。本仓库根目录即为可安装包，步骤如下：
- 打开 DSH → 设置 → 插件 → 添加插件；
- 粘贴仓库地址并安装：
https://github.com/LeiYuXingZhou/dsh-preview-extra
- 安装完成后，profile 的
cordis.patch.yml会由包内cordis.patch.yml（dsh.bundle.patch）自动挂载 Loader 行；刷新页面即可生效，无需重启 DSH。
若本机无法直连 github.com:443，需先为 git 配置代理后再从 GitHub 安装，或使用本地目录绝对路径指向仓库根目录安装。仓库另提供 scripts/install.mjs，可向指定 profile 复制包并追加 patch 行（幂等）。
插件以当前 DSH 进程与浏览器上下文运行；安装前建议在 GitHub 阅读源码与 MIT 许可证，确认符合你的环境策略。
典型用法¶
- 在 DSH 右侧栏打开「文件」tab，或从聊天/交付物卡片点开目标文件；
- 使用上表对应后缀的文件即可触发新预览，例如
.stl、.glb、.zip、.wav、.srt、.toml、.hex、.vcd、.kicad_sch、.dfu等； - 遇到
.7z等仅识别格式时，按界面提示先解压为 zip/tar 再预览。
开发与二次打包时，修改 src/ 后需运行 scripts/build-client.mjs 生成 lib/client.js，并可配合 tools/smoke.mjs、skeleton/verify.mjs 做冒烟与契约校验（命令见仓库 README）。
适用场景与注意¶
适合在 DSH 内直接核对 3D 样件、压缩包内容、固件 HEX、谱图 JCAMP、仿真 VCD、KiCad 工程或 DFU 镜像，而不必反复导出到外部工具。插件逻辑全部在客户端 bundle 内执行，不替代内置 Markdown/PDF 等预览，而是与之并列注册。
注意：大模型或智能体生成的二进制文件仍应自行校验来源与安全；压缩包预览虽有 bomb 限额，打开不可信归档仍需谨慎。社区插件目录（如 skillhub.cn）为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-preview-extra 把一批常见但内置未覆盖的格式收进 DSH 右侧栏同一预览体验，适合本地 Harness 工作流里快速看文件内容。更多信息见社区目录页与 GitHub 仓库：
- 目录：https://www.skillhub.cn/plugins/LeiYuXingZhou/dsh-preview-extra
- 仓库：https://github.com/LeiYuXingZhou/dsh-preview-extra
- 发布：https://github.com/LeiYuXingZhou/dsh-preview-extra/releases/tag/v0.1.0
