前言¶

DeepSeek Harness（dsh）把智能體跑在本機：查資料、改代碼、處理文件，都在你自己的電腦上完成。官方把這件事概括成「Everything is a plugin」——模型、工具、會話、沙箱和界面都可以拆成插件來組合。開發者預覽版仍在演進，社區也在往外接通道上補能力。

本機跑得通之後，下一個常見需求是：人在外面，只拿得出手機微信，能不能把同一套 DSH 當移動終端用。常見做法是再搭一層網關、公網入口，或者把 OpenClaw 全家桶拉進來。維護成本會跟着上來，而你真正要的往往只是一條管道：微信發消息，家裏或辦公室那臺已經能跑 dsh web 的機器幹活，結果再回微信。

dsh-wechat-bridge 做的就是這條管道。它走騰訊官方 iLink 機器人通道（微信裏「ClawBot / 龍蝦」同款），掃碼配對後長輪詢收消息，再調用本機 DSH 發回回覆。社區插件目錄 deepseek-harness-plugin.com 把它歸在「會話與消息」類。需要說明：該目錄是獨立站點，和 DeepSeek / 幻方沒有官方從屬關係，不是官方應用商店。

本文按目錄詳情頁、GitHub 倉庫 README / package.json / LICENSE，以及 DeepSeek Harness 官方倉庫覈對後整理。

這是什麼¶

dsh-wechat-bridge 是一款把 DeepSeek Harness 接到微信的傳輸插件，由 gtaifu 維護，託管在 GitHub 倉庫 gtaifu/dsh-wechat-bridge，許可證爲 MIT。package.json 當前版本是 1.1.0，要求 Node.js >= 18。截至 2026 年 8 月 18 日，倉庫有 7 顆星。

它解決的問題很具體：把微信變成 DSH 的移動終端。倉庫 README 把數據路徑畫成：

手機微信 ──► 騰訊 iLink 官方通道 (ilinkai.weixin.qq.com) ──► weixin-bot.mjs ──► 本機 DSH
    ▲                                                              │
    └────────────────────────── 回覆 ──────────────────────────────┘

協議對照的是騰訊官方開源 SDK @tencent-weixin/openclaw-weixin 2.4.6。官方 OpenClaw 微信插件本身也只是這套協議的客戶端，AI 後端可以自選；騰訊側按倉庫的說法只是管道。因此這裏不需要 OpenClaw 運行時，也不需要公網服務器或額外網關。

適合已經會裝 DSH、並且希望「隨時在微信裏」用私有助理的人。倉庫聲明的驗證基線是：Node.js >= 18、dsh@0.1.0-rc.6（npm）、iLink 對照 SDK 2.4.6，操作系統覆蓋 Windows / macOS / Linux，最後驗證日期爲 2026-08-14。新版本 DSH 一般向後兼容（橋接只調用 dsh 的 headless 子命令），但升級 DSH 或官方 SDK 之後，README 要求先跑本地閉環測試，再連真實微信。

核心功能¶

零運行時依賴，掃碼即用¶

實現只用 Node 內建模塊，不裝 npm 運行時依賴，也不起獨立 daemon。個人微信免申請、免白名單：終端打印二維碼鏈接，手機微信打開並確認即可配對。登錄憑證會自動續期；收到騰訊 errcode -14（token 失效）會自動重新掃碼。憑證有效期由騰訊服務器決定，社區實測大約 24 小時，官方沒有承諾時長。

微信側需要在「我 → 設置 → 插件」裏添加「ClawBot / 龍蝦」插件。這是騰訊官方通道，和逆向個人微信協議不是同一類方案。

一人一上下文，會話可命名¶

每個微信聯繫人（from_user_id）有獨立的 DSH 對話記憶和工作目錄，默認落在 data/workspaces/ 下。跨輪次的文件操作結果會保留；記憶按條數和字符雙上限滾動裁剪。

同一聯繫人還可以有多個命名會話：默認會話叫 main。微信裏用斜槓指令切換：

