前言¶
DeepSeek Harness（DSH）跑在本機時，常見用法是坐在電腦前在網頁或 IDE 裏發任務。人離開工位、只帶着手機時，要麼遠程桌面，要麼把需求記到別處再回來執行，鏈路都偏長。若希望用日常 IM 當「遙控器」，又不必自建公網回調服務，需要 DSH 側有一條官方通道的接入實現。下面介紹社區插件 dsh-wechat-assistant（維護者 Huangzihengcmd，分類：客戶端）：掃碼登錄微信一次，之後在同一聊天窗口發自然語言指令，由本機 DSH Agent 執行並把結果回傳。
這是什麼¶
dsh-wechat-assistant 是 DSH 插件，把個人微信賬號接到本機正在運行的 DSH 進程上。底層走騰訊爲 Agent 生態提供的 微信 ClawBot 通道（官方包 @tencent-weixin/openclaw-weixin）；插件負責 DSH 側的橋接：掃碼授權、進程內長輪詢收消息、把消息送入 DSH Session 執行、再把 Agent 輸出發回微信。
與「自建 Webhook + 公網服務器收微信回調」相比，README 強調：無需公網服務器、無需手動複製 token；二維碼在瀏覽器本地渲染，協議側使用 iLink Bot 的 get_bot_qrcode / get_qrcode_status / getupdates / sendmessage 等接口。
核心功能¶
- 掃碼登錄：打開 DSH 設置裏的「微信助理」即生成登錄二維碼；手機微信掃碼並確認授權，必要時在頁面填寫手機上的數字配對碼。
- 長輪詢收消息：通道在 DSH 進程內長輪詢微信服務端，README 說明不佔用端口。
- 執行與回傳：每條微信消息進入對應用戶的 DSH Session；一輪跑完後把正文發回同一聊天窗口。
- 會話管理：發送
/new或/新會話會結束當前對話並開啓新的 DSH Session。 - 狀態持久化：每個微信用戶對應獨立 Session；賬號憑據與續傳游標等寫在
<DSH_HOME>/wechat-assistant/accounts/下（默認<DSH_HOME>爲~/.dsh）。
數據流可概括爲：
微信 App ⇄ 微信 ClawBot 服務 ⇄ 本插件（長輪詢）⇄ DSH Agent
安裝與啓用¶
插件通過 DSH 的 plugin add 安裝，命令以 README 爲準：
dsh plugin add Huangzihengcmd/dsh-wechat-assistant
也可在 DSH 界面 Plugins → 添加插件，填入倉庫地址 Huangzihengcmd/dsh-wechat-assistant。
兼容性（README）：需要 DSH >=0.2.1-rc.5（依賴 ctx.agents.create/resume、agent.followup()、agent.whenIdle()、settings.section 等能力）。package.json 中聲明 Node >=22.13.0。許可證爲 MIT。
安裝後可在 Plugins 頁面或 profile 的 cordis.patch.yml 中調整插件行配置：
| 字段 | 默認 | 說明 |
|---|---|---|
autoConnect |
true |
啓動時自動接上上次登錄的賬號 |
cwd |
空 | 新會話的工作目錄；留空則用 DSH 默認目錄 |
典型用法¶
- 打開 設置 → 微信助理。頁面打開時會自動生成登錄二維碼。
- 用手機微信掃描二維碼，在手機上確認授權；若提示輸入數字配對碼，填到頁面輸入框。
- 卡片顯示「已連接」後，在微信裏直接發指令。
普通自然語言即可，例如：
幫我看一下這個項目有哪些測試沒跑
把這個目錄裏的 CSV 彙總成一張表
需要清空上下文時發送 /new 或 /新會話。
二維碼過期：二維碼有時效；過期後頁面會提示，點「刷新二維碼」即可。Host 側也會自動換髮（最多 3 次）。
適用場景與注意¶
適合誰：已經在本機跑 DSH、希望用手機微信臨時下發任務或看執行結果，且能接受消息內容進入 DSH 會話日誌（與網頁端對話同樣可追溯）的開發者。
權限與安全（README 原文要點）：
- 插件在本機 DSH 進程權限下執行指令，安裝前應自行審閱源碼與 MIT 許可證。
- 微信憑據只存在本機，不會發給瀏覽器或 DSH 之外；HTTP 路由僅接受本機 loopback 請求。
- 賬號 JSON 等文件權限爲
0600，路徑見 README 中的accounts/<id>.json等說明。
DSH 生態採用「一切皆插件」的擴展方式；社區目錄站點與 DeepSeek / 幻方無官方從屬關係，本文僅介紹該倉庫公開文檔中的能力。
結尾¶
dsh-wechat-assistant 把微信 ClawBot 通道接到 DSH：一次掃碼、進程內長輪詢、結果回到同一聊天。需要安裝命令與配置字段時，以 GitHub README 爲準；在目錄站可查看條目：dsh-wechat-assistant @ skillhub.cn。
