景速览 JingPeek:按一下空格,文件内容即刻呈现
一款灵感来自 macOS Quick Look 的 Windows 文件快速预览工具:资源管理器选中文件按空格即弹出置顶预览框,覆盖图片 / PDF / 音视频 / Office 原版式 / 代码高亮 / Markdown / 压缩包,未知格式兜底展示。本文记录玩法(交互)设计、格式支持边界与技术实现。
导语: 在 macOS 上看文件有个朴实的小快感:选中文件按一下空格,内容就浮在眼前,不用等软件启动。Windows 一直没有等价的「轻量级」方案——预览窗格笨重、第三方工具又爱捆绑全家桶。「景速览 JingPeek」把这个体验原样搬到了 Windows:常驻托盘、空格即览、看完就走。

左:核心交互示意——选中文件 → 按下空格 → 文件旁弹出预览 右:主界面 · 让文件,先被看见
核心交互:三步,一秒
整个工具的灵魂只有一条动线:选中文件 → 按下空格 → 在文件旁边查看内容。
- 预览框始终置顶,默认 600 × 460,优先出现在所选文件右侧,空间不足自动换边;可拖动标题移动、拖右下角改大小。
- 空格再次按下即收起,Esc 隐藏并返回原来的资源管理器,方向键循环切换同目录文件(后台按自然名称排序建队列),Enter 用默认程序打开。
- 启动后直接常驻系统托盘,不弹主界面——它不是又一个「窗口应用」,而是一个随叫随到的系统级能力。
预览框标题栏自带置顶、打开、更多菜单与关闭;更多菜单里有适应窗口、原始比例、图片旋转、全屏、文件信息。文件信息面板支持复制路径、资源管理器定位、保存可见预览截图、计算并复制 SHA-256(100MB 内)。
格式支持:从 HEIC 到十六进制兜底
| 类别 | 能看到什么 |
|---|---|
| 图片 | PNG/JPEG/GIF/WebP/TIFF/SVG/AVIF/HEIC/PSD 合成图/DDS/TGA/ICNS 等,GIF 动态播放,静态图可旋转,Ctrl + 滚轮缩放 |
| 音视频 | MP4/MKV/AVI/MOV/WebM/WMV/FLV 等容器,MP3/WAV/FLAC/AAC 等音频;系统解码失败自动转内置 FFmpeg 兼容播放 |
| 多页滚动、适应宽度、缩放(不含密码/注释/OCR) | |
| Word / 文档 | DOC/DOCX/RTF/ODT 完整静态页面,含图片表格,可翻页缩放 |
| Excel / 表格 | XLS/XLSX/XLSB/ODS 保留合并单元格、格式、图片、图表,工作表下拉切换,隐藏表也标明 |
| PPT / 演示 | PPT/PPTX/PPS 等完整静态幻灯片(含隐藏页),不播动画与内嵌媒体 |
| 代码 / 文本 | 常见语言 Pygments 高亮 + 行号,Markdown 排版渲染,CSV/TSV 前 500 行 × 40 列 |
| 压缩包 | ZIP/7Z/RAR/TAR 目录列表(最多 2,000 项),不解压到磁盘 |
| 其他一切 | 任何可读取文件都有基础预览:属性 + 文本探测(前 64 KB)或十六进制(前 4 KB) |
最后一条是设计底色:专用解析失败时自动回到基础查看,不会只留一页错误。空文件、无扩展名、未知扩展名都有可用展示;常见 PDF、图片、ZIP、媒体还能按文件签名识别,扩展名丢了也认得。

左:图片预览 · 缩放与旋转 右:PDF 阅读 · 多页滚动
Office 原版式:离线引擎,不装 Office 也能看
Word / Excel / PPT 走的是完整静态渲染路线:内置离线 LibreOffice 引擎把文档原样排版导出预览——图片、图表、合并单元格、隐藏幻灯片都在,界面还提供「文字提取预览」作为显式降级选项,不会悄悄变成纯文字。

左:Word 文档 · 完整静态排版 右:Excel 工作表 · 保留格式与图表
引擎的工程约束写得很实在:独立临时配置 + Windows 作业对象运行,取消或超时会结束渲染进程但不关你已打开的 Office/WPS;单次最长 120 秒、进程组内存上限 2 GB;渲染结果与静态预览各有缓存(8 份 / 16 份共 256 MB),文件一变自动重生成,设置里可一键清除。

左:PPT 幻灯片 · 含隐藏页静态渲染 右:Markdown 排版 · 支持表格与代码
兼容解码:不装解码器也能播视频
遇到系统缺编解码器的 MP4,JingPeek 会先用系统后端快速播放;失败后自动启动内置 FFmpeg,转为 H.264/AAC MP4 在同一个预览框播放——不用装 codec pack、不调外部播放器、不改原文件、不联网。兼容准备有进度可看、可取消(Esc 或切换文件即终止),宽度限 1280px、单次最长 180 秒、临时输出小于 1GB,会话内最多保留 3 个兼容缓存。

左:代码高亮 · Pygments + 行号 右:视频播放 · 兼容解码兜底

左:压缩包 · 目录预览不解压 右:未知文件 · 属性 + 十六进制兜底
桌面兼容:连腾讯桌面整理都照顾到了
1.5.x 系列重点打磨了桌面场景:支持原生 Windows 桌面、重定向/公共桌面,并专门适配腾讯桌面整理 DeskGo——它用自绘界面、没有标准选中接口,兼容模式只在已核对的桌面主窗口工作,临时调用复制读取文件路径后恢复原剪贴板;期间检测到其他复制动作不会覆盖新内容。设置里可关闭该模式;剪贴板被占用时会明确提示,而不是硬闯。
偏好设置提供自动播放、登录启动、Office 原版式预览开关,以及 1.6.0 新增的中英文界面即时切换(主界面、托盘、设置同步更新,无需重启)。

左:偏好设置 · 语言 / 自启 / 缓存管理 右:文件信息 · SHA-256 / 定位 / 截图
隐私与边界:说清楚「不能做什么」
- 🔒 本地解析:不上传文件、不主动联网;网页链接点击后先询问再用系统浏览器打开。
- 🔒 不改原文件:不自动执行压缩包内容或文档宏;用默认程序打开是你主动按 Enter 的动作。
- ⚠️ 诚实的边界:DRM、加密文档、损坏媒体、专有工程文件仍可能只能基础查看;无权限文件读不了;「所有类型」指可读文件都有展示,不代表所有专有格式都能还原原版式。
- ⚠️ 体积透明:完整 Office 渲染引擎随 EXE 离线提供,运行时约 1.7 GB——单文件版仅首次运行释放(有进度、可取消),之后按「版本 + 校验值」隔离复用缓存,不再重复释放。
技术栈与开源
- 栈:Python + PySide6/Qt(预览与 PDF/多媒体)、ctypes + UIAutomation(选中文件定位与混合 DPI 坐标转换)、内置 LibreOffice UNO 静态导出(Office 原版式)、内置 FFmpeg(兼容解码)、C# 原生启动器(单文件首次释放缓存)。
- 发布形态:便携版单文件 EXE / Inno Setup 安装版双形态;中英双语安装界面。
- 质量:
tests/提供解析单测与界面集成测试;依赖版本固定,第三方许可证随包完整保留(MIT,Office 引擎与第三方组件各自许可独立)。 - 📦 下载:Releases | 🛠 源码:github.com/jingpanlong/JingPeek
评论 0
登录后即可参与评论,理性发言,友好交流。