核心功能與使用指南

文字與程式碼檢視器

專為軟體開發者與技術讀者打造，兼顧日常原始碼的高保真語法渲染，以及數十甚至數百 MB 超大型記錄檔的瞬間流暢開啟、絕不卡死。

雙檢視架構：標準檢視 vs 大檔案檢視

為了徹底解決檢視大檔案時記憶體不足崩潰與介面凍結的問題，Seer 會依據檔案大小自動調整檢視模式：

• 自動分流閾值：透過組態設定控制，預設為 3 MiB（3,145,728 位元組）。
  • ≤ 3 MiB：在 標準檢視 中開啟，提供完整的語法樣式、自動換行、程式碼格式化以及快速渲染切換。
  • > 3 MiB：自動在 大檔案檢視 中以串流方式載入檔案，確保開啟數百 MB 的記錄檔、資料庫 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）。
• 省略位元組工具提示：將滑鼠游標懸停在該標記上時，會顯示資訊工具提示，回報確切省略的位元組數（例如：此行已被截斷（省略了 14,848 個位元組）），既能保持絲滑流暢的互動，又不會在無聲無息中失去對被截斷內容的認知。

完整快速鍵清單

自訂語法醒目提示

Seer 的程式碼醒目提示引擎採用開源的 Kate 語法醒目提示規範（與 Kate、KWrite、Qt Creator 及 KDevelop 共享相同標準）。當現成的內建規則未涵蓋特殊或自訂檔案格式時，或當您想要自訂語法配色時，無需編寫程式碼或編譯任何內容，即可輕鬆新增 .xml 語法定義檔。

1. 語法參考與範例

• 語法格式參考說明：Kate 醒目提示 XML 格式說明
• 官方範例 (hextxt.xml)：ccseer/Seer-Controls/plugins/hex-viewer/syntax/hextxt.xml

官方的 十六進位檢視 (Hex View) 控制列外掛正是採用了這種機制：它將十六進位資料傾印到具有自訂 .hextxt 副檔名的檔案中，並隨附 syntax/hextxt.xml 以提供專屬的語法醒目提示。

2. 儲存位置與啟用

將您的 .xml 定義檔放入 Seer 的任一語法目錄中：

• 標準安裝版 Seer：%LocalAppData%\Corey\Seer\syntax\（即 C:\Users\<您的使用者名稱>\AppData\Local\Corey\Seer\syntax\；若 syntax 資料夾尚不存在，請手動建立）。
• 可攜式 Seer（當應用程式根目錄下存在 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"）。缺少、未含小數點或不相容的 kateversion 屬性檔案將被略過。

4. 衝突判定與覆寫機制

當多個語法定義發生重疊時，Seer 會套用確定性的優先權規則：

• 名稱完全相同（name 相符）：若自訂定義與現有或內建定義具有相同的 name，則以 version 較高者為準。若版本號相同，則保留先載入的定義。
• 副檔名重疊（extensions 衝突）：當不同語言定義宣告了相同的副檔名時（例如兩套定義皆宣告了 *.shader），priority 數值較高者勝出。
• 覆寫內建醒目提示：若要將 Seer 針對特定檔案類型的內建醒目提示替換為社群更新或自訂規則，只需在 priority 中指定較高的正整數（例如 priority="100"；內建優先權通常為個位數），Seer 即會優先採用您的自訂規則。

影片與音訊檢視器

提供 GPU 硬體解碼支援（預設關閉）與即時音訊視覺化，為所有主流媒體格式帶來流暢的播放體驗。

解碼與 OpenGL 渲染需求

