前言¶
DSH 的常見使用方式是先在電腦端打開 Web 或桌面 Host,再在工作區裏下發任務、觀察輸出、切換模型和權限。若希望離開電腦後仍能處理長任務,就需要一個不依賴電腦界面的通道。
zp-home/dsh-weixin-clawbot 提供的是一個獨立的 DeepSeek Harness(DSH)Host Bundle:它把騰訊官方微信 ClawBot/iLink 通道接入 DSH,讓手機微信通過文本命令遠程控制 DSH 執行電腦任務。
它不修改 DSH 核心,也不依賴桌面微信或 WxHook。原版 Web 和桌面 DSH 仍可打開,並複用同一 DSH Session。
這是什麼¶
- 項目:
zp-home/dsh-weixin-clawbot - 定位:獨立 DSH Host Bundle,將微信 ClawBot/iLink 通道橋接到 DSH Agent
- 維護者:
zp-home - 許可證:
MIT - 適用平臺:Windows、macOS、Linux
- 運行環境:Node.js
22.19.0或更高版本 - 已驗證 DSH 版本:
0.1.0-rc.8、0.1.1-rc.2 - 項目邊界:社區獨立適配項目,不是騰訊、微信、DeepSeek 或 DeepSeek Harness 官方項目
核心能力¶
消息與任務¶
- 接收微信文本任務,並將 DSH 執行結果以文本形式回覆;長回覆會自動分段。
- 接收微信語音的官方轉寫文本,並按普通文本任務處理。
- 當前僅處理文字和微信側語音轉寫文本,不支持接收微信圖片、文件、視頻或其他媒體內容。
- 不支持向微信發送圖片、文件、音頻或視頻;DSH 的結果目前僅以文本回復。
會話管理¶
- 爲授權微信用戶維護獨立的持久 DSH Session。
- 支持新建、切換、重命名、歸檔、搜索和跨 Host 重啓恢復。
- 可複用 Web 或桌面端已打開的同一 DSH Session,避免重複創建 Agent。
運行中控制¶
- 支持
/cancel,在長任務執行期間取消。 - 支持
/steer,追加糾偏。 - 支持
/task、/queue、/doctor,查看任務、隊列和通道診斷。 - 支持查看或切換模型、Preset、工作目錄與會話權限。
- 將未由插件處理的 DSH 原生命令,例如
/plan、/goal、/compact,轉交給 DSH 命令系統。
權限與審批¶
- 默認使用
workspace-write。 - 切換爲
danger-full-access需要發送明確確認命令:/permission danger-full-access confirm。 - 主用戶可通過
/users、/invite、/revoke、/audit管理授權用戶。 workspace-write的 DSH 審批可通過/approve、/reject在微信一次性處理。
可靠性¶
- 回覆先寫入持久 Outbox。
- 臨時發送失敗會指數退避。
- Host 重啓後繼續重試。
安裝與啓用¶
下面介紹 DSH Web Profile 的快速安裝方式。先執行安裝命令,再按照倉庫說明完成微信 ClawBot/iLink 二維碼配對;配對完成後,微信消息會通過該通道進入 DSH。
Web Profile 快速安裝命令如下:
dsh plugin --profile web add github:zp-home/dsh-weixin-clawbot
如果實際啓動的是桌面 DSH Host,需要把命令中的 web 換成桌面構建實際啓動的 Profile;資料未給出固定桌面 Profile 命令,具體以本地 DSH 啓動方式爲準。
啓用前需要滿足以下條件:
- Host 必須常駐運行;一次性
headless進程退出後無法維持 iLink 長輪詢。 - Node.js 版本需要爲
22.19.0或更高版本。 - 已驗證 DSH
0.1.0-rc.8與0.1.1-rc.2。 - 支持 Windows、macOS、Linux。
注意:本項目按設計不提供 Windows 開機啓動、計劃任務或系統服務安裝。
典型用法¶
經過上面的安裝和配對步驟後,可以先在微信中發送:
/status
該命令用於查看會話、任務、工作區、Preset、權限和模型。
如果任務正在運行,需要立即停止,可以發送:
/cancel
如果希望在最近的 DSH step 邊界追加修正,可以發送:
/steer <內容>
查看或切換當前會話模型,可以發送:
/model [provider/model]
如果確實需要當前會話擁有完整機器訪問,必須發送明確確認命令:
/permission danger-full-access confirm
默認情況下仍應優先使用 workspace-write。
適用場景與注意¶
適合以下場景:
- 需要在手機上查看 DSH 任務狀態、隊列和通道診斷。
- 需要遠程取消長任務或在 step 邊界追加糾偏。
- 希望手機微信與電腦端 DSH 共用同一 Session,不重複創建 Agent。
- 需要在微信中處理
workspace-write的一次性審批。
使用前注意:
- 插件以當前 DSH Host 進程的權限運行,安裝前應檢查源碼與
MIT許可證。 - 狀態文件會保存 iLink 遊標、允許用戶 ID 和 Session 映射,應視爲私有文件。
- 不要提交
$DSH_HOME/.credentials.yaml、state.json、配對二維碼或未經脫敏的日誌。 - 當前媒體能力有限:不接收也不發送圖片、文件、音頻或視頻。
- 它依賴常駐 Host;若關閉 Host 或使用一次性
headless進程,無法持續接收微信消息。
鏈接¶
- GitHub:https://github.com/zp-home/dsh-weixin-clawbot
- 插件線索中給出的目錄頁:https://www.skillhub.cn/plugins/zp-home/dsh-weixin-clawbot
該 URL 來自插件線索,未在已抓取資料正文中直接確認。