DSH 插件：WeChat 懸浮球橋接

前言¶

DeepSeek Harness (DSH) 採用了模塊化插件架構。lubaiUwU/dsh-wechatclawbot 插件實現了微信客戶端的接入，通過本地運行的網關服務，將微信消息中繼至 DSH 的智能體進行處理，並支持自動回覆。

該方案不依賴 OpenClaw，而是直接使用騰訊官方的 iLink 協議（與 @tencent-weixin/openclaw-weixin 同源）。它爲 DSH 提供了一個獨立的微信對話區，消息不會混入 GUI 原生會話，適合需要在本地環境運行微信自動化的場景。

核心功能¶

• 掃碼即用：通過 GUI 右下角的懸浮球掃碼登錄，登錄憑證本地保存，重啓 DSH 後自動恢復登錄。
• 獨立對話區：微信消息進入獨立的對話窗口，上下文連續且不干擾 GUI 原生會話。
• 對話切換：支持通過發送 /new、/新對話 或在懸浮球面板點擊「新對話」來切換獨立的對話區。
• ClawBot 專用模型：在懸浮球面板配置模型（支持快捷選擇或自定義）與思考強度（off/high/max），配置僅對微信回合生效。
• 聯繫人白名單：默認允許所有聯繫人，支持在面板對新聯繫人進行批准或忽略操作。

安裝與啓用¶

用戶無需手動處理複雜的依賴或路徑，只需通過 DSH 的自然語言接口或 CLI 命令安裝。

1. 用戶安裝命令

對 DSH 說以下任意一句：

請幫我安裝插件 https://github.com/lubaiUwU/DSH-WeChatClawBot

或在終端執行：

dsh plugin --profile <profile> add github:lubaiUwU/DSH-WeChatClawBot

（注：<profile> 需根據實際情況替換，如 desktop 或 web）

2. 安裝 Agent 執行步驟

安裝過程由 Agent 自動處理，需按順序完成：

1. 確定 Profile：檢測 $DSH_HOME/profiles/ 目錄，優先級爲 desktop > web > 其他。
2. 執行安裝：運行 dsh plugin add 命令。
3. 處理依賴墊片：如果遇到 allowBuilds 錯誤，編輯 pnpm-workspace.yaml 添加：

    allowBuilds:
      dsh-wechat-clawbot: true

並重新執行安裝命令。

4. 重啓 DSH：安裝完成後必須重啓 DSH 或 DSH Desktop 才能加載插件。

典型用法¶

安裝並重啓後，右下角會出現微信綠色懸浮球，按以下步驟操作：

1. 登錄：點擊懸浮球，使用手機微信掃碼。首次登錄可能需要輸入驗證碼。
2. 對話：微信發送消息，消息將直接進入 DSH 的獨立微信對話區。
3. 切換：在微信或面板點擊「新對話」，開啓新的上下文窗口。
4. 配置：在懸浮球面板設置模型密鑰和思考強度。
5. 審批：對於新聯繫人，面板會提示批准或忽略。

環境與架構¶

• 運行環境：
  • Node.js：必須安裝 >= 22.19 版本。
  • DSH Desktop：必須通過環境變量 ELECTRON_RUN_AS_NODE=1 拉起網關服務。
• 本地端口：
  • 127.0.0.1:51235：微信網關（負責協議收發與登錄）。
  • 127.0.0.1:51236：模型配置端點（懸浮球讀寫配置）。
• 數據存儲：
  • 狀態目錄位於 ~/.dsh-wechat/，包含登錄憑證、白名單、模型配置及會話映射。

適用場景與注意¶

• 適用對象：需要在 DSH 環境下進行微信自動化交互的開發者或個人用戶。
• 協議來源：微信接入使用騰訊官方 iLink 協議，核心代碼 MIT 許可。
• 風險提示：
  • 僅供學習與個人自動化研究使用。
  • 存在賬號風控風險，強烈建議使用小號。
  • 個人微信自動化操作可能導致賬號被限制或封禁，使用者需自行評估後果。