• 解碼後端：硬體解碼預設關閉——設定 > 類型 > 媒體 下的 停用硬體解碼 選項已勾選，因此 Seer 預設採用軟體解碼（FFmpeg、dav1d）。取消勾選即可讓 Seer 嘗試使用 GPU 解碼器，並可在 user.ini [Media] 的 decoders 下自訂後端的精確優先順序（D3D11、MFT:d3d=11、DXVA、CUDA、FFmpeg、dav1d 等）。
• ⚠️ OpenGL 硬體渲染：影片畫面的繪製顯示嚴格要求來自 GPU 的有效 OpenGL 硬體渲染環境。在極少數環境下（例如虛擬機器、缺少 GPU 直通的遠端桌面連線，或顯示卡驅動程式過舊/損毀的系統），影片播放可能無法正常渲染畫面。

播放控制與音量行為

• 播放速度生命週期：播放速度的微調僅在執行階段有效（保留於目前應用程式生命週期內），在下次啟動 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%。
• 逐格前進後退：按下 , / . 可暫停並向後 / 向前跳轉 1 格（Shift + , / Shift + . 則跳轉 5 格）。亦可透過右鍵「跳轉」選單進行操作。
• 繼續播放進度：在設定或 user.ini 中啟用時（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 外掛 後，Seer 即可原生預覽專業電影級 RAW 素材，包含 RED R3D (.r3d) 與 Blackmagic RAW (.braw)。

圖片檢視器

專為精準設計審閱與攝影檢視打造，融合 GPU 加速渲染、深度手勢支援，以及超大無損 RAW 圖片的瞬間秒開。

顯示模式與畫布瀏覽

• 預設顯示模式設定：在 設定 > 類型 > 圖片 中設定您偏好的開啟尺寸：
  • 自動調整（預設）：自動放大或縮小，使整張圖片完整容納於檢視器視窗內，不出現捲軸。
  • 符合短邊：縮放至短邊貼合視窗邊緣；必要時可捲動長邊（非常適合長條螢幕截圖或全景橫幅）。
  • 原始大小優先：始終以 100% 原始未縮放的實體解析度開啟圖片。
• 智慧擴展 (E)：按下 E（或從右鍵快顯功能表中選取 擴展），智慧最佳化預覽視窗大小與縮放層級：
  • 針對 直式長圖（例如：手機螢幕截圖、長網頁擷取）：將圖片寬度擴展至填滿螢幕可用寬度，同時允許順暢的垂直捲動。
  • 針對 橫向全景圖片：將高度調整至符合螢幕可用高度，同時允許水平捲動。
  • Seer 會自動計算螢幕上的最大可讀尺寸，並相應調整預覽視窗大小。
• 直接邊框貼合：按下 W 使圖片符合視窗寬度，或按下 H 使其符合視窗高度。
• 按兩下切換：在畫布任意處按兩下，即可在 1:1 實際畫素解析度與視窗最適大小模式之間瞬間切換。
• 滑鼠滾輪與觸控板手勢：
  • 滾輪動作模式：在 設定 > 類型 > 圖片 中，選擇滾動滑鼠滾輪是垂直捲動畫布，還是無需按住 Ctrl 即可平滑縮放。
  • Shift + 滾輪：水平捲動畫布——輕鬆平移寬幅圖片，無需拖曳捲軸。
  • Windows 精確觸控板：原生支援雙指雙向開合縮放 (Pinch-to-zoom) 與雙指流暢畫布平移。
  • 點擊並拖曳：放大後，只需按住滑鼠左鍵並拖曳即可自由漫遊畫布。
• 概觀縮圖 (M)：按下 M 可切換右下角導覽縮圖的顯示。放大檢視時，點擊或拖曳縮圖上的醒目提示視口方框，即可精確跳轉巡覽數千畫素的巨大畫布。

檢視技巧與背景切換

• 解析度標籤與即時縮放工具提示：底部控制列上的解析度標籤顯示圖片的原始原生尺寸（例如 3840×2160）。將游標懸停在該標籤上會顯示即時工具提示，呈現 目前渲染尺寸與精確縮放百分比（例如 1280×720 (33.33%)），讓您對目前的縮放比例一目了然。
• 5 種畫布背景模式切換 (B)：
  • 按下 B（或使用右鍵選單）可在 無背景（跟隨應用程式主題）、透明棋盤格、純黑、純灰 與 純白 之間瞬間循環切換。
  • 解決透明度檢視痛點：檢視淺色/深色透明 PNG、單色標誌或白色向量 SVG 時必不可少——切換至黑色可檢視白色醒目提示，切換至白色可檢查深色輪廓。
