在 DeepSeek Harness (DSH) 的開發流程中，開發者經常需要在側邊欄查看文件內容。面對圖像、PDF 或長文本，頻繁切換窗口或查看縮略圖會打斷操作流。dsh-quicklook 插供了 QuickLook 風格的快速預覽方案，按下 Space 鍵即可在當前上下文獲得大圖或大文本覆蓋層預覽。
插件定位¶
該插件由 Hoemr 維護，定位爲 dsh-better-sidebar 的配套客戶端插件。它通過瀏覽器端邏輯接管文件預覽，主機端僅作爲休眠存根存在。其核心價值在於在編輯器或側邊欄中實現類似 QuickLook 的瞬間預覽，支持圖像、PDF 和文本類型。
核心功能¶
- 大圖覆蓋預覽：對活動文件標籤頁按下 Space 鍵，會立即彈出覆蓋層顯示內容。
- 內容類型支持：自動識別文件類型，渲染圖像、PDF 或文本內容。
- 縮放記憶：預覽窗口的縮放比例會通過
localStorage（鍵名dsh-quicklook:size）保存，重啓應用後保持上次設置。 - 可選依賴：插件設計爲可選的 peer contract，依賴
dsh-better-sidebar>=0.13.1 且 <0.16。若未掛載該依賴，插件不提供任何功能。 - 熱插拔：支持動態加載，安裝順序不影響功能激活。
安裝與啓用¶
安裝前請確保環境滿足 Node.js 版本要求（^22.19.0 || >=24.0.0）。
使用官方安裝命令添加插件：
dsh plugin --profile desktop add dsh-quicklook@0.1.0
安裝完成後重啓應用，插件會通過 bundle patch 自動掛載。
典型用法¶
- 打開預覽：在活動文件標籤頁上按下
Space鍵。 - 關閉預覽：再次按下
Space鍵，或按下Escape鍵。
注意事項¶
- 功能依賴：必須先安裝並掛載
dsh-better-sidebar才能觸發預覽。 - 權限與安全：插件運行在客戶端上下文，請確保從可信來源獲取源碼。
- 許可證：該插件採用 MIT 許可證開源。
總結¶
dsh-quicklook 通過 Space 鍵交互解決了側邊欄文件預覽的痛點，提供輕量級的圖像與文本查看能力，配合 localStorage 記憶縮放比例，適合需要頻繁查看文件細節的 DSH 開發場景。
- 目錄頁：https://www.skillhub.cn/plugins/Hoemr/dsh-quicklook
- GitHub：https://github.com/Hoemr/dsh-quicklook
