前言¶

DeepSeek Harness (DSH) 採用插件化架構，開發者經常需要在移動設備上與 agent 交互。dsh-weixin 插件解決了這一問題，它將手機微信作爲對話 DSH agent 的入口，允許用戶通過微信發送指令，由 agent 處理後通過微信回覆，無需在手機上額外安裝客戶端。

dsh-weixin 是什麼¶

這是一個 DeepSeek Harness 微信通道插件。由用戶 wendayuan 維護，許可證爲 MIT。它負責在微信端與 DSH 系統之間建立連接，使 agent 能夠接收來自微信的消息，執行任務，並將結果返回給微信。

核心功能¶

1. 消息流轉：手機微信發消息 → DSH agent 幹活 → 回覆發回微信。
2. 上下文連續：每個微信對話對應一個持久 session，支持多輪對話。
3. 憑據複用：複用 DSH 現有模型憑據（~/.dsh/.credentials.yaml），無需單獨配置。
4. 規則注入：自動加載 ~/.dsh/AGENTS.md 與 workspace AGENTS.md，agent 具備與網頁版一致的規則約束。
5. 進程常駐：插件隨 DSH 進程常駐，無需獨立守護進程。

安裝與啓用¶

使用官方安裝命令添加插件：

dsh plugin --profile web add github:you/dsh-weixin

安裝完成後，需要完成一次登錄。插件複用微信官方 iLink 通道的掃碼登錄。

登錄方式（推薦）：
使用橋接器 CLI 預登錄，憑證存於 ~/.openclaw：

npx weixin-acp login

終端打印二維碼，使用手機微信掃碼並確認，終端顯示「✅ 與微信連接成功」即可。之後該登錄狀態會隨 DSH 進程自動複用。

配置¶

在 profile 的 cordis.patch.yml 中覆蓋配置（均爲可選）：

- id: weixin
  name: dsh-weixin
  config:
    cwd: /path/to/workspace   # agent 工作目錄，默認爲 DSH 啓動目錄
    provider: deepseek-official # 覆蓋默認 provider 路由
    model: deepseek-v4-pro      # 覆蓋默認模型

使用示例¶

配置完成後，在微信中依次發送以下消息進行驗證：

1. 身份驗證：發送「你是誰」，確認 agent 知道自身身份與工作目錄。
2. 上下文測試：發送「記得剛纔說了什麼嗎」，驗證持久 session 與上下文連續性。
3. 工具測試：發送「用 bash 跑 pwd」，驗證 agent 可以執行命令。
4. 規則測試：發送一個僅在 AGENTS.md 中有定義答案的問題，驗證規則注入生效。

注：首次發送消息可能需要 10~30 秒的冷啓動時間，屬於正常現象。

安全與說明¶

• 通信安全：消息走微信服務器，非端到端加密。建議不要在微信中發送密碼或 token。
• 安全邊界：插件無消息白名單，安全邊界等同於你的微信賬號。建議微信開啓雙重驗證或設備鎖。
• 密鑰存儲：API key 不存儲在本插件的任何文件中，由 DSH 憑據服務解析。
• 底層依賴：橋接底層使用社區包 weixin-agent-sdk，該包走微信官方 iLink 通道，但客戶端代碼非微信官方維護。
• 重啓行爲：DSH 重啓會清空微信對話記憶（文件改動不受影響）。

結語¶

dsh-weixin 提供了將微信直接作爲 DSH agent 界面的能力。它通過複用 DSH 的現有憑據與規則系統，降低了在移動端使用 agent 的門檻。更多細節與源碼，請參考項目目錄頁或 GitHub 倉庫。