• 方向旋轉與翻轉：按下 R / L 順時針 / 逆時針旋轉 90°；按下 X / Y 進行水平 / 垂直翻轉。
• 超大圖片快速開啟（150 MiB 閾值）：
  • 開啟巨大圖片（掃描檔案、數十億畫素空拍圖或超過 150 MiB 的大型 TIFF 檔案）往往會導致一般檢視器凍結。
  • Seer 採用兩階段管線：在按下空白鍵時於數毫秒內擷取高解析度內嵌預覽資料以實現零卡頓的即時預覽，同時支援隨選載入完整未壓縮點陣圖，避免記憶體耗盡。

進階格式與中繼資料

• 專業 Adobe PSD 相容性：
  • 無需啟動 Photoshop，即可完全相容原生 Adobe Photoshop .psd 檔案。
  • 全面支援 8 位元、16 位元與 32 位元 色彩深度。
  • 在 CMYK 印刷色彩、雙色調 (Duotone)、索引色 (Indexed) 及多色版 (Multichannel) 模式下皆具備完美的色彩渲染。
• 相機 RAW 無損底片與 EXIF：
  • 原生直接解碼專業相機 RAW 格式：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)：
  • 對於封裝了多種解析度與位元深度的 Windows 圖示 (.ico)、游標 (.cur) 或 macOS 圖示 (.icns)，底部控制列會顯示所有內嵌圖示大小的可選清單（例如 16x16、32x32、48x48、256x256）。
  • 點擊控制列中的 匯出選取影像為 PNG，即可將作用中的圖示圖層立即匯出為獨立的透明 PNG 檔案。
• 向量圖形 (SVG) 與原始碼檢視：
  • 在任何縮放比例下皆能以無限銳利度渲染向量圖形。右鍵選單提供單鍵捷徑，可直接在文字檢視器中檢視原始 XML 原始碼結構。

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 種可設定的預設開啟縮放模式：

• 四種預設縮放模式：
  • 預設 / 實際大小：以 1:1 原始實體尺寸開啟頁面。重要的歷程記錄行為：只有 此預設選項會從檔案歷程記錄中還原儲存的縮放層級；其他模式在開啟時會忽略歷程記錄中的縮放比例。
  • 合適寬度：動態縮放頁面，使 所有頁面的最大寬度 符合檢視器視窗。初始縮放計算會參考視窗大小基準（預設 fit_w = 960，可在 user.ini [PDF] 中設定）。
  • 符合高度：動態縮放頁面，使 目前頁面 符合檢視器視窗高度（在雙頁展開時採用雙聯對開頁中較高的那一頁）。user.ini [PDF] 中的 fit_h = 960 僅提供初始視窗高度基準。
  • 自訂縮放：始終以您偏好的自訂縮放比例開啟檔案（例如 125%、150%）。
• 右鍵縮放選單與自訂預設設定：
  • 右鍵快顯功能表會顯示目前的即時縮放百分比（例如 自訂 (135%)）。
  • 「設定目前縮放為自訂」：當您將檔案調整至理想舒適的閱讀大小時，按一下右鍵並選取此選項，即可將該精確百分比立即儲存為全域自訂預設值。

側邊欄導覽與頁面對齊

