MIT 開源的 DSH 外掛 bundle,把微信、QQ、釘釘、飛書與 Telegram 接到 DeepSeek Harness:統一設定、掃碼或 Bot 授權、附件內容擷取,並在每個聊天裡都能用宿主官方的斜線指令。
DSH 整合
原生執行環境
作者聲明
安全稽核
未稽核
最後核實
2026-11-14
授權條款
MIT
01它能幫你完成什麼?
不用打開 Harness 視窗,直接在平常在用的即時通訊裡跟 DSH agent 對話
同一個 agent 可以從微信、QQ、釘釘、飛書與 Telegram 存取,全部在「設定 → 頻道」一個面板裡設定與掃碼授權
希望在手機和桌面上一直開著的聊天軟體裡拿到 DeepSeek Harness 回答的人
在聊天裡直接把截圖、PDF、試算表與檔案丟給 agent
支援視覺的模型直接辨識圖片,PDF / DOCX / XLSX 與文字附件會擷取內容供 agent 讀取(入站單檔上限 100 MiB)
在聊天裡收檔案、希望 agent 就地處理的分析與客服人員
在聊天視窗裡控制正在跑的 DSH 工作階段
宿主的官方斜線指令在任何頻道工作階段都能用——`/stop`、`/new`、`/help`、`/status`、`/version`、`/models`、`/model`、`/mirror` 與 `/bind`
在手機上發起長任務、需要在不開 Harness 介面的情況下查看、中止或重新綁定工作階段的使用者
02如何將外掛接入 DeepSeek Harness?
先決條件
- `npx @deepseek-ai/dsh` 能跑起來,且 Harness Web 的一般工作階段能正常對話
- DeepSeek Harness `0.1.5-rc.2` 與 Node `22.19+`(README 指向 docs/compatibility-matrix.md 的版本對照表)
- 各頻道的平台憑證——QQ 的 AppID / AppSecret、釘釘的 clientId / clientSecret、飛書的 AppId / AppSecret,或 Telegram 的 Bot Token;微信不需要憑證,掃碼登入即可
安裝步驟
- 01
安裝穩定版 bundle:`npx @deepseek-ai/dsh plugin --profile web add -w @wsz987/dsh-channels@latest`
$ npx @deepseek-ai/dsh plugin --profile web add -w @wsz987/dsh-channels@latest
- 02
確認 bundle 已合併進 profile:`npx @deepseek-ai/dsh --profile web --dump-config`
$ npx @deepseek-ai/dsh --profile web --dump-config
- 03
啟動 Harness Web:`npx @deepseek-ai/dsh web`
$ npx @deepseek-ai/dsh web
- 04
在 Harness Web 打開「設定 → 頻道」,設定或登入需要使用的頻道,再完成「安全存取」設定
- 05
安裝、更新與移除都要保留 `-w` 參數;升級時先升 Harness,再更新外掛
驗證整合成功
- `npx @deepseek-ai/dsh --profile web --dump-config` 的輸出裡能看到該 bundle 已合併進 profile
- 在「設定 → 頻道 → 安全存取」確認誰能透過 Bot 使用本機 agent——沒確認之前,頻道可能顯示已連線,但訊息進不了 agent
復原
- `npx @deepseek-ai/dsh plugin --profile web remove -w @wsz987/dsh-channels`
03DSH 整合程度與能力邊界
DSH 外掛 bundle:用 `dsh plugin --profile web add -w` 裝進 profile,在 Harness Web 的「設定 → 頻道」面板裡統一設定與掃碼授權
五個頻道轉接器共用一個面板
每個平台的憑證或掃碼登入(微信免憑證;QQ、釘釘、飛書、Telegram 需要應用程式憑證或 Bot Token)→每個頻道帳號一條活動工作階段,支援文字、圖片與檔案(微信只支援入站檔案),QQ / 釘釘 / 飛書 / Telegram 支援串流回覆
微信掃碼後憑證會自動保存啟動 Telegram Bot 時會呼叫 `deleteWebhook` 移除該 Bot 既有的 webhook入站存取控制
「設定 → 頻道 → 安全存取」裡的設定:辨識我的帳號、依群組白名單,或明確開啟「所有群組」→一份允許驅動本機 agent 的帳號與群組名單;不在名單裡的訊息進不到 agent
群組預設關閉,允許的群組要逐一手動加入附件內容擷取
在頻道工作階段裡傳送的圖片、PDF / DOCX / XLSX / 文字附件(入站單檔上限 100 MiB)→圖片直接交給支援視覺的模型,檔案則擷取文字供 agent 讀取
音訊與影片只做降級處理,不是完整支援聊天內的官方斜線指令
在任意頻道工作階段裡輸入的斜線指令→由宿主命令系統執行——`/stop`、`/new`、`/help`、`/status`、`/version`、`/models`、`/model`、`/mirror`、`/bind`;未辨識的指令直接提示「未知命令」,不會送給模型
`/stop` 會不等頻道排隊訊息,直接取消目前的 agent`/model` 還會把目前模型寫進 Harness 的全域預設模型,供後續新工作階段使用依頻道帳號隔離工作區
`$DSH_HOME/profiles/web/cordis.patch.yml` 裡的 `workspace.mode` 設定→預設依「頻道 / 帳號」自動隔離各工作階段的檔案;也可以改成 `host-cwd` 或 `disabled`
要改隔離方式只能編輯這個 patch 檔
04適合誰?何時不該用?
適合
- 希望在手機和桌面上一直開著的聊天軟體裡拿到 DeepSeek Harness 回答的人
- 在聊天裡收檔案、希望 agent 就地處理的分析與客服人員
- 在手機上發起長任務、需要在不開 Harness 介面的情況下查看、中止或重新綁定工作階段的使用者
不適合
- 需要 DeepSeek Harness `0.1.5-rc.2` 與 Node `22.19+`;外掛必須與 Harness 版本相符,所以升級要先升 Harness 再更新外掛,而且安裝、更新、移除都要保留 `-w` 參數。
- 不在安全存取白名單裡的人送的訊息進不到 agent,而此時頻道仍可能顯示已連線;群組預設關閉。頻道工作階段通常用 `Workspace Write`,只有確需存取 Workspace 外檔案且信任目前任務時才啟用 `Full access`。
- 各頻道能力不一致:微信只讀入站檔案(不能傳檔案、沒有串流回覆),音訊與影片在所有頻道都只是降級處理。Telegram 需要 Bot API 10.2+ 且只支援長輪詢,啟動時會移除該 Bot 既有的 webhook,所以同一個 Bot 不能同時給別的 webhook 消費者使用。
- 專案迭代很快,README 要求升級前先備份資料;它是社群維護的頻道擴充,不是 DeepSeek Harness 或各訊息平台的官方專案。
05相容性、維護與安全提醒
- 需要 DeepSeek Harness `0.1.5-rc.2` 與 Node `22.19+`;外掛必須與 Harness 版本相符,所以升級要先升 Harness 再更新外掛,而且安裝、更新、移除都要保留 `-w` 參數。
- 不在安全存取白名單裡的人送的訊息進不到 agent,而此時頻道仍可能顯示已連線;群組預設關閉。頻道工作階段通常用 `Workspace Write`,只有確需存取 Workspace 外檔案且信任目前任務時才啟用 `Full access`。
- 各頻道能力不一致:微信只讀入站檔案(不能傳檔案、沒有串流回覆),音訊與影片在所有頻道都只是降級處理。Telegram 需要 Bot API 10.2+ 且只支援長輪詢,啟動時會移除該 Bot 既有的 webhook,所以同一個 Bot 不能同時給別的 webhook 消費者使用。
- 專案迭代很快,README 要求升級前先備份資料;它是社群維護的頻道擴充,不是 DeepSeek Harness 或各訊息平台的官方專案。
MIT · 僅有 README 證據,最新版本 v0.5.1,未做安全稽核
06常見問題
在 DeepSeek Harness 裡怎麼安裝 dsh-channels?
執行 `npx @deepseek-ai/dsh plugin --profile web add -w @wsz987/dsh-channels@latest`,用 `npx @deepseek-ai/dsh --profile web --dump-config` 確認已合併,再用 `npx @deepseek-ai/dsh web` 啟動 Harness Web。安裝、更新、移除都要保留 `-w` 參數。
它要求哪些版本,升級順序是什麼?
README 寫明需要 DeepSeek Harness `0.1.5-rc.2` 與 Node `22.19+`,儲存庫裡有相容矩陣。外掛必須與 Harness 相符,所以先升 Harness(`npm i -g @deepseek-ai/dsh@next`)再更新外掛:同一版本線用 `update`,跨版本線用 `add` 重裝。
為什麼頻道顯示已連線,agent 卻不回訊息?
安全存取還沒確認。到「設定 → 頻道 → 安全存取」確認誰能透過 Bot 使用本機 agent——外掛不會把「能傳訊息給 Bot 的人」當成已授權使用者。微信自動使用目前掃碼的帳號;釘釘 / 飛書 / Telegram 要按「辨識我的帳號」並私訊 Bot 傳一次辨識指令;QQ 私聊僅建立者可用,群組要另外設定。
能透過頻道傳什麼?
所有頻道都能傳文字、都能收發圖片,QQ / 釘釘 / 飛書 / Telegram 還能收發檔案。支援視覺的模型直接讀圖片,PDF / DOCX / XLSX 與文字附件會擷取內容供 agent 讀取,入站單檔上限 100 MiB;微信只讀入站檔案,音訊與影片是降級處理,微信也沒有串流回覆。
能在聊天裡控制正在跑的工作階段嗎?
可以。宿主的官方命令系統會在任意頻道工作階段裡解析斜線指令:`/stop` 會不等排隊訊息直接取消目前的 agent,另外還有 `/new`、`/help`、`/status`、`/version`、`/models`、`/model`、`/mirror`、`/bind`。未辨識的斜線指令只會提示「未知命令」,不會送給模型;部分指令在群組裡無法使用。
07相關的 DSH 工作流程
dsh-im
作者 xmanrui
通過掃碼或機器人憑據把IM機器人接入DeepSeek Harness(支援飛書、微信、釘釘、企業微信、QQ、Slack、Telegram、Discord和WhatsApp)。 Connect IM bots to DeepSeek Harness via QR code or credentials (9 channels).
dsh-aurabot-qq
作者 aureth-labs
讓 DeepSeek Harness 裡的 AI 以「大肥魚」住進 QQ:會聊天、發表情、發語音、記事、發空間、刷 B 站、唱歌。功能都是模組,能開關、能自己寫,還能從模組市場裝更多(SnowLuma / OneBot v11)。
dsh-qqbot
作者 tencent-connect
讓 QQ Bot 接入 DeepSeek Harness(dsh)的官方外掛
dsh-wechat
作者 xcisxc29
DeepSeek Harness 微信頻道
08資料與來源
将微信、QQ、钉钉、飞书和 Telegram 接入 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)
接入后,在 Harness Web“设置 → 渠道”面板统一配置与扫码授权,并在各平台对话框中直接与 Agent 对话(图片来源:[docs/ScreenShot](./docs/ScreenShot)):
npx @deepseek-ai/dsh plugin --profile web add -w @wsz987/dsh-channels@latest
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-14。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
