HoverPeek

🖱️ 一個輕量級的 Windows 檔案預覽工具，讓你在檔案總管中懸停滑鼠即可快速預覽檔案內容。

繁體中文 | English

✨ 功能特色

📸 支援多種檔案格式

• 圖片預覽

  • 支援格式：JPG、PNG、GIF（含動畫）、WebP、SVG、AVIF、BMP、TIFF、ICO
  • 自動縮放，保持圖片比例
  • 高品質渲染（SkiaSharp）

• 資料夾預覽（🆕 新功能）

  • 瀏覽資料夾內的檔案列表（檔名、大小、修改日期）
  • 雙擊檔案可直接預覽內容
  • 支援返回上層導覽

• 壓縮檔預覽

  • 支援格式：ZIP、RAR、7Z、TAR、GZ、BZ2、XZ、LZMA
  • 瀏覽壓縮檔內的檔案列表
  • 雙擊檔案可直接預覽內容（無需解壓）
  • 內建圖片快取，提升重複瀏覽效能

• 影片預覽

  • 支援格式：MP4、AVI、MKV、MOV、WMV 等
  • 使用 VLC 引擎，支援硬體解碼
  • 自動播放/靜音可設定

• 文字檔預覽（🆕 新功能）

  • 支援 30+ 種檔案格式
  • Markdown 渲染：.md 檔案顯示為格式化的 HTML（支援 GitHub Flavored Markdown）
  • 語法高亮：程式碼檔案自動套用顏色標記
    • 支援語言：C#、Python、JavaScript、TypeScript、Java、Go、Rust、C/C++、Ruby、PHP、HTML、CSS、SQL、PowerShell、Bash 等
  • 智慧編碼偵測：自動偵測 UTF-8、Big5、系統預設編碼
  • 檔案大小/行數限制（可設定）

⚙️ 完整的設定系統（🆕 新功能）

• 懸停行為

  • 懸停延遲（預設 500ms）
  • 抖動容忍度（預設 8px）
  • 自動關閉延遲（預設 600ms）

• 預覽視窗

  • 視窗大小（寬度/高度）
  • 視窗位置（固定螢幕中央 / 跟隨滑鼠）
  • 淡入/淡出動畫時間

• 圖片設定

  • 最大預覽尺寸（預設 800px）
  • GIF 動畫開關

• 文字設定

  • 最大檔案大小（預設 1MB）
  • 最大顯示行數（預設 1000 行）
  • 字型大小/家族
  • Markdown 渲染開關
  • 語法高亮開關

• 影片設定

  • 自動播放
  • 靜音播放

• 壓縮檔設定

  • 自動展開檔案列表

• 關於（🆕 新功能）

  • 版本資訊、作者、GitHub 連結

• 啟動設定

  • 開機自動啟動（寫入 Windows 註冊表）

🎯 核心優勢

• ✅ 輕量化：背景運作，不佔用工作列，僅在系統托盤顯示圖示
• ✅ 快速預覽：無需開啟應用程式，懸停即可查看
• ✅ 優雅降級：Markdown/語法高亮失敗時自動切換到純文字顯示
• ✅ 不干擾工作：預覽視窗不搶焦點，不影響目前操作
• ✅ 自動定位：預覽視窗智慧定位，避免超出螢幕邊界
• ✅ 設定持久化：設定儲存於 JSON，重啟後保留

📦 安裝

系統需求

• 作業系統：Windows 10/11（64-bit）
• .NET Runtime：.NET 8.0 Desktop Runtime
• WebView2（可選）：用於 Markdown 渲染，Windows 10/11 通常已內建

下載

前往 Releases 頁面下載最新版本。

從原始碼建置

# 複製專案
git clone https://github.com/kyosora/HoverPeek.git
cd HoverPeek

# 建置專案（Release 模式）
dotnet build src/HoverPeek.App/HoverPeek.App.csproj -c Release

# 執行檔位於
# src/HoverPeek.App/bin/Release/net8.0-windows/HoverPeek.App.exe

🚀 使用方式

1. 啟動應用程式

   • 執行 HoverPeek.App.exe
   • 應用程式會最小化到系統托盤（右下角通知區域）

2. 預覽檔案

   • 在檔案總管中，將滑鼠移到檔案上
   • 懸停約 500ms（可設定）
   • 預覽視窗會自動彈出

3. 開啟設定

   • 右鍵點擊系統托盤的 HoverPeek 圖示
   • 選擇「設定」
   • 調整各項參數後點擊「儲存」

4. 退出程式

   • 右鍵點擊系統托盤圖示
   • 選擇「退出 HoverPeek」

🎨 功能展示

圖片預覽

懸停在圖片上，立即顯示高品質預覽，支援 GIF 動畫

Markdown 渲染

.md 檔案自動渲染為格式化的 HTML，支援程式碼區塊、表格、清單等

語法高亮

