前言¶
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
