资源管理站

做了一个免费的 QSL 卡片在线制作工具,通联完 3 分钟出卡

zyglz 165 0

特别声明:本文为原创,可自由转载、引用,但需署名作者且注明文章出处,如有侵权请联系!

作为一名业余无线电爱好者,每次通联后做 QSL 卡片都很麻烦。于是我自己写了一个在线工具,免费、开箱即用、还支持 API 批量出卡。

一、为什么要做这个工具?

我是 BG9PZK,一名业余无线电爱好者。

每次通联结束,都要给对方寄 QSL 卡片。但传统的做卡方式实在太折腾了:

封面: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 步:填写通联信息

在左侧"通联信息(按格填写)"面板中:

  1. 填对方呼号(自动大写)
  2. 点"现在"一键填入当前日期和时间
  3. 填频率、信号报告、设备等
  4. 可选:填对方 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 调用、个人/分享双模式。整个过程坚持几个原则:

  1. 单文件优先:能不拆就不拆,降低维护成本
  2. 隐私第一:个人信息绝不进公开源码
  3. 渐进增强:本地版离线可用,网络版锦上添花
  4. API 友好:所有功能都能通过参数调用,方便自动化

如果你也是 HAM,欢迎来试试:https://qsl.ttdd.top

有任何建议或问题,欢迎在评论区留言,或者通过工具页面的反馈入口联系我。

73! — BG9PZK

公众号

评论列表 (已有0条评论)

消灭零回复

发表评论 (已有0条评论)

icon_lol.gif2016zhh.gif2016fendou.gif2016lengh.gificon_exclaim.gif2016gg.gif2016yhh.gificon_cry.gif2016bs.gif2016qd.gif2016bz.gificon_eek.gif2016ka.gif2016zhem.gificon_confused.gif2016qq.gif2016db.gif2016jk.gif2016tuu.gif2016zk.gif2016kk.gificon_neutral.gif