v1.2.5-beta.1

免安裝 Python，下載對應平台的壓縮檔，解壓後即可執行。
No Python required — download the archive for your platform, unzip, and run.

本版更新 / What's new (v1.2.5-beta.1)

Beta 測試版 / Beta build: 本版新增 AVI 輸入與多種輸出格式，並將分通道疊合改為逐通道自身參考對齊等較大變更，請先保留原始素材與既有輸出再進行測試。 / This build adds AVI input and multiple output formats and changes Channel split to align each channel to its own reference; keep your source data and previous outputs while testing.

• 新增 AVI 輸入支援：可讀取未壓縮 AVI（單色／RGB）與 Bayer-CFA AVI，與 SER 相同支援隨機存取任一幀；相關介面文字由「SER」更新為「SER / AVI」。 / Added AVI input: reads uncompressed AVI (mono/RGB) and Bayer-CFA AVI with the same random per-frame access as SER; UI strings updated from "SER" to "SER / AVI".
• 新增多種輸出格式：除既有 16 位元 TIFF 外，新增 PNG、BMP 與 FITS 輸出（PNG／FITS 保留 16 位元，BMP 為 8 位元）。 / Added output formats: alongside 16-bit TIFF, you can now export PNG, BMP, and FITS (PNG/FITS keep 16-bit; BMP is 8-bit).
• 分通道疊合（Channel split）改為進階設定中獨立的疊合選項，不再是 RGB 對齊下拉選單的模式之一；並改為每個通道各自對齊到自身同色參考（紅對紅、綠對綠、藍對藍）。同訊號對齊更準確，跨通道色散配準改由主介面 RGB 對齊作為後處理。 / Channel split is now an independent stacking option under Advanced Settings rather than an RGB-align dropdown mode, and aligns each channel to its own same-colour reference (R→R, G→G, B→B). Same-signal alignment is more accurate, with cross-channel dispersion left to the main-UI RGB align post-correction.
• 涵蓋度感知正規化（coverage-aware normalization）擴及所有網格疊合與 Drizzle 路徑，避免部分涵蓋的邊緣變暗。 / Coverage-aware normalization now applies across all mesh-warp and Drizzle paths, preventing partial-coverage borders from darkening.
• 主介面重整：Stack 按鈕更名為 Run 並與 Export／Frame 重新分組，Analyze 獨立成一列，Re-apply 按鈕更名為 Post Processing 並移至群組底部；穩定化方法選項名稱也更清楚。 / Main UI reorganized: the Stack button is renamed Run and regrouped with Export/Frame, Analyze gets its own row, the Re-apply button is renamed Post Processing and moved to the group bottom, and stabilization method options are renamed for clarity.
• 進度視窗會依狀態文字自動調整高度，長訊息不再被切掉；品質圖表文字改為固定英文，修正中文介面下字形缺失（顯示為空白方框）的問題。 / The progress window now grows to fit long status text instead of clipping it, and quality-chart labels are fixed to English to avoid missing-glyph (blank box) rendering under a Chinese UI.
• 「保留原始尺寸」裁切改以畫布中心對齊，保留涵蓋度最高的中央區域。 / The "Preserve original size" crop is now centered on the canvas, keeping the maximally-covered central region.
• 修正批次處理：當沿用的對齊點不適用於某檔案的參考幀時，改以自動佈點取代，而非直接失敗。 / Batch fix: when reused alignment points don't fit a file's reference frame, fall back to auto-placed APs instead of failing.
• 多處 UI／tooltip 改寫為更淺白的措辭，並同步繁體中文翻譯。 / Reworded many UI/tooltip strings in plainer language and synced the Traditional Chinese translation.

先前更新 / Earlier (v1.2.4)

• 改進樣板比對的次像素位移估算：驗證 2D 高斯峰值擬合是否為可信極大值，遇到不可靠或可能像素鎖定的峰值時，改以局部 fractional NCC 搜尋細化至 1/16 像素，降低剩餘的 pixel-locking。 / Improved template-matching sub-pixel estimation: 2D Gaussian peak fits are validated as trustworthy maxima, while unreliable or pixel-lock-prone peaks fall back to local fractional-NCC refinement at 1/16-pixel resolution.

• 修正並補齊繁體中文介面翻譯，統一幀、對齊點與全域 RGB 等術語；品質圖表與 Drizzle kernel 現在也會隨介面語言翻譯。 / Corrected and completed the Traditional Chinese UI translation, standardized frame, alignment-point, and Global RGB terminology, and made quality-chart and Drizzle-kernel labels translatable.

• 修正批次 AP 與全域 RGB poly／mesh 的說明文字，並在 Two-stage 啟用時停用不生效的 Coarse scale 設定。 / Corrected the batch-AP and Global RGB poly/mesh help text, and disabled the ineffective Coarse scale setting while Two-stage stabilization is enabled.

• 移除已由串流處理路徑取代的舊批次 API，更新 profiling 與測試，並完成 Ruff 靜態檢查清理。 / Removed obsolete batch APIs superseded by streaming paths, updated profiling and tests, and completed Ruff static-analysis cleanup.

