前言¶
DeepSeek Harness（DSH）是能在本機讀寫文件、執行命令、跑長任務的編碼 agent。常見用法是坐在電腦前開客戶端對話；一旦人離開鍵盤，就沒有一個順手、穩定的「入口」把一句話丟給同一套 agent。
社區插件 dsh-plugin-im-bridge（維護者 eighteentang）做的是：把 QQ、微信等 IM 機器人接成 DSH 的對話入口——在手機上給機器人發消息，消息進電腦上的 DSH，由專用會話裏的 agent 處理，結果再回到手機。下面介紹它是什麼、支持哪些平臺、怎麼裝、怎麼試第一條消息，以及權限與安全上必須知道的事。
這是什麼¶
dsh-plugin-im-bridge 是 DSH 的客戶端類插件：在 DSH 客戶端內增加 IM 傳輸層與專用會話，不替代 DSH 本身。憑據保存在本機 ~/.dsh/.credentials.yaml（記錄名 im-bridge/bot），QQ 的 AppSecret 等不會回顯在設置頁。
架構上，隊列、專用會話、會話面板、權限預設、回覆分派是平臺無關的內核；QQ（WebSocket 長連接）、微信（HTTP 長輪詢）等各自實現傳輸層。設置頁對每個平臺會標註完成度，未做完的能力不會假裝可用。
支持的平臺與能力¶
| 平臺 | 狀態 | 說明 |
|---|---|---|
| 完整可用 | 收發 + agent；需自行申請 QQ 機器人 | |
| 微信 | 完整可用 | 收發 + agent；官方 iLink / ClawBot，掃碼即可 |
| 企業微信 | 只能收 | 長連接入站已接；回覆幀格式官方未公開，發不回去 |
| 飛書 | 只能收 | 入站已接；出站未實現，且需另裝約 30 MB 官方 SDK |
| 釘釘 | 只能收 | 入站已接；Stream 通道本身不能回覆 |
能做什麼（README 中的場景）：遠程派活、隨手查文件/目錄/代碼、發起長任務後離開再回看、雙向對話（追問與進度）；QQ 支持圖文/語音/文件收發（單文件 ≤ 5 MB）；微信支持收圖片（解密）與語音（取自帶轉寫），出站媒體待做。附件落在 <桌面>/im-bridge-media/<平臺>/<日期>/，路徑會拼進發給 agent 的消息。每個 IM 平臺各有一條獨立專用會話，與電腦上其它會話互不干擾。
安裝與啓用¶
前提：已安裝 DSH 並能正常登錄、對話。
在 DSH 界面安裝（推薦）¶
- 打開側邊欄 插件 頁，點 添加插件。
- 在「包名或地址」填完整 GitHub 地址（不能只填
dsh-plugin-im-bridge，該插件未發佈到 npm）：
github:eighteentang/dsh-plugin-im-bridge#v1.2.7
- 確認安裝後重啓 DSH 客戶端。
GitHub 地址不經過 npm 安裝源，需本機能訪問 github.com 或已配置代理。界面安裝的插件暫不支持自動更新，升級需卸載後改用新的 #vX.Y.Z 重裝。
命令行安裝¶
dsh plugin --profile <你的profile名> add github:eighteentang/dsh-plugin-im-bridge#v1.2.7
<你的profile名> 對應 ~/.dsh/profiles/ 下的目錄名；裝錯 profile 會導致當前客戶端看不到插件。推薦固定標籤 #v1.2.7，不寫標籤則裝 main 最新提交。
驗證：重啓後應有 設置 → 連接 IM，以及側邊欄企鵝圖標（QQ 會話面板）。可用 dsh plugin --profile <名字> list 或查看 ~/.dsh/profiles/<profile名>/package.json 裏 dsh-plugin-im-bridge 字段確認版本。
微信用戶版本注意：請用 v1.2.2 或更新；v1.2.1 及更早發微信回覆缺 client_id，往往只有第一條能顯示。
憑據與連接¶
打開 設置 → 連接 IM，按平臺展開「配置/測試」，保存後點「保存並測試連接」。
路線 A（微信）：手機微信 8.0.70+，且在「我 → 設置 → 插件」能看到 微信 ClawBot；連接時掃碼，bot_token 存本機，重啓客戶端一般不用重掃。
路線 B（QQ）：在 https://q.qq.com 創建機器人，從「開發設置」取 AppID、AppSecret；在「沙箱配置 → 消息列表單聊」把自己的 QQ 號加入白名單（未加則收不到消息且不報錯）。插件默認走 QQ 沙箱（家用寬帶無固定公網 IP 時正式環境需 IP 白名單，通常不可用）。
連接狀態可看設置頁或本機接口（僅 127.0.0.1）：
curl http://127.0.0.1:8799/im-bridge/status
返回 "connected": true 且 "bot" 爲機器人名即表示正常。
典型用法¶
第一條消息：QQ 用已加白名單的號私聊機器人；微信直接給「微信 ClawBot」發消息。例如：
幫我看看 D 盤有哪些文件
正常時會列目錄並把結果回到手機。
帶附件：在聊天裏直接發圖/語音/文件，無需特殊命令；可對 agent 說「看看我剛發的那張圖……」，agent 通過本地路徑讀取。
模型配置：專用會話默認用 DSH 的默認模型；若回覆提示沒有 API key，可在 profile 的 cordis.patch.yml 中爲 im-bridge 指定，例如：
- id: im-bridge
name: dsh-plugin-im-bridge
config:
agentProvider: deepseek-account
agentModel: deepseek-flash
其它可選配置項包括 agentReasoningEffort、workspace、sandbox（僅 QQ）、permissionPreset（默認 danger-full-access）、agentSessionId（僅應在個人 patch 中覆蓋以換新會話上下文）。修改後需重啓客戶端。
適用場景與注意¶
適合誰：需要在通勤、外出時用 IM 觸發本機 DSH agent，且能接受自行配置 QQ 機器人或微信 ClawBot 的開發者。
權限與安全（必讀）：插件以當前 DSH 進程權限在本機運行；默認 permissionPreset: danger-full-access，能私聊機器人的人即可在電腦上執行命令（無人值守時桌面審批框在手機上不可見）。安裝前應閱讀 GitHub 倉庫 源碼與 MIT 許可證，按自身環境收緊權限或限制可發消息的人。
排查無回覆：QQ 優先查沙箱白名單與連接狀態；微信查已連接且版本 ≥ v1.2.2；若提示沒有工具或沒有 API key，對照 README 的「已知問題」與模型配置節。
DSH 生態強調「一切皆插件」；SkillHub 目錄頁 是社區收錄站點，與 DeepSeek / 幻方無官方從屬關係。
結尾¶
dsh-plugin-im-bridge 把 IM 變成 DSH 的遠程對話入口：內核統一、傳輸層按平臺擴展，QQ 與微信已可完整對接 agent。安裝時使用資料中的地址 github:eighteentang/dsh-plugin-im-bridge#v1.2.7，配好憑據並理解默認高權限後再用於日常派活。
- 目錄頁：https://www.skillhub.cn/plugins/eighteentang/dsh-plugin-im-bridge
- 源碼與文檔：https://github.com/eighteentang/dsh-plugin-im-bridge
