[img width=200]https://storage.hamcq.cn/2026-08-08/1786164727-268249-00-logo.png[/img] 各位 OM 大家好，我是 BH5HIE。折腾 QSL 卡片的几年里，通联是快乐的，但是给远方的电台回信封：地址格式五花八门、中英文混排、邮编位置总对不齐、一次要打十几封……所以我自己写了一个跨平台的小工具 **QSL Mail**，专门解决"把地址整整齐齐地印到信封上"这件事。目前版本 **1.2.7**，已开源（MIT License），免费下载使用。 ## 一、这是什么 QSL Mail 是一个**信封制作与打印工作台**，面向业余无线电的卡片寄送场景，也适用于任何需要打印标准信封回邮地址的场合。它支持： - 收发件人的**姓名、呼号、地址、邮编、手机号**完整填写； - **国内 / 国际**两种寄送模式，国内模式自动显示左上角六位邮编格； - DL、C5、#10、C6 四种常用信封规格，以及**完全自定义尺寸**； - 横向 / 纵向排版，地址**自动换行**、框高自适应； - 信封上**实时可视化预览**，收发件人区块可以**直接拖动**定位，也可用滑杆数值微调； - **地址簿**：常用电台联系人增删改、搜索、一键套用； - **CSV / TXT 批量导入**，支持中文和常见英文列名，带批量打印队列； - **版式模板**：把常用排版存成模板，下次一键套用； - **任务历史**：每次编辑自动保存，随时找回； - 打印前**预览**，打印时自动隐藏预览辅助线、折线、印章和装饰纹样，只印实际内容； - **打印机校准**：打印缩放、X/Y 偏移、安全边界、纸张选择； - 桌面版把任务和联系人写入本地数据文件，**重装或换桌面版本（Electron ↔ Lite）数据不丢**。未填写呼号时统一显示 `NO CALL`，不会出现空白难看的情况。 --- ## 二、主界面一览打开软件后，左边是侧边栏（制作台 / 地址簿 / 我的模板 / 打印设置 + 最近任务），中间是信息填写区，右边是**实时信封预览**——纸面比例、内容位置都按实际打印尺寸呈现。 [upl-image-preview uuid=62395135-64e6-4da2-bf86-6ec29bd7788a url=https://storage.hamcq.cn/2026-08-08/1786164726-837332-01.png alt={TEXT?}] 预览区下方可以直接切换信封规格（DL / C5 / #10 / C6 / 自定义）、横竖方向，以及"精确定位"面板（X 位置、Y 位置、字号、框宽）。 --- ## 三、快速上手：5 步打出第一封 ### 第 1 步：填写收发件人信息在"收件人信息"里填写对方姓名、呼号、地址、邮编（手机号可选）；在"发件人信息"里填自己的回邮地址。侧边栏底部会显示你的电台身份，也可以点"从我的资料填充 ↗"一键带入保存在打印设置里的电台资料。地址很长不用怕，预览会自动换行，框的高度跟着内容走。 ### 第 2 步：选择寄送模式与信封规格寄国际邮件选**国际**，邮编会显示在收件人地址区；寄国内信选**国内**，信封左上角会出现六位邮编格，并多出"国内邮编格"面板，可单独调整**位置、单字大小、字间距**。 [upl-image-preview uuid=f86ebc38-f801-49bb-a5b8-edb231d2a601 url=https://storage.hamcq.cn/2026-08-08/1786164726-354320-02.png alt={TEXT?}] 信封规格按你手头的信封选：DL（220×110）、C5（229×162）、#10（241×105）、C6（162×114），或选"自定义"并在打印设置里填宽高。 ### 第 3 步：精确定位版式预览里的收件人 / 发件人区块可以直接**用鼠标拖动**；也可以用"精确定位"面板的滑杆微调 X / Y 位置、字号和框宽，选择"收件人 / 发件人"页签分别调整，一键"↺"恢复默认。 [upl-image-preview uuid=6db6d55c-41a1-41bc-9d34-ef8193005d73 url=https://storage.hamcq.cn/2026-08-08/1786164725-843794-03.png alt={TEXT?}] ### 第 4 步：预览并打印点右上角"打印信封"，先弹出**打印预览**确认内容与尺寸，再送打印机。预览里的虚线安全边界、信封折线、邮票和装饰纹样**不会印出来**，保证打印页干净。打印前建议先到"打印设置"里核对打印机、纸张和校准参数（见第六节），第一次打印用普通 A4 试一张再上信封更稳妥。 [upl-image-preview uuid=eecca255-83a0-4ccc-b9ce-fab8cb82aeb6 url=https://storage.hamcq.cn/2026-08-08/1786164723-932537-08.png alt={TEXT?}] --- ## 四、地址簿与快速套用常用电台存进地址簿后，两种方式快速套用： - 制作台右侧"快速套用"区一键填入最近联系人； - 打开"地址簿"搜索姓名 / 呼号 / 城市，点"套用"。 [upl-image-preview uuid=fc001bcb-2553-4cb4-a89a-766135f22521 url=https://storage.hamcq.cn/2026-08-08/1786164725-329666-04.png alt={TEXT?}] 联系人支持新建、编辑、删除，字段包括姓名、呼号、地址、邮编、手机号和备注（如 "Japan · Tokyo"）。 [upl-image-preview uuid=9e4c4b7d-9b1c-4261-92fa-fd2fd67b1ccb url=https://storage.hamcq.cn/2026-08-08/1786164725-80152-05.png alt={TEXT?}] --- ## 五、CSV 批量导入与批量打印一次通联很多电台时，用 CSV 批量导入最省事： 1. 点收件人面板的"下载模板"拿到标准 CSV； 2. 按模板填写（或用 LOTW / 日志软件导出的地址表改好列名）； 3. 点"导入 CSV"选择文件，第一行表头会自动识别中文或英文列名（姓名、呼号、地址、邮编、手机号，也兼容 name / callsign / address / zip 等）； 4. 导入后弹出**批量打印队列**，可勾选要打印的记录，先套用第一条到预览核对，再"批量打印"一次送出所有信封，每个信封独立一页、保持实际尺寸。标准 CSV 格式（第一行为表头，UTF-8）： ```csv 姓名,呼号,地址,邮编,手机号 Takahashi Ken,JA7QXG,1-2-3 Chiyoda Tokyo,100000,090-1234-5678 Michael Lane,VK3LQ,15 Collins St Melbourne,3000,+61 400 123 456 ``` [upl-image-preview uuid=34217976-c1e6-442b-8c6b-7a84f44f4a89 url=https://storage.hamcq.cn/2026-08-08/1786164723-546297-09.png alt={TEXT?}] --- ## 六、打印设置与校准 "打印设置"里集中了打印机、纸张和电台资料三块： - **打印机**：桌面版读取系统打印机列表，可选择指定打印机； - **送入打印机的纸张**：按信封实际尺寸，或 A4 / Letter（手动套打）； - **信封规格**：DL / C5 / #10 / C6 / 自定义（名称 + 宽高 mm）； - **打印机校准**：水平偏移 X、垂直偏移 Y（单位 mm，正数向右 / 向下）、打印缩放 80%–120%； - **安全边界**：预览中显示安全区域辅助线； - **我的电台资料**：姓名、呼号、回邮地址、邮编、手机号，保存后一键填充到发件人。 [upl-image-preview uuid=0d686618-113b-435c-9d28-8130ebf91540 url=https://storage.hamcq.cn/2026-08-08/1786164724-209781-07.png alt={TEXT?}] 如果印出来整体偏了：用**偏移**把内容挪回正确位置；如果内容大小不对：用**缩放**微调，比折腾打印机设置直观得多。 --- ## 七、我的模板调整好的版式（信封规格 + 收发件人位置字号 + 模式 + 打印参数）可以存成模板，例如"日本 QSL 横向""国内套打 C5"。下次在"我的模板"里直接套用，不用重新调。 [upl-image-preview uuid=f73afbe0-a259-47c1-8b1a-654528a2881f url=https://storage.hamcq.cn/2026-08-08/1786164724-499355-06.png alt={TEXT?}] --- ## 八、下载与安装项目开源地址：发布页提供两个系列，界面和操作完全一致： **QSL Mail（Electron 完整版）**，适合需要设备级打印参数和完整安装体验： | 平台 | 文件 | | --- | --- | | Windows | `QSL.Mail.Setup.1.2.7.exe`（安装版）、`QSL.Mail.1.2.7.exe`（免安装便携版） | | macOS | `QSL.Mail-1.2.7-arm64.dmg`（Apple Silicon）、`QSL.Mail-1.2.7.dmg` / `-mac.zip`（Intel） | | Linux | `QSL.Mail-1.2.7.AppImage`、`qsl-mail_1.2.7_amd64.deb` | **QSL Mail Lite（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 用户注意：应用已配置 Developer ID 签名与公证流程；若打开时提示无法验证开发者，请在"系统设置 → 隐私与安全性"中允许运行，或右键打开。 --- ## 九、数据保存在哪里 - 草稿、版式、模式、模板、打印设置：保存在应用本地存储； - 任务历史与联系人：桌面版同时写入 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 版共用同一套数据文件，换着用不丢任务和联系人。 --- ## 十、常见问题 **Q：浏览器版怎么用？** A：浏览器版面向快速体验，在项目目录运行 `python3 -m http.server 4173` 后打开 `http://127.0.0.1:4173`；不建议直接双击 `index.html`。浏览器版打印始终弹出系统打印框，数据存浏览器 localStorage。 **Q：印出来位置偏了 / 大小不对？** A：先打印一页普通纸核对。整体偏移用"打印设置"里的 X / Y 偏移修正（mm），大小差一点用打印缩放，安全边界辅助线可以帮你判断内容是否超出可打印区域。 **Q：Lite 版和完整版有什么区别？** A：功能与界面一致。完整版捆绑 Chromium、提供设备级打印参数（指定打印机、静默打印等）；Lite 版用系统 WebView，体积小、启动快，macOS 打印走系统原生流程。 **Q：会收费吗？** A：完全免费开源，MIT License。欢迎到 GitHub 提 Issue、建议或 PR。 --- 73 de BH5HIE

