一、项目简介

业余无线电QSL管理系统 3.0.0 是一个面向业余无线电爱好者的开放软件项目。

项目最初围绕 QSL 卡片管理和通联记录展示展开，3.0.0 版本在原有基础上进一步扩展，逐步形成覆盖 QSO 日志、QSL 管理、电台控制、数字模式、媒体资料、数据同步、个人电台展示及社区通信 等能力的综合软件体系。

项目计划同时提供：

• 移动端；
• PC端；
• Halo 插件。

不同终端根据各自使用场景承担不同功能，并共享统一的数据和业务体系。

项目坚持 开源、免费、本地优先、数据开放 的基本方向，使用户既可以完全在本地使用，也可以根据需要启用联网同步、自托管 Web 服务及其他扩展能力。

二、项目目标

本项目希望逐步建立一套完整、开放且可持续发展的业余无线电软件工具链。

主要目标包括：

1. 为个人业余无线电操作提供统一的 QSO 日志和 QSL 管理工具；
2. 支持移动、固定台、户外架台、比赛、数字模式等不同使用场景；
3. 提供电台控制、日志自动记录及相关设备联动能力；
4. 提供 LoTW 等现有业余无线电服务的兼容和数据交换能力；
5. 支持 QSL 卡片、SSTV 图片及其他通联资料的统一管理；
6. 支持用户自行部署个人 Web 电台页面及日志管理服务；
7. 支持多人共同维护俱乐部台、比赛台、特设台等公共电台数据；
8. 探索适用于业余无线电社区的开放身份、公告、QSL交换及去中心化通信机制；
9. 为其他开发者提供可复用的数据模型、接口和基础组件。

项目最终希望从单一应用逐步发展为：

一套面向业余无线电个人、团队和社区的开放软件平台。

三、主要使用场景

3.1 个人日常通联

用户可以通过移动端或 PC 端记录日常 QSO，并管理：

• 呼号；
• 时间；
• 频率；
• 模式；
• RST；
• 网格；
• QSL 状态；
• LoTW 状态；
• 通联备注；
• 卡片及图片资料。

日志可以长期保存在本地，也可以选择同步至个人 Halo 站点。

3.2 户外和移动操作

移动端主要面向：

• 户外架台；
• POTA / SOTA 等活动；
• 卫星通信；
• 临时电台；
• 移动操作。

在无网络环境下仍可以完成日志记录和本地数据管理，恢复网络后再进行数据同步。

3.3 固定电台

PC端主要面向固定台和复杂操作场景，可逐步提供：

• 电台 CAT 控制；
• 自动读取频率和模式；
• PTT控制；
• 数字模式；
• SSTV；
• FT8/FT4；
• 频谱及相关辅助工具；
• 日志联动；
• DX信息；
• 比赛辅助功能。

PC端同时可以承担固定台的主要设备控制和数据处理任务。

3.4 QSL卡片管理

项目继续保留并强化原有 QSL 管理能力。

用户可以记录：

• 收卡；
• 发卡；
• 卡片申请；
• 回卡状态；
• 卡片交换方式；
• 卡片图片；
• 邮寄信息；
• LoTW及其他电子确认状态。

实体卡片与电子确认可以统一关联到对应 QSO。

3.5 个人电台网站

通过 Halo 插件，用户可以自行部署个人业余无线电站点。

站点可以用于：

• 日志管理；
• QSL查询；
• QSL申请；
• 通联记录展示；
• 卡片展示；
• 电台资料展示；
• 活动记录；
• 数据统计；
• 个人主页。

用户可以自行决定哪些数据公开、哪些数据仅供本人或指定成员使用。

3.6 俱乐部与多人电台

Halo端计划支持多人共同管理同一个电台空间。

适用场景包括：

• 俱乐部电台；
• 学校社团电台；
• 比赛台；
• 特设台；
• DXpedition；
• 临时活动呼号。

不同成员可以根据职责拥有不同管理权限，共同维护日志、QSL及相关资料。

四、软件组成

4.1 移动端

移动端定位为：

