核心功能与使用指南

文本与代码查看器

专为软件开发者与技术读者打造，兼顾日常源码的高保真语法着色排版与数十甚至数百兆超大日志文件的秒级极速打开。

两种视图架构：标准视图 vs 大文件视图

为彻底解决大文件预览时内存溢出崩溃或界面假死的问题，Seer 会根据文件体积自动选用最适宜的视图模式：

• 自动分流阈值：由配置项控制，默认阈值为 3 MiB（3,145,728 字节）。
  • ≤ 3 MiB：自动采用 标准视图 打开，提供完整的代码语法高亮、自动折行、代码格式化排版以及快速渲染视图切换。
  • > 3 MiB：自动切换为 大文件视图 进行流式分块加载，确保数十甚至数百兆的超大日志、数据库 SQL 转储或大型 CSV 文件能够毫秒级极速打开，杜绝内存耗尽。

为了维持超大文件瞬时秒开且毫无卡顿的性能表现，大文件视图采用固定行高的高速流式排版；因此，计算密集型功能（如长行自动折行、代码自动格式化、以及 Markdown/HTML/SVG 视图直接渲染切换）在此模式下不可用。两种视图均完整支持语法高亮、全文查找（Ctrl + F）、代码行号（N）、空白字符符号（W）、微缩全景图（M）以及鼠标划词文本选择。

单行长度限制与溢出保护

在检视打包压缩后的代码（如单行压缩的 minified JavaScript、单行超大 JSON 报文或 Base64 字符串）时，单行可能包含数万甚至数十万个字符。若将整行完全排版渲染，在窗口调整大小或计算换行时会导致严重的界面卡顿或假死。

• 默认单行上限：10,000 字符：Seer 默认单行最大读取并排版 10,000 字符（配置项中强制设定了 10,000 字符的最低下限）。
• 溢出胶囊徽标：当某一行超出 10,000 字符时，超额字节会被安全截断，并在行尾右侧绘制胶囊状溢出徽标（如 … 500 B 或 … 14.5 KB）。
• 省略字节提示：将鼠标光标悬停在徽标上时，会浮现工具提示显示被截断省略的具体字节数（例如 Line truncated (14,848 bytes omitted)），在保障界面丝滑交互的同时直观告知截断详情。

快捷键清单

自定义语法高亮规则

Seer 的代码高亮引擎基于开源社区通用的 Kate 语法高亮规范（与 Kate、KWrite、Qt Creator、KDevelop 共享相同的语法标准）。当内置高亮规则未涵盖特定专业格式，或希望调整高亮配色时，无需编写代码或编译程序，只需添加 .xml 语法定义文件即可。

1. 语法参考与官方示例

• 语法格式参考文档：Kate Highlight XML 规范说明
• 官方参考示例 (hextxt.xml)：ccseer/Seer-Controls/plugins/hex-viewer/syntax/hextxt.xml

官方的 十六进制查看 (Hex View) 控制栏插件便采用了此机制：它将十六进制数据转储为带有 .hextxt 扩展名的文件，并随插件打包了 syntax/hextxt.xml 来提供专属的高亮色彩。

2. 存放目录与生效方式

将编写或获取的 .xml 定义文件放置在 Seer 的任一语法目录中：

• 普通安装版：%LocalAppData%\Corey\Seer\syntax\（即 C:\Users\<你的用户名>\AppData\Local\Corey\Seer\syntax\；若 syntax 文件夹不存在可自行创建）。
• 便携版（程序根目录下存在 portable.cfg 时）：<Seer安装目录>\data\syntax\。
• 扩展插件包：插件包自身也可在 <插件根目录>\syntax\ 下打包随附语法定义文件。

生效方法：放入文件后，只需重启 Seer 即可。宿主程序在启动时会自动扫描、校验并注册所有符合规范的语法文件。

3. XML 文件规范与关键约束

语法文件必须遵循标准 Kate Syntax XML 规范，以下为官方 hextxt.xml 的核心结构示例：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE language>
<language name="HexDump" section="Other"
          extensions="*.hextxt" version="2" priority="100" kateversion="5.0"
          mimetype="text/x-hexdump" author="corey" license="MIT">
  <highlighting>
    <contexts>
      <context name="Dump" attribute="Normal" lineEndContext="#stay">
        <RegExpr String="^[0-9A-Fa-f]{8}(?=\s{5})" attribute="Offset" context="DataRow"/>
        <RegExpr String="^Offset\(h\).*$" attribute="ColumnHeader" context="#stay"/>
        <RegExpr String="^\[.*\]$" attribute="Banner" context="#stay"/>
      </context>
      <context name="DataRow" attribute="Normal" lineEndContext="#pop">
        <RegExpr String="\|.{16}\|$" attribute="Ascii" context="#stay"/>
        <RegExpr String="\b[0-9A-Fa-f]{2}\b" attribute="HexByte" context="#stay"/>
      </context>
    </contexts>
    <itemDatas>
      <itemData name="Normal" defStyleNum="dsNormal"/>
      <itemData name="Offset" defStyleNum="dsFunction"/>
      <itemData name="HexByte" defStyleNum="dsDataType"/>
      <itemData name="Ascii" defStyleNum="dsString"/>
      <itemData name="ColumnHeader" defStyleNum="dsComment"/>
      <itemData name="Banner" defStyleNum="dsAlert"/>
    </itemDatas>
  </highlighting>
</language>

