前言¶
DeepSeek Harness (DSH) 採用了插件化架構。對於在 Web profile 中運行的 DSH 實例,如果需要從即時通訊(IM)平臺(如飛書或 Slack)直接發送指令,手動輪詢或編寫適配器效率低下。dsh-wsl-im 提供了直接的橋接方案。
這是什麼¶
dsh-wsl-im 是 DeepSeek Harness 的一個插件,用於在 IM 平臺和 DSH 之間建立橋接。消息流程遵循:IM → 插件 → ctx.agents → 回覆。
- 版本: 0.3.8
- 所有者: 173787247
- 許可: MIT
核心功能¶
- 消息流: 支持將 IM 消息流注入到
ctx.agents中以觸發回覆。 - 平臺支持: 飛書、企微、釘釘、QQ、Slack、Discord、Telegram、Mattermost。
- 工具: 提供
im_status工具用於檢查連接狀態。
安裝與啓用¶
使用官方命令安裝插件:
dsh plugin --profile web add github:173787247/dsh-wsl-im
安裝後,通過環境變量啓用特定適配器:
DSH_IM_FEISHU=1
DSH_IM_SLACK=1
典型用法¶
飛書依賴¶
使用飛書需要安裝 Node.js 依賴:
npm i @larksuiteoapi/node-sdk
Mock 測試模式¶
在不配置真實機器人密鑰的情況下測試消息流:
export DSH_IM_MOCK=1
curl -s http://127.0.0.1:18999/mock -H 'content-type: application/json' -d '{"text":"/status","chatId":"t1"}'
適用場景與注意¶
- 會話模型: 插件爲每個 IM 平臺註冊一個工作區(例如
~/.dsh/im-workspace/{feishu,wecom,...})。每個聊天對應一個會話,而不是整個平臺一個會話。 - 連接管理: 每個 Bot 對應一個活躍的 WebSocket 連接。
- 安全: 如果
allowedUserIds爲空,則所有人可訪問。暴露 Bot 前請設置白名單。 - 平臺特定配置:
- 企微: 通常需要
HTTPS_PROXY/HTTP_PROXY。 - Discord: 必須開啓“消息內容意圖”。
- Telegram: 僅支持長輪詢
getUpdates。
- 企微: 通常需要
結尾¶
該插件爲 IM 平臺與 DSH ctx.agents 之間的集成提供了標準化方案。源代碼和文檔可在 GitHub 上找到。