# Cloudlog helper `Cloudlog helper`是一款轻量级的`Cloudlog`/`Wavelog`辅助程序，支持自动上传当前电台信息以及实时QSO数据到Cloudlog/Wavelog/Clublog，同时支持大部分主流电台以及与`JTDX`/`WSJT-X`等软件协同工作！如果您的电脑性能捉襟见肘，或单纯需要一个自动化QSO/电台信息上传工具，不妨来试试`Cloudlog Helper`！ **下载地址详见文末～** [upl-image-preview uuid=90967da0-bb80-472f-9edc-a6197f7fa7be url=https://storage.hamcq.cn/2025-05-24/1748065495-594152-image.png alt={TEXT?}] ## 💻 支持的平台 + Windows 7 SP1+ + Ubuntu 20.04+ 或其他主流发行版 + 正在适配macOS... ## ⚡️ 快速开始! > 您也可以选择自行编译，请参照下文的`编译`章节。 + 从`Release`中下载对应系统版本的软件。如果您使用Linux且需要使用电台数据上报功能，请使用sudo启动软件。 + 打开软件，点击`设置`->`基础设置`打开设置页面。 + **请在开始使用前完全阅读本文档及文末的免责声明** ### 📌 Cloudlog配置 + 输入您的Cloudlog / Wavelog服务器（下称Cloudlog）地址以及对应的API KEY。 + 点击“测试”，如您输入正确，在apikey下方将出现选择站点ID的下拉框。如果您在Cloudlog / Wavelog设置了多个站点请在此选择正确的id，后续的QSO都将上传到此id中。 [upl-image-preview uuid=3f9808d4-d967-4333-ab94-cf21c2d69e79 url=https://storage.hamcq.cn/2025-05-24/1748064884-443580-image-20250510212652161.png alt={TEXT?}] ### 📌 Clublog配置 + 输入您在Clublog上注册时使用的呼号、邮箱和密码。 + 点击“测试”，如测试通过，您可以在“UDP设置”中启用“自动上传QSO到Clublog”。 [upl-image-preview uuid=9e716b13-4f36-4101-9a04-3947f55ad564 url=https://storage.hamcq.cn/2025-05-24/1748064968-776528-image-20250524113607297.png alt={TEXT?}] [upl-image-preview uuid=acb46143-7b07-4dac-aead-b69e91b4a07e url=https://storage.hamcq.cn/2025-05-24/1748064978-321228-image-20250524113747984.png alt={TEXT?}] ### 📌 Hamlib配置 > 如果您不需要电台数据自动上传功能，可直接忽略这一步。 > **由于在开启JTDX（或WSJT-X，下称JTDX）后，电台的控制权将被JTDX独占，因此在未设置JTDX前，此功能和JTDX不能同时启用。可查看`与JTDX协同工作`部分获取解决方法。** 本软件可以定时上传电台信息（频率、模式等）到您的Cloudlog服务器。当您需要记录QSO信息时，Cloudlog会自动获取当前的频率、模式等数据，并自动填充至对应输入框中，避免手动输入错误。同时，Cloudlog 主界面中也会实时显示电台的频率、模式等信息，方便操作时参考。 + 在`电台型号`下拉框中选择您使用的电台的型号。 + 在`设备端口`中选择您的设备所在的端口。 + 点击“测试”按钮。测试无误后方可勾选“电台数据自动上报”。点击“确认”保存配置。 [upl-image-preview uuid=0a864aee-9133-4b35-a219-b089f7f0178b url=https://storage.hamcq.cn/2025-05-24/1748065176-960175-image.png alt={TEXT?}] + 软件主界面应该出现了读取到的电台相关信息。打开您的Cloudlog网站，主页应该出现了您的电台信息： [upl-image-preview uuid=72fb3b5b-7be3-4080-af49-f2790289f4f5 url=https://storage.hamcq.cn/2025-05-24/1748066022-987751-image.png alt={TEXT?}] + 在"Station"中选择您的电台。此后，在您填写QSO信息时，Cloudlog都将自动帮您填充频率、模式等信息。 [upl-image-preview uuid=21fac9a3-66dd-445d-87bc-0fdaaee2b1e6 url=https://storage.hamcq.cn/2025-05-24/1748066041-361585-image.png alt={TEXT?}] ### 📌 UDP服务器配置此部分的工作原理类似`GridTracker`，`JTDX`会通过 UDP 协议广播当前解码的呼号、频率、信号报告等信息，而`CloudlogHelper`将接收这些信息并解码，将通联结果实时上传至您的Cloudlog服务器。 + 此部分不须过多配置，如果您更改了此部分的端口号，请同步更改JTDX中的UDP服务器配置。**注意，如果JTDX和CloudlogHelper不在同一台机器上运行，您需要勾选“允许外部连接”选项，并更改JTDX中UDP服务器的ip地址部分为运行Cloudlog Helper机器的ip。** [upl-image-preview uuid=bc7c5178-066f-49f5-87b8-bd03bea26f2b url=https://storage.hamcq.cn/2025-05-24/1748066234-422632-image.png alt={TEXT?}] + 此后，当JTDX处于发射模式，或完成了一个QSO之后，软件主界面都会显示对应信息。 [upl-image-preview uuid=099e59d6-9d60-42d1-ac48-8c0dcf30b27c url=https://storage.hamcq.cn/2025-05-24/1748066158-494490-image.png alt={TEXT?}] ## 🚀 高级 ### 🎯 与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方法保持原配置不变. [upl-image-preview uuid=fed6fe9a-65ff-43cd-b833-5665f277a480 url=https://storage.hamcq.cn/2025-05-24/1748066353-858967-image.png alt={TEXT?}] + 测试CAT和PTT均可用后，点击“确定”。 + 现在您就成功实现了CloudlogHelper和JTDX的协同工作。 [upl-image-preview uuid=35750201-259f-463f-bba8-cd614cf562c1 url=https://storage.hamcq.cn/2025-05-24/1748066388-343080-image.png alt={TEXT?}] ### 🎯 各配置项说明 #### ⚙️ Hamlib配置 | 配置项 | 说明 | | -------------------------- | ------------------------------------------------------------ | | 电台数据自动上报 | 如此项被勾选，软件将自动上传获取到的电台信息到指定的cloudlog服务器。 | | 轮询间隔 | 指定向rigctld后端获取电台数据的时间间隔。默认为9秒。 | | 电台型号 | 目前使用电台的型号。型号列表从rigctld中读取，因此理论上只要hamlib支持的电台本软件均支持。 | | 设备端口 | 电台所在的端口。 | | 报告异频信息 | 在轮询时向rigctld请求异频（在接收和发射时使用不同频率）信息。部分电台不支持此功能或读取的数据有误。 | | 报告发射功率 | 在轮询时向rigctld请求当前的发射功率。部分电台不支持此功能或读取的数据有误。 | | 高级设置-rigctld命令行参数 | 手动指定启动rigctld后端的命令行参数。此项具有最高的优先级，如果此项不为空，其他相关配置（禁用PTT控制/允许外部控制）均会被忽略。**如果您选择手动指定命令行参数，则必须显式指定rigctld的ip地址和端口（-T -t ）,软件将从命令行参数中自动解析port。** | | 高级设置-禁用PTT控制 | 在启动时禁用rts和dtr控制（增加参数`--set-conf=""rts_state=OFF"" --set-conf ""dtr_state=OFF"" `）。仅在部分Lnux上需要启用。如需与JTDX等第三方软件协同工作，此选项不应该勾选。 | | 高级设置-允许外部控制 | 允许从localhost以外的设备与rigctld后端交互（增加参数 `-T 0.0.0.0` ）。 | | ~~高级设置-允许请求代理~~ | ~~启动一个代理服务器，可以将外部的请求代理至软件中，由软件按照优先级按顺序自动发送至rigctld。~~ | | 使用外部rigctld服务 | 使用外部的rigctld作为软件的rigctld后端。例如您手动启动了一个rigctld实例，就可以勾选此选项，配置软件使用您指定的rigctld后端。 | #### ⚙️ UDP服务器配置 | 配置项 | 说明 | | --------------------- | -------------------------------------------------------- | | 启用UDP服务器 | 启动一个UDP服务器，用于接收来自第三方软件发送的QSO数据。 | | 端口号 | UDP服务器的端口号。 | | 允许外部连接 | 允许接收localhost以外的设备发来的请求。 | | 自动上传QSO到Cloudlog | 自动上传接收到的QSO到指定的Cloudlog服务器。 | | 自动上传QSO到Clublog | 自动上传接收到的QSO到指定的Clublog服务器。 | | QSO上传失败重试次数 | 指定QSO上传失败重试次数。 | ## 🛠️ 编译详见github readme ## ✨ 其他详见github readme ## 🙏 致谢 + [Hamlib](https://github.com/Hamlib/Hamlib): 业余无线电设备控制库（支持电台、旋转器、调谐器及功放） + [WsjtxUtils](https://github.com/KC3PIB/WsjtxUtils): 基于 C# 的类库及示例代码，通过 .NET & .NET Framework 4.8 的 UDP 接口与 WSJT-X 交互 ## 📝 许可证 `Cloudlog Helper`是释放至公共领域的免费无约束软件。任何人可出于任何目的（商业或非商业），以任何形式（源代码或编译文件），自由地复制、修改、发布、使用、编译、出售或分发本软件。完整的许可证信息请参考仓库中的[Unlicense](./LICENSE)文件。 ## ⚠️ 免责声明 1. 软件使用 Cloudlog Helper 是一款免费的开源软件，旨在为业余无线电爱好者提供便捷的 Cloudlog/Wavelog 辅助功能。用户可自由下载、使用或修改本软件，但所有使用行为均需自行承担风险。开发者及贡献者不对因使用本软件导致的任何直接或间接损失负责，包括但不限于： + 数据丢失或损坏 + 电台设备异常或故障 + 网络通信问题 + 其他因软件兼容性、配置错误或操作不当引发的后果 2. 功能限制测试阶段声明：本软件目前处于测试阶段（UNDER TESTING），可能存在未发现的缺陷或功能不稳定性。建议用户在使用前备份重要数据，并避免完全依赖本软件进行关键操作。第三方依赖：本软件依赖 Hamlib、JTDX/WSJT-X 等第三方库或工具，其功能及兼容性受限于这些组件的支持范围。开发者无法保证所有设备或软件的适配性。 3. 数据安全与隐私用户需自行确保输入的 Cloudlog/Wavelog API Key、Clublog 账户信息等敏感数据的安全性。本软件不会主动收集或存储这些信息，但因用户设备或网络环境导致的数据泄露风险需由用户自行承担。通过 UDP 服务器接收的 QSO 数据默认仅在本地处理，启用“允许外部连接”功能可能增加安全风险，请谨慎配置。 4. 设备操作风险使用 Hamlib 控制电台时，请确保遵循设备制造商的操作规范。错误的轮询间隔或配置可能导致电台异常。建议首次使用时在不连接电台的情况下测试功能。与 JTDX/WSJT-X 等软件协同工作时，需注意避免端口冲突或控制权竞争问题。开发者不承担因配置错误导致的设备损坏责任。 ## 下载地址 github: https://github.com/SydneyOwl/cloudlog-helper 欢迎star~ 蓝奏云：https://wwbk.lanzouq.com/b00uz66gsd 密码:5ii8

