特别声明:本文为原创,可自由转载、引用,但需署名作者且注明文章出处,如有侵权请联系!
作为一名业余无线电爱好者,每次通联后做 QSL 卡片都很麻烦。于是我自己写了一个在线工具,免费、开箱即用、还支持 API 批量出卡。
一、为什么要做这个工具?
我是 BG9PZK,一名业余无线电爱好者。
每次通联结束,都要给对方寄 QSL 卡片。但传统的做卡方式实在太折腾了:

- 用 PS 排版?每次都要重新调位置,半小时过去了
- 用专业软件?功能复杂,学习成本高,还不一定支持中文
- 找打印店?贵,而且模板固定,没法个性化
更麻烦的是,我经常在野外架台,通联完一堆台,回来要一张张做卡,效率极低。

于是我决定自己动手,用最纯粹的技术栈——一个 HTML 文件——做一个开箱即用的 QSL 卡片制作工具。
现在它已经上线了:https://qsl.ttdd.top
二、这个工具能做什么?
2.1 核心功能:按格填写,实时预览
打开网页,左侧填通联信息,右侧实时预览卡片效果。
通联信息包括:
| 字段 | 说明 |
|---|---|
| 对方呼号 | 自动转大写 |
| 对方 QTH | 对方电台位置 |
| 日期 / UTC / 北京时间 | UTC 与北京时间自动互算 |
| 频率 / 信号报告 | 支持历史记录下拉联想 |
| 设备 / 功率 / 天线 | 支持下拉联想 |
| 寄语 / 操作员 | 自定义文本 |
填完点"导出当前面"或"导出合并图",PNG 图片直接下载,可打印可发送。
2.2 确认类型与工作模式
- 确认类型:OUR QSO / YOUR SWL REPORT / EYE QSO(单选)
- 工作模式:FM / SSB / CW / FT8 / 自定义模式
- EYE QSO 快捷:一键清空除日期时间外的所有内容,自动填入当前时刻
2.3 图片与元素
- 自定义底图:上传本地图片或粘贴图片 URL,支持铺满/完整显示
- 电子签名:上传签名图片,可拖动位置、滚轮调大小
- 呼号印章:同上
- 附加图片 A/B:两张附加图,独立控制正反面显示
- 二维码:输入内容自动生成,说明文字可独立设置位置和样式
2.4 个人信息与颜色
QTH、地址、电话、邮箱、QQ、CQ 分区、ITU 分区、Grid 定位……每项独立控制显示与否。
正面/背面文字颜色、通联信息背景色、备用信息背景色,全都可以自定义。
2.5 模板管理
把整套配置存为模板,下次一键套用。每个模板有唯一 ID,支持 ?tpl=模板ID 传参。
2.6 多端同步
- 分享版:GitHub Gist 同步配置,首次上传自动创建私有 Gist
- 个人版:Cloudflare Access 邮箱登录,KV 自动同步,多设备一致
2.7 API 一键出卡
这是我最喜欢的功能。通联日志直接生成卡片:
https://qsl.ttdd.top/api/card?call=BG5XYZ&date=20260904&freq=145.5&mode=FM&auto=1打开链接自动生成并下载 PNG。支持 side=both 导出合并图,side=both2 导出正反两张。
完整 API 文档:https://qsl.ttdd.top/api-doc.html
三、3 分钟做出第一张卡
第 1 步:打开网页
浏览器访问 https://qsl.ttdd.top,无需注册、无需下载。
第 2 步:填写通联信息
在左侧"通联信息(按格填写)"面板中:
- 填对方呼号(自动大写)
- 点"现在"一键填入当前日期和时间
- 填频率、信号报告、设备等
- 可选:填对方 QTH、寄语
第 3 步:导出图片
右侧预览确认无误后,点"导出合并图",一张正反面合并的 QSL 卡片就下载好了。
四、技术实现:一个 HTML 文件的全栈实践
4.1 技术栈
- 前端:纯 HTML + CSS + 原生 JavaScript(零框架、零构建)
- Canvas 渲染:html2canvas 导出 PNG
- 二维码:qrcode.js 纯前端生成
- 后端:Cloudflare Worker(单文件 JS)
- 存储:Cloudflare KV(个人版)+ GitHub Gist(分享版)
- 认证:Cloudflare Access 零信任邮箱认证
- 托管:Cloudflare Pages
4.2 架构设计

4.3 隐私设计
这是我最在意的部分:
- 个人图片只存 URL:通过 Worker 环境变量注入,绝不写进 HTML 源码
- 分享版完全脱敏:未登录时使用占位图,不含任何个人信息
- 本地上传图片仅存本地:localStorage + 导出配置带图,不上传服务器
- Cloudflare Access 保护:个人版端点仅本人邮箱可访问
五、和其他工具的区别
| 特性 | 本工具 | 传统 PS | 专业软件 |
|---|---|---|---|
| 免费 | ✅ | ❌ 付费 | ❌ 付费 |
| 开箱即用 | ✅ | ❌ 需学习 | ❌ 需安装 |
| 多端同步 | ✅ | ❌ | ⚠️ 部分 |
| API 批量出卡 | ✅ | ❌ | ❌ |
| 离线可用(本地版) | ✅ | ✅ | ✅ |
| 中文支持 | ✅ | ✅ | ⚠️ 部分 |
| 自定义底图 | ✅ | ✅ | ✅ |
六、后续计划
- [ ] 支持通联日志导入(ADIF/CSV)批量出卡
- [ ] 卡片模板市场(用户分享模板)
- [ ] 移动端 APP(PWA)
- [ ] 更多卡片尺寸和版式
七、写在最后

这个工具从一个简单的本地 HTML 文件开始,慢慢迭代到现在支持多端同步、API 调用、个人/分享双模式。整个过程坚持几个原则:
- 单文件优先:能不拆就不拆,降低维护成本
- 隐私第一:个人信息绝不进公开源码
- 渐进增强:本地版离线可用,网络版锦上添花
- API 友好:所有功能都能通过参数调用,方便自动化
如果你也是 HAM,欢迎来试试:https://qsl.ttdd.top
有任何建议或问题,欢迎在评论区留言,或者通过工具页面的反馈入口联系我。
73! — BG9PZK
















评论列表 (已有0条评论)
消灭零回复