• 单文件大小限制：单个 .xml 文件必须严格控制在 512 KB 以内。超过 512 KB 的文件会被自动忽略，以防意外混入非语法大文件。
• 关键属性要求：
  • name（必填）：该语法的唯一识别名称（例如 name="HexDump"）。
  • section：所属类别（如 Sources、Scripts、Markup、Other 等）。
  • extensions（必填）：绑定的文件名后缀通配符，多个通配符之间用分号 ; 分隔（例如 extensions="*.hextxt"）。
  • ⚠️ 严禁在分号后添加空格：匹配器按原样识别后缀，若书写为 *.foo; *.bar，第二个后缀会被解析为 " *.bar"（含前导空格），导致该后缀永远无法匹配任何真实文件。请务必紧凑书写为 *.foo;*.bar。
  • priority（优先级）：必须为正整数（如 priority="100"）。
  • version：版本号（整数或浮点数，如 version="2"）。
  • kateversion：Kate 格式版本号，必须包含小数点（如 kateversion="5.0" 或 kateversion="6.0"）。缺失该属性、无小数点或不兼容的版本会被引擎直接跳过。

4. 冲突判定与覆盖机制

当存在多个语法高亮定义冲突时，Seer 遵循确定性的优先级规则：

• 同名规则替换 (name 相同)：若新规则与已有或内置规则的 name 相同，系统将对比两者的 version 属性，版本号更高者胜出；若版本号相同，则优先保留先加载的规则。
• 扩展名重叠仲裁 (extensions 重叠)：当不同名称的语法规则声明了相同的扩展名时（例如两套规则均声明了 *.shader），priority（优先级）数值更高者胜出。
• 覆盖内置高亮规则：若希望替换 Seer 针对某类文件的内置高亮效果，只需在自定义 XML 中将 priority 设定为一个较大的正整数（如 priority="100"；内置规则优先级通常为个位数），即可确保自定义规则优先接管该扩展名。

视频与音频查看器

支持 GPU 硬件解码加速（默认未开启）与实时音频可视化，流畅播放各类主流多媒体格式。

解码与 OpenGL 渲染要求

• 解码后端：硬件解码 默认处于关闭状态——在 设置 > 类型 > 媒体 中，停用硬件解码 选项开箱即为勾选状态，因此 Seer 默认以 CPU 软件解码运行（FFmpeg、dav1d）。取消勾选该项即可允许 Seer 调用 GPU 硬件加速解码。解码管线还可在 user.ini [Media] 中通过 decoders 自定义首选解码后端顺序（支持 D3D11、MFT:d3d=11、DXVA、CUDA、FFmpeg、dav1d 等）。
• ⚠️ OpenGL 硬件渲染：视频画面的渲染绘制严格依赖显卡的 OpenGL 硬件上下文。在极少数特殊系统环境下（如未开启 GPU 直通的远程桌面连接、虚拟机、或显卡驱动异常/损坏），可能因缺少 OpenGL 环境导致视频画面无法正常渲染出图。

播放控制特性与音量差异

• 倍速调整机制：播放倍速调节仅在当前运行的程序生命周期内有效，下次重新启动 Seer 时会自动重置恢复为 1.0x 正常速度。
• 常规预览 vs 独立窗口音量控制：
  • 常规预览窗口：仅支持切换 静音 / 取消静音（按下 M 或点击控制栏静音按钮），不提供常驻音量滑块调节；
  • 独立窗口 (SeerViewer.exe)：支持通过鼠标滚轮或音量滑块弹出框精细调节音量大小，配备屏幕音量浮层提示 (Volume OSD)，并在退出后自动保存并持久化音量偏好。
• 字幕轨选择与同目录外挂自动发现：对于内嵌多语言字幕轨的视频，可通过右键 字幕 菜单选择切换或关闭字幕轨。Seer 同时会自动探测并挂载视频同级目录下同名的 .srt、.ass、.ssa、.vtt 外挂字幕文件。
• 小于 1 秒超短内容保护：时长在 1 秒以下 (< 1,000 ms) 的超短媒体文件不提供常规播放交互功能：进度条、时间指示器、播放/暂停按钮、倍速按钮与静音按钮完全隐藏，时间轴相关快捷键全部禁用。循环播放会自动关闭以避免反复重启解码管线导致高频闪烁，媒体播放一次后停留在最后一帧，控制栏给出“无时间轴”状态提示。
• 视频章节标记与悬停提示：对于内嵌章节信息的视频（如 MP4 / MKV），进度条上会自动绘制章节分割标记。鼠标悬停在进度条上滑动时，会浮现包含精确时间戳与对应章节标题的工具提示（例如 04:15 | 第二章 概述）。
• 时间指示器模式切换：点击控制栏上的时间标签按钮，即可即时切换时间显示模式（在已播时间 / 总时长与倒计时剩余时间之间切换），切换后的显示偏好会自动保存。
• 百分比数字快进：播放时直接按下数字键 0 ~ 9，可瞬间跳转至视频总时长的 0% ~ 90% 位置。
• 逐帧微调 (Frame Stepping)：按下快捷键 , / . 会自动暂停并进行“上一帧 / 下一帧”单帧步进（按住 Shift + , / Shift + . 支持快速 5 帧大步进）。亦可在右键“跳转”菜单中选择逐帧步进操作。
• 记忆播放进度：默认不开启；可在设置或 user.ini [Media] 中通过 audio_remember_playback_pos 与 video_remember_playback_pos 开启音视频记忆播放进度。

画面与封面复制

在预览音视频时，随时按下快捷键 Ctrl + C 即可将画面素材快速复制到系统剪贴板：

