Feishu ↔ dot

在飞书里，接着和你的 dot 聊

把自己的飞书机器人私聊，接到已经在用的 dot：从飞书发来问题，让 dot 处理，再把经你授权的文字回复送回原消息。开启图片输入后，也能把新收到的 PNG/JPEG 交给 dot 查看；开启图片输出后，可把明确要求的当前生成图片发回同一绑定私聊。状态卡片由调用者显式提交。

每人自己部署一套。 你提供飞书应用、主机和本人专属的官方 OpenAI Tunnel；bridge 负责连接，不运行模型，也不提供共享托管服务。

English · 开始部署 · 功能 · 安全

• 熟悉的聊天入口： 用已有的飞书私聊继续和 dot 沟通。

• 自己部署和管理： 主机、应用配置与数据库由你管理。

• 可核查的消息状态： 看清排队、API 接受与待核对的投递结果。

原创信息流示意，非产品截图。事件通知与工具调用是不同路径；飞书 WebSocket 收信无需公开事件回调；回复仍需 dot 调用发送工具。

能做什么

默认有 16 个 MCP 工具，包括状态提交与输出查询。FEISHU_MEDIA_INPUT=images-v1 增加 get_event_image；FEISHU_IMAGE_OUTPUT=on 增加图片分块暂存与发送两个工具。只开输入共 17 个，只开输出共 18 个，两者全开共 19 个。输入和输出分别启用，仅支持受限 PNG/JPEG；图片处理、披露与状态发送仍需明确授权。不支持语音或转写，也不会自动捕获所有 dot 回复或审批；飞书卡片点击不批准 dot 权限。

Related MCP server: lark-cli-mcp

架构：两条独立通路

[A] Intake + notification (authorized subscription; not a reply)
Feishu DM --WebSocket--> bridge --MCP Events / callback--> dot
                            |
                            +--> SQLite: inbox + handling ledger

[B] Authorized output (dot must call explicitly)
dot --MCP tools--> Official OpenAI Tunnel --loopback MCP--> bridge
                                                           |
                          Feishu DM <--Feishu API-----------+
                                                           |
                          SQLite: outbox + receipts <-------+

[A] 把新收件持久化并通知／唤醒 dot；callback 接受不表示处理完成。[B] 由 dot 经本人专属官方 Tunnel 调用工具，bridge 才会发送文字、受限 PNG/JPEG 或状态卡片。入站、处理决策、输出队列与回执分别记录；sent 只代表 API 接受，uncertain 不自动重发。bridge 不运行模型，也不会自动捕获所有 dot 回复或审批。

使用效果示例

原创合成示例，非真实聊天截图，不包含用户私聊、账户或回执标识。布局用于说明行为，不保证各客户端呈现一致；真实验收另见验收记录。

图片输入和输出分别启用，仅支持受限 PNG/JPEG；不支持语音或转写。所有输出只面向本人的当前绑定私聊，仍需明确授权；这是个人自部署连接，不是共享托管服务。

开始前准备好

• 主机： Linux/macOS、Node.js 24+、npm，以及持久磁盘、进程监管和必要的出站 HTTPS/WebSocket 连通性。图片模式另需 Linux /usr/bin/prlimit 和锁定的 sharp 依赖。

• 飞书： 你自己的应用、已核实的 app/tenant 和私聊收发权限；同一应用只能有一个事件消费者，每个数据库只能有一个 bridge 进程。

• dot： 已有 dot 和仅本人可用的官方 OpenAI Tunnel；实际账号须支持所需的 MCP Events 与 Tunnel 组合，请先核对部署要求。

从源码开始

在新目录中安装，不要覆盖已有实例的配置或数据库：

git clone https://github.com/yaodiff/feishu-dot-bridge.git
cd feishu-dot-bridge
npm ci --ignore-scripts
npm run init:personal

初始化会构建源码，生成私有 .env、应用配置和独立随机密钥；如果发现已有 .env、config 或 data，会拒绝覆盖。它不会替你创建飞书应用、Tunnel 或平台权限。

接着按完整部署指南完成三个步骤：

1. 配置飞书。 在本机填写应用、tenant 和 App Secret，核实没有其他消费者后启用 websocketExclusiveConsumer。

2. 启动并连接。 运行 node --env-file=.env dist/src/main.js；配置本人专属官方 Tunnel，转发到 http://127.0.0.1:3000/mcp 并注入本地 X-Bridge-Token。bridge 保持 loopback 监听。

3. 配对再授权。 在 dot 中连接并核对工具，让 dot 生成配对命令，由你发送到机器人私聊。确认绑定后，明确授权事件订阅及回复／文字副本范围。

连接界面的 “None” 只表示不另走 OAuth，后端密钥校验仍然必需。不能把个人 Tunnel 共享给其他人。运行中的旧实例升级请走备份与迁移流程，不要重新初始化。

先试，再长期运行

短时实网检查已观察到文字双向流转、事件恢复读取和一次合并回复覆盖，详见真实验收记录。当前生成图片的真实上传／发送及状态卡片创建／更新也已在一次授权实网检查中观察到，见输出验收边界。这是实验性项目，尚不能据此承诺全天稳定或比云端更可靠。

• 回复由 dot 发起。 dot 内的答案不会自动变成飞书回复；漏项检查由调用方在唤醒时执行，没有独立自动补发服务。

• 状态需要分开看。 callback 接受不代表 dot 已处理；pending 不是送达，sent 表示 API 接受而非客户端显示／已读，uncertain 必须先核对目的端。

• 恢复有范围。 只恢复已持久化的事件和任务；没有历史回填保证，订阅有期限，图片引用会过期且重启后丢失。详见断连与恢复。

• 数据需要保护。 数据仍经过 OpenAI；SQLite 消息正文未做应用层加密，凭据检测可能漏报，图片去元数据不识别画面中的秘密。请保护配置、磁盘和备份，不把真实消息或秘密提交仓库。

当前面向个人机器人私聊，不支持群聊、多用户共享、历史回填或 ChatGPT 原生消息自动捕获。更多边界见安全说明与逐安装验收清单。

本地检查

npm test
npm run demo

完整测试套件要求 Linux、/usr/bin/prlimit、openssl 和 mkfifo；macOS 文字运行时支持不等于完整套件支持。测试和 demo 使用合成数据与模拟服务，不连接真实飞书或 dot，也不能替代实网验收。

按需深入

许可证

源码采用 MIT。图片依赖与预编译原生组件另有许可证；分发前请核对第三方许可与义务。