各位 OM 大家好，我是 BH5HIE。在幾年來不斷製作 QSL 卡片的過程中，我發現使用遠方的電台回信封時，地址格式五花八門、中英文混排、郵編位置總是錯亂，而且一次要寄出十幾封……因此，我自行開發了一個跨平台的簡易工具。 QSL郵件，專門解決「將地址整齊地印在信封上」的問題。目前版本 1.2.7，已公開（採用 MIT 授權），可免費下載和使用。
一、這是什麼？
QSL 信件是一個信封製作與印刷的工作台，適用於向業餘無線電愛好者寄送 QSL 卡的情境，也適用於任何需要印製標準信封並填寫回郵地址的情況。它支援：
- 發送者和接收者姓名、呼號、地址、郵編、手機號請務必完整填寫。
- 國內 / 國際兩種寄送模式：國內模式會自動顯示右上角的六位郵遞區號。
- DL、C5、#10、C6 這四種常見的信封規格，以及完全客製化尺寸；
- 水平／垂直排版，地址自動換行、框的高度自動調整。
- 信封上的即時視覺預覽，收發者區塊可以直接拖曳此外，也可以使用滑桿進行精細調整。
- 聯絡人列表：常用無線電聯繫人的新增、刪除、修改、搜尋，以及一次性應用。
- CSV/TXT 大量匯入支援繁體中文及常見的英語命名方式，並提供批次列印佇列功能。
- 樣板：將常用的排版設定儲存為範本，下次可以一次性套用。
- 任務紀錄：每次編輯後自動儲存，隨時可以還原。
- 列印前預覽，在列印時自動隱藏預覽輔助線、折線、印章和裝飾紋樣，僅列印實際內容。
- 列印機校準：可調整縮放、X/Y 偏移、安全邊界、紙張選擇。
- 桌面版本將任務和聯絡人資訊儲存到本機的資料檔案中。重新安裝或更換桌面版本 (Electron ↔ Lite) 時，不會遺失資料。。
若未填寫呼號，則統一顯示 請勿撥打不會出現空白且不美觀的情況。
二、主要介面概覽
打開軟體後，左邊是側欄（製作台/地址簿/我的範本/列印設定+最近任務），中間是資訊填寫區，右邊是即時信封預覽——紙張的比例和內容的位置，都依照實際印刷尺寸呈現。
在預覽區域下方，您可以直接切換信封規格（DL / C5 / #10 / C6 / 自定義）、橫向或縱向，以及「精確定位」面板（X 位置、Y 位置、字號、框寬）。
三、快速入門：五步驟，輕鬆發送第一封郵件
第一步驟：填寫寄件人和收件人的資訊
在「收件人資訊」中填寫對方姓名、呼號、地址、郵編（可選填手機號碼）；在「發件人資訊」中填寫自己的回郵地址。側邊欄底部會顯示您的廣播電台身份，也可以點擊「從我的資料填入 ↗」，一鍵導入已儲存在「列印設定」中的廣播電台資訊。
地址可以很長，不用擔心，預覽功能會自動換行，框的高度也會跟著內容調整。
第二步驟：選擇寄送方式與信封規格。
寄國際郵件的選擇國際，郵編會顯示在收件人地址區；寄國內信選國內，信封的左上角會出現六位的郵編格，並且新增「國內郵編格」面板，可以個別調整。位置、單字大小、字間距。
信封規格請依照您手邊的信封選擇：DL（220×110）、C5（229×162）、#10（241×105）、C6（162×114），或選擇「自訂」，並在列印設定中填寫寬和高。
第三步驟：精確定位排版
預覽中的收件人和發件人區塊可以直接使用滑鼠移動此外，您也可以使用「精確定位」面板上的滑桿來微調 X/Y 的位置、字號和框寬，並分別在「收件人/發件人」頁籤中進行調整，然後按下「↺」按鈕即可恢復預設值。
步驟四：預覽並列印
點選右上角的「列印信封」，會先顯示。列印預覽確認內容與尺寸後，再送給列印機。預覽中的虛線安全邊界、信封摺痕、郵票以及裝飾圖樣。無法列印，確保列印頁面乾淨。
在列印之前，建議先前往「列印設定」頁面檢查列印機、紙張及校準參數（請參閱第六節）。第一次列印時，建議先使用一般的 A4 紙測試一次，再放入信封，這樣會更安全。
四、聯絡人列表與快速套用
將常用的電台加入「連絡人」後，可以透過兩種方式快速套用：
- 在製作台的右側「快速套用」區域，可以一次性填入最近聯絡人。
- 開啟「聯絡人」搜尋姓名/號碼/城市，點擊「套用」。
聯繫人支援新增、編輯、刪除功能，欄位包含姓名、聯絡號碼、地址、郵遞區號、手機號碼以及備註（例如「日本・東京」）。
五、支援 CSV 格式的大量匯入與大量列印
當需要同時匯入多個電台時，使用 CSV 格式進行批量匯入是最方便的方式：
- 從「下載範本」按鈕，取得標準 CSV 格式。
- 請按照範本填寫（或使用 LOTW/記錄軟體匯出之地址表進行修改）。
- 點擊「導入 CSV」，選擇檔案。系統會自動辨識第一行的標題，並將其對應為中文或英文的欄位名稱（例如：姓名、呼號、地址、郵編、手機號碼），同時也支援 name / callsign / address / zip 等格式。
- 導入後，會顯示彈出視窗批量列印佇列可以勾選要列印的記錄，先套用第一條進行預覽檢查，然後「一次性列印」所有信封，每個信封獨立在一頁上，並維持實際尺寸。
標準 CSV 格式 (第一行為標題，使用 UTF-8 編碼)：
姓名,呼號,地址,郵編,手機號碼
高橋健,JA7QXG,1-2-3 產道東京,100000,090-1234-5678
麥克萊恩,VK3LQ,15 柯林斯街墨爾本,3000,+61 400 123 456
六、列印設定與校準
「列印設定」中包含了三個部分：「列印機」、「紙張」和「廣播」。
- 列印機：桌面版可以讀取系統已安裝的印表機清單，並可選擇特定印表機。
- 送入印表機的紙張：依照信封的實際尺寸，或 A4/Letter (手動套打)。
- 信封規格：DL / C5 / #10 / C6 / 定制（名稱 + 寬度 x 高度，以毫米為單位）；
- 列印機校準：水平偏移 X、垂直偏移 Y（單位為毫米，正數表示向右/向下），列印縮放比例 80%–120%。
- 安全邊界：預覽時顯示安全區域輔助線。
- 我的廣播節目資料：姓名、呼號、回郵地址、郵編、手機號，儲存後可直接填入「寄件人」欄位。
如果打印出來整體歪斜：請使用偏移將內容移回正確的位置；若內容大小不符，請使用：縮放微調，比起調整印表機設定來說，更為直觀。
七、我的範本
調整後的格式（信封規格 + 收發者位置字號 + 模式 + 輸出參數）可以儲存為範本，例如「日本 QSL 橫向」、「國內套打 C5」。下次在「我的範本」中直接套用，無需重新調整。
八、下載與安裝
專案的開源網址：https://github.com/net3pang/QSLMailPrint
發布頁提供了兩個系列，介面和操作完全一致：
QSL 信件 (Electron 完整版)，適合需要設備級的列印參數以及完整的安裝體驗：
| 平台 | 檔案 |
|---|
| Windows | QSL.Mail.Setup.1.2.7.exe（安裝版本）QSL.Mail.1.2.7.exe（無需安裝，可攜帶版本） |
| macOS | QSL.Mail-1.2.7-arm64.dmg（蘋果晶片）QSL.Mail-1.2.7.dmg / - mac.zip（英特爾） |
| Linux | QSL.Mail-1.2.7.AppImage、qsl-mail_1.2.7_amd64.deb |
輕量版 QSL 信件 (Wails)它體積小、啟動快速，並使用系統 WebView，同樣支援真實列印和批量列印：
| 平台 | 檔案 |
|---|
| Windows | QSL-Mail-Lite-windows-x64.exe |
| macOS | QSL-Mail-Lite-macos-arm64.zip / QSL-Mail-Lite-macos-x64.zip |
| Linux | QSL-Mail-Lite-linux-x64 |
macOS 用戶請注意：應用程式已設定開發者身分驗證簽名與證書流程。如果開啟時提示無法驗證開發者，請在「系統設定 → 隱私與安全」中允許執行，或使用右鍵點擊開啟。
九、數據儲存的位置
- 草稿、排版、模式、範本、列印設定：儲存在應用程式的本地儲存。
- 任務紀錄與聯絡人：桌面版本同時寫入 Go JSON 資料檔案，預設位置：
- macOS：
~/Library/Application Support/QSLMail/qsl-mail-data.json
- Windows：
%AppData%\QSLMail\qsl-mail-data.json
- Linux：
~/.config/QSLMail/qsl-mail-data.json
- 可用的環境變數
QSL_MAIL_DB 指定資料檔案的位置。
Electron 版本和 Lite 版本共享相同的資料檔案，輪流使用不會導致任務或聯絡人遺失。
十、常見問題
問：「瀏覽器版的用法是什麼？」
Ａ：瀏覽器版本主要針對快速體驗，可在專案目錄中執行。 python3 -m http.server 4173 後打開 http://127.0.0.1:4173；建議不要直接雙擊 index.html。瀏覽器版本總是會彈出系統的列印視窗，並將資料儲存在瀏覽器的 `localStorage` 中。
問：「列印出來的位置不對／尺寸也不正確？」
Ａ：首先，先在普通紙上列印一頁，檢查整體偏移。對於整體偏移，可以使用「列印設定」中的 X/Y 偏移修正（mm），對於大小差異，則使用列印縮放功能。此外，「安全邊界輔助線」可以幫助您判斷內容是否超出可列印區域。
問：「Lite」版本與「完整」版本有何不同？
A：功能與介面一致。完整版本內建 Chromium，並提供設備級的列印參數（指定列印機、靜默列印等）；輕量版則使用系統 WebView，體積小、啟動快速，macOS 的列印會遵循系統原生流程。
問：「會收費嗎？」
A：完全免費且開源，採用 MIT 授權。歡迎您在 GitHub 上提出問題、建議或貢獻。
BH5HIE 的頻道為 73
闽ICP备2021006864号-7
闽公网安备35020602002794号