• 動態檢視側邊欄 (O)：按下 O 切換側邊欄。為保持介面簡潔，分頁標籤會依據檔案內容動態顯示：
  • 頁面縮圖：對所有檔案始終可用，顯示帶有頁碼的連續縮圖列。
  • 檔案大綱 / 目錄：僅在 PDF 包含內嵌書籤/目錄資料時出現，顯示用於章節跳轉的多層級可摺疊樹狀結構。
  • 註解與評論：僅在 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 會自動偵測存放庫狀態，並在檔案項目旁顯示以顏色區分的標記：
  • 已修改 (M)：包含未暫存或已暫存修改的已追蹤檔案。
  • 已新增 (A)：新暫存的檔案。
  • 未追蹤 (?)：新建立且尚未被 Git 追蹤的檔案。
  • 已重新命名 (R)：已重新命名的檔案。
  • 已刪除 (D)：已移除的已追蹤檔案。
  • 此功能可在 設定 > 類型 > 資料夾 中切換（預設啟用）。
• 就地檔案搜尋 (Ctrl + F)：
  • 按下 Ctrl + F 即可即時搜尋檔名，支援區分大小寫比對 (Aa)。
  • 相符的檔名會醒目提示，而不相符的項目會淡化變暗而非隱藏，確保資料夾結構保持可讀。在三種檢視模式下皆可使用 Enter 或 F3 逐項跳轉比對。
• 側邊資訊檢視與預覽窗格 (Alt + D)：
  • 按下 Alt + D 切換右側資訊窗格，無需開啟個別的預覽視窗即可直接檢視檔案縮圖、EXIF 中繼資料與檔案備註。

壓縮檔檢視與快速操作

• 即時壓縮檔檢視與二次解壓縮：
  • 原生直接讀取壓縮檔，包括 .zip、.7z、.rar、.tar、.gz、.bz2、.xz、.zst、.iso、.cab、.chm 及 .arj，無需將暫存檔解壓縮至磁碟。
  • 支援需要二次解壓縮的巢狀壓縮檔。
• 背景計算資料夾大小：開啟資料夾會在個別的輔助處理程序中啟動大小掃描，確保預覽視窗保持順暢回應，並在掃描完成後於屬性檢視器中顯示資料夾的累計大小。
• 便捷的路徑複製：
  • 右鍵快顯功能表捷徑支援單鍵將絕對路徑、相對路徑或整個目錄清單複製到剪貼簿。

網頁與 Markdown 檢視器

為 .html、.mhtml 與 .md 檔案提供現代化的離線渲染。

瀏覽器引擎與安全性考量

Seer 內嵌了 完整的 Chrome (Chromium) 瀏覽器引擎，具備與現代網頁瀏覽器完全相同的版面配置與執行能力：

• Chrome (Chromium) 核心：完整相容 HTML5、現代 CSS3、JavaScript、Canvas、SVG 與硬體加速，完美支援離線單頁應用程式、報告與 .mhtml 網頁封存檔案。
• 本機與網路權限：
  • 為了支援豐富的本機報告、離線檔案與 Markdown 預覽，放寬了網頁安全邊界限制：本機檔案可載入跨目錄的本機資產、擷取外部 CDN 資源，並存取剪貼簿。
• 資料快取與永續儲存：
  • HTTP 網路快取完全保留在記憶體中（MemoryHttpCache），而永續網頁儲存（如 HTML5 localStorage、IndexedDB 及網站資料）則儲存於 %LocalAppData%\Corey\Seer\web。
• ⚠️ 安全性警告：
  • 由於預覽的 HTML 檔案被賦予了本機檔案讀取、網路存取及指令碼執行權限，切勿預覽來自未知來源的不可信、可疑或未經驗證的 .html 檔案。

浮動搜尋列與目錄

• WebEngine 上方的浮動搜尋列：
  • 搜尋列在獨立視窗中浮動於頁面上方，因此在硬體加速的網頁檢視區上保持清晰且完全半透明，不會被視口遮擋。
  • 按下 Ctrl + F 開啟頁內關鍵字搜尋，支援區分大小寫比對 (Aa) 與 F3 / Shift + F3 跳轉。
• 浮動目錄 (T)：按下 T 可切換側邊的動態浮動目錄，即時追蹤閱讀捲動進度。
• 內容縮放：按住 Ctrl 並滾動滑鼠滾輪，或按下 Ctrl + = / Ctrl + - 進行放大或縮小。

