SuperAPI AI 工具集

bluebubbles

编程与开发

查看项目

更新于 10-16 00:04

技能介绍

用途:按公开资料整理,BlueBubbles 技能面向需要开发或更新 Moltbot 的 BlueBubbles 外部频道插件的场景,涉及扩展包、频道实现、Webhook 入站和 REST 交互。

主要组成:扩展包位于 extensions/bluebubbles/,入口为 index.ts;频道实现为 extensions/bluebubbles/src/channel.ts;Webhook 处理在 extensions/bluebubbles/src/monitor.ts(通过 api.registerHttpHandler 注册);REST 辅助在 extensions/bluebubbles/src/send.ts 与 src/probe.ts;运行时桥接为 src/runtime.ts(通过 api.runtime 设置);引导目录项在 src/channels/plugins/catalog.ts。

内部辅助函数:健康检查用 probeBlueBubbles;文本发送用 sendMessageBlueBubbles;聊天查找用 resolveChatGuidForTarget;tapback 反应用 sendBlueBubblesReaction;输入状态与已读用 sendBlueBubblesTyping、markBlueBubblesChatRead;入站媒体下载用 downloadBlueBubblesAttachment;共享 REST plumbing 用 buildBlueBubblesApiUrl 与 blueBubblesFetchWithTimeout。资料提示应使用这些内部辅助而非直接调用原始 API。

Webhook:BlueBubbles 向网关 HTTP 服务发送 JSON;需防御性归一化发送者与聊天 ID(不同版本 payload 有差异),跳过标记为自身发送的消息,并通过插件运行时 api.runtime 与 clawdbot/plugin-sdk 辅助接入核心回复管线。对于附件与贴纸,文本为空时可用 media:... 占位符,并通过入站上下文中的 MediaUrl(s) 附加媒体路径。

配置:channels.bluebubbles.serverUrl(基础 URL)、channels.bluebubbles.password、channels.bluebubbles.webhookPath;动作门控 channels.bluebubbles.actions.reactions 默认 true。

消息工具:react 动作除 messageId 外还需 target(手机号或聊天标识),例如 action=react target=+15551234567 messageId=ABC123 emoji=❤️。

限制:以上均为资料中明确的信息,未提及安装命令、收费、平台支持范围与具体效果,暂未提供。