前言¶
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 或配置文件灵活控制访问权限与行为。更多细节可参考项目主页。
