前言¶

DeepSeek Harness (DSH) 提供了插件化扩展能力。dsh-bluebubbles 是一个 Bridge 插件，用于将本地运行的 BlueBubbles 服务（macOS 上的 iMessage 桥接）接入 DSH。它通过 REST 工具和 Webhook 推送，将消息路由到已绑定的 Workspaces。

核心功能¶

该插件主要解决本地 iMessage 代理与 DSH 工作区之间的通信问题，包含以下能力：

本地服务器桥接：将本地 BlueBubbles 服务器接入 DSH。
REST 工具：提供 bluebubbles_send_text（发送文本）和 bluebubbles_send_attachment（发送附件）两个高频工具。
Webhook 推送：支持 /bluebubbles/webhook 路径接收推送，并自动查找绑定的 Workspace。
CLI 管理：通过 bb-channel CLI 进行绑定解析、联系人管理及配置。
辅助模块：包含 dsh-heartbeat（心跳）和 dsh-cron（定时任务）模块。
会话持久化：支持冷启动与会话恢复。
API 检测：自动检测新旧 Shell/Persistence API。

典型用法¶

主要通过 bb-channel CLI 进行操作。所有输出均为格式化 JSON（对 jq 友好），错误信息输出到 stderr。

聊天与消息¶

bb-channel chats [--limit N] [--all]
bb-channel messages <chatGuid> [--limit N]
bb-channel send <chatGuid> <text...>
bb-channel send-attachment <chatGuid> <file>

绑定与会话管理¶

bb-channel bind <chatGuid> (--workspace PATH | --session ID)
bb-channel unbind <chatGuid>
bb-channel bindings

联系人与 Webhook¶

bb-channel contacts
bb-channel set-contact <address> <name>
bb-channel webhook [--url URL]

环境配置¶

可以通过环境变量 BLUEBUBBLES_TZ=Asia/Shanghai 覆盖时区设置。

注意事项¶

版本兼容性：仅支持 DSH 主机版本 0.1.1-rc.1、0.1.1-rc.2 和 0.1.7-rc.2。0.1.5 及其他未经测试的预览版不受支持。
凭证链：环境变量读取优先级为 process.env -> ~/.dsh/.env -> ~/.zshenv。
实时生效：bb-channel CLI 直接编辑配置文件，修改立即生效，无需重载。
防循环机制：使用 pendingSent 队列和 seenGuids 防止消息重复发送。
引用回复：支持 iMessage 的引用回复（swipe-reply）功能。

安装与启用¶

源数据未提供具体的安装命令。

结尾¶

dsh-bluebubbles 将本地的 iMessage 能力封装为 REST 工具和 Webhook，供 DSH Agent 调用。开发者可以通过 CLI 直接管理聊天、绑定和联系人，适合需要在本地环境中通过 iMessage 进行自动化交互的场景。

dsh-bluebubbles

前言¶