感觉做的非常好，希望能顺势增加qsl卡打印模版，可以把qsl卡和信封一起印，我用的是针式打印机，之前用的一个非常古老的软件，功能少，但是一个软件能打印qsl卡和信封，现在有了这种ham用的软件，感觉可以结合一下

@"BU2GQ"#p101249 可以考虑增加，但是大家的qsl背面都不太一样，可能只能在空白卡面上打印

妙啊！！！回头试一试~

@"BH5HIE"#p101260 也许可以自行上传参考图、拉文本框

@"BI2QHS-Jerrystyle"#p101278 有道理，我看看能不能vibe一下

@"BH5HIE"#p101260 可以参考wavelog（HamCQ Echo）上的QSL卡片设计器，有开源的代码估计也可以参考[Wavelog QSL Postcards](https://github.com/twicklund76/wavelog-qsl-postcards)

QSL Mail —— 业余无线电 QSL 信封制作与打印软件（图文使用说明）

BI9DJV

厉害一会换电脑试试再弄几个印章模板加进去会不会更好点

BA4RBX

hhh 我也做过一个类似的，同时支持直接打印追踪二维码

BA4VTS

没那么麻烦其实，word自带的信封功能就能用。

打开word，邮件——中文信封——信奉制作向导

大小里面都有，国内你正常用C5就行

