Cloudlog Helper
这段时间软件有更新，但HamCQ CN 站暂时停运了，就先把帖子发来这儿~
轻量级的Cloudlog/Wavelog辅助程序，自动上传当前电台信息以及实时QSO数据，支持大部分主流电台以及与JTDX/WSJT-X等软件协同工作！
如果您的电脑性能捉襟见肘，或单纯需要一个自动化QSO/电台信息上传工具，不妨来试试Cloudlog Helper！
github: https://github.com/SydneyOwl/cloudlog-helper
蓝奏云：https://wwbk.lanzouq.com/b00uz66gsd 密码:5ii8
💻 支持的平台
- Windows 7 SP1+
- Ubuntu 20.04+ 或其他主流发行版
- 正在适配macOS...
⚡️ 快速开始!
📌 Cloudlog配置
📌 第三方日志系统
📌 Clublog配置
📌 eqsl配置
输入您在eqsl上注册使用的账号和密码。点击测试，测试通过后可启用eqsl自动上传。
📌 HamCQ配置
HamCQ社区是国内的业余无线电爱好者交流社区。本软件集成了HamCQ社区的日志上传功能，您只需在对应输入框中填写HamCQ的apikey即可。
📌 Hamlib配置
如果您不需要电台数据自动上传功能，可直接忽略这一步。
由于在开启JTDX（或WSJT-X，下称JTDX）后，电台的控制权将被JTDX独占，因此在未设置JTDX前，此功能和JTDX不能同时启用。可查看与JTDX协同工作部分获取解决方法。
本软件可以定时上传电台信息（频率、模式等）到您的Cloudlog服务器。当您需要记录QSO信息时，Cloudlog会自动获取当前的频率、模式等数据，并自动填充至对应输入框中，避免手动输入错误。同时，
Cloudlog 主界面中也会实时显示电台的 频率、模式等信息，方便操作时参考。
📌 UDP服务器配置
此部分的工作原理类似GridTracker，JTDX会通过 UDP 协议 广播当前解码的呼号、频率、信号报告等信息，而CloudlogHelper将接收这些信息并解码，将通联结果实时上传至您的Cloudlog服务器。
- 此部分不须过多配置，如果您更改了此部分的端口号，请同步更改JTDX中的UDP服务器配置。**注意，如果JTDX和Cloudlog Helper不在同一台机器上运行，您需要勾选“允许外部连接”选项，并更改JTDX中UDP服务器的ip地址部分为运行Cloudlog Helper机器的ip。
**
- 此后，当JTDX处于发射模式，或完成了一个QSO之后，软件主界面都会显示对应信息。
🚀 高级
🎯 与JTDX/Wsjt-x协同工作
如果您希望在开启JTDX的情况下实时上报电台数据，请参考以下内容。Wsjt-x的操作过程与此类似。
当您开启JTDX后，电台的控制权将被JTDX独占，此时您将无法通过本软件读取电台频率。幸运的是，JTDX和本软件均可以使用Rigctld作为电台的控制后端，您只需修改一下JTDX中的网络服务器地址，使
本软件和JTDX共享一个Rigctld后端即可。
请勿将JTDX和本软件的轮询间隔设置得过小，太频繁的数据请求可能导致电台来不及反应导致出错。一个建议值是在JTDX的设置-电台中设置时间间隔为8s，本软件的轮询间隔为15s。请注意，两者不能为整数倍数
具体做法如下（以Windows7为例）：
- 打开Cloudlog Helper，进入“设置”页面，填写电台相关信息后勾选“电台信息自动上报”。注意，不要勾选
禁用PTT控制 。JTDX依赖此功能控制电台发射。
- 点击“应用更改”。
- 打开
JTDX，进入设置-电台，将无线电设备更改为Hamlib NET rigctl
，CAT控制中的网络服务器填写rigctld后端地址（默认为127.0.0.1:4534），PTT方法保持原配置不变.
🔧 实用工具
QSO上传助手
此工具能够自动从您的Cloudlog服务器上下载已上传的QSO，并于本地QSO(目前仅支持Wsjtx和JTDX格式的日志)进行对比，筛选出未上传的QSO并帮您自动上传补齐。例如您启动了jtdx， 但是忘记启动日志记录软件，或者网络不小心断开了没发现，这时候就会存在遗漏 QSO 没上传的情况。此工具旨在解决这一问题。
| 配置项 | 说明 |
|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|
| Execute sync on startup | 如果勾选了此项，则在每次启动软件时都会首先打开这一工具并自动开始同步。 |
| Username | Cloudlog的登陆用户名。 |
| Password | Cloudlog的密码。 |
| Cloud Sample (days) | 从Cloudlog上按照天数下载的最新的QSO数量，这些QSO将作为基准数据，用于与本地QSO进行对比。<br/>请按照自己的需求设置。如果通联不频繁，这个值应当适当大一些以确保下载的云端QSO样本量足够覆盖本地QSO。例如设为 10 表示工具会获取云端最新的 10 天内的 QSO 记录。 |
| Local Sample (QSOs) | 从本地日志文件读取的最近 QSO 记录数量，用于与云端记录对比。例如设为 50 表示工具会检查本地最新的 50 条 QSO 是否都已上传到云端（即是否在从云端下载的，数量为Cloud Sample的最新QSO中都存在）。 |
| Local Log Paths | 本地的日志路径。 |
🎯 各配置项说明
请见github readme。
🛠️ 编译
请见github readme。
✨ 其他
请见github readme。
🙏 致谢
- Hamlib: 业余无线电设备控制库（支持电台、旋转器、调谐器及功放）
- WsjtxUtils: 基于 C# 的类库及示例代码，通过 .NET & .NET Framework 4.8 的 UDP 接口与
WSJT-X 交互
- ADIFLib: 用于读取、解析和写入 ADIF（版本 3.1.0）文件的 C# 库。
📝 许可证
Cloudlog Helper是释放至公共领域的免费无约束软件。任何人可出于任何目的（商业或非商业），以任何形式（源代码或编译文件），自由地复制、修改、发布、使用、编译、出售或分发本软件。
完整的许可证信息请参考仓库中的Unlicense文件。
⚠️ 免责声明
软件使用
Cloudlog Helper 是一款免费的开源软件，旨在为业余无线电爱好者提供便捷的 Cloudlog/Wavelog
辅助功能。用户可自由下载、使用或修改本软件，但所有使用行为均需自行承担风险。开发者及贡献者不对因使用本软件导致的任何直接或间接损失负责，包括但不限于：
- 数据丢失或损坏
- 电台设备异常或故障
- 网络通信问题
- 其他因软件兼容性、配置错误或操作不当引发的后果
功能限制
数据安全与隐私
- 用户需自行确保输入的 Cloudlog/Wavelog API Key、Clublog 账户信息等敏感数据的安全性。本软件不会主动收集或存储这些信息，但因用户设备或网络环境导致的数据泄露风险需由用户自行承担。
- 通过 UDP 服务器接收的 QSO 数据默认仅在本地处理，启用“允许外部连接”功能可能增加安全风险，请谨慎配置。
设备操作风险
- 使用 Hamlib 控制电台时，请确保遵循设备制造商的操作规范。错误的轮询间隔或配置可能导致电台异常。建议首次使用时在不连接电台的情况下测试功能。
- 与 JTDX/WSJT-X 等软件协同工作时，需注意避免端口冲突或控制权竞争问题。开发者不承担因配置错误导致的设备损坏责任。
