业余无线电 QSL卡片管理系统

本次更新

• 修复 ADI Header 起始结构，使导出文件符合 ADIF 3.1.7。
• ADI 仅输出可打印 ASCII；字段包含中文或其他非 ASCII 字符时整字段省略，并在导出完成后提示省略数量。
• ADI 多行字段压平为单行，应用字段补充数据类型标识。
• 将 USB/LSB 规范化为 MODE=SSB 与对应 SUBMODE。
• 新增 UTF-8 ADX 导出，通过 _INTL 字段保留中文内容。
• ADIF 导出页新增独立的“导出ADI文件”和“导出ADX文件”按钮。
• 同步产品定义和项目结构化清单。

验证

• Gradle clean build 完整构建与 Java 测试通过。
• Vitest 6 项 ADIF 协议单元测试通过。
• ESLint、Oxlint 与 TypeScript 类型检查通过。
• 插件热重载成功。
• Chrome MCP 实际导出 111 条 ADI/ADX 记录：ADI 非法字节和字段长度异常均为 0，MY_SIG 缺省、USB 映射及 ADX 中文字段均验证通过。

Generated from v2.3.30

本次更新

• 实体 QSL 卡申请页新增完整申请与寄送进度状态。
• 支持显示可申请、申请未通过可重新申请、审核中、建卡中、建卡异常、待制卡、已制卡、已打包、已发卡和已签收。
• 状态由实体卡申请、QSO 占用与关联卡片实时聚合，不新增重复持久化字段。
• 公开查询接口新增 statusCode、statusText、statusTextEn，保留原兼容字段。
• 前台新增中英双语状态标签和颜色区分。
• 不公开申请备注、审核说明、内部错误、地址、邮箱等敏感信息。
• 同步产品定义、API 合同、字段清单、结构化清单和项目说明。

验证

• Gradle 完整构建与全部测试通过。
• 插件热重载成功。
• 本机运行态公开页面和 TEST 呼号查询验证通过，未提交测试申请。

Generated from v2.3.29

本次更新

• 实体 QSL 申请页新增可视化卡片版本候选区。
• 横版、竖版卡面均在正方形预览框中完整显示。
• 卡面右侧展示版本名称与剩余可用数量。
• 每条 QSO 支持独立选择对应卡片版本。
• QSO 最右侧新增“申请此记录的卡片 / Request Card for This QSO”快捷按钮。
• 完善选择、取消选择、待审核及已有卡片状态的交互联动。
• 同步实体 QSL 开发约束、产品定义和项目结构化清单。

验证

• Gradle 完整构建与测试通过。
• 插件热重载成功。
• Chrome 实际页面交互验证通过，未提交测试申请。

Generated from v2.3.28

更新内容

• 后台本台卡片版本新增‘仅支持实体 QSL 通联卡’开关。
• 开关开启后，实体 QSL 卡申请、普通通联和线下换卡仍可使用该版本。
• 线上换卡页面继续展示受限版本，但不可选择并显示限制原因。
• 线上换卡提交接口新增服务端校验，阻止绕过前端选择受限版本。
• 修正实体 QSL 卡申请错误排除 active=false 卡片版本的问题。
• 公开卡片版本接口新增 qsoOnly（是否仅限实体 QSL 通联卡）字段。
• 同步产品定义、API 合同、结构化清单及实体卡申请约束文档。

验证

• Gradle 完整构建与全部测试通过。
• 前端类型检查和构建通过。
• 插件热重载成功。
• 已使用 TEST 呼号和 202605 版本完成实体卡申请运行验证。

Generated from v2.3.27

更新内容

• 新增独立的实体 QSL 卡申请页面 /qsl_card，支持按呼号查询 QSO、逐条选择卡片版本及个人地址或卡片局收件。
• 公开页面采用中英双语展示，卡片局候选按去向国、名称、邮编和地址显示。
• 新增实体卡申请与 QSO 占用持久化模型，阻止待审核申请或已有卡片的 QSO 重复提交。
• 新增后台实体卡申请审核，审核通过后立即自动创建全部卡片，并记录逐条 QSO 与卡片编号映射。
• 新增审核邮件通知、RBAC 权限、导入导出、迁移状态及启动恢复支持。
• 完善公开接口校验、限流、安全测试和开发约束文档。

Generated from v2.3.26

Full Changelog: v2.3.23...v2.3.24

Generated from v2.3.24

• 新增插件迁移状态基线，持久化记录运行版本、最近成功版本、数据结构版本、已应用迁移和待迁移项。
• 新增控制台迁移状态查询与预检查 API，为后续跨大版本和小版本数据迁移提供入口。
• 补充迁移状态权限节点、RBAC 角色模板、后端 API 合同、产品定义和结构化清单文档。
• 版本号递增至 2.3.23。

Generated from v2.3.23