• 新增進階選項「保留原始尺寸」：啟用 Auto Crop 時，輸出維持 SER 原始幀尺寸；Drizzle 則精確乘上倍率。COG 穩定化會自動開啟，Phase 會自動關閉；手動調整此選項不會反向改變穩定化方法。 / Added an advanced “Preserve original size” option: with Auto Crop enabled, output keeps the SER frame dimensions, multiplied exactly by the Drizzle scale. COG stabilization enables it automatically and Phase disables it; changing the option itself does not alter the stabilization method.

• 修正 Bayer Drizzle 完成後「Re-apply Color Align」無法使用，且 Global RGB／poly／mesh 校色被略過的問題。 / Fixed Re-apply Color Align remaining disabled after Bayer Drizzle and Global RGB/poly/mesh correction being skipped on that path.

• 將大型主視窗程式依責任拆分為 dialogs、runtime、settings persistence、export、quality chart 與共用工具模組，提高可讀性與維護性。 / Split the oversized main-window implementation into responsibility-focused dialog, runtime, settings-persistence, export, quality-chart, and utility modules for readability and maintainability.

• Global RGB 樣板對齊新增低訊號遮罩：自動忽略中央量測區域中的大面積近黑／無資料像素，降低背景或拼接邊界造成的誤對齊。 / Global RGB template alignment now auto-masks large near-black or no-data regions in its measurement ROI, reducing mistracks caused by background or mosaic borders.

• Global RGB 的量測範圍改為涵蓋所有啟用 AP 完整視窗的方框，與穩定化 anchor 脫鉤；Drizzle 時會同步縮放 AP 座標。 / The Global RGB measurement ROI now covers the full windows of all enabled APs, independently of the stabilization anchor, with AP coordinates scaled for Drizzle output.

• 對齊前 Gaussian pre-blur 的預設 sigma 改為 2.0，提升雜訊幀的對齊穩定性；僅作用於位移估算，不影響疊圖細節與清晰度選幀。 / The default pre-alignment Gaussian blur sigma is now 2.0 for steadier tracking on noisy frames; it affects shift estimation only, not stacked detail or sharpness-based selection.

• 輸出 TIFF 的文字 sidecar 新增實際 RGB 對齊結果：Global RGB 記錄 R/B 位移與 response，poly／mesh 記錄各通道 AP 統計、RMS、最大位移及是否套用。 / TIFF text sidecars now include actual RGB alignment results: R/B shifts and responses for Global RGB, and per-channel AP statistics, RMS, maximum displacement, and applied status for poly/mesh modes.

• Local Select 改為真正逐 AP 獨立選幀：每個對齊點各自選擇局部最清晰的幀，並以網格重心權重平滑融合，支援一般網格疊合、彩色、Drizzle 與 Bayer Drizzle。 / Local Select is now genuinely per-AP: every alignment point independently selects its locally sharpest frames, blended smoothly with mesh barycentric weights across plain mesh, colour, Drizzle, and Bayer Drizzle paths.

• 新增 COG 輸出置中：使用 COG 穩定化時，可在 Auto Crop 後將亮度重心移至輸出中央；預設開啟，Phase 穩定化會自動略過。 / Added optional COG output centering after Auto Crop; enabled by default for COG stabilization and automatically skipped for Phase stabilization.

• AP overlap 移至主畫面 AP size 旁，預設改為 0.75；Mesh warp smoothing 預設改為 0.025；Debayer 預設改為 VNG；Frame Select 與 Local Select 預設皆為 100%。 / AP overlap moves beside AP size on the main panel and defaults to 0.75; mesh-warp smoothing defaults to 0.025; debayer defaults to VNG; Frame Select and Local Select both default to 100%.

• 輸出 TIFF 的文字 sidecar 現在記錄完整 PipelineConfig、所有主畫面參數、來源 metadata、實際選取幀索引與 AP 座標，提升處理結果的可重現性。 / TIFF text sidecars now record the complete PipelineConfig, every main-panel parameter, source metadata, selected frame indices, and AP coordinates for improved reproducibility.

• 修正彩色 Drizzle 勾選 coverage map 時，在疊合完成後出現「too many values to unpack」的錯誤，並補強逐 AP 路徑的記憶體估算與 worker 限制。 / Fixed the post-stack “too many values to unpack” failure when saving colour-Drizzle coverage maps, and strengthened RAM estimates and worker limits for per-AP paths.

• AP 預覽燈泡圖例新增淡灰色箭頭說明：代表偏差校正前的原始量測位移；彩色箭頭則為實際用於疊合的校正後位移。 / The AP overlay legend now explains the dim-grey raw pre-bias shift arrow versus the corrected coloured shift used for stacking.

先前更新 / Earlier (v1.2.3)