• 视频当前帧提取：直接将当前视频播放/暂停所在的原始分辨率画面帧作为无损高清图片复制到系统剪贴板。
  • 精确定位指定帧：若需要截取特定镜头或某一精准帧，可先暂停视频，配合逐帧步进快捷键（按 , 上一帧、按 . 下一帧，或按 Shift + , / Shift + . 快速大步进 5 帧）定位至目标画面，再按下 Ctrl + C 即可精准提取。
• 音频封面与波形提取：
  • 包含内嵌封面时：若音频内嵌有专辑封面且当前处于封面模式（纯封面或封面与波形组合），按下 Ctrl + C 会直接提取原始高清专辑封面图片存入剪贴板；
  • 无封面（或纯波形模式）：若音频本身没有封面或当前设置为纯波形视图，按下 Ctrl + C 会直接截取当前渲染呈现的音频动态波形画布，以图片形式存入剪贴板。
• 每次复制成功后，屏幕上均会弹出提示确认截图已保存至剪贴板。

音频动态波形图与电影 RAW 格式

• 音频动态波形图：播放纯音频文件（MP3、FLAC、WAV 等）时内置动态波形分析器（可在右键菜单中随时切换）：
  • 3 种视图模式：纯专辑封面、封面与波形组合、纯波形显示；
  • 4 种波形渲染样式：镜像柱状频谱、对称柱状频谱、平滑频域曲线、动态流体波浪。
• 电影级 RAW 原始视频扩展：配合官方 mdkadapter 插件，可原生直接预览影视级摄影机原始底片格式 RED R3D (.r3d) 与 Blackmagic RAW (.braw)。

图片查看器

专为设计审阅与摄影检视打造，兼具 GPU 硬件加速渲染、深度手势交互以及超大无损图片的瞬间秒开。

视图排版与画布导航手势

• 默认显示模式：可在 设置 > 类型 > 图像 中自定义每次打开图片时的首选尺寸形态：
  • 自动适配 (Auto Fit)（默认）：缩放以完整容纳整张图片于窗口内，不出现滚动条。
  • 短边适应 (Fit Short Side)：优先将图片的短边撑满窗口边缘，长边通过滚动条平移，便于直接阅读长截图或宽幅全景素材。
  • 原图优先 (Prefer Full Size)：始终以原始 100% 物理分辨率展示，图片细节分毫毕现。
• 智能边缘扩展 (E)：按快捷键 E（或通过鼠标右键菜单选择“扩展”），Seer 会智能优化预览窗口尺寸与缩放比例：
  • 针对竖长图（如手机长截屏、网页长图）：自动将图片宽度撑满屏幕可用宽度，高度随之展开并支持顺畅垂直滚动；
  • 针对横长图（如全景长图、横幅大图）：自动将图片高度撑满屏幕可用高度，宽度随之展开并支持横向平移浏览；
  • 程序会自动计算屏幕最大可用区域并智能调整窗口大小，无需用户反复手动拖拽拉大窗口。
• 直接边框贴合：按快捷键 W 直接贴合窗口宽度，按快捷键 H 直接贴合窗口高度。
• 双击瞬时切换：双击画面任意区域，即可在“1:1 实际物理像素”与“自适应窗口尺寸”之间瞬间往返切换。
• 滚轮与触控板手势优化：
  • 滚轮行为模式：在 设置 > 类型 > 图像 中，可自由设定鼠标滚轮的默认动作为“垂直滚动平移画布”或“直接无级缩放（无需按住 Ctrl）”。
  • Shift + 滚轮：水平横向滚动画面——浏览宽幅全景大图时无需手动拉动横向滚动条。
  • Windows 精准触控板 (Precision Touchpad)：原生支持双指开合无级缩放 (Pinch-to-zoom)、双指同向滑动自由平移画布。
  • 鼠标拖拽平移：图片放大后，按住鼠标左键即可自由抓手平移画布视口。
• 视口小地图导航 (M)：按快捷键 M 开启或关闭右下角的全景微缩导航图。在大图深度放大后，小地图上会清晰框选当前视口位置，支持直接点击或拖拽白色框体在数万像素的大图间精准定位。

隐蔽检视技巧与背景切换

• 分辨率标签与实时缩放比例提示：控制栏上的分辨率标签默认常驻显示图片的原始像素大小（如 3840×2160）。将鼠标光标悬停在分辨率标签上时，会浮现工具提示，实时展示当前窗口内的显示尺寸以及精确缩放百分比（例如 1280×720 (33.33%)），方便快速掌握当前画面的实际缩放倍率。
• 5 种画布背景底色循环切换 (B)：
  • 按快捷键 B（或通过右键菜单），可在 无底色（跟随软件主题）、透明棋盘格、纯黑、纯灰、纯白 5 种背景模式之间即时循环切换。
  • 解决透明图检视痛点：对于带有透明通道的浅色 Logo、白色线条矢量图或暗色图标，一键切至纯黑或纯白底色，可瞬间凸显白色高光轮廓或暗部透明细节，是设计师与开发者的实用利器。
• 方向旋转与镜像翻转：按 R / L 顺时针 / 逆时针旋转画面 90°；按 X / Y 进行水平 / 垂直镜像翻转。
• 超大图片分级秒开（150 MiB 阈值）：
  • 面对动辄数亿像素的卫星航拍图、超清扫描件或巨幅 TIFF 时，传统图片查看器容易假死甚至内存溢出。
  • Seer 设定了 150 MiB 大图阈值：超大图片优先以毫秒级提取高质量预览图像，实现按空格瞬间秒开；状态栏提供全量无损加载提示，兼顾极致响应速度与巨量数据解析。

专业格式兼容与元数据深挖