Markdown 主題、數學公式與圖表

• 100% 離線且獨立自足：所有 Markdown 渲染資產——包括主題樣式表、KaTeX 數學字型以及 Mermaid 圖表引擎——皆直接內建隨附於 Seer 中。Markdown 預覽完全在離線狀態下運作，零相依於外部 CDN 或線上 CSS/JS。
• 主題庫：精選內建主題包括 default、github_light、github_dark、obsidian、studio、papyrus、amethyst、prism、evergreen、sahara、nordic 等。亦可在 設定 > 類型 > HTML 中指定自訂外部 CSS 檔案。
• LaTeX 數學公式 (KaTeX)：原生渲染行內 $math$ 與獨立區塊 $$math$$ 公式。
• 技術圖表 (Mermaid)：原生渲染流程圖、循序圖與甘特圖。
• GitHub 警告提示區塊：原生樣式支援 [!NOTE]、[!TIP]、[!WARNING]、[!IMPORTANT] 及 [!CAUTION] 引號區塊。
• 另存為 PDF：底部控制列包含「另存為 PDF」操作，支援單鍵將排版套用樣式的 Markdown 或網頁匯出為向量 PDF 檔案。

系統預覽器與縮圖

針對 Seer 內建檢視器未涵蓋且未安裝專用 Seer 外掛的專有或特殊檔案格式，Seer 透過兩層後備（fallback）機制善用 Windows 作業系統生態系。

概念與運作原理

要理解此模組，首先必須釐清這兩項功能代表什麼，以及其基礎資料來源：

• 系統預覽器：
  • 直接對應 Windows 檔案總管內建預覽窗格 中顯示的內容（在 Windows 檔案總管中按 Alt + P 切換）。
  • 它是由第三方應用程式向作業系統註冊的互動式預覽元件（例如：可捲動的檔案檢視、互動式試算表預覽）。
• 系統縮圖：
  • 擷取系統產生或應用程式產生的 檔案圖示/縮圖，並在預覽視窗中放大置中呈現。當互動式預覽處理常式無法使用時，放大的高解析度縮圖可確保該檔案依然立即可被識別。
• 資料來源：由已安裝的應用程式提供：Windows 本身無法原生預覽每種特殊的專有檔案格式。這些功能是由您安裝的第三方軟體提供並註冊至 Windows 中的（例如：安裝 Adobe Photoshop 會提供 .psd 預覽，安裝 Microsoft Office 會提供 .docx / .xlsx / .pptx 預覽，而 3D/CAD 軟體套件則提供工程模型預覽）。
• Seer 的角色：讀取並代管現有資料：
  • Seer 僅僅是嘗試從作業系統中讀取並代管這些資料。Seer 本身並未隨附這些封閉格式的專有解碼器；相反地，它使用標準系統預覽與縮圖介面橋接至 Windows 殼層（shell）。
  • 若電腦上未安裝相關應用程式，或者該軟體未向 Windows 註冊殼層預覽元件，Seer 就無法憑空產生預覽。

兩層載入與順暢後備

當遇到非內建格式時，Seer 遵循優先循序後備流程：

graph TD
    A["專有 / 非內建檔案 (按下空白鍵)"] --> B{"Windows 或已安裝的應用程式是否提供預覽支援？"}
    B -- "可用且載入成功" --> C["代管系統預覽器 (內嵌原生互動式視口)"]
    B -- "無法使用或載入失敗" --> D{"是否啟用縮圖後備？"}
    D -- "已啟用且縮圖存在" --> E["擷取殼層縮圖 (放大並置中)"]
    D -- "已停用或找不到縮圖" --> F["顯示不支援的檔案提示"]

1. 第一優先權：系統預覽器：搜尋並啟動 Windows 或已安裝軟體所提供的預覽元件，內嵌與檔案總管預覽窗格完全相同的原生互動式檢視。
2. 第二優先權：系統縮圖：若未註冊預覽處理常式或初始化失敗，Seer 會擷取最高解析度的殼層縮圖，並平滑放大以符合視窗大小。

