dsh-connect-feishu

English | 中文

面向 dsh-connect 的 飞书 / Lark 渠道适配器：通过飞书开放平台的长连接（WebSocket）或自建 webhook 端点接收消息，转发给 DSH 智能体，并将回复流式返回飞书，支持交互式菜单卡片。

安装

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

配置

在 DSH profile 的 cordis.patch.yml 中。这些插件会通过各自的 bundle 清单自动注册，因此这里只需要**覆盖（override）**它们的配置——不要再用 insert 重新插入（重复的 id 会让 dsh 启动失败）：

- 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

| 键 | 默认值 | 说明 | |---|---|---| | appId / appSecret | env FEISHU_APP_ID / FEISHU_APP_SECRET | 飞书自建应用凭据 | | transport | websocket | 长连接（无需公网）；webhook 运行内置 HTTP 服务，需要公网 HTTPS | | verificationToken | — | Webhook 验证令牌（仅 webhook 传输） | | encryptKey | — | Webhook 加密密钥（仅 webhook 传输） | | webhookPort | 9000 | transport: "webhook" 时内置 webhook 服务的 HTTP 端口 | | webhookPath | / | 飞书事件回调所 POST 的 URL 路径（webhook 传输） | | requireMention | true | 群聊中仅在 @机器人 时才会响应 | | dmMode | open | 私聊策略：open / allowlist / pair / disabled | | language | zh | 面向用户的消息语言：zh / en |

在飞书侧你还需要：启用机器人能力、订阅 im.message.receive_v1 和 card.action.trigger 事件、发布应用版本。参见仓库中的 docs/feishu-setup.zh.md。

文档

https://github.com/IvanWu2015/dsh-connect

许可

MIT