前言¶

DeepSeek Harness（DSH）的擴展方式是「一切皆插件」：智能體能力可以通過插件接入不同前端，而不需要把每個前端單獨實現一遍。對於已經在 IM 裏處理消息的開發者來說，比較常見的訴求是把 dsh agent 接到飛書（Lark）、企業微信（WeCom）或 Telegram，並在已有聊天工具中完成多輪對話。下面介紹 dsh-im-hub 插件。

這是什麼¶

dsh-im-hub 是一個面向 DeepSeek Harness 的多平臺 IM 網關插件，維護者爲 ThreeBody6666，許可證爲 MIT。當前 package.json 中的版本爲 0.2.3。

它的定位是把 dsh agent 接到常用 IM 中，支持以下平臺：

• Feishu（Lark）
• WeCom（WeChat Work，企業微信）
• Telegram

核心能力¶

先說它提供的接入方式：

• Feishu（Lark）：支持官方 WebSocket 長連接，也支持 webhook 模式；國際版 Lark 通過 adapters.lark 配置。
• WeCom：支持應用消息回調，使用 WXBizMsgCrypt 的 AES-256-CBC 解密，並做 SHA1 簽名校驗。
• Telegram：使用 Bot API long polling，並按 4096 字符上限拆分消息。
• Mock：提供 stdin 加本地 HTTP 端點，用於測試。

在會話管理方面，它提供按聊天隔離的 agent 會話：

• 保留多輪上下文
• 每個聊天內的對話輪次串行處理
• 空閒會話按配置回收

在訪問控制方面，每個 adapter 都支持 allowedUserIds 白名單。如果 allowedUserIds 爲空，表示允許所有人訪問；生產環境建議明確填寫允許訪問的用戶 ID。

它還提供一組 Slack 風格命令：

/help
/reset
/status
/model

在配置方式上，dsh-im-hub 支持兩類入口：

• Web GUI 中的可視化設置卡片，適用於 v0.2.0 及以上版本
• YAML 配置，位於 cordis.patch.yml

安裝與啓動¶

使用官方安裝命令把插件加入 im profile：

dsh plugin --profile im add dsh-im-hub

隨後使用同一個 profile 啓動 dsh：

dsh --profile im

如果使用本地 checkout 做開發調試，可以使用本地路徑安裝：

dsh plugin --profile im add link:D:/projects/dsh-im-hub

配置¶

dsh-im-hub 的插件行在 cordis.patch.yml 中默認是禁用的。啓用某個 adapter 前，需要先修改插件配置。

以 Telegram 爲例，至少需要啓用 adapter、填寫 Bot token，並配置允許訪問的用戶 ID：

- id: dsh-im-hub
  disabled: false
  config:
    adapters:
      telegram:
        enabled: true
        token: '123456:ABC-DEF...'
        allowedUserIds: [123456789]

其中：

• enabled 控制該 adapter 是否啓用
• token 是 Telegram Bot token
• allowedUserIds 是允許與該 Bot 對話的 Telegram 用戶 ID 列表

allowedUserIds 爲空時表示允許所有人訪問。生產環境建議顯式設置白名單。

如果插件運行在 Web GUI 中，並且版本不低於 v0.2.0，可以在設置界面中配置：

Settings → Plugins → Configurable plugins → IM Gateway (dsh-im-hub)

憑據類字段保存在服務端，Web GUI 中顯示爲 write-only badge。

各平臺接入前置條件¶

Telegram¶

Telegram 需要從 @BotFather 獲取 Bot token，然後填入 adapters.telegram.token。

Feishu / Lark¶

飛書長連接模式適用於自建企業應用。接入前需要完成以下配置：

• 訂閱事件：im.message.receive_v1
• 授予消息權限：
• im:message:send_as_bot
• im:message:p2p_msg
• im:message:group_msg 或 group_at_msg

國際版 Lark 使用 adapters.lark 配置。

WeCom¶

企業微信使用回調服務器方式，不提供長連接模式。回調服務器需要可訪問的公網 HTTPS URL，也可以通過 tunnel 暴露。

適用場景與注意¶

dsh-im-hub 適合以下場景：

• 希望把 dsh agent 接到飛書、企業微信或 Telegram
• 需要在聊天工具中保留多輪上下文
• 需要按用戶 ID 限制可訪問 agent 的範圍
• 需要在不引入真實平臺憑據的情況下用 Mock adapter 做本地測試

使用前需要注意：

• 插件以當前 dsh 進程權限運行
• 安裝前應檢查插件源碼
• 應確認許可證與運行環境要求；該插件許可證爲 MIT
• 社區插件目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不應理解爲官方應用商店

鏈接¶

GitHub 倉庫：

https://github.com/ThreeBody6666/dsh-im-hub

社區插件目錄：可按插件名 dsh-im-hub 在 DSH 社區插件目錄中查找。