用途:该技能用于开发或维护 Moltbot 的 BlueBubbles 外部频道插件,涉及扩展包、REST 发送/探测与 Webhook 入站。
主要能力与结构:扩展包位于 extensions/bluebubbles/,入口为 index.ts;频道实现见 src/channel.ts;Webhook 处理见 src/monitor.ts(通过 api.registerHttpHandler 注册);REST 辅助见 src/send.ts 与 src/probe.ts;运行时桥接见 src/runtime.ts(通过 api.runtime 设置);引导目录条目见 src/channels/plugins/catalog.ts。
内部辅助函数(应使用这些而非直接调用原始 API):probeBlueBubbles 用于健康检查;sendMessageBlueBubbles 用于文本发送;resolveChatGuidForTarget 用于查找聊天;sendBlueBubblesReaction 用于 tapback;sendBlueBubblesTyping 与 markBlueBubblesChatRead 用于聊天状态;downloadBlueBubblesAttachment 用于入站媒体;buildBlueBubblesApiUrl 与 blueBubblesFetchWithTimeout 用于共享 REST 管道。
Webhook:BlueBubbles 向网关 HTTP 服务器发送 JSON;需防御性规范化发送者/聊天 ID(不同版本载荷有差异);跳过标记为来自自身的消息;通过插件运行时(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=❤️。
限制:资料未提供安装命令、收费、价格、平台与效果等信息。