Introduction¶
DeepSeek Harness (DSH) is mainly used for workflow orchestration. To facilitate interaction with the DSH Agent via Feishu (Lark), you can use the zyfgood/dsh-feishu-bot plugin. The plugin connects through a Feishu self-built application and receives messages using the official SDK’s WebSocket long-lived connection, so no public callback address is required.
Core Features¶
The plugin mainly provides the following capabilities:
- Inbound Reply Modes: Supports three modes:
echo(echo the original text),llm(generate a direct reply), andagent(standard mode reusing context). - Asking During Task Execution: While the Agent is executing a task, it supports inserting a question at the next node via
steer. The Agent will respond first and then continue the task. - Outbound Tools: Provides 9
feishu_*tools (such as sending messages, querying sessions, and checking connection status) for the Agent to actively call. - Interactive Confirmation: Supports interactive cards with buttons for confirmation questions.
- Policy Control: Supports policies such as replying only when @mentioned in group chats, private chat toggles, and session whitelists.
Installation¶
- Set environment variables:
export FEISHU_APP_ID=cli_xxx
export FEISHU_APP_SECRET=xxx
- Run the installation command:
dsh plugin --profile web add "github:zyfgood/dsh-feishu-bot#main&path:/"
Feishu Open Platform Configuration¶
Create an enterprise self-built application on the Feishu Open Platform and publish a version. In “Events and Callbacks,” subscribe to im.message.receive_v1, and set the subscription method to “Receive events/callbacks using long-lived connections” (no callback URL is required). It is recommended to configure the App Secret using environment variables.
Usage¶
In Feishu, you can use session commands such as /new, /model, /sessions, and /attach, or call feishu_connection_status to view the connection status.
Dependencies¶
The plugin depends on @larksuiteoapi/node-sdk, version 0.8.3.