minyang2020/dsh-feishu-bridge

README 摘要

feishu-dsh-bridge 中文 English 在飞书(Lark)里直接和你的 DeepSeek Harness Agent 对话的双向桥接器。 飞书用户(私聊或群里 @机器人)的消息通过 长连接 (WebSocket,无需公网端口)进入本机正在运行的 DSH( dsh web ),Agent 的回复、审批请求、提问都会实时回到飞书会话。 特性 - 私聊按用户 :每个飞书用户自动绑定一个独立 DSH 会话,上下文连续互不干扰 - 群聊按 @ :群里只有 @机器人 才响应,回复发回群里 - 流式输出 :Agent 回复以 cardkit 打字机卡片逐字上屏(cardkit 权限缺失时自动降级为普通回复) - 审批转发 :Agent 请求权限时飞书收到确认文本,回复「同意/拒绝」即可 - 提问转发 :Agent 提问时按序号/选项格式回复 - 断线重连 :飞书长连接与 DSH 事件流均自动重连 - 零公网依赖 :飞书长连接由本机主动发起,无需开放端口、无需公网 URL 环境要求 - Node.js = 22(在 v24 上验证) - 正在运行的 DSH: dsh web (或任意通过 client-connection 插件暴露 /api 的 DSH 宿主,默认 http://127.0.0.1:3200 ) - 飞书企业自建应用(App ID / App Secret) 快速开始 作为 dsh bundle 插件安装 然后在 profile 的 cordis.patch.yml 里配置: 注:GitHub 仓库名为 dsh-feishu-bridge ,npm 包名为 feishu-dsh-bridge (npm 原名已被占用);两者是同一项目。 配置文件 .env : 飞书开放平台配置清单(一次性,约 10 分钟) 1. 打开 飞书开放平台 →「创建企业自建应用」。 2. 「凭证与基础信息」:记下 App ID / App Secret ,填入 .env 。 3. 「添加应用能力」→ 启用 机器人 。 4. 「权限管理」→ 开通: - im:message.p2p msg:readonly — 读取用户发给机器人的单聊消息 - im:message.group msg:readonly — 获取群组中所有消息 - im:message:send as bot — 以应用的身份发消息 - cardkit:card:write — 流式卡片(可选,缺失时回复自动降级为非流式) 5. 「事件与回调」→「事件订阅」→ 请求方式选 使用长连接接收事件 (WebSocket,无需公网 URL)→ 添加事件 接收消息 im.message.receive v1 。 6. 「版本管理与发布」→「创建版本」→「申请发布」。企业内自建应用通常即时生效;若企业开启审核需…

分类