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