super-wechat-bridge：把微信 iLink ClawBot 消息橋接進 DeepSeek Harness

前言¶

用 dsh（DeepSeek Harness）跑智能體時，操作入口通常在 Web 界面裏。人離開電腦後，想給 agent 補一句指令、查一下任務結果，就得專門回去開頁面。如果這些對話和通知能直接走微信，事情會順很多。

super-wechat-bridge 解決的就是這個問題：它通過微信官方的 iLink ClawBot 協議，把微信消息接進 dsh，讓微信成爲 dsh 的遠程入口。下面介紹它的定位、核心功能、安裝與使用方式。

這是什麼¶

super-wechat-bridge 是一個微信 iLink ClawBot 遠程橋接插件，作者是 Qshuai0213，許可證爲 MIT，當前版本 1.0.0。它不走第三方機器人協議，而是官方 iLink 協議直連：長輪詢收消息，用 msg 包裹 + text_item 發送（官方格式）。peerDependencies 聲明 @deepseek-ai/dsh-agent ^0.1.0-rc.6、@deepseek-ai/dsh-tools ^0.1.0-rc.6 等，協議與 dsh API 均經實測。

一個值得注意的實測細節：發送時必須帶 base_info.channel_version + from_user_id + client_id，缺失時服務器會返回 message_id 但不投遞。插件已經處理了這一點。

核心功能¶

會話與回覆¶

1、每個微信用戶獨立 dsh 會話，通過 agents.create({ sessionId }) 創建，用 agent.followup 續輪。

2、回覆自動轉發：wechat 會話每輪 agent 的最終文字回覆自動發回微信。實現上監聽 session/event，按 user/message 真實來源過濾上下文快照。

3、wechat_reply 工具用於主動推送（比如任務完成通知）。同一輪內如果已經用工具發送過，自動轉發會跳過，避免重複。

4、會話級提示詞：wechat 會話的 agent 會收到「正在通過微信對話」的上下文，按會話 id 條件注入，不影響其他會話。

Web 設置界面¶

微信功能沒有獨立入口，全部集成在 dsh Web 的「設置 → 微信橋接」頁面，包含掃碼登錄、模型/預設/思考強度/權限配置、會話列表（打開/複製/刪除）、憑據狀態。

24h 自動續期¶

iLink 會話有效期約 24 小時（服務端限制，無法延長）。插件內置自動續期：到期前約 2 小時，把新二維碼鏈接推送到微信（發給最近活躍的會話），掃碼即可無縫續期，全程不斷線；最後 30 分鐘未續期會再次提醒。

其他¶

插件自帶 dsh.bundle.patch（cordis.patch.yml），安裝後自動掛載，無需手動編輯 profile 的 cordis.patch.yml。
錯誤落盤 stateDir/errors.log，排查問題時可直接查看。

安裝與啓用¶

從 GitHub 安裝發佈版：

dsh plugin --profile web add "github:Qshuai0213/super-wechat-bridge"

本地開發安裝：

dsh plugin --profile web add "file:D:/ai工作區/super-wechat-bridge"

安裝後 patch 自動掛載，配置走 schema 默認值：stateDir 默認爲 $DSH_HOME/channels/wechat（無 DSH_HOME 時 ~/.dsh/channels/wechat）、dmPolicy: pairing。

需要覆蓋配置時，在 profile patch 裏按 id 追加 config，例如改成 allowlist 模式並指定允許的微信用戶：

- insert:
    - id: wechat-bridge
      config:
        dmPolicy: allowlist
        allowFrom: ['o9cq80wwZLaIrJEBTW3TCRCVVyt8@im.wechat']

改完後重啓 dsh web。

登錄¶

三種方式任選：

1、Web 界面掃碼：打開「設置 → 微信橋接」，點「獲取登錄二維碼」，用手機微信掃碼並確認，憑據自動寫入並開始收消息。

2、微信內點鏈接續期（推薦）：到期前插件會自動推送「登錄憑據將於約 X 小時後過期」的消息，點開其中的鏈接掃碼確認即可。

3、命令行：

node node_modules/super-wechat-bridge/login.mjs "<你的 stateDir>"

stateDir 默認爲 $DSH_HOME/channels/wechat（無 DSH_HOME 時 ~/.dsh/channels/wechat）。手機微信打開輸出的鏈接掃碼授權，憑據寫入 credentials.json。

典型用法¶

使用流程很直接：微信裏給 ClawBot 發第一條消息 → dsh 出現 wechat-* 會話 → agent 回覆自動發回微信。

在「設置 → 微信橋接」的通道設置區塊裏，可以調整並持久化到 settings.yaml 的配置項包括：

設置項	說明
模型提供方 / 模型	微信會話使用的模型；留空跟隨全局默認
思考強度	`off / low / medium / high / max`，留空跟隨默認
權限模式	`pairing`（放行所有）/ `allowlist`（僅允許列表）/ `disabled`（關閉通道）
允許列表	allowlist 模式下生效，每行一個微信用戶 ID

生效時機有區別：權限模式與允許列表即時生效；模型/思考強度只對之後新建的微信會話生效，已有會話不變。頁面上同時顯示憑據狀態（登錄時間、剩餘有效期、活躍會話數），剩餘不足 2 小時插件會自動向微信推送續期二維碼。

適用場景與注意¶

適合的人羣：已經在跑 dsh，希望在手機上通過微信隨時與 agent 對話、下發指令、接收主動通知（比如任務完成提醒）的開發者。

使用前需要知道這些限制：

重啓後會話不續接：橋接按 wechat-<userId>-<時間戳> 新建會話，dsh web 重啓後同一微信用戶會開新會話，舊會話歷史保留在側邊欄，但橋接不再關聯。
圖片/語音等非文本消息以佔位文本 [非文本消息] 呈現，當前通道不接收媒體內容。
修改插件代碼後需要重啓 dsh web 才生效（HMR 不重載 node_modules 裏的模塊）。
iLink 會話約 24 小時有效期是服務端限制，插件只能續期，無法延長。

另外提醒一點：插件以當前 dsh 進程的權限運行，安裝前建議先查看源碼確認行爲符合預期。該項目使用 MIT 許可證。

結尾¶

super-wechat-bridge 把微信官方 iLink 協議和 dsh 的會話體系接在一起，配合 Web 設置界面和 24h 自動續期，讓微信成爲一個低維護成本的 dsh 遠程入口。如果你平時用微信多、離開電腦的時間長，值得裝上試一下。

插件目錄頁：https://www.skillhub.cn/plugins/Qshuai0213/super-wechat-bridge
GitHub 倉庫：https://github.com/Qshuai0213/super-wechat-bridge

順帶一提，skillhub.cn 是社區的插件目錄站點，與 DeepSeek / 幻方沒有官方從屬關係；DSH 本身的理念是「一切皆插件」，這類通道橋接正是插件生態裏常見的一類需求。