鍵盤快速鍵可靠性與雲端保護

• 鍵盤關閉：當 Seer 本身擁有焦點時，Space 與 Esc 照常關閉預覽。當內嵌的第三方預覽器（例如 Microsoft Office 或 Adobe 預覽處理常式）取得鍵盤焦點時，按鍵訊息不再直接傳遞至 Seer，因此 Seer 會切換至其低階鍵盤掛鉤（keyboard hook）。Space 預設即由掛鉤處理；Esc 轉發由 user.ini [General] 中的 enable_esc_key 控制，且預設關閉——若您希望在外部預覽器持有焦點時也能使用 Esc 關閉視窗，請啟用該選項。
• 雲端隨選檔案保護：對於僅限線上的雲端檔案（例如尚未下載至本機的 OneDrive 或雲端同步預留位置檔案），Seer 會自動避免啟動預覽處理常式或中繼資料擷取，防止非預期的背景檔案下載。

組態設定與管理

此模組的所有設定皆於 設定 > 類型 > 系統預覽器 中管理：

• 全域開關：在 設定 > 類型 > 系統預覽器 下全面啟用或停用後備模組。
• 個別切換縮圖後備：若您偏好僅使用互動式預覽器並希望避免放大的靜態縮圖，請取消勾選 設定 > 類型 > 系統預覽器 下的 無預覽處理常式的檔案使用系統縮圖 選項。
• 副檔名排除清單：透過在 user.ini [SystemViewer] 中設定 exclude，排除特定有問題或載入緩慢的第三方預覽處理常式。

已知限制與重要提示

1. 預覽開啟時檔案被鎖定

• 觀察到的現象：在預覽視窗保持開啟期間，嘗試在 Windows 檔案總管或其他程式中對該檔案進行 重新命名、移動、覆寫或刪除，將觸發 Windows 訊息：「因為檔案已在另一個程式中開啟，所以無法完成動作」。
• 解決方式：
  • 只需 關閉 Seer 預覽視窗（按下 Space 或 Esc），或在檔案管理員中巡覽至任何其他檔案。Seer 會立即關閉第三方預覽元件並釋放檔案，讓重新命名或刪除操作得以正常進行。
• 與縮圖的比較：
  • 相較之下，當後備 殼層縮圖 或 Seer 的原生內建檢視器作用時，檔案會被快速讀取並立即釋放，不會鎖定檔案。

2. 資料快取與手動重新整理

• 軟體變更後的現象：當您 安裝或解除安裝軟體（例如安裝 Photoshop、Office 或 CAD 工具）後，Windows 會更新其設定，但 Seer 可能會繼續讀取其快取資料，而無法立即識別新的預覽功能。
• 如何重新整理：
  • 只需 重新啟動 Seer，或在 Seer 設定中切換任何檢視器選項並點擊 確定，即可觸發完整的執行階段重新載入。
  • 運作原理：檢視器執行階段重新載入時會自動清除本機系統預覽器快取，促使 Seer 重新掃描 Windows 並識別新安裝的預覽元件。

偏好設定

按下 Ctrl + ,（或以右鍵點擊系統匣圖示並選取 設定）即可開啟 Seer 設定對話方塊。以下為您詳細介紹各設定面板中的關鍵選項：

1. 一般設定

• 語言：選擇您偏好的使用者介面語言。Seer 隨附支援超過 15 種語言的完整在地化介面。
• 外觀主題：在 淺色、深色 與 自動 (跟隨系統)（自動符合您的 Windows 系統色彩模式）之間切換。
• 開機時自動執行：
  • 桌面版：預設使用標準 Windows 登錄檔啟動。您也可以在 設定 > 系統 中選擇 使用 Windows 工作排程器，以獲得更高的可靠性與提升的權限。
  • Microsoft Store 版：點擊 開啟 Windows 設定 按鈕直接跳轉至「Windows 設定 -> 應用程式 -> 啟動」以啟用自動啟動。
