前言¶
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 上找到。