业余无线电爱好者（Ham）通常会把每一次通联（QSO）记录到日志平台。BG8LNG 开发了一款 Halo 插件 通联统计（QsoStats），通过 Wavelog 日志平台的 API v2，把你的通联数据实时展示在个人网站上——统计看板、按呼号查询、一键 OQRS 卡片申请，全部开箱即用。
主要功能
1. 通联统计看板
插件会拉取 Wavelog 统计数据并渲染成现代化卡片：通联总数、活跃度（今日/本月/今年）、DXCC 字头、波段分布、模式分布、最近通联。所有项目都可以在后台增删、排序、启停、改标题。
2. 按呼号查询 QSO
在组件顶部的搜索框输入呼号，即可查询本站与该呼号的通联记录，列表只展示日期、模式、频段三列，简洁明了。
3. 一键 OQRS 卡片申请
OQRS（Online QSL Request System）让访客可以在线申请 QSL 卡片。查询到通联记录后，点击列表下方的「一键 OQRS 申请」，填写邮箱（必填）、选择寄送方式（卡片管理局 / 直邮）、可附留言，即可一键为列表中的所有通联提交卡片申请。申请由插件后端转发到 Wavelog，访客无需持有任何 API Token，安全又方便。
4. 跟随主题风格的现代排版
组件以 CSS 变量驱动，自动继承主题的字体与配色；默认的卡片式设计（柔和阴影、渐变强调色、模式/频段徽标）在亮色与暗色主题下都有不错的表现，主题作者也可以通过 --qso-stats-* 变量深度定制。
安装与配置
1. 在 GitHub Releases 下载最新版 qso-stats-*.jar；
2. 在 Halo 后台「插件 → 安装」上传并启用（旧版本可直接升级，配置会保留）；
3. 在插件「设置」中填写：
- Wavelog 站点地址（如 https://log.example.com）
- API v2 Token（wl2_ 开头，需 statistic:read 与 qso:read 权限）
- 可选：缓存时间、请求超时、统计项目、呼号查询与 OQRS 开关、结果上限等
4. 在任意页面放置组件容器即可展示：
<div class="qso-stats-widget"></div>也可以直接访问独立统计页面 /qso-stats（Halo ≥ 2.26 自动复用主题布局）。
相关链接
- 插件主页：<https://github.com/bg8lng/halo-plugin-qso-stats>
- 使用文档：见插件仓库 README
- Wavelog：<https://www.wavelog.org>
如果你也是 Ham 且在用 Halo，欢迎安装体验；有任何建议或问题，欢迎到仓库提 Issue。73！