• 以系統管理員身分執行：以提升的系統管理員權限重新啟動 Seer，讓 Seer 能夠在以系統管理員身分執行的應用程式（例如以管理員權限執行的 Total Commander、Directory Opus 或 Everything）中攔截按鍵並預覽檔案。
• 自動檢查更新：切換 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 檔案。
  • 系統預覽器：切換不支援格式的縮圖後備。
  • 已停用：將 Seer 絕不應預覽的特定副檔名加入黑名單。

3. 進階設定

• 按兩下以預設程式開啟檔案：啟用時，在預覽檢視區內的任意處按兩下即可立即在預設註冊的應用程式中啟動該檔案（與按下 Ctrl + O 相同）。
• 載入雲端預留位置檔案：控制在預覽未離線下載的雲端預留位置檔案（例如 OneDrive 隨選檔案）時，Seer 是否自動觸發隨選背景下載。保持取消勾選可節省您的網路頻寬與磁碟空間。
• 在檔案總管中追蹤選取的檔案：自動跟隨您在檔案總管中的選取項目；使用方向鍵巡覽即可即時更新預覽視窗，無需反覆按下 Space。
• 檔案變更時自動重新整理預覽：啟用時（預設停用），在外部程式中修改並儲存正在預覽的檔案會就地重新載入檢視（文字檢視器會還原其儲存的閱讀位置）。針對資料夾，它會監視第 1 層目錄的變更。
• 預覽視窗焦點：決定預覽視窗是否奪取檔案管理員的鍵盤焦點。當按下 Space 後快速鍵似乎「不起作用」時，請檢查此設定：
  • 永不取得焦點（預設）：預覽視窗絕不從檔案總管或檔案管理員搶奪焦點，因此打字與方向鍵能繼續在該處運作。再次按下 Space 會立即關閉預覽，但檢視器層級的快速鍵（Z、M、Ctrl + F 等）只有在點擊視窗內部後才會回應。
  • 每次預覽檔案時：每次新預覽都會啟動視窗，因此檢視器快速鍵能立即運作。代價是每次按下 Space 後焦點都會離開檔案管理員。
  • 僅在視窗開啟時：在預覽視窗出現時取得一次焦點，但在視窗保持開啟時切換檔案不會再次搶奪焦點。
• 接收軟體模擬按鍵事件：預設關閉。Seer 的鍵盤掛鉤特意忽略 Windows 標記為插入/模擬的按鍵輸入，因此在您工作時巨集、虛擬鍵盤或遠端控制工作階段不會意外跳出預覽。當 Seer 由自動化驅動時請開啟此選項——如 AutoHotkey/AutoIt 指令碼、螢幕小鍵盤、協助工具或重放按鍵的遠端桌面/KVM 設定。此選項同時涵蓋觸發鍵與下方的 Delete/Esc 處理。
• 視窗大小和位置模式：
  • 自動調整大小與位置（預設）：依據每個檔案的原生外觀比例與檢視器的最佳比例動態調整視窗尺寸。
  • 保持視窗大小和位置：記住上次關閉預覽視窗時的精確幾何形狀與螢幕座標。
  • 開啟時視窗置中：一律將預覽視窗置中顯示於使用中螢幕的正中間。
• 標題列按鈕操作：選擇點擊標題列中的主要按鈕時發生的行為：
  • 分離視窗（預設）：將目前預覽分離為獨立的浮動視窗。它仍然屬於執行中的 Seer 實例，因此結束 Seer 也會將其關閉。
  • 釘選視窗：保持預覽置頂釘選，失去焦點時不關閉。
  • 獨立視窗：啟動完全隔離的檢視器處理程序 (SeerViewer.exe)。