/send 的絕對路徑直接用；相對路徑按當前會話的工作目錄計算。圖片、視頻按媒體發送，其餘按文件發送。微信發來的圖片、文件、視頻會自動下載解密，落到 data/media/。語音保存爲官方原始 .silk，倉庫當前不做轉碼。

可審計，也能指定工作目錄¶

聊天記錄、DSH 完整運行軌跡、運行日誌分三層可查。對話原文在 data/history/（本地明文 JSON）；DSH 軌跡仍由 DSH 自己寫在 ~/.dsh/sessions/。命令入口包括：

node weixin-bot.mjs chats
node weixin-bot.mjs history --chat <ID> --last 20
node weixin-bot.mjs sessions --chat <ID>

<ID> 可以用完整 chatId、用戶 ID，或 chats 列出的 hash 鍵。

如果希望某個會話直接跑在代碼倉庫根目錄，而不是默認的 data/workspaces/，可以在數據目錄放 workspace-overrides.json。值可以是路徑字符串，也可以是帶權限的對象：

{
  "0bf36b275c23e653": {
    "dir": "D:\\path\\to\\your\\workspace",
    "permission": "danger-full-access"
  }
}

鍵是該會話默認工作目錄名（safeKey(chatId) 的前 16 位，可用 node weixin-bot.mjs chats 的「鍵」列查看）。permission 可選 read-only、workspace-write、danger-full-access；不設則跟隨 DSH 全局設置。danger-full-access 表示不限制文件讀寫、不彈審批。改完後要重啓 dsh-weixin run 才生效。

倉庫裏還有通用橋接 bridge.mjs，提供 serve 子命令（HTTP 殼，默認端口 8317、綁定 127.0.0.1，可選 --token 鑑權），給 OpenClaw exec、wechaty 等外部程序調用。日常連微信走的是 weixin-bot.mjs / dsh-weixin。

倉庫已聲明的限制¶

• 單條回覆超過 --reply-max-chars（默認 3800）會截斷，完整結果在 DSH 工作目錄或終端裏。
• 羣聊：官方插件當前聲明僅 direct chat，羣消息不保證。
• 同一時刻只有一條 DSH 任務在跑，不同聯繫人串行排隊。
• 騰訊可能變更協議端點或字段；失效屬於協議漂移，升級本倉庫再驗證即可。

安裝與啓用¶

插件以當前 dsh 進程的權限運行，安裝時可能執行代碼。安裝前請檢查源代碼倉庫和許可證；如需可復現安裝，請固定 commit 哈希。

社區目錄頁給出的安裝命令是（以頁面原文爲準）：

dsh plugin add github:gtaifu/dsh-wechat-bridge

固定到某個 commit 時寫成：

dsh plugin add github:gtaifu/dsh-wechat-bridge#<commit>

把 <commit> 換成倉庫裏的真實哈希。

倉庫 README 把日常使用建立在全局命令 dsh-weixin 上。當前可用的源碼安裝方式：

git clone https://github.com/gtaifu/dsh-wechat-bridge.git
cd dsh-wechat-bridge
npm install -g .

國內也可以用 README 標明的 Gitee 鏡像：https://gitee.com/gtaifu/dsh-wechat-bridge。Windows 下可以不安裝，直接運行倉庫裏的 dsh-weixin.cmd，或 node weixin-bot.mjs <子命令>。

README 另寫了一種 npm install -g dsh-wechat-bridge，並註明「npm 發佈後可用」；倉庫驗證清單裏，按包名安裝這一項仍標爲待復跑。因此目前不要把 npm 包名安裝當成已經走通的路徑。

卸載命令、清除憑證和刪除本地 data/ 的做法見倉庫 README。DSH 自己的運行軌跡在 ~/.dsh/sessions/，與本插件的數據目錄相互獨立。

典型用法¶

環境：Node 18+；本機已安裝 DSH，且 dsh web 能跑。

連真實微信¶

dsh-weixin login
dsh-weixin run

1. login 時終端會打印二維碼鏈接，用手機微信打開該鏈接並確認。
2. 在微信「我 → 設置 → 插件」中添加「ClawBot / 龍蝦」。
3. 配對成功後，給 Bot 發消息即可。run 需要保持終端開着。