v0.2.2已更新： + 修正flrig模式读取失败的问题 + 修正了一个可能导致图表内存泄漏的问题 `v0.2.0`-`v0.2.1-patch1`累计更新： + 现已支持将FLRIG作为电台控制后端！您可以在Hamlib和FLRIG之间进行选择！（#3） + 新增支持多种日志服务（现支持Cloudlog / Wavelog / HRDLOG（含On-Air功能）/ Clublog / eqsl.cc / HamCQ / LoTW / QRZ）。（#4） + 主窗口现支持将电台模块、无线电模块和日志模块分离为浮动窗口，方便随时调用。 + 新增多类统计图表，包含台站分布图与世界热力图。 + 已完成英文翻译。 + 设置窗口的界面优化。 + 修复多项程序错误。（#5） [upl-image-preview uuid=f96fb153-3059-4ff9-8724-208e84599577 url=https://storage.hamcq.cn/2025-10-04/1759586796-686691-noborder-edit-small.png alt={TEXT?}] [upl-image-preview uuid=10794e59-26c8-445b-a162-ff02fe27fdd1 url=https://storage.hamcq.cn/2025-10-04/1759587532-322456-2025-10-02-182044.png alt={TEXT?}] [upl-image-preview uuid=146561c2-6adf-44c5-8cee-ba374d434eec url=https://storage.hamcq.cn/2025-10-04/1759587563-62328-2025-10-02-182013.png alt={TEXT?}]