• 专业级 Adobe PSD 原生兼容：
  • 无需启动笨重的 Photoshop，直接原生解析 .psd 设计工程文件。
  • 全面支持 8 位、16 位、32 位色彩深度。
  • 完美兼容 CMYK 印刷色彩模式、双色调 (Duotone)、索引色 (Indexed) 以及多通道 (Multichannel) 模式，方便快速校对印刷分色稿与设计图。
• 相机 RAW 无损底片秒级直出与 EXIF：
  • 原生支持各大相机厂商的无损原始底片：Canon (.cr2, .cr3)、Nikon (.nef)、Sony (.arw)、Fujifilm (.raf)、Adobe (.dng)、Olympus (.orf)、Panasonic (.rw2) 等。
  • 优先提取相机内嵌的全尺寸高清图像，按空格键毫秒级直出；在属性检查器 (Ctrl + I) 中完整提取机身型号、镜头规格、光圈大小、快门速度、ISO 感光度、曝光补偿、焦距及 GPS 拍摄经纬度。
• 动图智能流探测：
  • 许多 .apng 与 .webp 文件内部仅包含一帧静态图像。Seer 会自动探测动画元数据，智能分流走最佳查看引擎：
  • 单帧静态文件：自动分流走标准静态图片通道，支持 1:1 像素比对与 EXIF 查看。
  • 多帧动态图 (GIF / APNG / 动态 WebP)：自动加载动态播放引擎，支持播放/暂停控制，并可用快捷键 , / . 进行单帧逐帧回退 / 前进，精准提取动画帧。
• 多图层图标容器 (ICO / CUR / ICNS) 与 PNG 导出：
  • 查看包含多套分辨率规格的 Windows 图标 (.ico)、指针 (.cur) 或苹果图标 (.icns) 时，控制栏会自动列出内嵌的所有尺寸与色深规格（如 16x16, 32x32, 48x48, 256x256）。
  • 控制栏提供“导出选中图像为 PNG”按钮，支持一键将当前选中的单个图标图层单独导出为透明 PNG 图片。
• 矢量图 (SVG) 无级缩放与 XML 源码直达：
  • 无论放大多少倍均保持平滑边缘无锯齿；右键菜单提供一键切换至“查看 XML 源码”视图，无需在文本编辑器中重复打开即可快速审查 SVG 代码结构。

PDF 文档查看器

内置基于高保真矢量引擎的独立 PDF 渲染模块，提供流式分批渲染、超大白皮书流畅阅读与深度批注交互。

阅读排版与平铺总览

• 双页对开排版 (P)：按快捷键 P（或通过右键菜单），可在“单页连续垂直滚动”与类似实体书的“双页跨页对开排版”之间自由切换。
• 平铺总览视图 (Ctrl + G)：按快捷键 Ctrl + G 可进入全书总览模式，将文档所有页面以高清缩略图网格平铺铺开，点击任意页面缩略图即可直接定位跳转。
• 翻页与快速导航：按 [ / ] 翻至上一页 / 下一页；按 Home / End 直达文档首页 / 尾页。按快捷键 M 开启或关闭视口小地图。
• 一键缩放调节：按 W 适应页面宽度，按 H 适应页面高度，按 A 还原为 1:1 实际物理大小。
• 3 种阅读配色主题 (D)：按快捷键 D 循环切换 默认白底、暗黑夜间模式（深色护眼反色）与 柔和米黄暖色（纸张质感护眼），不破坏文档原格式。
• 分页线风格切换 (G)：按快捷键 G 循环切换页与页之间的间隔样式（默认纯净间隙、实线分割、虚线分割、波浪线分割）。
• 页面旋转 (R / L)：按快捷键 R / L 顺时针 / 逆时针旋转文档页面 90°。

默认缩放模式与窗口基准计算

除常规缩放快捷键（Ctrl + = / Ctrl + - 或按住 Ctrl 滚动鼠标滚轮）外，Seer 提供了 4 种开卷默认缩放模式，可在右键菜单与配置中灵活设定：

• 四种默认缩放模式：
  • 默认 / 实际大小 (Default / Actual Size)：以 1:1 原始物理尺寸打开。独特的历史恢复逻辑：仅有 此模式在打开同一文件时会自动从历史记录中恢复上次退出时的缩放比例；选择其他三种模式打开时均会忽略历史缩放，直接强制套用预设规则。
  • 适应宽度 (Fit Width)：基于文档全部页面中的最大宽度（Maximum width of all pages）进行缩放计算，使最宽页面恰好贴合窗口。计算依赖基准窗口宽度 fit_w（默认值为 960 像素，可在 user.ini [PDF] 中配置）。
  • 适应高度 (Fit Height)：基于当前页面的高（在双页对开排版中采用对开页中较高的一页）进行缩放计算，使页面高度贴合视口高度。user.ini [PDF] 中的 fit_h = 960 仅作为初始窗口高度计算基准。
  • 自定义缩放 (Custom Zoom)：始终以用户指定的固定倍率（如 125%、150% 等）直接打开所有 PDF。
• 完善的右键缩放菜单与一键存为默认：
  • 右键菜单提供完整的缩放控制组，并实时显示当前正在生效的缩放百分比（如 自定义 (135%)）；
  • “将当前缩放设为自定义默认”：当您通过快捷键或滚轮随意微调到了最舒适的阅读比例后，右键点击此选项，即可将当前画面的精确比例一键固化为全局的自定义默认比例。

侧边栏导航与缩略图对齐

