空格快速预览

在 Windows 资源管理器中按空格预览文件,支持文本、Office、图片、Markdown、网页、音频、PDF 与二进制文件。

最后更新 约 3 分钟阅读 在 GitHub 上编辑此页
全部文档
本页目录

SigXor 的核心交互对标 macOS Finder 的「空格快速预览」(Quick Look)。选中文件后按 Space 弹出预览浮窗,再按一次或按 Esc 关闭。

打开预览的三种方式#

  • 资源管理器: 选中一个或多个文件,按 Space 打开;↑ / ↓ 在多选文件之间切换。
  • 托盘菜单: 选择「打开文件预览…」并挑选文件。
  • 命令行或文件关联: 运行 SigXor.exe <file>,或把文件路径作为参数传给已运行的实例。

未选中文件时按空格不会响应;鼠标焦点位于文本输入框等编辑控件时,空格也不会触发预览,避免与输入冲突。

支持格式一览#

类别 格式 说明
文本 / 代码 txt、cs、py、js、ts、json、xml、yaml、toml、md、log、sql、sh、bat、ini 等 语法高亮、编码识别、可编辑
图片 png、jpg、jpeg、bmp、gif、webp、svg 适应窗口、实际大小、缩放
Word docx、docm、rtf、odt 双引擎,只读
Excel xlsx、xlsm、ods、xls(仅网页视图) 多工作表,每表上限 1 万行
PowerPoint pptx、pptm、odp 优先本机 PowerPoint 整页画面,否则结构化视图
Markdown md、markdown GitHub 风格渲染,可切源码
网页 html、htm、xhtml WebView2 按原目录渲染
音频 mp3、wav、flac、ogg、m4a、aac 播放、进度、倍速、循环
PDF pdf Chromium 内置查看器
二进制 任意文件 十六进制视图,可编辑

文本与代码#

文本和代码预览使用 AvalonEdit 渲染:

  • 内置多种语言的高亮规则,包含 JSON、TOML、YAML、日志等。
  • 自动识别 UTF-8、UTF-16、GB18030 等编码,可手动切换。
  • 支持编辑模式、撤销重做与保存,详见编辑与保存。
  • 100 MB 以内自动加载;超过 100 MB 时提示改用十六进制视图。

图片#

PNG、JPG、BMP、GIF(静态)、WebP 与 SVG(按位图渲染)均可预览,支持适应窗口、100% 实际大小与自由缩放。图片目前只读,编辑功能在后续版本规划中。

Office 文档#

Word、Excel、PowerPoint 使用双引擎预览,可在预览窗口顶部一键切换:

结构化视图(默认)

  • 基于 DocumentFormat.OpenXml 解析 docx / xlsx / pptx,自研 RTF 与 ODF 读取器。
  • 秒开、离线、可单元测试。
  • Word 按标题、段落与表格渲染;Excel 多工作表 DataGrid;PowerPoint 优先调用本机 PowerPoint 导出整页 PNG。

网页渲染视图

  • WebView2 + 离线内嵌 mammoth.js / SheetJS / PPTXjs,接近原样的高保真排版。
  • 旧版 .xls 由 SheetJS 兜底,仅在网页视图可用。

Office 预览为只读,不进入编辑与保存链路。旧版 .doc / .ppt(OLE2)两种引擎均不支持,会提示改用十六进制视图;PPT / PPTX 超过 8 MB 时禁用网页引擎。

Markdown#

默认渲染视图基于 Markdig 与自研 GitHub 风格离线样式,支持表格、任务列表、围栏代码、删除线与自动锚点。可一键切换源码模式,并在源码模式下编辑、保存与切换编码。

  • 内嵌原始 HTML 会被转义为文本,避免脚本执行。
  • 渲染输入上限为 200 万字符,超出时提示切换源码模式。
  • Markdown 中的相对图片按文件所在目录解析。
  • 渲染依赖 WebView2,缺失时自动进入源码模式。

网页预览#

本地 HTML 文件由 WebView2 按原目录渲染,脚本启用,./img、style.css 等相对引用天然生效。可一键切换只读源码。

安全提示: 预览不受信任的 HTML 等同于在浏览器中打开它。文件所在目录会映射进 WebView2 沙箱,预览关闭时映射即销毁。文件名包含 # 或 ? 时无法按 URL 加载,会自动切换源码模式。

音频#

音频预览使用 WebView2 自研播放页:

  • 支持 mp3、wav、flac、ogg(Vorbis / Opus)、m4a(AAC)。
  • 播放 / 暂停、进度拖动、5 秒快进快退、音量、倍速与循环。
  • 显示时长、大小与近似比特率。
  • WMA、AIFF、MIDI 不支持;编解码能力取决于 WebView2 的 Chromium 内核。

PDF#

PDF 使用 WebView2 / Chromium 内置 PDF 查看器,支持缩放与翻页,只读。WebView2 运行时缺失时降级为提示卡片。

相关文档#