• 公开网格清单 API 取消返回数量上限，历史 limit 参数保留兼容但不再限制结果。
• 新增 detailLevel 详情级别参数，支持 full 完整模式和 brief 简略模式；简略模式只返回网格与呼号清单，不返回通联明细。
• 同步公开 API 合同、产品定义和结构化清单文档，版本号递增至 2.3.22。

Generated from v2.3.22

• 收卡业务三个子菜单的基本清单保留已结束收卡记录可见，便于继续查看闭环后的收卡状态。
• 已结束收卡记录不再显示继续收卡和结束收卡入口，避免重复追加收卡。
• 保持通联业务送达确认等待处理清单原有过滤逻辑不变。
• 同步结构化文档与产品定义，版本号递增至 2.3.21。

Generated from v2.3.21

• 新增公开通联网格清单接口，返回四位网格、呼号集合、通联时间、模式、频率与频段。
• 网格清单按对方 QTH 中的 Maidenhead 网格聚合，6 位或 8 位统一截取四位，地区或地址类 QTH 自动跳过。
• 补充公开接口限流、参数校验、服务层聚合与路由测试。
• 同步结构化文档与后端 API 合同，版本号递增至 2.3.20。

Generated from v2.3.20

• 发信确认列表将“卡片备注”列调整为“备注”，同列展示业务备注与卡片备注。
• 优化备注列排序逻辑，按业务备注和卡片备注的组合内容排序。
• 清理 CardPrint 工具中冗余的 2026v4 含二维码改版预设文件。
• 版本号递增至 2.3.19，并同步插件元数据与构建版本。

Generated from v2.3.19

• 将收卡记录人工关联入口从审计查询页迁移到收卡业务三个子菜单的“已收卡片”操作列，审计菜单保持只读查询。
• 收卡业务“已收卡片”支持对未关联发卡编号的收卡记录选择目标卡片并二次确认，保留线上换卡未匹配记录的创建卡片入口。
• 在线打印工具封面打印新增国内卡片 / 国际卡片筛选，按去向国是否存在区分队列，并补充回归测试与文档。
• 调整通知邮件模板祝语文案，同步默认模板资源与文档示例。
• 版本号递增至 2.3.18，并同步插件元数据与构建版本。

Generated from v2.3.18

• 支持同一卡片 ID 连续关联多条收卡记录，确认收卡不再自动进入结束收卡状态，只有点击“结束收卡”才关闭继续收卡入口。
• 修复确认收卡匹配流程中可能提前创建未匹配收卡记录的问题，并补充收卡状态校验与回归测试。
• 在线打印工具封面打印与打包确认改为显示所有未打包卡片，覆盖通联业务、线上换卡与线下换卡场景。
• 通联业务制卡打印发射地址优先使用本台 MY_QTH，并更新对应预设字段。
• 优化通联日志筛选、ADIF 导入兼容与覆盖导入相关页面和文档说明。

Generated from v2.3.17

• 修正通联日志 ADIF 与 Cabrillo 导出时区换算，按记录时区将日期时间转换为 UTC。
• 手工新增通联记录默认使用 UTC+8，UTC 实时填充与 ADIF/Cabrillo 导入保留 UTC。
• 更新通联时间与时区字段语义说明。

Generated from v2.3.16

• 修正 ADIF 与 Cabrillo 导出日期时间，按记录时区换算为 UTC 后输出。
• 修正 ADIF 导出 TX_PWR 字段，按 ADIF Number 类型导出瓦特数值。
• 更新通联日志导入导出说明与结构化项目清单。

Generated from v2.3.15

• 新增通联日志 ADIF 导入去重，重复记录默认跳过不覆盖。
• 导入预览增加可导入、重复跳过、无效数量统计。
• 明确创建版本发布流程约定。

Generated from v2.3.14

• 新增通联日志 Cabrillo 格式导入与导出。
• 修复 QRZ.CN 图片拼接邮箱无法解析的问题。
• 同步插件版本与项目结构文档。

Generated from v2.3.13

• 增加线上换卡同呼号提交冷却时间配置，默认 5 分钟。
• 服务端阻止同呼号待审核重复提交、冷却期重复提交和并发重复点击。
• 同步系统配置导入导出字段、文档与测试覆盖。

Generated from v2.3.12

变更

• 修复收卡、发信、制卡等流程未完整应用邮件通知策略的问题。
• 补齐换卡申请审核后自动不发送邮件策略的状态落库。
• 换卡申请审核列表默认按审核时间倒序显示最新记录。

验证

• ./gradlew.bat clean build
• ./gradlew.bat reloadPlugin

Generated from v2.3.11

• 统一重要操作按钮颜色分级：创建卡片、导入、AI 应用、邮件外发使用 warning 样式。
• 编辑/修改按钮统一为白底中性样式。
• 优化本台设备能力胶囊与移除按钮的视觉对齐。
• 修复通联业务待创建记录一键创建卡片时忽略页面已选卡片版本的问题。