強烈建議加上 --allow-from，只響應指定用戶 ID（逗號分隔）。倉庫寫得很明確：任何能給你微信發消息的人，都能觸發本機 DSH 執行任務，權限等價於你本機賬號。登錄憑證在 --auth-file（默認 weixin-auth.json）裏，含 bot token，不要提交到版本控制或外傳。

常用命令行選項（均有 DSH_WXBOT_* / DSH_BRIDGE_* 環境變量等價項）：

停接收消息：在 dsh-weixin run 的終端按 Ctrl+C。清除本機登錄憑證：dsh-weixin logout。歷史數據默認不刪，重新 login 可以恢復。

本地閉環（不連真實微信）¶

倉庫提供 mock iLink 服務器，用來驗證協議頭和收發流程，不消耗模型：

# 終端 A
node test-mock-ilink.mjs --port 8899

# 終端 B（Linux / macOS）
export DSH_BRIDGE_MOCK_DSH=1
node weixin-bot.mjs login --base-url http://127.0.0.1:8899 --data-dir ./test-data
export DSH_WXBOT_MAX_MSGS=2
node weixin-bot.mjs run --base-url http://127.0.0.1:8899 --data-dir ./test-data

Windows PowerShell 把 export 換成 $env:DSH_BRIDGE_MOCK_DSH="1" 即可，命令與 README 一致。

對騰訊真實端點做冒煙（只取真實二維碼，不登錄）：

node weixin-bot.mjs probe

適用場景與注意事項¶

適合這些情況：

• 本機已經在跑 DSH，希望用手機微信遠程下任務、收回復。
• 不想額外部署公網服務器、ngrok 或 OpenClaw。
• 需要按聯繫人隔離記憶和工作目錄，或者同一人切換多個命名會話。
• 需要把本機文件發到微信，或把微信發來的圖片/文件落到本地再交給 DSH。

使用前把這幾條當作硬約束：

1. 權限。插件以當前 dsh 進程權限運行。微信消息會觸發本機 DSH 執行，--allow-from 只放行自己，並維持 DSH 自身的沙箱和審批配置。workspace-overrides.json 裏的 danger-full-access 會關掉文件限制和審批彈窗，只在你明確需要時使用。
2. 許可證與源碼。項目是 MIT 社區開源，安裝前應閱讀倉庫源碼和 LICENSE。社區目錄不是 DeepSeek 官方應用商店。
3. 通道條款。這是騰訊官方 iLink 通道，受《微信 ClawBot 功能使用條款》約束：騰訊可以限速、過濾或中止服務，不得用於營銷、客服、高頻羣發。
4. 憑證。weixin-auth.json 等於「以你的微信身份收發消息」。網絡訪問範圍按 README 是 HTTPS 訪問 ilinkai.weixin.qq.com 與騰訊 CDN，閉環測試時指向本地 mock。往來消息原文以明文 JSON 存在 data/history/。
5. 穩定性。羣聊不保證；任務串行；回覆可能截斷；協議可能漂移。二維碼過期、掃了沒反應時，重新 dsh-weixin login，並確認打開的是最新打印的鏈接。出現 dsh: command not found 時先安裝 DSH，或用 --dsh-bin 指定路徑。

安全問題請按倉庫 SECURITY.md 私下報告（GitHub Security Advisory，或標題帶 [SECURITY] 的 issue），不要在公開 issue 裏貼 token 或復現細節。

小結¶

dsh-wechat-bridge 把本機 DSH 接到微信官方 iLink 通道：掃碼登錄、零運行時依賴、不經過 OpenClaw，一個好友對應一套常駐會話。目錄頁安裝入口是 dsh plugin add github:gtaifu/dsh-wechat-bridge；日常收發靠 dsh-weixin login 和 dsh-weixin run。先看源碼和許可證，加上 --allow-from，再把它當成你口袋裏的 DSH 終端。

• 目錄頁：https://deepseek-harness-plugin.com/zh-CN/plugins/dsh-wechat-bridge/
• GitHub：https://github.com/gtaifu/dsh-wechat-bridge
• DeepSeek Harness：https://github.com/deepseek-ai/deepseek-harness