🛡️ 警務手機影像轉檔與逐格截圖系統 Police-Image-Toolkit (v11.4.0)

專為第一線外勤與警務鑑識同仁打造之 Windows 原生免安裝影像處理工具箱。 徹底擺脫瀏覽器記憶體限制與資安疑慮，專注於手機圖片高速批次轉檔與手機影片精準逐格截圖。

---

專案概念與開發原因

警用影像處理工具將影像格式轉換與影片逐格截圖整合成 Windows 本機工作流程。開發動機是手機照片及影片片段進入報告前，常要重複轉檔、旋轉與截圖，人工操作容易漏張或弄錯順序。

採 .NET／WPF 桌面架構，配合背景處理與原始檔保護，讓大量影像可以在本機整理。工具處理的是報告用輸出，不取代原始素材保存或後續內容判讀。

典型流程：加入素材 → 選擇轉換／截圖／切割 → 確認預覽與輸出位置 → 檢查成品及索引。

🚀 下載與快速開始 (Download & Quick Start)

📥 取得程式（請選擇其一下載）

下載項目	格式	說明	連結
PoliceImageToolkit.exe	.exe	推薦。免安裝單一執行檔，下載後直接雙擊開啟	⬇️ 點此直接下載（最新版）
PoliceImageToolkit-v11.4.0-win-x64.zip	.zip	壓縮包（適用於被瀏覽器或端點限制直接下載 exe 之環境）	📦 點此下載 ZIP 壓縮檔

🔗 想下載歷史版本或查看詳細更新紀錄，請至 GitHub Releases 頁面。

💻 系統需求

• 作業系統：Windows 10 / 11 (64-bit)
• 執行環境：完全免安裝、零相依性（已內建獨立 Runtime，電腦無需預先安裝 .NET）
• 網路狀態：預設完全離線；只有使用者主動按下「檢查更新」並確認後，才會連線至 GitHub Release 查詢版本資訊。所有影像與影片處理均在本機完成，不會上傳檔案。

💡 安裝與初次執行說明

1. 免安裝：下載 PoliceImageToolkit.exe 後，放置於任意資料夾（如桌面或隨身碟）即可。
2. 雙擊即開：直接雙擊 PoliceImageToolkit.exe 開啟工具。
3. 若出現 Windows SmartScreen 防護提示：
   • 由於本程式為內部獨立編譯開源軟體，未購買微軟商業數位憑證，Windows 可能跳出「Windows 已保護您的電腦」藍色提示。
   • 請點擊 「其他資訊」 ➜ 再點擊 「仍要執行」 即可正常啟動。
4. 驗證發布檔：dist\SHA256SUMS.txt 與 使用說明.txt 會隨本機發布產生，可用 Get-FileHash .\PoliceImageToolkit.exe -Algorithm SHA256 比對雜湊值。

---

⚡ 核心功能特色

1. 📁 手機圖片高速批次轉檔 (Image Batch Converter)

專門解決外勤人員收到民眾 iPhone (HEIC) 或 Android (WebP) 照片無法在公務電腦開啟的問題。

• 支援格式：iPhone HEIC/HEIF、Android WebP、PNG、JPG、BMP、TIFF。
• 操作方式：
  1. 將照片批次拖曳進主視窗。
  2. 選擇目標輸出格式（預設轉為相容性最高之 JPG）。
  3. 設定壓縮品質（預設 90%）與是否限制最大寬高（預設等比例原尺寸）。
  4. 點擊 「開始批次轉檔」，多核心平行處理，百張相片瞬間完成。
• 智慧方向校正：自動辨識手機拍攝 Exif 中繼資料，修正旋轉角度，轉出正常視角圖檔。

---

2. 🎬 手機影片精準逐格截圖 (Video Frame Snapshot)

專為翻拍監視器、密錄器、手機對話紀錄（LINE / 簡訊）滾動錄影打造之逐格證物截圖工具。

• 自適應大畫面手機圖框：專為手機側錄與對話錄影打造，畫面大而清晰。
• 🔄 上頁末行對照視窗 (Anti-Leak Preview)：即時顯示前一張截圖畫面與時間戳，比對對話紀錄絕不漏行或重複。
• ⚡ 全域極速鍵盤快捷鍵（支援盲按秒截，輸入文字時自動旁路）：

  按鍵	動作說明
  Space（空白鍵）	秒截當前證物畫面（伴隨快門白光閃爍視覺回饋，非同步零阻塞存檔）
  ← / → 或 A / D	微調 0.1 秒（逐格精準對齊）
  ↑ / ↓ 或 W / S	快進 / 快退 1.0 秒
  Z	復原 / 刪除上一張截圖（防誤截快速清理）
  P 或 Enter	播放 / 暫停影片

• 純淨原始輸出：輸出 100% 原始解析度圖檔；每部影片各自輸出至專屬資料夾，預設以 001.png、002.png 連續排序，可選填前綴。
• 輸出可追溯：輸出資料夾會更新 report_index.json，保留輸出檔名、來源檔名、影片時間與像素尺寸；不寫入絕對路徑、案號或其他個資。

---

3. 🎮 2D 遊戲 Q 版介面與高對比可讀性 (2D Game Q-Style UI)

