没有金粒？加入IK系列插件QQ交流群免费获取：318569582
- 作者：I IKUN2004
- QQ：2895552468
插件简介
IK_Spark_Bridge 是一款专为星辰守望服务器及 IK 系列插件打造的底层消息桥接核心组件。它本身不直接向玩家提供游戏内功能，而是作为中间件，将 SparkBridge 的底层 QQ 机器人 API 进行了高度封装。通过统一导出
IK_UTILS 命名空间接口，其他任何 LSE 插件（如在线时长里程碑、经济流水播报等）只需一行代码，即可轻松将游戏内的数据推送到官方 QQ 群，彻底告别复杂的机器人对接逻辑。
核心特性
开箱即用： 默认自动读取 SparkBridge主插件配置的默认群号，无需重复配置繁琐的机器人数值。
异常隔离： 完美的错误捕获与状态检测（isBridgeReady），当机器人掉线或未配置时，调用它的插件不会因此发生崩溃或报错。
统一前缀： 支持在配置文件中设置全局统一的消息前缀（如 [星辰守望]），让推送到群内的消息整齐划一。
无缝接入： 极其简洁的 ll.import导出接口，为所有第三方脚本插件提供了最优雅的 QQ 互通方案。
配置文件说明
插件首次运行后，会在 SparkBridge 目录下生成 config.json。| 配置项 | 数据类型 | 默认值 | 作用说明 |
|---|---|---|---|
enabled | boolean | true | 全局开关。设为 false 则切断所有依靠此插件发送的 QQ 消息。 |
useSparkDefaultGroup | boolean | true | 是否自动读取 SparkBridge 主配置里的默认群号。 |
groupId | number | 0 | 若上一项设为 false，则强制使用此项指定的 QQ 群号进行推送。 |
prefix | string | "" | 消息前缀。例如填入 [星辰] ，群内收到的所有消息前都会带上这个前缀。 |
logSuccess | boolean | false | 是否在控制台打印每一条成功推送到 QQ 群的消息日志（建议按需开启以防刷屏）。 |
安装与部署
前置依赖要求：- 服务器必须已安装 LeviLamina (LSE) 环境。
- 服务器必须已正确安装并配置好 SparkBridge3（星火桥接）主插件，且机器人能正常登录。
- 将下载好的 IK_Spark_Bridge.js 文件直接放入服务器的 SparkBridge3/plugins/ 目录中。
- 启动（或重启）服务器。
- 观察控制台，若出现 [IK_Spark_Bridge] 星辰QQ消息桥接插件加载完成 且后续提示 QQ机器人已上线，则代表安装成功。
开发者 API (供其他插件调用)
本插件将所有方法导出在 IK_UTILS 命名空间下。其他 LSE 插件可通过以下方式极速接入：1. 快速发送消息 (最常用)
这是最核心的方法，调用后直接将文本发送至配置好的 QQ 群。
代码：
// 1. 导入接口
const sendToQQ = ll.import("IK_UTILS", "sendToBridge");
// 2. 直接使用 (会自动处理前缀和错误)
if (sendToQQ) {
sendToQQ("这是一条来自星辰守望其他插件的测试消息！");
}2. 获取桥接状态接口
用于获取当前机器人是否准备就绪、获取群号，或者热重载配置。
代码：
// 获取状态
const isReady = ll.import("IK_UTILS", "isBridgeReady");
if (isReady && isReady()) {
log("QQ机器人已准备就绪！");
}
// 获取当前绑定的推送群号
const getGroupId = ll.import("IK_UTILS", "getBridgeGroupId");
let targetGroup = getGroupId ? getGroupId() : 0;
// 通知桥接核心重新读取 config.json
const reloadBridge = ll.import("IK_UTILS", "reloadBridgeConfig");
if (reloadBridge) reloadBridge();注意事项： 任何依赖本插件的组件，在使用前请务必使用
if (ll.import(...))进行判空检查，以确保在玩家未安装本桥接核心时，原插件仍能正常独立运行。