• 动态智能侧边栏 (O)：按快捷键 O 展开或折叠侧边栏。侧边栏会根据当前 PDF 文件内嵌的实际数据动态展示功能标签页，避免无效展示：
  • 页面缩略图：恒定存在，提供带独立页码标号的连续页面微缩图流；
  • 文档目录大纲 (TOC)：仅在 PDF 文件本身包含书签/目录数据时才会出现，提供多层级树状目录快速跳转章节；
  • 高亮与批注列表：仅在文档中存在读者批注时才会出现，汇总所有高亮画线、删除线与文本附注。
• 缩略图当前页对齐 (V)：在主视口阅读正文时，随时按快捷键 V，侧边栏缩略图列表会自动滚动并将当前正文正在阅读的页面居中高亮对齐。
• 侧边栏停靠位置可配：默认停靠在右侧，可在 user.ini [PDF] show_sidebar_left = true 中自由调整为靠左停靠。

交互式超链接、全文检索与安全

• 原生交互式超链接：直接支持点击文档内目录跳转指定页、点击内部跨页锚点、点击外部网页 URL（直接调起默认浏览器打开）、以及点击 mailto 邮箱链接发起邮件。
• 批注与划线可见性 (T)：按快捷键 T 开启或关闭文档中所有高亮标记、下划线及文本批注图层的显示。
• 全文流式检索 (Ctrl + F)：
  • 后台异步流式检索并带有动效指示环；
  • 支持区分大小写匹配 (Aa)，当前命中项以深橙色高亮并自动垂直居中，其余命中项以黄色浅亮显示，全面支持跨行折行短语连贯跳转。支持使用 F3 / Shift + F3 在匹配项之间跳转。
• 密码加密文档解锁：遇到带有安全口令保护的加密 PDF，会自动弹出原生密码输入对话框解锁预览，防止程序假死崩溃。

文件夹与压缩包查看器

无需解压即可瞬间透视目录层级与归档文件内容，深度整合现代开发与设计工作流。

三种核心排版视图

• 层级树状视图 (Alt + T)：经典多层级可折叠展开树状目录结构，直观呈现文件夹与子文件的从属关系。
• 多列穿透导航 (Alt + C)：类似 macOS Finder 的多列穿透导航，在深层级目录中点击子项即可平滑向右延伸展开下一层级，浏览深层文件无需频繁进退目录。
• 画廊卡片视图 (Alt + Y)：专门针对图片、摄影与素材目录优化的大尺寸高清缩略图网格流，支持使用方向键平滑导航，右侧联动信息属性窗格。

Git 状态集成与就地检索

• Git 仓库状态指示：
  • 当预览的文件夹位于 Git 仓库中时，Seer 会自动探测仓库状态并在文件旁边绘制状态颜色标识：
  • Modified (M)：当前工作区或暂存区已修改的文件；
  • Added (A)：新暂存添加的文件；
  • Untracked (?)：新建尚未被版本追踪的文件；
  • Renamed (R)：已重命名的文件；
  • Deleted (D)：已删除的文件。
  • 该功能可在 设置 > 类型 > 文件夹 中开启或关闭（默认开启）。
• 文件名就地实时检索 (Ctrl + F)：
  • 在目录内直接按 Ctrl + F 实时输入关键词查找，支持大小写匹配 (Aa)；
  • 命中名称高亮显示，未命中项以半透明淡化代替隐藏，使目录树整体结构依然清晰可读。按 Enter 或 F3 可在所有三种视图中循环定位跳转。
• 右侧信息与属性预览窗格 (Alt + D)：
  • 按 Alt + D 快速开启或关闭右侧信息窗格，直接查验所选文件的缩略图、详细系统属性与备注信息，无需单独弹窗。

归档免解压与高效操作

• 主流压缩包免解压穿透与二次解压：
  • 原生直接读取主流归档格式，包括 .zip、.7z、.rar、.tar、.gz、.bz2、.xz、.zst、.iso、.cab、.chm、.arj 等数十种压缩包，不向磁盘解压任何临时文件。
  • 原生支持嵌套包含二次解压格式的多层归档直接穿透浏览。
• 后台异步目录体积扫描：打开文件夹后，会在独立的辅助进程中启动体积扫描，预览窗口保持完全响应；扫描完成后，文件夹的综合占用体积会自动显示在属性检查器中。
• 便捷路径提取：
  • 通过右键菜单可一键复制绝对路径、相对路径或整个目录清单文本到剪贴板。

网页与 Markdown 查看器

为 .html、.mhtml 以及 .md 文件提供现代化的离线渲染能力。

浏览器引擎与安全注意事项

Seer 的网页与 Markdown 查看器内置了完整的 Chrome (Chromium) 浏览器核心，具备与现代浏览器完全一致的排版引擎与执行环境：

• 基于 Chrome (Chromium) 核心：完整兼容 HTML5、现代 CSS3、JavaScript、Canvas、SVG 与硬件加速，无论是离线单页应用、报表页面还是 .mhtml 归档网页均能高保真呈现。
• 本地与网络资源权限：
  • 为了完整呈现离线数据报表、开发文档与 Markdown 预览，放宽了本地文件的安全边界限制：本地文档可以直接引用加载跨目录的本地图片、字体与样式表，也可以正常请求 CDN 或外部网络资源，并允许脚本读写剪贴板。
• 数据缓存与持久化存储：
  • 网页 HTTP 网络请求缓存保存在纯内存中（MemoryHttpCache），而持久化站点数据（如 HTML5 localStorage、IndexedDB 及存储数据）会安全保存在本地应用目录 %LocalAppData%\Corey\Seer\web。
• ⚠️ 安全风险警示：
  • 由于预览 HTML 文件时赋予了其执行脚本、读取本地文件、请求网络与读写剪贴板的权限，请切勿使用 Seer 预览来源不明、未经验证的可疑 .html 文件。

