名称： bluebubbles
描述： 为 Clawdbot 构建或更新 BlueBubbles 外部频道插件（扩展包、REST 发送/探测、Webhook 入站处理）。

BlueBubbles 插件

当需要处理 BlueBubbles 频道插件时，请使用此技能。

项目结构

• 扩展包目录：extensions/bluebubbles/（入口文件：index.ts）。
• 频道实现：extensions/bluebubbles/src/channel.ts。
• Webhook 处理：extensions/bluebubbles/src/monitor.ts（通过 api.registerHttpHandler 注册）。
• REST 辅助工具：extensions/bluebubbles/src/send.ts + extensions/bluebubbles/src/probe.ts。
• 运行时桥接：extensions/bluebubbles/src/runtime.ts（通过 api.runtime 设置）。
• 插件目录入口：src/channels/plugins/catalog.ts。

内部辅助函数（请使用这些函数，而非直接调用原始 API）

• 健康检查：extensions/bluebubbles/src/probe.ts 中的 probeBlueBubbles。
• 文本消息发送：extensions/bluebubbles/src/send.ts 中的 sendMessageBlueBubbles。
• 聊天标识查找：extensions/bluebubbles/src/send.ts 中的 resolveChatGuidForTarget。
• 消息反应（Tapback）：extensions/bluebubbles/src/reactions.ts 中的 sendBlueBubblesReaction。
• 聊天状态管理：extensions/bluebubbles/src/chat.ts 中的 sendBlueBubblesTyping 与 markBlueBubblesChatRead。
• 入站媒体下载：extensions/bluebubbles/src/attachments.ts 中的 downloadBlueBubblesAttachment。
• 通用 REST 工具：extensions/bluebubbles/src/types.ts 中的 buildBlueBubblesApiUrl 与 blueBubblesFetchWithTimeout。

Webhook 处理

• BlueBubbles 会将 JSON 数据发送至网关 HTTP 服务器。
• 需对发送者/聊天 ID 进行防御性规范化（不同版本的负载格式可能不同）。
• 忽略标记为“来自自身”的消息。
• 通过插件运行时（api.runtime）和 clawdbot/plugin-sdk 辅助工具，将消息路由至核心回复管道。
• 对于附件/贴纸：若文本为空，使用 <media:...> 占位符，并通过入站上下文中的 MediaUrl(s) 附加媒体文件路径。

核心配置

• channels.bluebubbles.serverUrl（基础 URL）、channels.bluebubbles.password、channels.bluebubbles.webhookPath。
• 操作开关：channels.bluebubbles.actions.reactions（默认为 true）。

消息工具注意事项

• 消息反应（Reactions）：react 操作除了需要 messageId 外，还必须指定 target（电话号码或聊天标识符）。
  示例：action=react target=+15551234567 messageId=ABC123 emoji=❤️