• 接收「刪除」鍵：讓 Delete 鍵能配合 Seer 的檔案鎖定機制，而非彼此衝突。實際執行的行為取決於哪個視窗擁有焦點：
  • 預覽視窗聚焦：Seer 關閉預覽（以及顯示相同檔案的任何分離視窗），然後將檔案移至 Windows 資源回收筒。檔案仍在載入時不會執行任何動作，且釘選視窗會保持開啟——它們只能由您手動關閉。
  • 檔案管理員聚焦：Seer 本身不會刪除任何內容。它僅隱藏預覽並釋放檔案佔用，因此您在檔案總管、Total Commander 或 Directory Opus 中要求的刪除操作不會因「因為檔案已在另一個程式中開啟，所以無法完成動作」而失敗。
  • 若您在重組檔案時保持 Seer 開啟，且不希望任何按鍵動作意外刪除檔案，請保持此選項關閉。
• 隱藏系統匣圖示：將 Seer 從 Windows 系統匣中隱藏，以實現極致簡約。若隱藏，Seer 在啟動時提供 8 秒的安全時間，在此期間圖示仍保持可見，以便您存取設定。
• 開啟 user.ini：點擊底部的 user.ini 按鈕，即可在預設編輯器中開啟 user.ini 進行手動微調（將滑鼠懸停在按鈕上可檢視完整路徑；欄位參考請參閱 自訂設定指南）。

4. 系統

• 使用 Windows 工作排程器：在 Windows 工作排程器（建議使用，免受 UAC 權限阻擋）與舊版登錄檔啟動方式之間切換。
• 快顯功能表整合：在 Windows 檔案總管的所有檔案與目錄滑鼠右鍵快顯功能表中新增 「使用 SeerViewer 開啟」 操作，直接啟動獨立的 SeerViewer.exe 處理程序檢視檔案。
• 在「開啟方式」功能表中註冊：針對所有支援的檔案格式，在原生 Windows「開啟方式」應用程式清單中註冊 SeerViewer。
• 設為預設應用程式：開啟 Windows 預設應用程式 頁面，以便您自行將檔案類型指向 SeerViewer。Seer 無法靜默接管關聯——Windows 需要該確認步驟。
• 檔案備註總開關：全域開啟或關閉 Seer 的個人檔案備註系統。

5. 快速鍵

• 觸發鍵：自訂主要觸發鍵與輔助按鍵組合（例如 Space、Alt + Space、Ctrl + Space、Shift + Space）。
• 分離視窗觸發鍵：設定自訂的輔助按鍵組合，直接在分離視窗中啟動預覽。
• 動作重新繫結：重新繫結任何全域或檢視器專屬快速鍵（例如：旋轉、靜音、自動換行、搜尋列、全螢幕），以符合您的個人肌肉記憶。

6. 備份、匯入與重設

進階設定 底部的三個按鈕可在不同電腦之間轉移完整設定，或還原為出廠狀態：

• 匯出：將目前設定的快照寫入您選取的 .ini 檔案。該檔案採用 Seer 自有的匯出格式（包含版本資訊，並非供手動編輯使用），因此請將其作為備份保留，而非在編輯器中開啟。此快照涵蓋儲存於 config.ini 中的設定（外觀、快速鍵、各類型選項、外掛開關等）。它不包含 user.ini 微調內容，且刻意跳過啟用授權資料、最近清單（PDF / 媒體歷史記錄、各頁面縮放記憶）、視窗位置以及多檢視器指派對應表。
• 匯入：套用先前匯出的快照，並隨後立即重新啟動 Seer，因為有若干設定僅在全新啟動時生效。數值將依原樣複製——包含其中的任何絕對路徑（見下文）。非 Seer 匯出檔案，或由不同匯出格式版本寫入的檔案，將會被拒絕並顯示錯誤。
• 還原預設值：清除 config.ini 並還原為預設值，隨後重新啟動。啟用與授權資料均予以保留，手動編輯的 user.ini 數值亦不受影響，因此您可以保留自己的進階微調。該按鈕初次點擊時會變為確認/取消按鈕對——需要再次點擊確認。