• Q 版貼紙卡片與厚底按鍵：粗墨色外框、底部厚陰影卡片、金色標題徽章；按鈕具實體按鍵下沉回饋，主要（藍）、執行（綠）、危險（紅）、次要（奶油）操作一眼可辨。
• 高對比配色（WCAG AA）：深墨字 / 奶油卡片 13.9:1、次要字 7.5:1、白字 / 藍綠紅按鈕皆 ≥ 4.8:1、墨字 / 金色 9.2:1。
• 遊戲背包格清單：轉檔與截圖清單採圓角格子、白 / 奶黃斑馬紋、粗框選取；輸入框、下拉選單、勾選框、滑桿與捲軸全面統一風格。
• WPF 中文字清晰度：底層強制啟用 ClearType 與整數排版對齊，避免微軟正黑體筆畫發虛。
• 保留工具本質：功能名稱與流程不變，不加入等級、經驗值或強制動畫。

---

4. 🏷️ 版本徽章與 GitHub 自動檢查更新 (Auto Update Checker)

• 頂部版本徽章：主介面頂端動態載入 version.txt，清楚標註當前版本號。
• 『🔄 檢查更新』按鈕：點擊後非同步向 GitHub Release API 查詢最新發行資訊：
  • 已是最新版：彈出成功提示與當前版本。
  • 發現新版：彈出對話框展示新版本號與更新重點，點擊確認可直接開啟下載。
  • 離線防護：公務內網或連線逾時時顯示友善提醒，不影響本機核心工具運作。

---

🔮 未來展望 (Roadmap)

後續評估推動之優化項目（不影響目前功能之發布與運作）：

1. Photo-Report-Generator 匯入索引：由下游工具讀取既有 report_index.json，協助帶入圖片與來源資訊；此功能需於該 Repository 另案實作。
2. 影片手機框滑鼠滾輪步進微調（Mouse Wheel Scrubbing）：游標懸停於手機螢幕時，滾輪向上/向下直接前後 0.1 秒步進，達成「右手滾輪定位、左手 Space 秒截」極速盲操。
3. 影片多倍速播放切換（1.0x / 1.5x / 2.0x）：長影片快速瀏覽跳轉涉案段落。

---

❓ 常見問題 (FAQ)

Q1: 下載後需要安裝或設定任何執行環境嗎？

不需要。 本程式採用 .NET 8 LTS Self-Contained 獨立單檔打包，已內建所有必備核心庫，目標電腦不需要安裝 .NET Runtime 或其他軟體，隨點隨開。

Q2: 為什麼 Windows 會提示「Windows 已保護您的電腦」？

這是微軟針對未購買昂貴企業憑證的開源軟體的標準 SmartScreen 提示。本專案原始碼完全公開開源，無任何惡意代碼，請安心點擊 「其他資訊」 ➜ 「仍要執行」 即可。

Q3: 影像與影音資料會不會被上傳到雲端？

不會。 所有編解碼運算均在電腦本機執行，不會上傳影像、影片、案號或其他本機檔案。程式平時完全離線；只有使用者主動按下「檢查更新」並確認後，才會向 GitHub Release 查詢版本與更新說明。

Q4: 若特定 iPhone HEIC 或 WebP 圖檔無法解碼該怎麼辦？

本工具會呼叫 Windows 內建的 WIC 影像編解碼管線。若舊版 Windows 10 缺少相關 Codec，系統會跳出繁體中文友善提示，請至微軟市集安裝免費的「HEIF 影像延伸模組」或「WebP 影像延伸模組」即可。

---

🛠️ 開發者資訊與本機建置

專案結構

03_Police-Image-Toolkit/
├── src/
│   └── PoliceImageToolkit/       # 🚀【C# .NET 8 WPF 原生桌面專案】
│       ├── app.ico / app_icon.png# 專屬警務鑑識圖示
│       ├── version.txt           # 當前版本宣告檔 (v11.4.0)
│       ├── Models/               # 轉檔與影片快照資料模型
│       ├── Services/             # 轉檔、影片截圖與更新檢查引擎
│       ├── ViewModels/           # MVVM 架構邏輯
│       └── Views/                # 2D 遊戲 Q 版風格 WPF 介面
├── dist/                         # 發行成品：EXE、version.txt、SHA256SUMS.txt、使用說明.txt
└── scripts/
    ├── build.ps1                 # 一鍵發布單檔 Exe (含快取清理、無 pdb、圖示快取重新整理)
    └── qa.ps1                    # QA 檢核與建置測試腳本

本機建置發布指令

# 執行 QA 與語法建置檢核
powershell -ExecutionPolicy Bypass -File .\scripts\qa.ps1

# 發布單檔獨立免安裝 Exe (產出於 dist/PoliceImageToolkit.exe)
powershell -ExecutionPolicy Bypass -File .\scripts\build.ps1

---

📄 授權條款 (License)

本專案採用 MIT License 授權開放使用。

已知 Bug、限制與疑難排解

以下區分已確認問題、功能限制及待驗證項目；歷史修正不代表舊發行包已自動更新，也不代表本次文件更新重新完成所有功能測試。

狀態	情境	處理方式
系統限制	HEIC／HEIF、WebP 或影片編碼可能缺少 Windows 所需解碼支援。	先確認系統編碼器與來源格式；同一副檔名不代表每種內部編碼皆可讀取。
影像限制	來源解析度太低，或文字在壓縮後已模糊。	切割與轉換無法還原不存在的細節；保留原始檔並抽查報告尺寸下的可讀性。

歷史修正包括自訂輸出路徑的開啟行為、背景 Bitmap 跨執行緒問題與暫存輸出清理，詳見 CHANGELOG.md。實際支援格式仍以目前電腦與檔案的解碼結果為準。

問題回報

請提供使用版本／啟動方式、作業系統與相關環境、重現步驟、預期及實際結果，以及去識別的錯誤訊息或最小樣本。先保留現場與來源資料；不要附真實案件、完整帳號、密碼、Token 或 API Key。版本修正以對應原始碼與發行包為準。