前言¶
DeepSeek Harness(DSH)主要用于工作流编排。为了方便通过飞书(Feishu / Lark)与 DSH Agent 交互,可以使用 zyfgood/dsh-feishu-bot 插件。该插件通过飞书自建应用接入,使用官方 SDK 的 WebSocket 长连接接收消息,无需配置公网回调地址。
核心功能¶
插件主要提供以下能力:
- 入站回复模式:支持
echo(回显原文)、llm(直接生成回复)和agent(标准模式复用上下文)三种模式。 - 任务执行中提问:Agent 正在执行任务时,支持通过
steer在下一个节点插入问题,Agent 会先回应再继续任务。 - 出站工具:提供 9 个
feishu_*工具(如发消息、查会话、查连接状态等),供 Agent 主动调用。 - 交互式确认:支持带按钮的交互卡片进行确认问答。
- 策略控制:支持群聊 @机器人回复、私聊开关、会话白名单等策略。
安装¶
- 设置环境变量:
export FEISHU_APP_ID=cli_xxx
export FEISHU_APP_SECRET=xxx
- 运行安装命令:
dsh plugin --profile web add "github:zyfgood/dsh-feishu-bot#main&path:/"
飞书开放平台配置¶
在飞书开放平台创建企业自建应用并发布版本。在「事件与回调」中订阅 im.message.receive_v1,并将订阅方式设置为「使用长连接接收事件/回调」(无需配置回调 URL)。App Secret 建议使用环境变量配置。
使用¶
在飞书内可使用 /new、/model、/sessions、/attach 等会话命令,或调用 feishu_connection_status 查看连接状态。
依赖¶
插件依赖 @larksuiteoapi/node-sdk,版本为 0.8.3。