前言¶

在 DeepSeek Harness (DSH) 的使用場景中，開發者常在 WSL 等類 Linux 環境下操作，但目標系統是 macOS。直接通過命令行操作 macOS 的系統通知、快捷指令或剪貼板往往比較繁瑣。dsh-mac-companion 插件解決了這一跨系統調用的問題，它作爲中間件，讓運行在 WSL 中的 DSH 能夠通過 HTTP 調用 Mac 上的守護進程，從而接入 Mac 的本地能力。

是什麼¶

dsh-mac-companion 是一個 DeepSeek Harness 插件，旨在充當 macOS Companion Daemon 的客戶端。它允許 DSH 通過 HTTP 協議與 Mac 上的守護進程通信，實現對系統通知、快捷指令執行以及剪貼板讀寫等功能的控制。該插件是 dsh-wsl-kit 的可選伴侶組件，並非包含在標準的安裝腳本中。

核心功能¶

插件提供了以下核心能力：
* mac_companion_status：通過 GET /v1/health 檢查 Companion 守護進程的健康狀態。
* mac_notify：向 Mac 系統發送通知。
* mac_run_shortcut：在 Mac 上執行快捷指令。
* mac_clipboard_read：讀取 Mac 剪貼板中的文本內容。
* mac_clipboard_write：向 Mac 剪貼板寫入文本內容。

安裝與啓用¶

在 WSL 環境中，先通過插件管理命令安裝該插件：

dsh plugin --profile web add github:173787247/dsh-mac-companion

安裝完成後，需要在 Mac 上啓動 Companion 守護進程。請確保 Mac 上已安裝 Python 3，並在終端中運行：

python3 companion/server.py --port 18765 --token 'your-secret'

最後，在 WSL 中配置環境變量以連接到 Mac：

export DSH_MAC_COMPANION_URL=http://<mac-ip>:18765
export DSH_MAC_COMPANION_TOKEN=your-secret

典型用法¶

經過上面的步驟，DSH 即可調用上述功能。例如，在 DSH 的配置或腳本中，通過指定對應的工具名稱即可觸發：
* 檢查狀態：調用 mac_companion_status。
* 執行通知：調用 mac_notify。
* 運行快捷指令：調用 mac_run_shortcut。
* 讀寫剪貼板：調用 mac_clipboard_read 或 mac_clipboard_write。

適用場景與注意¶

• 前置要求：DSH 版本需 ≥ 0.1.2。
• 確認機制：調用 mac_run_shortcut 和 mac_clipboard_write 時，必須設置參數 confirm=true 以觸發系統確認。
• 替代方案：如果僅用於 SSH CLI 場景，建議直接使用 dsh-remote-ssh 插件。
• 來源說明：該插件位於 GitHub 倉庫，遵循 MIT 許可證。由於它不是 install.sh 的一部分，需要手動安裝。

總結¶

dsh-mac-companion 提供了一種通過 DSH 橋接 macOS 本地能力的方案。通過簡單的 HTTP 配置和守護進程啓動，開發者可以方便地在 WSL 中控制 Mac 的通知、快捷指令和剪貼板。相關代碼與文檔位於 GitHub。