用过楼主写的森海克斯写频软件先赞再看

设置界面在3000×2000分辨率，150%缩放的环境下，窗口过大。把缩放改为100%后显示正常。 [upl-image-preview uuid=b522ef00-5ef5-465d-b6bc-04fa561ff2db url=https://storage.hamcq.cn/2025-05-24/1748071780-463632-image.png alt={TEXT?}]

@"Liridice"#p66905 哈哈，代码漏提交了，编译错版本了，现在已更新+修正

@"BG5VLI"#p66908 另外，Clublog的上传似乎不工作

@"Liridice"#p66909 Clublog的上传需要手动启用的，默认是未启用状态 [upl-image-preview uuid=d33768e7-3bf6-4622-8513-d6fb9e86fb99 url=https://storage.hamcq.cn/2025-05-24/1748076504-873891-image.png alt={TEXT?}] 另外需要确认下呼号邮箱和密码是否正确

@"BG5VLI"#p66916 重新打开一次工具，现在正常了。

@"Liridice"#p66917 哈哈，那就是出bug了，我研究一下

看起来还不错，比我现在用的方案简单点。我现在用的我RCForb+flrig+WavelogGate+OWRX,实现电台、日志、频谱三方频率、模式联动。 [upl-image-preview uuid=0541aa48-8ad6-4887-96b0-3b5bf3a6402a url=https://storage.hamcq.cn/2025-05-24/1748081285-405163-290b19545151d34767ef29c3b3fbffd.png alt={TEXT?}]

可以跟RCForb共存吗，RCForb可以虚拟一个K3的设备串口给flrig使用，间接给WavelogGate读取电台数据。另外怎么跟OWRX联动频率？ [upl-image-preview uuid=99e3e994-304a-4d41-9d90-4189ea6764da url=https://storage.hamcq.cn/2025-05-24/1748081545-587282-image.png alt={TEXT?}]

@"BI7ALG"#p66921 不知道rcforb是不是用的hamlib作为控制后端，如果是的话说不定可以共用一个rigctld实现共存，这样就不需要gate了；另外owrx是啥？还是第一次听说

Cloudlog 助手 - 一種輕巧的 Cloudlog/Wavelog 工具，支援無線電台數據自動上傳以及 QSO 自動上傳。

BG5VLI

版本 0.1.3 已發布：

整合 HamCQ 的日誌功能
修正 UDP 伺服器的啟動異常問題
修正設定視窗縮放異常問題

歡迎下載體驗！

BI7ALG

BG5VLI FT-710的串行埠直接連接一直出現錯誤，也無法使用RCForb產生的虛擬K3設備，甚至在第一次進入設定介面時，軟體都會崩潰，穩定性還需要持續改進。

BG5VLI

BI7ALG 哈，目前軟體仍在開發中，穩定性確實不足。另外，虛擬設備 K3 目前似乎不受 hamlib 支援。若需要使用串列直接連接，請注意該串列是否已被其他軟體佔用。

BG5TOX

薄膜！
做得非常棒！

BD8DHF

我目前使用的是jtdx+gridtracker將 QSO上傳到wavelog。在這種情況下，可能會遺漏 QSO： jtdx已經啟動，但gridtracker卻沒有啟動，或者網路不小心斷線，導致無法偵測，這時候就會出現遺漏 QSO的情況。
我不確定 Cloudlog Helper 是否能夠處理這種情況。例如，如果忘記啟動 Cloudlog Helper 或網路斷線的情況下，之後是否能自動補齊遺失的 QSO？
目前我採用定期執行一個 Python 腳本的方式，來查詢本地 `jtdx` 目錄下的所有記錄，然後透過 API 查詢 `wavelog` 中已存在的記錄，逐一比較，如果發現有遺漏的記錄，再透過 API 將其上傳到 `wavelog` 中。

BA7LAC

BD8DHF 實際上，你可以直接在 wavelog 中重新傳送記錄，因為系統會自動忽略重複的 QSO。

BG5VLI

BD8DHF 是的，可以直接上傳重複的日誌。Wavelog/Cloudlog 會自動過濾（除非您已選擇「允許重複日誌」）。
之後可能會新增日誌掃描功能，將當天遺失的日誌傳送上。

BD8DHF

BA7LAC 但這樣就需要手動操作，不太優雅。

BD8DHF

BG5VLI 自動是最理想的方式。相較於程式本身處理數據的規模，QSO 的數據量可以說是極小的，我使用的 Python 腳本，可以直接比較最近的一千條 QSO，也只需要幾秒就能完成。

BG5VLI

版本 0.1.4 發布：

修正主視窗關閉時，應用程式未正確關閉的問題。
新增 eQSL 功能支援
新增 QSO 輔助功能 (測試階段)
介面設定優化
支援 UDP 資料傳輸

關於 QSO 上傳助手：
這個工具（設定 - 工具）能夠自動從您的 Cloudlog 伺服器下載已上傳的 QSO，並與本地 QSO (目前僅支援 WSJTX 和 JTDX 格式的日誌。)進行比較，篩選出尚未上傳的 QSO並自動幫您補齊。例如，您啟動了jtdx，但卻忘了啟動記錄軟體，或是網路不小心斷線而未發現，這時就會出現遺漏 QSO未上傳的情況。此工具旨在解決這個問題。在使用此工具之前，必須先完整填寫主設定中關於cloudlog的部分。

設定選項	說明
啟動時進行同步	如果已勾選此選項，則每次啟動軟體時，該工具會自動開啟並開始同步。
Username	Cloudlog 的登入使用者名稱。
Password	雲路記錄的密碼。
雲端樣本	從 Cloudlog 取得的最新 QSO 數量，這些 QSO 將作為基準數據，用於與當地的 QSO 進行比較。這個值應該顯著大於 Local Sample。例如，設定為 `200` 該工具會取得雲端上最新的 200 筆 QSO 記錄。
當地樣本	從本地日誌檔案讀取的最近 QSO 記錄數量，用來與雲端記錄進行比較。例如設定為 `50` 這款工具會檢查您當地的最新 50 筆 QSO 是否已經上傳到雲端（也就是，這些 QSO 是否也存在於從雲端下載的，數量為「Cloud Sample」的最新 QSO 中）。
本地記錄路徑	本機的日誌路徑。

Liridice

仍然有一些無法解釋的錯誤，例如 QSO 上傳助手發現我的日誌中有幾條記錄沒有上傳，顯示處理成功。但查看軟體的 UDP 日誌後，發現剛才上傳的這些記錄都是失敗的上傳，原因如下：
呼叫失敗，狀態碼為 400（請求錯誤）：POST http://url/index.php/api/qso/
再去 Wavelog 檢查這些記錄，已經存在。

BG5VLI

Liridice `wavelog` 在測試方面可能有些不足，因為我個人使用的是 `cloudlog`，兩者之間的 API 非常相似，這需要進一步研究。
另外，我想請問一下，這些在「QSO助手」中偵測到的 QSO，之前是否真的沒有進行過任何記錄或傳輸？

Liridice

BG5VLI 這個我忘了看過了，等我把收音機修好之後再試看看。😆

然而，即使重新上傳這些失敗記錄，仍然會出現相同的錯誤訊息。

BG5VLI

v0.2.2已更新：

修正flrig模式读取失败的问题
修正了一个可能导致图表内存泄漏的问题

v0.2.0-v0.2.1-patch1累计更新：

现已支持将FLRIG作为电台控制后端！您可以在Hamlib和FLRIG之间进行选择！（#3）
新增支持多种日志服务（现支持Cloudlog / Wavelog / HRDLOG（含On-Air功能）/ Clublog / eqsl.cc / HamCQ / LoTW / QRZ）。（#4）
主窗口现支持将电台模块、无线电模块和日志模块分离为浮动窗口，方便随时调用。
新增多类统计图表，包含台站分布图与世界热力图。
已完成英文翻译。
设置窗口的界面优化。
修复多项程序错误。（#5）

« 上一页

闽ICP备2021006864号-7

闽公网安备35020602002794号互联网举报中心

用户协议隐私政策社区规范积分规则中继规则转载须知
更新日志联系我们常见问题友情链接运营报告赞助

浩奇科技（厦门）有限公司

是无线电，把我们联系在一起