前言¶
在 DeepSeek Harness（DSH）裏跑 AI 夥伴時，常見做法是隻在桌面客戶端或 Web 裏對話。微信仍是很多人日常收發的入口：朋友、羣、文件傳輸助手都在那邊，而 DSH 會話在另一邊。若要把兩邊連起來，常見思路是第三方機器人或改客戶端，往往涉及注入、hook 或獨立 Bot 號，和「用自己微信號、朋友看到的就是本人在說話」不是同一條路。
下面介紹社區插件 dsh-wechat-bridge（維護倉庫 thawline/dsh-wechat-bridge）。它在 DSH 側掛宿主與會話，在本機跑 Python 橋接：只讀微信 4.x 本地 SQLite 收消息，用 Windows UI Automation 和剪貼板把夥伴的回覆真正發回微信。分類屬於 DSH 插件目錄裏的「客戶端」；上游爲 Yuuyuko-uu/dsh-wechat-bridge（MIT），thawline 版在原版上補了一批日常使用中容易踩坑的行爲（文末 README 有「相對原版的改動」列表）。
這是什麼¶
一句話：微信裏說的話進 DSH 默認會話（或可綁定的單獨會話）；夥伴說完一整輪後，最後一句（以及匹配到的表情包圖片）發回微信。
不注入、不 hook、不改微信。 收消息依賴微信處於登錄狀態；發消息會驅動微信窗口完成輸入，同一微信號不宜同時開兩個橋。插件以當前 DSH 進程權限運行，安裝前建議在 GitHub 查看源碼與 MIT 許可證，並自行評估個人號自動化的封號等風險（README 明確建議先用小號或測試號）。
數據流示意（宿主與 Python 之間走本機 HTTP）：
微信 ──讀本地庫──> 插件裏的 Python 橋接 ──POST /dsh-wechat-bridge/receive──> DSH 會話
<──UIA 發送── 插件裏的 Python 橋接 <──GET /dsh-wechat-bridge/outbox── DSH 會話
平臺：僅 Windows（UI Automation 爲 Windows 獨有）。package.json 中版本爲 1.3.4。
核心功能¶
收消息與發消息¶
- 文本：外部消息經橋接 POST 到宿主，進入所選 DSH 會話。
- 圖片與表情包：橋接落盤後由宿主用視覺模型生成中文描述再轉進會話；未配視覺密鑰時標記「沒看清」，不擋消息。語音、視頻跳過。
- 發送：從 outbox 隊列取待發內容；夥伴回覆裏的
[表情: 描述]會到dsh-meme表情庫按 caption/關鍵詞找圖，以圖片消息發到微信，描述文字本身不出現在正文；找不到則按原文文字發送。
權限與羣聊¶
- 主人（設置裏填 wxid 或暱稱，逗號分隔）：聊天、讀文件、跑命令、改設置均可。
- 別人：若開啓「外人只能聊天」，該輪對話在工具執行前被
tools.guard硬攔，僅允許文字回覆；需宿主提供tools.guard（README 寫明本版本 DSH 有），否則僅日誌警告，約束變弱。 - 羣聊默認僅在被點名（默認別名寫死在
bridge/wechat_bridge.py的DEFAULT_ALIASES）或主人說話時進入；可配置羣上下文條數、回覆間隔、每小時上限、羣聊日記、屏蔽名單等。日記默認目錄爲~/.dsh/wechat-diary。
防迴環與文件傳輸助手¶
自己發給自己的消息通常跳過；文件傳輸助手放行，便於自測。另有剛發出文本比對跳過、外發後 12 秒內不讀文件傳輸助手等規則。
會話工具¶
插件向夥伴暴露兩個工具，也可在設置頁操作：
| 工具 | 作用 |
|---|---|
wechat_block |
增刪查「不回誰」屏蔽名單 |
wechat_bind |
將指定微信聊天綁定到某間 DSH 會話 |
thawline 版相對原版的補充（摘要）¶
README 列舉的改進包括：同會話發消息儘量不搶前臺、發送前清空輸入框防重複、發圖以數據庫校驗是否成功、羣名查不到時的兜底、同一輪多條回覆拼接發送、臨時目錄不可寫時的 tmp/ 兜底等。細節以倉庫 README 爲準。
安裝與啓用¶
DSH 生態是「一切皆插件」；社區目錄在 skillhub.cn，與 DeepSeek / 幻方無官方從屬關係。
安裝命令（來自 README）：
dsh plugin --profile desktop add github:thawline/dsh-wechat-bridge
或在 設置 → 插件 → 安裝 中填寫 github:thawline/dsh-wechat-bridge。裝完後重啓一次 DSH，打開 設置 → 通到微信。
第一次使用建議按 README 三步走：
- 裝依賴：點「裝依賴」；若已有裝好
wechatauto-replica的 Python 3.10+，可直接填「解釋器」路徑；否則用系統 Python 建虛擬環境（venv 默認在~/.dsh/wechat-bridge-venv）。 - 啓動：點「啓動」，日誌出現「橋接已就緒」即可。
- 選會話：選擇「默認會話」，打開「總開關」；可先保持「試運行」（只記日誌不真發），確認無誤後再關閉試運行。
不想自行裝 Python 時，可使用 Release 中的 Windows x64 Python 3.12 綠色運行環境：解壓 wechat-bridge-runtime-win64-py312.zip，將 python 文件夾放到 ~/.dsh/wechat-bridge-runtime/python（即存在 C:\Users\<你>\.dsh\wechat-bridge-runtime\python\python.exe），橋接會自動識別。
持久配置在 ~/.dsh/wechat-bridge-config.json；保存後橋接約 30 秒內自動生效，無需重啓 DSH。
典型用法¶
- 與 文件傳輸助手 對話，等價於與綁定的 DSH 夥伴對話；其他私聊、羣消息也會按規則轉入（羣默認需點名或主人發言）。
- 對夥伴說：「以後別理拼多多」（對應
wechat_block），或「把某某羣接到主要聊天記憶那間」（對應wechat_bind）。 - 調試發送可走 HTTP：
POST /dsh-wechat-bridge/test-send真發測試句；完整接口列表見 README（receive、outbox、state、save、bridge/start 等）。
適用場景與注意¶
適合：已在 Windows 上使用 DSH desktop profile，希望用本人微信把日常聊天接到固定 DSH 會話，並需要羣上下文、日記、外人僅聊天等約束的開發者或高級用戶。
務必留意：
- 發送可能搶微信窗口焦點；失敗重試時可能把微信拉到前臺。
- 微信升級可能導致 UIA 控件路徑失效，發不出去時先看設置頁日誌。
- 圖片處理依賴視覺模型配置；無密鑰時描述爲「沒看清」。
- 同一微信號不要同時運行兩個橋接實例。
- 個人號自動化非官方接口，存在封號風險；插件 README 建議小號驗證。
結尾¶
dsh-wechat-bridge 用讀庫 + UIA 的方式，在不動微信客戶端的前提下，把 DSH AI 夥伴和微信做成雙向通道，並在一 fork 里加強了發送可靠性與羣聊日常細節。目錄與說明見 SkillHub 插件頁，源碼與完整配置表見 GitHub：thawline/dsh-wechat-bridge。
