koishi-plugin-earthquake-early-warning v0.1.5

koishi-plugin-earthquake-early-warning

一个基于 Wolfx API 的实时地震预警的插件（移植于 MCEEW，感谢作者与项目）

>>
⚠️福建局地震预警⚠️ | 第 1 报 
2024-07-15 18:42:59 发生
震央: 台湾花莲县附近海域 
(北纬: 24.22度 东经: 121.84度)
规模: 4.1
更新时间: 2024-07-15 18:43:26

>>
⚠️福建局地震预警⚠️ | 第 2 报 
2024-07-15 18:42:59 发生
震央: 台湾花莲县 
(北纬: 24.13度 东经: 121.35度)
规模: 3.5
更新时间: 2024-07-15 18:43:44

ChangeLog

v0.1.5

修复

• 本插件无法在指令管理界面设置别名和等级权限的问题

修改

• 修改触发指令#EEW 为 EEW
• 命令与子命令的别名与权限设置均交予指令管理界面进行设置
• 精简插件设置

v0.1.4

修改

• 更换依赖 ws 为 koishi内置的 ctx.http.ws，遵循koishi标准

新增

• 支持推送如下的历史消息源
  1. China CENC Eqlist
  2. Japan JMA Eqlist

v0.1.3

修复

• 无法处理并预警来自Japan JMA EEW的信息

v0.1.2

新增

• 插件设置页面的日志信息显示

v0.1.1

修改

• Koishi的权限系统消息提示由自定义消息提示改为官方消息提示
• 完善日志显示（匹配Koishi终端格式，以 eew 开头）
• 修改操作为子指令，以适配Koishi官方操作 （支持 点操作 调用和 空格操作 调用） 例如：#EEW.开启 = #EEW 开启 = eew 开启 = eew.开启

v0.1.0

发布

• 支持如下的预警源
  1. Sichuan / Taiwan / Fujian EEW.
  2. Japan JMA EEW
• 支持简单的Koishi的权限系统，默认为2级
• 支持预警的开关设置，需要手动去设置启用
• 支持预警的别名设置，默认为#EEW 和 eew
• 支持多Bot多用户推送（仅需建立一个WebSocket）
• 支持预警附加Emoji

Command

EEW -h

>> EEW -h
指令：eew
地震预警菜单界面
可用的子指令有：
    eew 关闭  关闭地震预警
    eew 平台  查看地震预警推送Bot列表
    eew 开启  开启地震预警
    eew 测试  发送地震预警测试消息
    eew 状态  查看地震预警信息
    eew 目标  查看地震预警推送目标列表
    eew 重置  重置地震预警

Warning

• 启用插件前，请先启用并设置好WebSocket地址、推送群聊/私聊名单和推送机器人名单
• 使用插件前，先打开预警EEW的总开关和需要推送的地区预警信息的开关
• 此插件实时预警依赖于所填写的API，通信很可能受到 地区等 影响
• 设置成功后并用指令启动预警时，插件设置的日志信息会显示如下心跳信息

2024-07-18 11:45:14 [S] eew ws opened
2024-07-18 11:45:14 [I] eew ws received: heartbeat.alive [2024-07-18 11:45:14]
2024-07-18 11:46:14 [I] eew ws received: heartbeat.alive [2024-07-18 11:46:14]

网络设置

1. eewUrl （必填） 地址预警的WebSocket地址（以 wss://） （此处不提供API，请自行搜索）

2. eewTimeout 通信超时时间（默认值：1500ms）

基本设置

1. enableEew 指令 EEW 的总开关。(默认值：关闭)

2. showEewLog 推送预警时是否同时在终端中显示预警信息。(默认值：开启)

3. showEewEmoji 输出信息中是否使用Emoji表情强调。(默认值：开启)

名单设置 （必填）

1. eewSendList 预警推送 群聊 / 私聊 白名单，你需要指定如下两个字段 target （群聊：Group，私聊：Friend） id （群QQ \ 个人QQ \ 其他平台的ID类型）

   <mark>PS：沙盒中的用户ID就是用户名</mark>

2. eewBotList 预警机器人白名单（此处要填入机器人的ID字段） PS：自己的QQBot的机器人ID就是QQ号，而沙盒的机器人ID就是koishi

