在 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
