前言¶
DeepSeek Harness (DSH) 採用了“一切皆插件”的理念，將各類功能模塊化以構建智能體工作流。對於需要通過即時通訊（IM）與智能體交互的場景，將 IM 平臺（如 RingCentral）集成到 DSH 循環中是關鍵一環。RingCentral 團隊消息插件爲 DSH 提供了這一集成能力，將 RingCentral 的 IM 通道轉化爲智能體的前端入口，實現消息驅動的代理循環。
插件簡介¶
這是一個 RingCentral Team Messaging IM 通道插件，用於 deepseek-harness (dsh)。該插件由 ringclaw 維護，採用 MIT 許可證。它的核心作用是將 RingCentral 機器人添加程序轉變爲 dsh 智能體的第一級前端：RingCentral 聊天中的入站帖子驅動智能體循環，助手回覆則作爲線程帖子傳回。
核心功能¶
- 將 RingCentral 集成到 DeepSeek Harness (dsh)。
- 將 RingCentral 機器人添加程序轉變爲 dsh 代理的第一級前端。
- 入站帖子驅動代理循環。
- 助手回覆作爲 RingCentral 線程帖子傳回。
- 純 Cordis 插件。
- 直接使用 RingCentral Team Messaging v1 REST API + WebSocket。
- 重用主機 dsh 服務。
- 支持 Web GUI 配置。
- 支持命令：
/new、/compact、/model、/stop、/rc-ping、/rc-version、/rc-status、/rc-help。
安裝與啓用¶
通過 dsh 插件管理器進行安裝。安裝後需要配置環境變量並啓動服務。
- 安裝插件
使用官方提供的命令將插件安裝到指定 profile。
npx @deepseek-ai/dsh plugin --profile ringcentral add dsh-ringcentral
- 配置環境變量
插件運行需要 Bot 的 JWT 令牌以及 DeepSeek 的 API 密鑰。
export RC_BOT_TOKEN="your-bot-jwt"
export DEEPSEEK_API_KEY="your-deepseek-key"
- 啓動服務
啓動 dsh 並加載 ringcentral profile。
npx @deepseek-ai/dsh --profile ringcentral
- 本地路徑安裝
若需從本地源碼安裝，需先構建項目，再通過絕對路徑添加。
cd /path/to/dsh-ringcentral
pnpm install && pnpm build
npx @deepseek-ai/dsh plugin --profile ringcentral add /path/to/dsh-ringcentral
使用方法¶
安裝並啓動後，可以通過 Web GUI 進行配置，或使用內置命令。
-
Web GUI 配置
進入 Web 界面，路徑爲 Settings -> Plugins -> Plugin configuration。在此處可以編輯除密鑰外的所有配置項。 -
命令列表
在 RingCentral 聊天中，支持以下命令：/new或/reset或/clear：開始新會話，清除上下文。/compact：壓縮會話歷史，用摘要替換舊記錄。/model：顯示或切換使用的模型。/stop：中止當前的生成過程。/rc-ping：連通性測試。/rc-version：查看插件版本。/rc-status：查看當前會話狀態。/rc-help：列出所有可用命令。
配置與訪問控制¶
配置遵循 dsh 的實踐規範，配置優先級高於環境變量，環境變量高於憑據文件。
- 密鑰管理：
RC_BOT_TOKEN等密鑰不存儲在 profile YAML 中，通過顯式配置值、環境變量或憑證文件解析。 - 訪問控制：通過
dmMode、dmAllow、groupMode、groupAllow控制私聊和羣組的處理模式。RingCentral 的團隊、全員、羣組聊天類型均由group表面控制。 - 會話密鑰：格式爲
ringcentral:<accountScopeKey>:<scope>:<peerId>，其中 scope 爲direct（私聊）、group（羣組）、channel（頻道）。 - 默認限制：默認歷史記錄限制爲 250 條消息，默認文本塊限制爲 4000 字符。
注意事項¶
- 權限與源碼：插件以當前 dsh 進程的權限運行。在安裝前應檢查源碼與許可證（MIT）。
- Bot 配置：在 RingCentral 開發者門戶創建 Bot 應用時，需至少授予
TeamMessaging、ReadAccounts和WebSocketsSubscription權限，並安裝到賬戶中。 - 所有者憑據：設置所有者憑據（JWT REST API 應用）可用於歷史記錄讀取和發件人回退，但歷史記錄工具始終優先通過 Bot 客戶端讀取。
結語¶
該插件通過純 Cordis 插件的方式，直接對接 RingCentral API，爲 DeepSeek Harness 提供了完整的 IM 通道支持。開發者可以通過 Web GUI 或配置文件靈活控制訪問權限與行爲。更多細節可參考項目主頁。