推送设置

下述开关不开启则不推送

1. enabledScEew 是否启用四川地震预警推送（默认值：关闭）

2. enabledFjEew 是否启用福建地震预警推送（默认值：关闭）

3. enabledCwaEew 是否启用台湾地震预警推送（默认值：关闭）

4. enabledJmaEew 是否启用日本地震预警推送（默认值：关闭）

5. enabledJmaEqlist 是否启用日本地震报告推送（默认值：关闭） （暂设定为仅解析No1消息）

6. enabledCencEqlist 是否启用中国地震台网地震报告推送（默认值：关闭） （暂设定为仅解析No1消息）

Usage

以下是所有命令的使用方法，请自行翻阅。

格式：EEW <操作>

使用前注意事项

• 若插件设置完毕后，需要用 EEW 开启 来启动预警 当 EEW 状态 内的预警开关和通信状态均为正常时，预警插件才生效 此时也可等待一会后通过查看终端中是否出现ws received: heartbeat.alive 此类心跳检测信息来判断预警是否正常运行。

• 此插件暂未实现失去连接后的连接恢复，若有需要请定期用EEW 状态 进行检查，若为 已开启✅️ 但是 无连接❌ 时，需要先执行EEW 重置 进行状态重置后再用 EEW 开启 来启用插件。

状态

查看地震预警信息 EEW 状态 或 EEW.状态

>> EEW 状态
⚠️地震预警状态信息⚠️
预警开关：已关闭 ❌
通信状态：无连接 ❌
平台数量：共 1 个 🤖
目标数量：共 3 个 🧑

>> EEW 状态
⚠️地震预警状态信息⚠️
预警开关：已开启 ✅️
通信状态：正在连接 ⏳
平台数量：共 1 个 🤖
目标数量：共 3 个 🧑

>> EEW 状态
⚠️地震预警状态信息⚠️
预警开关：已开启 ✅️
通信状态：已连接 ✅️
平台数量：共 1 个 🤖
目标数量：共 3 个 🧑

>> EEW 状态
⚠️地震预警状态信息⚠️
预警开关：已开启 ✅️
通信状态：无连接 ❌
平台数量：共 1 个 🤖
目标数量：共 3 个 🧑

开启

开启地震预警 EEW 开启 或 EEW.开启

>> EEW 开启
地震预警开启成功

>> EEW 开启
请勿重复开启

关闭

关闭地震预警 EEW 关闭 或 EEW.关闭

>> EEW 关闭
地震预警关闭成功

>> EEW 关闭
请勿重复关闭

重置

重置地震预警 EEW 重置 或 EEW.重置 此命令如下场景： 预警开关：已开启 ✅️ 通信状态：无连接 ❌ 此情况一般为丢失连接

>> EEW 重置
地震预警重置成功

测试

发送地震预警测试消息 EEW 测试 或 EEW.测试

>> EEW 测试
⚠️台湾地震预警⚠️ | 第 2 报
2024-04-03 07:58:10 发生
震央: 花蓮縣壽豐鄉 
(北纬: 23.89度 东经: 121.56度)
规模: 6.8
深度: 20km
最大震度: 6弱
更新時間: 2024-04-03 07:58:27

目标

查看地震预警推送目标列表 EEW 目标 或 EEW.目标

>> EEW 目标
⚠️地震预警推送目标⚠️
目标：Alice [私聊] 🧑
目标：Bob [私聊] 🧑
目标：Zeta [私聊] 🧑
目标：114514 [群聊] 🧑
目标：1919810 [私聊] 🧑

平台

查看地震预警推送Bot列表 EEW 平台 或 EEW.平台

>> EEW 平台
⚠️地震预警推送平台⚠️
平台：koishi [机器人] 🤖
平台：114514 [机器人] 🤖

致谢

• 感谢 Wolfx Project 提供的地震防灾相关的Wolfx Open API
• 感谢 @TenkyuChimata 的 MCEEW 项目（从此处移植）

End

• 本插件无法保证为最及时的预警，地震预警应先以 当地预警 为准！
• 本插件暂时未做消息整合，当预警时可能会出现刷屏的情况。
• 地震来了谁没事看QQ群？（逃 ε=ε=ε=┏(゜ロ゜;)┛ -- Aegiszhy