前言¶

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

前言¶