随身业余无线电工具。

主要围绕轻量、便携和现场操作设计。

预计包括：

• QSO日志；
• ADIF导入导出；
• QSL管理；
• LoTW；
• 卡片照片；
• SSTV；
• 轻量数字模式；
• 轻量电台控制；
• 数据同步；
• 电台状态查看。

移动端不限定单一操作系统，后续可根据开发资源逐步支持不同平台。

4.2 PC端

PC端定位为：

固定电台综合操作终端。

除基础日志和QSL管理外，重点承担：

• 电台控制；
• 音频处理；
• 数字模式；
• 频谱和瀑布图；
• 固定台自动化；
• 外部软件联动；
• 比赛辅助；
• 卫星通信辅助；
• 多设备协同。

PC端将作为复杂功能和专业操作能力的主要承载平台。

4.3 Halo插件

Halo插件定位为：

自托管的业余无线电 Web Station Hub。

主要提供：

• Web日志管理；
• QSL管理；
• 数据同步；
• 多用户；
• 权限管理；
• 公开展示；
• 数据统计；
• Web API；
• 卡片及媒体管理。

Halo插件可以与移动端、PC端组合使用，也可以独立使用。

五、数据与同步

项目以用户数据长期可控为基本原则。

移动端和PC端均保存本地数据，使软件在没有网络的情况下仍然能够正常完成主要操作。

用户如配置 Halo 服务，则可以在本地与 Halo 之间同步日志、QSL及其他相关数据。

整体关系可以概括为：

移动端 ─────┐
            │
            ├──── Halo
            │
PC端 ───────┘

其中：

• 本地客户端负责日常操作；
• Halo负责联网数据、多人协作和Web展示；
• 用户可以根据需要选择是否启用Halo。

具体同步机制、数据状态和冲突处理方式将在独立的同步协议文档中定义。

六、数据兼容

项目将尽量保持与现有业余无线电生态兼容。

重点包括：

• ADIF；
• LoTW；
• Hamlib；
• rigctld；
• N1MM Logger+；
• WSJT-X；
• JTDX；
• DX Cluster；
• Telnet；
• S3 Compatible Object Storage。

项目不会要求用户放弃现有软件生态，而是希望成为现有工具之间的数据和功能连接层。

七、电台与设备控制

项目计划建立统一的电台控制能力，用于连接不同品牌和型号的业余无线电设备。

主要能力包括：

• 读取频率；
• 修改频率；
• 模式控制；
• VFO控制；
• PTT；
• 信号状态；
• 电台参数；
• 日志自动填充。

Hamlib 将作为重要兼容方案之一，同时保留未来扩展其他设备协议的能力。

具体电台控制接口和设备兼容方案将在 Radio HAL 技术文档中定义。

八、数字模式与媒体

项目计划逐步建立统一的音频和数字信号处理能力。

早期重点方向包括：

• SSTV；
• FT8 / FT4；
• 音频频谱；
• 瀑布图。

数字模式产生的通联信息最终进入统一日志体系。

图片及媒体内容可用于：

• SSTV接收图片；
• QSL卡片照片；
• 电台活动照片；
• 其他通联附件。

媒体既可以保存在本地，也可以配置对象存储服务。

九、QSL与身份体系

QSL仍然是本项目的重要核心能力之一。

除传统实体卡片管理外，项目未来将探索：

• 数字QSL；
• 双方通联确认；
• 呼号身份；
• 数字签名；
• 去中心化QSL交换。

LoTW Callsign Certificate 等现有业余无线电身份体系可以作为外部身份凭据之一。

未来的身份和QSL协议将在独立协议文档中设计，并保持与基础日志系统相互独立。

十、业余无线电社区通信

项目未来计划探索一个开放的业余无线电事件和公告网络。

可能包括：

• DX Spot；
• 电台在线状态；
• QRV公告；
• POTA/SOTA活动；
• 比赛信息；
• 卫星报告；
• 个人公告；
• QSL请求。

该能力可以与传统 DX Cluster 和 Telnet 系统进行兼容，同时探索新的分布式或去中心化通信方式。