然后一步步来，需要的勾选，不需要的不选就行。可以单个，也可以批量生成。激光打印机就能打印。

BH5HIE

BA4VTS 新版本还可以打卡片，这个打完之后还可以自动生成日志，后续还计划接入wavelog同步纸质QSL确认状态

BG9JXB

我工作破电脑win7，打不开exe文件，只能通过网页版(phthon3......命令打开)，存在一个问题，不能保存地址簿，联系人填好后点保存联系人没反应

BH5HIE

BG9JXB 不好意思，网页版只是为了当场爽一下，我忽略了支持旧版本的windows和macOS系统

BG9JXB

BH5HIE 大佬能做出来已经很NB了，不过有个小建议，能不能加入给地址簿批量导入导出csv的功能，我现在用excel自己手动记录的，想全部转到程序里

BH5HIE

https://github.com/net3pang/QSLManager 响应朋友们需求，又做了卡片打印和地址管理功能，可以批量打印卡片和信封了，最近一次我回的几十张卡都是用这个软件打印的卡片和信封

BG7NOD

哇，都太厉害了吧

BG2LXR

这个qslmanager的设计思路和功能实现做的真是太好了！

吹毛求疵的说，左下角的用户设置区域和右侧的实时预览区域，是不是可以固定位置，不随滚动条滑动，特别是实时预览，滑走看不见了就不是实时预览了；另外，通过菜单点了全屏显示，没看快捷键，习惯性的猛按半天esc怎么也回不来，是对f11的使用太少了。

BH5HIE

BG2LXR 不吹毛求疵，有道理，我周末看看怎么改一下

« 上一页

闽ICP备2021006864号-7

闽公网安备35020602002794号互联网举报中心

用户协议隐私政策社区规范积分规则中继规则转载须知
更新日志联系我们常见问题友情链接运营报告赞助

浩奇科技（厦门）有限公司

是无线电，把我们联系在一起