程式碼檔案（.py、.js、.cs 等）自動套用語法顏色，並顯示行號

資料夾瀏覽

懸停資料夾即可瀏覽內容，雙擊檔案直接預覽

壓縮檔瀏覽

展開壓縮檔內容清單，雙擊檔案可直接預覽（無需解壓）

影片播放

自動播放影片，支援硬體加速解碼

⚙️ 技術架構

技術棧

• 框架：WPF (.NET 8.0)
• 圖片處理：SkiaSharp
• 壓縮檔：SharpCompress
• 影片播放：LibVLCSharp
• Markdown 渲染：Markdig + Microsoft Edge WebView2
• 語法高亮：AvalonEdit
• 全域滑鼠鉤子：Windows Low-Level Mouse Hook (WH_MOUSE_LL)
• 檔案路徑解析：UI Automation API

專案結構

HoverPeek/
├── src/
│   ├── HoverPeek.App/          # 主應用程式（WPF）
│   │   ├── App.xaml.cs         # 應用程式入口，整合所有元件
│   │   ├── SettingsWindow.xaml # 設定視窗 UI
│   │   └── SettingsWindow.xaml.cs
│   ├── HoverPeek.Core/         # 核心邏輯（無 UI 依賴）
│   │   ├── MouseHook/          # 全域滑鼠 Hook
│   │   ├── FileResolver/       # 檔案路徑解析
│   │   ├── Preview/            # 預覽提供者
│   │   │   ├── ImagePreviewProvider.cs
│   │   │   ├── ArchivePreviewProvider.cs
│   │   │   ├── FolderPreviewProvider.cs # 🆕 資料夾預覽
│   │   │   ├── VideoPreviewProvider.cs
│   │   │   └── TextPreviewProvider.cs
│   │   └── Settings/           # 🆕 設定服務
│   │       ├── AppSettings.cs
│   │       └── SettingsService.cs
│   └── HoverPeek.UI/           # UI 元件
│       └── PreviewWindow.xaml  # 預覽視窗
└── README.md

核心機制

1. 全域滑鼠 Hook

• 使用 SetWindowsHookEx 註冊低階滑鼠 Hook
• 不阻擋滑鼠事件傳遞（CallNextHookEx）
• 效能開銷 <1ms

2. 懸停偵測

• 抖動容忍：滑鼠輕微移動（<8px）不會中斷計時
• 可取消機制：使用 CancellationTokenSource
• 預覽鎖定：顯示預覽後鎖定，避免滑鼠移動時觸發新預覽

3. 檔案路徑解析

• 主要方案：UI Automation API（支援各種視圖模式）
• 備用方案：Shell COM 介面
• 錯誤處理：解析失敗時靜默忽略

4. 預覽視窗

• 不搶焦點：ShowActivated=False + WS_EX_NOACTIVATE + WS_EX_TOOLWINDOW
• 自動定位：固定螢幕中央或跟隨滑鼠（避免超出邊界）
• 淡入淡出動畫：可自訂動畫時間

🛠️ 設定檔案

設定儲存於：%AppData%\HoverPeek\settings.json

範例設定：

{
  "HoverDelayMs": 500,
  "JitterTolerancePx": 8,
  "AutoCloseDelayMs": 600,
  "WindowWidth": 800,
  "WindowHeight": 600,
  "CenterWindow": true,
  "FadeInDurationMs": 150,
  "FadeOutDurationMs": 100,
  "ImageMaxDimension": 800,
  "EnableGifAnimation": true,
  "TextMaxFileSizeMB": 1,
  "TextMaxLines": 1000,
  "TextFontSize": 11,
  "TextFontFamily": "Consolas",
  "EnableMarkdownRendering": true,
  "EnableSyntaxHighlighting": true,
  "VideoAutoPlay": true,
  "VideoMuted": true,
  "ArchiveAutoExpand": true,
  "StartWithWindows": false
}

🤝 貢獻

歡迎提交 Issue 和 Pull Request！

開發流程

1. Fork 本專案
2. 建立功能分支（git checkout -b feature/amazing-feature）
3. 提交變更（git commit -m 'Add amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 開啟 Pull Request

建議的改進方向

• PDF 預覽支援
• 多螢幕支援改進
• 自訂 CSS 主題（Markdown）
• 更多語法高亮語言
• 縮圖快取機制
• 效能監控與最佳化

📄 授權

本專案採用 MIT License 授權 - 詳見 LICENSE 檔案

🙏 致謝

• QTTabBar - 靈感來源
• QuickLook - 參考實作
• SkiaSharp - 高效能圖片處理
• SharpCompress - 壓縮檔解析
• LibVLCSharp - 影片播放引擎
• Markdig - Markdown 解析器
• AvalonEdit - 程式碼編輯器與語法高亮
• WebView2 - HTML 渲染引擎

📮 聯絡

有任何問題或建議，歡迎開啟 Issue

---

Made with ❤️ by kyosora