feishu-to-dify

飞书 企业自建应用机器人 与 Dify 工作流 的对接中间层，基于 Python FastAPI 实现。

用户通过飞书单聊或群聊 @ 机器人提问，本服务将消息转发至 Dify 工作流（SSE 流式），并通过飞书 CardKit 流式卡片 实时展示回复。

本项目对接的是可双向收发的 应用机器人，不是「自定义 Webhook 机器人」（仅单向推送、无法接收用户消息）。

• 飞书 长连接 收消息（默认，无需公网 URL）
• Dify 工作流 response_mode=streaming 转发
• CardKit 卡片流式更新（打字机效果）
• 消息去重、错误处理、/health 健康检查

git clone <your-repo-url>
cd feishu-to-dify

python -m venv .venv
# Windows
.venv\Scripts\activate
# macOS / Linux
# source .venv/bin/activate

pip install -r requirements.txt
copy .env.example .env   # Windows
# cp .env.example .env   # macOS / Linux

编辑 .env，填入飞书 App ID/Secret 与 Dify API Key，然后：

python -m app.main

访问 http://localhost:8000/health，应返回 {"status":"ok","feishu_mode":"websocket"}。

详细步骤见 docs/使用指南.md。

完整说明见 使用指南 · 配置说明。

app/
├── main.py                 # FastAPI 入口 + 长连接 lifespan
├── config.py               # 环境变量
├── services/
│   ├── bridge.py           # 消息编排
│   ├── dify_client.py      # Dify SSE 客户端
│   ├── feishu_api.py       # 飞书 Open API
│   ├── feishu_card.py      # CardKit 流式卡片
│   ├── feishu_message.py   # 消息解析
│   └── feishu_ws_runner.py # lark-oapi 长连接
└── utils/

pytest

• 切勿 将 .env、真实 App Secret、Dify API Key 提交到 GitHub。
• 仓库仅保留 .env.example 作为模板（占位符，无真实密钥）。
• 若密钥曾泄露，请在飞书后台重置 App Secret，并在 Dify 中轮换 API Key。

• 飞书长连接接收事件
• CardKit 流式更新
• Dify 工作流 API

MIT（可按需修改）