← 返回列表
D

dsh-im-feishu

v1.0.5 · 3 天前发布

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

deepseek-harnessdshdsh-pluginfeishularkim-bridge

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 携带 `
    查看完整 README →

    版本兼容矩阵

    DSH 版本状态说明
    dsh@0.1.0-rc.6 ✅ 兼容 cordis patch ✅
    dsh@0.1.0 ✅ 兼容 标准 patch ✅
    dsh@0.2.0 ⚠️ 待验证 待实测（API 可能在变）
    dsh@0.3.0+ ❓ 未知 尚未发布

    💡 兼容矩阵每周末自动跑实测，欢迎 PR 修正

    元数据

    License
    MIT
    npm
    dsh-im-feishu
    Repo
    git+https://github.com/shaobeichen/dsh-im-bridge.git
    Engines
    {"node":">=22"}
    Weekly DL
    0
    Monthly DL
    0
    dsh.bundle
    {"bundle":{"patch":"./cordis.patch.yml"},"client":{"inject":["@deepseek-ai/dsh-client-connection","@deepseek-ai/dsh-client-ui-slots"],"platform":"web"}}