Skip to content
dsh marketplace

dsh-im-feishu

Verified

dsh-im-feishu · v1.0.5 · MIT · Web UI

飞书渠道适配器（dsh-im 插件家族，experimental）：WebSocket 长连接免公网 + 审批卡片按钮。需要真实飞书自建应用凭据，未经 CI 实测。

Install

dsh plugin add dsh-im-feishu

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Published to npm without a public repository. Inspect the package contents before installing.

Tags

Readme

dsh-im-feishu（飞书适配器）

飞书渠道适配器：官方 SDK @larksuiteoapi/node-sdk 长连接接收事件（免公网）+ 交互卡片审批按钮 + 文件消息。

✅ 状态：已在真实飞书自建应用上跑通（长连接 ready、文本收发、审批卡片）。 配置步骤见 docs/feishu-setup.md（含 card.action.trigger 回调配置的准确位置）。

  • 依赖：inject: ['im']（需 dsh-im 核心）
  • 密钥：appId: 'env:FEISHU_APP_ID'、appSecret: 'env:FEISHU_APP_SECRET'（§9：密钥不落明文）
  • 联调脚本：node demo/feishu-real.mjs --trust-first
  • 测试：npm run test:feishu（stub 官方 SDK，验证事件→ImMessage/回调→出站接线）

实现说明

  • 事件订阅（长连接）：
    • im.message.receive_v1（接收消息）→ 统一 ImMessage → ctx.im.dispatchInbound
    • card.action.trigger（卡片回传交互，在开放平台「回调配置」页签添加）→ ctx.im.handleCallback
  • 出站：
    • 文本消息 im.message.create（receive_id_type 按入站学习 + id 前缀启发：ou_=open_id / oc_=chat_id）
    • 审批卡片：msg_type: interactive，按钮 value 携带 {action, id, answer} 回传
    • 文件（/log 全量交付）：im.file.create 上传 → msg_type: file
  • 断线重连/心跳：由官方 WSClient（autoReconnect: true）内置（FR-1.5）