十一、开放与开源

业余无线电QSL管理系统 3.0.0 将继续坚持开放开发。

计划公开：

• 核心源代码；
• 数据模型；
• API；
• 协议；
• 开发文档；
• Roadmap；
• 设备兼容情况；
• Issue；
• 测试结果。

其他开发者可以：

• 提交代码；
• 增加设备支持；
• 开发新的客户端；
• 编写插件；
• 实现相关协议；
• 提供测试；
• 完善文档。

项目希望通过社区协作逐步完善，而不是由单一开发者长期封闭维护。

十二、第三方客户端与扩展

项目长期希望形成开放的软件生态。

除官方移动端、PC端和Halo插件外，其他开发者未来也可以基于公开接口开发：

• Android客户端；
• iOS客户端；
• Linux客户端；
• Web客户端；
• POTA工具；
• 卫星工具；
• 比赛工具；
• 电台控制工具；
• QSL工具；
• 数据分析工具。

这些软件可以根据需要使用项目中的部分基础能力，而无需完整采用全部系统。

十三、项目发展阶段

第一阶段：基础数据能力

重点完善：

• QSO日志；
• QSL；
• ADIF；
• 本地数据；
• Halo数据模型；
• 基础同步。

首先建立稳定的数据基础。

第二阶段：三端基础应用

形成：

• 移动端基础版本；
• PC端基础版本；
• Halo插件3.0版本。

实现完整的日志和QSL基础工作流。

第三阶段：设备与外部服务

逐步加入：

• LoTW；
• 电台控制；
• Hamlib；
• 对象存储；
• 外部日志软件兼容。

第四阶段：数字模式

逐步加入：

• SSTV；
• FT8 / FT4；
• 音频处理；
• 频谱相关功能。

第五阶段：多人和社区能力

进一步完善：

• 多用户；
• 电台Workspace；
• 权限；
• 俱乐部台；
• 比赛台；
• 团队协作。

第六阶段：开放网络

探索并逐步建立：

• Ham Identity；
• Ham Event；
• 去中心化QSL；
• P2P通信；
• 开放社区协议。

十四、项目协作方向

项目欢迎不同类型的参与者。

软件开发

包括：

• 移动端；
• PC端；
• Halo；
• C/C++；
• DSP；
• 网络协议；
• 前端；
• 后端。

设备适配

包括：

• Icom；
• Yaesu；
• Kenwood；
• SDR；
• USB串口设备；
• 音频设备；
• 天线控制器；
• 云台。

HAM业务

包括：

• ADIF；
• LoTW；
• QSL；
• Contest；
• Satellite；
• POTA/SOTA；
• DX Cluster。

测试

没有开发经验的用户也可以通过：

• 电台兼容测试；
• 不同操作系统测试；
• 日志导入测试；
• LoTW测试；
• QSL流程测试；
• 文档反馈；

参与项目。

十五、项目愿景

业余无线电QSL管理系统 3.0.0 希望从原有的 QSL 管理插件逐步发展为一套完整的开放业余无线电软件体系。

它既可以是一款普通用户直接使用的日志和QSL软件，也可以作为固定电台和户外电台的操作平台；既可以完全离线运行，也可以通过用户自己的Halo服务实现联网同步和公开展示；既可以服务个人电台，也可以服务俱乐部和多人电台。

长期来看，希望逐步形成：

                       开放业余无线电软件生态

                              │
            ┌─────────────────┼─────────────────┐
            │                 │                 │
          移动端             PC端             Halo
            │                 │                 │
            └─────────────────┼─────────────────┘
                              │
                    统一数据与开放接口
                              │
          ┌────────────┬──────┼──────┬────────────┐
          │            │      │      │            │
        LoTW         Radio   QSL    Media        P2P

项目最终希望实现的不是某一个特定软件功能，而是：

让业余无线电日志、设备、QSL、媒体和社区数据能够通过开放的软件和协议连接起来，并使每一位用户始终能够掌握自己的数据和电台。