悬浮查找栏与目录大纲

• 悬浮查找栏：
  • 查找栏在视口上方以独立悬浮窗口呈现，在硬件加速的 Web 视口之上始终保持锐利清晰且带有半透明阴影，杜绝被网页元素遮挡。
  • 按快捷键 Ctrl + F 呼出页面关键字查找，支持大小写匹配 (Aa)，并支持使用 F3 / Shift + F3 在各匹配项之间快速定位。
• 悬浮目录大纲 (T)：按快捷键 T 开启或关闭由文章标题自动生成的悬浮目录 (TOC)，阅读时长篇文档会自动跟随当前进度高亮对应章节。
• 排版字号无级缩放：按住 Ctrl 并滚动鼠标滚轮，或使用快捷键 Ctrl + = / Ctrl + -，可实时放大或缩小页面文字与排版比例。

Markdown 主题、数学公式与技术图表

• 100% 本地离线运行：所有 Markdown 渲染资源（包括主题样式表、KaTeX 字体库、Mermaid 图表引擎及脚本）全部内置随软件随附。预览排版完全离线运行，无需任何外网连接或线上 CSS/JS 依赖，即使在无网或内网隔离环境下也能毫秒级秒开渲染，杜绝任何隐私泄露隐患。
• 精选主题库：内置 default、github_light、github_dark、obsidian、studio、papyrus、amethyst、prism、evergreen、sahara、nordic 以及专为中文排版优化的 heti（赫蹏）主题，亦可在 设置 > 类型 > HTML 中指定自定义 CSS 文件。
• LaTeX 矢量数学公式：原生支持基于 KaTeX 的行内公式（$...$）与独立块公式（$$...$$）高精排版。
• 技术图表绘制 (Mermaid)：原生支持流程图、时序图、甘特图、类图等技术图表渲染。
• GitHub 风格提示块 (Alerts)：原生卡片式渲染 [!NOTE], [!TIP], [!WARNING], [!IMPORTANT], [!CAUTION]。
• 一键另存为矢量 PDF：控制栏提供“另存为 PDF”按钮，将排版精美的 Markdown 或网页一键打印保存为高质量矢量 PDF 文档。

系统预览器与缩略图

针对 Seer 内置查看器未覆盖且未安装专门第三方插件的专有文件格式，Seer 提供了直接调用 Windows 系统生态的两级兜底机制。

功能定义与原理现状

在理解该模块前，首先需要明确这两项功能分别代表什么以及数据来源于何处：

• 系统预览器：
  • 对应 Windows 资源管理器自带预览窗格（快捷键为 Alt + P）中所呈现的内容。
  • 它是一个由操作系统或第三方软件注册的交互式预览组件（如可滚动的文档视口、交互式排版界面等）。
• 系统缩略图：
  • 是将 Windows 系统或关联软件为该文件生成的图标/缩略图提取出来并放大居中展示。当文件缺乏交互式的系统预览器时，放大后的高清缩略图能确保“有图可看”。
• 能力来源：通常由安装的对应软件提供：Windows 系统本身并不自带所有专有格式的预览能力，这些能力通常是由您安装的对应应用程序自动向系统注册提供的（例如：安装 Photoshop 后系统获得 .psd 预览能力，安装 Microsoft Office 或 WPS 后获得 .docx、.xlsx、.pptx 预览支持，安装 CAD 软件后获得工程图纸预览支持）。
• Seer 的角色定位：尝试读取并呈现该数据：
  • Seer 只是尝试读取系统中的这一层数据并将其优雅呈现。Seer 自身并不内置这些专有格式的解析引擎，而是直接调用 Windows 系统的标准预览与缩略图接口桥接系统现有能力。
  • 若系统中未安装能够解析该文件的对应软件，或者该软件未向 Windows 注册预览组件，Seer 亦无法凭空调取其预览内容。

两级加载与自动降级流程

当遇到非内置格式时，Seer 遵循以下阶梯式处理流程：

graph TD
    A["遇到非内置专有格式文件 (按空格键预览)"] --> B{"系统或对应软件是否提供了系统预览器？"}
    B -- "已提供且加载成功" --> C["加载系统预览器 (嵌入原生交互式视口)"]
    B -- "未提供或加载失败" --> D{"是否启用了缩略图兜底？"}
    D -- "已启用且系统存在缩略图" --> E["提取高清缩略图 (放大居中展示)"]
    D -- "未启用或系统无缩略图" --> F["提示无法预览当前文件"]

1. 第一优先级：系统预览器：优先查找并载入系统或已安装软件提供的原生预览组件，直接在 Seer 窗口中嵌入显示与资源管理器预览窗格完全一致的原生交互界面。
2. 第二优先级：系统缩略图：若未找到可用的预览器或组件加载失败，Seer 会在后台调取系统最高规格的缩略图并进行高清放大自适应渲染，避免弹窗空白。

按键响应保障与云端文件防护

• 按键快速关闭：当 Seer 自身拥有输入焦点时，按下 Space 或 Esc 会照常立即关闭预览。当嵌入的第三方外部预览处理程序（如 Microsoft Office 或 Adobe 预览器）夺取了键盘焦点时，按键事件将不再直接传递给 Seer，此时 Seer 会回退使用全局底层键盘钩子。钩子开箱即可捕获 Space；而外部组件获焦时的 Esc 按键转发由 user.ini [General] 中的 enable_esc_key 控制（默认关闭）——若希望在第三方预览器持有焦点时按下 Esc 也能退出窗口，可将其开启。
• 云端占位文件按需下载防护：针对 OneDrive 或其他网盘未下载到本地的“仅联机占位文件”，Seer 会自动识别并拦截，严格禁止触发系统预览器与属性提取，防止后台意外消耗流量或等待超大文件同步下载。

