一、快速上手

1. 个人信息自动加载：呼号、己方 QTH、设备、天馈、GRID、PC、DRR、TEL、EMAIL、QQ、二维码链接与说明、操作员签名、默认类型 / 模式——都在个人中心统一维护，打开页面自动带入。
2. 填通联信息：对方呼号（自动大写）、日期时间（UTC）、频率、模式、信号报告、功率、天线、寄语。
3. 选类型与模式：通联类型 FM / SSB / CW / FT8 / 自定义；工作模式按需选择（「EYE QSO」可一键清空重填）；频率 / 设备 / 功率 / 天线等常用信息从下拉框直接选择，下拉选项支持添加、编辑、删除。
4. 回卡请求：PSE（请回卡）/ TNX QSL（感谢你的卡片）/ VY 73!（通联愉快）——个人中心可设默认值，也可逐张卡片单独修改。
5. 切换正反：类型选 正面 / 反面 / 正反两面，预览与导出跟随切换。
6. 导出：预览确认无误后，点「导出当前面」或「导出合并图」保存 PNG 图片。

二、大小颜色 · 字段控制

• 每个字段（呼号、时间、频率、设备、功率、寄语、己方 QTH、二维码说明等）都可设置：字体大小、位置坐标（左上角参考点）、字体颜色、背景颜色、是否显示、是否加粗、显示区域宽高（像素 px，基准设计画布 1800×1200，区域高默认一行文字高度、0=自适应）、文字对齐（左 / 中 / 右）；内容超出区域宽度自动换行，文字紧贴区域、无内间距。
• 设置为「不显示」的字段，页面预览与生成图片都不显示（API 传入参数也不显示）；显示则完全按设置的大小、颜色、位置输出。

三、底图与元素

• 正面底图 / 背面底图：上传本地图片、粘贴图片 URL、从设计方案导入、从云端方案库选背景；可设置画布尺寸。
• 本地图片超过 1800px / 300KB 会自动压缩到画布适配尺寸；图床图片建议压缩至最长边 1800px 以内（约 300KB 以下），过大图片可用顶部导航「图片处理工具」先处理。
• 电子签名（OP 行）、呼号印章、二维码（含说明文字，可设字体颜色、按设置自动换行）、附加图——在对应面板设置，勾选正面 / 背面显示。

四、模板管理

• 可把整套配置（底图、签名、印章、字段控制、排版）存为模板：存新模板 / 更新快照 / 重命名 / 删除 / 应用 / 复制 ID。
• 批量填写：点「批量填写」一键打开 QSL 卡片填写工具并自动应用当前模板，可批量导入通联记录（ADIF / CSV）批量生成、下载、打印卡片。

五、存储同步（GitHub）

• 个人素材与设置保存在 GitHub Gist；Token 在个人中心 → 数据同步统一配置（未配置不能同步），配置后此处一键同步。
• 布局与字段设置保存在浏览器本地，可在底部「存储管理」查看占用并一键清理（清理按钮即时反馈，不会叠加多个窗口）。

六、API 接口调用

• 支持 URL 参数直接生成卡片：/api/card?call=BG9PZK&mode=FM&freq=145.5&auto=1，字段与模板一一对应。
• 完整参数与示例见 API 使用文档；也可在填写工具导入通联记录自动填充。

七、常见问题

• 上传图片支持 jpg / png；底图建议约 900×600 或与卡片同比例，导出按比例缩放。
• 导出效果与右侧预览一致；若某元素没显示，检查「大小颜色·字段控制」里对应字段的显示开关与背景色设置。