Generated from v2.3.10

Full Changelog: v2.3.8...v2.3.9

Generated from v2.3.9

Full Changelog: v2.3.7...v2.3.8

Generated from v2.3.8

更新内容

• 换卡申请审核支持在编辑页标记已发卡，并完善卡片创建状态落库与导入导出。
• 修正邮件通知策略与业务页面联动，自动不发送策略会写入跳过状态且不外发邮件。
• 地址管理新增非必填字段：去向国，并同步到导入导出、制卡地址选择与打印工具映射。
• 更新相关接口、权限测试与项目文档。

验证

• .\gradlew.bat test
• .\gradlew.bat reloadPlugin

Release 附件由 GitHub Actions CD 自动构建并上传。

Generated from v2.3.7

v2.3.6

• 调整线上换卡业务-换卡申请审核页面展示：邮件状态与卡片创建状态移动到状态列显示。
• 操作列仅保留可点击动作，减少只读状态与操作按钮混杂。

Release 附件由 CD 自动构建并上传，本次不手动上传 JAR。

Generated from v2.3.6

v2.3.5

• 版本号更新至 2.3.5。
• 包含线上换卡申请审核操作优化：审核后支持不发邮件操作，已创建卡片后显示已创建标记并移除创建按钮。

Release 附件由 CD 自动构建并上传，本次不手动上传 JAR。

Generated from v2.3.5

2.3.1

本版本包含以下修复与改进：

• 邮件状态为“邮件已跳过”时，相关“发送邮件通知/发送邮件”按钮会置灰禁用，避免重复触发。
• 制卡、发卡、收卡回执页面补齐“邮件已跳过”状态显示。
• 通联日志 ADIF 导入增强：当 FREQ 为空但 BAND 有值时，自动将频率写为类似 15M BAND；当 MY_SIG=POTA 时，将 MY_SIG_INFO 视为本台 QTH。
• ADIF 导入中未落入模型的扩展字段，统一按 字段名称：字段内容； 追加到备注。

验证

• 本地 ./gradlew.bat test 通过。
• 本地 ./gradlew.bat reloadPlugin 通过。

Generated from v2.3.1

2.3.0

本版本包含近期累计功能与配置调整：

• 通联日志支持 ADIF 格式导入，ADIF 导出专项活动选项文案调整为“不添加”。
• 新增“日常线下换卡”内置活动。
• 线上换卡申请审核改为显式点击“创建卡片”后进入后续流程。
• 线上换卡收卡未匹配记录支持一键创建卡片并完成匹配。
• 系统配置邮件通知策略调整为更明确的三档/两档策略配置。
• 新增自动审批通过线上换卡请求后的本台邮件通知策略与模板。

验证

• 本地 .\gradlew.bat test 通过。
• 本地 .\gradlew.bat reloadPlugin 通过。
• GitHub Actions CI 通过。
• GitHub Actions CD 构建和 GitHub Release 附件上传通过。

更新内容

• 通联业务创建卡片默认卡片版本调整为系统内置“不发卡”。
• 修复收卡业务清单误隐藏“不发卡”正式卡片的问题，收卡业务仍可将对方来卡关联到无需我方发卡的通联记录。
• 同步产品定义与结构化清单文档。

验证

• .\gradlew.bat test 通过。
• .\gradlew.bat reloadPlugin 通过。

Generated from v2.2.5

更新内容

• 新增系统内置卡片版本“不发卡”，不写入本台卡片配置，库存视为无限。
• “不发卡”记录不进入制卡签发、发信确认、送达确认队列，并从待发、已发、签收统计口径中排除。
• 修复导入导出过程中 qsl-station-card-* / station-card-* 脏卡片记录继续传播的问题。
• 调整通联业务创建卡片清单为待创建记录，并支持一键创建正式卡片。
• 将收卡编号迁移入口收口到收卡业务批量编辑场景。
• 同步更新结构化规格文档与相关测试。

验证

• pnpm --dir ui build
• ./gradlew.bat test
• ./gradlew.bat reloadPlugin

Release 附件由 CD 自动构建并上传，本次不手动上传 JAR。

Generated from v2.2.4

2.2.3

本版本包含以下改动：

• 通联业务创建卡片新增默认卡片备注。
• 通联日志清单新增一键创建卡片操作，自动选择排序靠前且仍有库存的卡片版本。
• QRZ.COM 地址获取改为 Biography/Detail 资料页优先、XML 辅助，支持 Base64 动态 Biography 解码。
• 优化呼号地址 AI 解析提示词，中文地址优先于英文翻译地址。
• 增加 QRZ.COM 解析与提示词升级相关回归测试。

验证：

• pnpm --dir ui build
• ./gradlew.bat test
• ./gradlew.bat reloadPlugin

Generated from v2.2.3