设置与个性化管理

可在 设置 > 类型 > 系统 中集中管理该模块：

• 全局开关：在 设置 > 类型 > 系统 中随时开启或关闭整个系统预览模块。
• 单独控制缩略图兜底：若您只希望查看可交互的系统预览器，不希望看到放大的缩略图，可在 设置 > 类型 > 系统 中取消勾选【无预览处理程序的文件使用系统缩略图】。
• 格式排除列表：支持在 user.ini [SystemViewer] 中通过 exclude 指定排除特定的文件扩展名（例如排除某些启动极慢或容易发生异常的第三方预览组件）。

已知问题与关键使用提示

1. 文件被占用导致无法重命名或删除

• 现象：在当前预览窗口未关闭的情况下，若尝试在 Windows 资源管理器或其他程序中对该文件进行重命名、移动、覆盖保存或删除操作，系统可能会弹出警告提示：“操作无法完成，因为文件已在另一个程序中打开”。
• 解决方案：
  • 只需按 Space 键或 Esc 关闭当前的 Seer 预览窗口（或者在文件管理器中切换到其他任意文件），Seer 会立即退出预览组件并解除对文件的占用，随后即可正常进行重命名或删除操作。
• 与缩略图模式的区别：
  • 如果该格式触发的是系统缩略图或 Seer 原生内置查看器，通常仅在读取瞬间打开文件，读取完成后立即释放，不会产生持续占用的情况。

2. 系统预览器数据缓存与手动刷新

• 软件增删后的现象：当您在系统中新安装或卸载了某款第三方软件（例如新安装了 Photoshop、Office、CAD 或解压工具）后，由于 Seer 仍在读取原先缓存的信息，可能无法立刻感知到新软件提供的系统预览支持。
• 如何刷新生效：
  • 重启 Seer，或者在 Seer 设置中修改任意查看器开关后点击 确定 保存。
  • 刷新原理：当查看器运行时重新加载时，会自动清空系统预览器的本地缓存；随后下一次预览时，Seer 会重新扫描系统并识别新安装软件的预览能力。

常用设置与偏好配置

按下快捷键 Ctrl + ,（或右键单击系统托盘图标选择 设置），即可打开 Seer 设置面板。以下为您梳理各核心界面的常用配置选项与调优技巧：

1. 常规设置

• 语言：选择您习惯的界面语言，内置包含简体中文、繁体中文、English 等十余种语言。
• 外观主题：支持在 浅色 (Light)、深色 (Dark) 与 跟随系统 (Auto) 之间自由切换。
• 开机自启动：
  • 官网桌面版：默认通过标准的 Windows 注册表启动项自启。亦可在 设置 > 系统 中开启“使用任务计划开机自启”，具备更高权限与抗拦截稳定性；
  • 微软商店版：点击“打开系统设置”按钮，可直接跳转至 Windows 系统的“应用 > 启动”管理界面进行授权。
• 以管理员身份运行：使 Seer 提权运行。当您在以管理员权限运行的文件管理器（如 Total Commander、Directory Opus 或管理员模式的 Everything）中工作时，Seer 需具备相同权限才能正常捕获空格按键。
• 自动检查更新：开启后，Seer 会在每次启动时轻量检测是否有新版本发布。

2. 文件类型设置

在 设置 > 类型 中集中管理各类文件的关联与独立功能配置：

• 格式分类标签：顶部可切换查看 文本、图像、媒体、文件夹、PDF、HTML、系统、未知（没有特定查看器接管文件时使用的通用属性检查器）与 已禁用 分类；
• 总开关与扩展名管理：每个分类均包含独立的启用/停用开关。查看器的额外扩展名可通过 user.ini 对应的 extra_support 键添加（例如 [Text] extra_support）；已禁用 分类是唯一带有标签编辑器的分类，用于维护全局排除名单；
• 分类专属设置项：
  • 图像：配置默认显示模式（自动适配、短边适应、原图优先）与鼠标滚轮行为（滚动 vs 缩放）。小地图开关位于 user.ini [Image] 中的 show_minimap；
  • 文件夹：开启或关闭 Git 仓库状态颜色标识（M, A, ?, R, D）；
  • HTML：选择默认 Markdown 主题并支持指定外部自定义 CSS 样式文件；
  • 系统：开启或关闭缺少预览程序时的系统缩略图高清兜底；
  • 已禁用：集中维护全局黑名单后缀，完全忽略这些格式的空格预览响应。

3. 高级设置

• 双击窗口打开文件：勾选后，在任意预览窗口画面内双击鼠标左键，即可立即调用系统关联的默认程序打开该文件（与按快捷键 Ctrl + O 效果相同）。
• 加载云端文件：控制是否自动下载并预览云端占位文件（如 OneDrive 按需同步文件）。保持未勾选可有效节约网络流量与本地存储。
• 文件光标追踪：在资源管理器中移动方向键选择不同文件时，Seer 预览窗口会自动跟随光标实时刷新，无需反复敲击 Space 键。
• 外部修改自动热重载：开启后（默认关闭），当前正在预览的文件在外部编辑器被修改保存时，Seer 会自动原地刷新最新内容（文本查看器还会自动恢复阅读位置）。对于文件夹，仅检测 1 级目录内的变动。
• 预览窗口焦点：决定预览窗口弹出时是否抢夺键盘焦点。当发现按下 Space 预览后快捷键“无法响应”时，通常与此设置相关：
  • 永不获取焦点（默认）：预览窗口绝不抢夺资源管理器或文件管理器的焦点，方向键切换文件与键盘输入保持顺畅。再次按下 Space 可立刻关闭预览；如需使用查看器专属快捷键（如 Z、M、Ctrl + F 等），需先鼠标点击窗口内部激活；
  • 每次预览文件时：每次按空格或切换预览均立即激活预览窗口，查看器快捷键即刻可用，但焦点会离开文件管理器；
  • 仅在窗口打开时：仅在初次弹出预览窗口时获取一次焦点，后续保持打开并切换文件时不再重复夺取焦点。
