前言¶
在 DSH 的插件化使用方式下，dsh-plugin-wechat 提供一個微信入口。它解決的問題很具體：讓你用微信裏的文字消息觸發 DeepSeek Harness（DSH）的 AI，並收到帶工具和記憶的回覆。
如果你已經在用 DSH，並希望有一個微信入口來做查詢、處理文字任務，下面介紹它的功能、安裝命令和日常維護方式。
這是什麼¶
倉庫名：gnulife/dsh-plugin-wechat。
許可：MIT。
一句話定位：把 DeepSeek Harness（DSH）變成個人微信機器人——微信掃碼接入，每條微信消息由 DSH 的 AI（帶工具和記憶）回覆。
它使用騰訊官方 ClawBot（iLink）通道，需遵守《微信ClawBot功能使用條款》。
核心功能¶
- 微信掃碼接入。
- 每條微信消息由 DSH 的 AI（帶工具和記憶）回覆。
- 支持聯網搜索，使用
web_search工具；可用WECHAT_ENABLE_SEARCH=false關閉。 - 目前只支持文字消息，其他類型會收到“暫不支持”提示。
- 支持 macOS launchd 開機自啓和崩潰自動重啓。
- 支持通過環境變量或 DSH 插件配置界面設置
workspace、session mode、force login、mode、enable search、DSH_WEB_PORT。
安裝與啓用¶
啓動¶
先運行：
npx -y dsh-plugin-wechat
啓動後，終端裏會出現二維碼。用手機微信掃碼確認。
接着打開：
http://127.0.0.1:3080
在「設置 → 模型」填入 DeepSeek API Key。完成後，用微信發送文字消息測試回覆。
日常使用¶
重跑初始化腳本：
bash scripts/setup.sh
該腳本冪等，可重複執行。
停止¶
pkill -f "dsh web"
日誌¶
日誌目錄：
~/.dsh-plugin-wechat/logs/
典型用法¶
換賬號或重新登錄¶
刪除本地登錄憑證並重新掃碼：
rm -rf ~/.dsh/wechat/accounts.json && node scripts/login.js
也可以使用：
dsh-wechat-login
登錄憑證保存在：
~/.dsh/wechat/accounts.json
首次登錄仍需終端掃碼一次。
macOS 自啓¶
先確認已登錄過微信：
node scripts/login.js
安裝並啓動後臺服務：
bash scripts/service.sh install
查看狀態：
bash scripts/service.sh status
日常命令：
bash scripts/service.sh status
bash scripts/service.sh start
bash scripts/service.sh stop
bash scripts/service.sh uninstall
這套服務支持 macOS launchd 開機自啓和崩潰自動重啓。
指定工作目錄¶
讓微信 agent 在指定目錄下工作：
WECHAT_WORKSPACE=/Users/you/my-projects bash scripts/service.sh start
也可以在 DSH 插件配置界面的 workspace 字段填寫。修改配置後需要重啓 DSH 生效：
bash scripts/service.sh start
配置項¶
可以通過環境變量或 DSH 插件配置界面設置：
WECHAT_WORKSPACE/workspaceWECHAT_SESSION_MODE/session modeWECHAT_FORCE_LOGIN/force loginWECHAT_MODE/modeWECHAT_ENABLE_SEARCH/enable searchDSH_WEB_PORT
關閉聯網搜索：
WECHAT_ENABLE_SEARCH=false
掃碼網絡錯誤¶
如果掃碼時遇到網絡錯誤，可能是代理工具劫持了微信域名。需要給微信域名加直連規則，例如：
prepend-rules:
- DOMAIN-SUFFIX,weixin.qq.com,DIRECT
- DOMAIN-SUFFIX,liteapp.weixin.qq.com,DIRECT
加完規則後重跑：
bash scripts/setup.sh
適用場景與注意¶
適合的場景：
- 你希望用微信文字消息觸發 DSH 的 AI。
- 你希望在本機維護一個被動回覆的微信機器人。
- 你需要在 macOS 上做開機自啓和崩潰自動重啓。
注意事項：
- 目前只支持文字消息，圖片、語音等類型會收到“暫不支持”提示。
- 建議只做被動回覆，不羣發、不營銷。
- 保持 DSH 權限爲
workspace-write，勿開danger-full-access；橋默認只監聽本機。 - 插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
- Windows 環境請用 Git Bash 或 WSL。
- 修改配置後需重啓 DSH 生效。
結尾¶
dsh-plugin-wechat 的價值在於把微信文字消息接到 DSH 的 AI 會話上，讓你可以在微信裏完成查詢和文字任務。
倉庫地址：
https://github.com/gnulife/dsh-plugin-wechat.git