• 新增檢查更新功能：可從 Help 選單手動檢查，打包版啟動時也會安靜檢查一次（可在進階設定的「更新」分頁關閉）。僅讀取公開的發行清單、不會上傳任何資料；離線或連線失敗時自動略過。 / New check-for-updates: check manually from the Help menu, and packaged builds also do one quiet check on startup (opt-out under the Advanced Settings "Updates" tab). It only reads the public release list, uploads nothing, and silently skips when offline.
• 一般（非 drizzle）網格疊合新增記憶體預檢保護；原「Drizzle RAM limit」設定更名為通用的「RAM usage limit」，同時涵蓋 drizzle 與一般疊合路徑。 / Plain (non-drizzle) mesh stacking now gets the memory pre-flight guard; the former "Drizzle RAM limit" setting is renamed to the general "RAM usage limit" and governs both the drizzle and plain stacking paths.
• 修正自動佈點等作業完成時，進度視窗卡在「Cancelling…」而無法關閉的問題。 / Fixed the progress window getting stuck on "Cancelling…" (and refusing to close) when Auto Place and similar operations finished.

先前更新 / Earlier (v1.2.2)

• 新增手動排除幀功能：可在預覽中逐一切換排除任意數量的低品質幀，被排除的幀不參與疊合，並於品質圖上以洋紅色方框標示。 / New manual frame rejection: toggle any number of frames out of the stack from the preview; rejected frames are excluded regardless of quality and marked with magenta squares on the quality chart.
• 新增手動選擇參考幀：可將預覽中的幀固定為疊合／自動佈點的參考幀，覆蓋預設（品質最高幀）；批次處理仍自動挑選。 / New manual reference-frame selection: pin the previewed frame as the stacking / auto-AP reference, overriding the default (highest-quality frame); batch still auto-picks per file.
• 對齊點自動佈點改用 Lloyd CVT（重心 Voronoi）分佈，點位更均勻，並可設定晶格與邊緣保留距離。 / Auto AP placement now uses Lloyd CVT (centroidal Voronoi) for more even coverage, with configurable lattice and edge keep-out.
• 網格扭曲新增邊界錨環與外插模式，並新增「AP 位移離群拒斥 k」設定（k=0 可停用），未受信任的點以鄰近平均填補。 / Mesh warp adds a boundary anchor ring with extrapolate mode, plus an "AP shift outlier reject k" setting (k=0 disables); untrusted APs are filled with the neighbour mean.
• 次像素對齊改用 2D 高斯峰值擬合，降低像素鎖定（pixel-locking）；並新增對齊前高斯模糊（pre-blur）選項。 / Sub-pixel alignment now uses a 2D Gaussian peak fit to curb pixel-locking, with a new optional pre-alignment Gaussian blur (pre-blur).
• 色彩對齊「Global RGB」新增樣板比對法並設為預設，poly／mesh 模式沿用亮度疊合的對齊點，並拒斥不合理的 RGB 位移。 / "Global RGB" colour align gains a template-matching method (now default); poly/mesh modes reuse the luma stack's APs, and implausible RGB shifts are rejected.
• 品質排名會拒斥裁切／出框的行星幀。 / Quality ranking now rejects clipped / off-frame planets.
• 進度對話框（含批次）新增預估剩餘時間（ETA）。 / Progress dialogs (including batch) now show an estimated time remaining (ETA).
• 修正 Windows 上幀索引輸入框過窄、看不到數字的問題。 / Fixed the frame-index spin box being too narrow to show its digits on Windows.
• 預覽區可縮到影像最小寬度，設定／預覽分隔線拖動更順暢。 / The preview column can now shrink to the image's minimum width, so the settings/preview splitter drags smoothly.
• 隨附第三方授權資訊，符合 PySide6/Qt LGPL 規範。 / Bundled third-party license information for PySide6/Qt LGPL compliance.

下載 / Download

平台 / Platform	檔案 / File
Windows (x64)	MapStacker-windows-x64.zip
Linux (x64)	MapStacker-linux-x64.zip
macOS (Apple Silicon)	MapStacker-macos-arm64.zip

系統需求與注意事項 / Requirements & notes

Windows

• Windows 10 / 11 (64-bit)。
• 解壓後執行資料夾內的 MapStacker.exe，不需另外安裝 Python。
• 若提示缺少 VC++ 執行庫，請安裝 Microsoft Visual C++ Redistributable（近代 Windows 多半已內建）。
• Unzip and run MapStacker.exe; no separate Python install needed. If a missing
  VC++ runtime is reported, install the Microsoft Visual C++ Redistributable.

Linux

• 需 glibc ≥ 2.31（Ubuntu 20.04+、Debian 11+ 或同等發行版）。
• 解壓後執行資料夾內的 MapStacker。圖形介面使用 Qt xcb，在純文字環境或缺少 X11 的情況下無法啟動。
• Requires glibc ≥ 2.31 (Ubuntu 20.04+, Debian 11+). Unzip and run MapStacker.
  The GUI uses the Qt xcb plugin and will not start in a headless / X11-less environment.

macOS

• 僅提供 Apple Silicon (arm64) 版；Intel Mac 不支援。
• 因 app 未簽章，首次開啟若被 Gatekeeper 阻擋，請右鍵 →「打開」，或到「系統設定 → 隱私權與安全性」放行。
• Apple Silicon (arm64) only; Intel Macs are not supported. The app is unsigned —
  if Gatekeeper blocks the first launch, right-click → "Open".

多國語言 / Languages

內建英文與繁體中文介面。English and Traditional Chinese UI are bundled.