• 接收模拟键盘事件：默认关闭。Seer 的键盘钩子会主动忽略被 Windows 标记为模拟或注入的按键，以防宏脚本、屏幕键盘或远程桌面在后台误触发预览。若您通过 AutoHotkey、AutoIt 脚本、虚拟键盘或无障碍辅助工具驱动 Seer，请勾选此项。该选项同时适用于触发键及后续的 Delete / Esc 按键响应。
• 窗口大小和位置模式：
  • 自动适应大小与位置（默认）：根据每个文件的原始分辨率和最佳比例动态调整窗口尺寸；
  • 保持窗口大小和位置：记住上一次关闭预览窗口时的屏幕坐标与窗口长宽；
  • 每次打开窗口都居中：不论上次位置为何处，每次打开均居中显示在当前屏幕中央。
• 标题栏按钮动作：配置点击标题栏主按钮时的响应行为：
  • 分离窗口（默认）：将预览窗口原地分离为独立的浮动子窗口，随 Seer 主程序退出而关闭；
  • 钉住窗口：将当前窗口置顶钉住，失去焦点时不自动退出；
  • 独立窗口：启动完全隔离的独立轻量进程 (SeerViewer.exe) 承载该预览。
• 允许 Delete 键删除文件：使 Delete 键能与 Seer 的文件句柄智能协同，具体行为取决于焦点所在位置：
  • 焦点位于预览窗口：Seer 自动关闭预览（以及显示同一文件的其他分离窗口），并将文件移入 Windows 回收站。加载中途不会触发误删，钉住窗口仅能由用户主动关闭；
  • 焦点位于文件管理器：Seer 自身不执行删除操作，仅自动隐藏预览并迅速释放文件占用句柄，避免资源管理器、Total Commander 或 Directory Opus 弹出“操作无法完成，因为文件已在另一个程序中打开”的错误；
  • 若您习惯在重命名或整理文件时保持 Seer 常驻开启，且不希望任何按键意外删除文件，请保持此项未勾选。
• 隐藏托盘图标：可彻底隐藏右下角系统托盘图标以追求极简桌面。若需重新找回，在启动后的前 8 秒内托盘图标会强制显现，亦可在任意预览窗口中直接按 Ctrl + , 呼出设置。
• 直接定位 user.ini：点击面板底部的 user.ini 按钮，直接在默认文本编辑器中打开该配置文件进行深度调优（悬停按钮可查看完整绝对路径；各字段含义详见 自定义配置文件指南）。

4. 系统

• 使用任务计划开机自启：推荐保持勾选，使用 Task Scheduler 替代传统注册表 Run 键，自启体验更稳定且不受 UAC 提权干扰。
• 右键菜单集成：为 Windows 资源管理器的鼠标右键菜单添加 “使用 SeerViewer 打开 (Open with SeerViewer)” 选项，直接调用独立的 SeerViewer.exe 轻量进程打开该文件或目录。
• 注册到“打开方式”：在系统右键“打开方式”列表中注册 SeerViewer，方便直接指定使用 Seer 打开任意特定文件。
• 设为默认打开程序：一键打开 Windows 默认应用 设置页，方便按文件类型将关联程序指定为 SeerViewer。Seer 无法静默接管关联——Windows 强制要求用户在此页面确认。
• 文件备注总开关：全局开启或关闭属性检查器内的“文件备注与备忘录”能力。

5. 快捷键设置

• 触发键与修饰键：自定义预览主触发键（默认为 Space），支持绑定修饰键（如 Alt + Space、Ctrl + Space、Shift + Space）以防与部分软件快捷键冲突。
• 分离预览独立触发键：可为直接以分离窗口形式打开预览设定专属快捷组合。
• 全模块快捷键重映射：支持自由修改旋转、缩放、静音、换行、查找、全屏等全部操作按键，打造契合个人肌肉记忆的工作流。

6. 配置备份、导入与恢复

在 高级 设置面板底部提供了配置迁移与重置功能，方便在多台设备间同步或一键恢复出厂状态：

• 导出：将当前配置快照写入指定的 .ini 文件。该文件采用 Seer 专属的导出格式（带版本号，不建议手动编辑），主要用于备份归档。快照包含 config.ini 中的全部设置（外观主题、快捷键、类型参数、插件开关等）；不包含 user.ini 自定义参数，并会自动排除激活授权信息、最近历史记录（PDF / 媒体进度与缩放记忆）、窗口位置及多查看器分配表。
• 导入：载入此前导出的配置快照，并在导入完成后立即自动重启 Seer（部分配置需重启生效）。配置值将按原样应用，包括内部存储的绝对路径；若选取的非 Seer 导出文件或版本不兼容，系统将报错拒绝。
• 恢复默认：将 config.ini 重置为出厂初始值并自动重启软件。激活授权信息保持完好，且不会触动 user.ini 中手动调优的高级参数。点击该按钮后会变为“确认并重启 / 取消”按钮对，需二次点击确认以防误触。