本次更新

• 修复 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

查看版本详情