前言¶

DeepSeek Harness (DSH) 的核心理念是「一切皆插件」。在開發即時通訊（IM）場景的智能體時，讓智能體接入企業微信是一個常見需求。dsh-wecom 插件通過 aibot WebSocket 網關，讓 DeepSeek Harness 的智能體變成能在企業微信中雙向對話的助手。它無需公網地址，也無需自建應用回調，只需智能機器人的 bot_id 和 secret。該插件由 michaelcode-wang 維護，採用 MIT 許可證。

核心功能¶

• 企業微信長連接：建立與 wss://openws.work.weixin.qq.com 的 WebSocket 長連接，斷線後自動退避重連。
• 獨立會話管理：每個聊天窗口對應一個獨立的 agent 會話，保留多輪上下文，空閒後自動回收資源。
• 訪問控制：通過 allowedUserIds 白名單控制誰能驅動智能體。
• 富文本支持：支持 Markdown 回覆，超長消息自動分片（默認 4000 字符）。
• 聊天命令：支持 /help、/reset、/status 等指令。

前置條件¶

1. 企業微信智能機器人：在企業微信後臺創建「智能機器人」，獲取 bot_id 和 secret。
2. Preset Roster：im profile 本身不包含 Web 層，默認的 agent-presets 由 dsh-web-app 提供。若要讓 agent 掛載某個 preset，需在 im profile 的配置中手動插入 roster。

安裝與啓用¶

使用官方安裝命令添加插件：

dsh plugin --profile im add dsh-wecom

安裝完成後，在 $DSH_HOME/profiles/im/cordis.patch.yml 中進行配置。

配置¶

打開 $DSH_HOME/profiles/im/cordis.patch.yml，按照以下步驟修改：

1. 插入 preset roster：由於 im profile 缺少 Web 層，必須手動補全 roster 配置。
2. 啓用插件：聲明插件 ID 並配置連接參數。

# 1) 插入 preset roster
- insert:
    - id: agent-presets
      name: '@deepseek-ai/dsh-agent-presets'
      config:
        default: taibai

# 2) 啓用本插件
- id: dsh-wecom
  disabled: false
  config:
    botId: '你的機器人ID'
    secret: '你的機器人密鑰'
    allowedUserIds: ['你的企業微信userid']
    agent:
      preset: taibai

配置完成後，啓動 DSH 的 IM profile：

dsh --profile im

建議配合 launchd 或 systemd 將其設爲常駐服務。

配置項說明¶

安全注意事項¶

• 白名單是必須的：務必配置 allowedUserIds。如果留空，任何企業微信用戶都能驅動你的智能體執行主機工具，存在安全風險。
• 密鑰保護：secret 配置項被標記爲 role('secret')，不會回顯到瀏覽器界面。

適用場景與說明¶

該插件協議移植自 Hermes Agent。使用前請確保環境滿足以下條件：
- Node.js 版本 >= 22
- 已安裝 DeepSeek Harness 及相關依賴

插件以當前 DSH 進程的權限運行，使用前建議檢查源碼與許可證。

結語¶

dsh-wecom 提供了一個標準化的方式，將 DeepSeek Harness 的智能能力延伸到企業微信 IM 場景中。通過配置 preset roster 和 allowedUserIds，可以快速搭建一個安全、私有的企業級智能助手。

• GitHub 倉庫
• 插件目錄