The Feishu / Lark channel adapter for dsh-connect: receives messages over the Feishu Open Platform long connection (WebSocket) or a self-hosted webhook endpoint, forwards them to the DSH agent, and streams replies back to Feishu, with interactive menu cards.

Install

dsh plugin --profile web add dsh-connect dsh-connect-feishu

Configuration

In the DSH profile's cordis.patch.yml. The plugins register themselves via their bundle manifests, so only override their config — do not insert them again (duplicate ids crash dsh at boot):

- id: connect
  name: dsh-connect
- id: connect-feishu
  name: dsh-connect-feishu
  config:
    appId: cli_xxx
    appSecret: cli_secret_xxx
    transport: websocket
    requireMention: true
    dmMode: open

Key	Default	Description
`appId` / `appSecret`	env `FEISHU_APP_ID` / `FEISHU_APP_SECRET`	Feishu custom app credentials
`transport`	`websocket`	Long connection (no public network needed); `webhook` runs the built-in HTTP server and needs public HTTPS
`verificationToken`	—	Webhook verification token (webhook transport only)
`encryptKey`	—	Webhook encrypt key (webhook transport only)
`webhookPort`	`9000`	HTTP port for the built-in webhook server when `transport: "webhook"`
`webhookPath`	`/`	URL path Feishu event callbacks post to (webhook transport)
`requireMention`	`true`	Groups only respond when the bot is @mentioned
`dmMode`	`open`	DM policy: open / allowlist / pair / disabled
`language`	`zh`	User-facing message language: `zh` / `en`

On the Feishu side you also need: bot capability enabled, im.message.receive_v1 and card.action.trigger events subscribed, and an app version published. See docs/feishu-setup.md in the repository.