pi-feishu-bridge
连接飞书WebSocket通道，实现CardKit原生流式响应。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-feishu-bridge。 它的用途是：连接飞书WebSocket通道，实现CardKit原生流式响应。 完整的 Skill 内容见：https://321skill.com/skills/pi-feishu-bridge/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我在飞书群里创建一个智能天气助手，当用户询问天气时，让回复像打字一样逐字显示出来。’，它会指导你使用 pi-feishu-bridge 建立WebSocket连接，并编写将天气API返回的数据流式推送到飞书CardKit卡片的代码。或者，
对AI说：‘我的飞书机器人需要实时汇报一个长时间后台任务的进度条。’，它会演示如何通过该桥接器分块发送进度百分比，动态更新卡片上的进度条组件。
介绍
Pi-Feishu Bridge 解决了在飞书开放平台中，通过WebSocket协议高效、实时地推送CardKit卡片消息并支持原生流式输出的技术难题。传统HTTP轮询或回调方式存在延迟高、资源消耗大、无法实现流畅的渐进式内容展示等问题，而该工具提供了基于WebSocket的双向通信通道，能够将AI生成的内容、实时数据或长文本以流式（streaming）方式逐步推送到飞书聊天窗口的CardKit卡片中，提升用户体验。
使用方式通常是在Node.js项目中安装此npm包，配置飞书机器人的App ID与密钥，建立WebSocket连接并监听消息事件。开发者可以编写业务逻辑，在收到用户消息后，通过该桥接器将需要流式输出的内容（如大模型生成的文本、代码片段）分块发送，飞书客户端会实时渲染更新卡片内容，实现类似打字机效果的交互体验。
它非常适合需要将后端服务（尤其是AI应用、实时数据监控、长任务进度汇报）与飞书工作台深度集成的开发者。无论是构建飞书智能助手、内部工具看板，还是需要向特定群组或用户推送流式通知的应用，都可以利用此工具简化开发流程。
建议在使用前，确保已熟悉飞书开放平台的基本概念（如机器人、卡片消息、权限配置）。由于涉及WebSocket长连接，需要注意服务端的稳定性、断线重连机制以及飞书API的调用频率限制。在开发调试时，可充分利用飞书提供的开发者工具进行沙箱测试。
核心特点
与仅支持HTTP回调的普通飞书机器人SDK相比，它专门提供了稳定的WebSocket通道，并深度集成了CardKit的原生流式渲染能力，使得在飞书卡片中实现逐字输出、进度条更新等动态交互成为可能，而非一次性发送完整静态卡片。
注意事项
不适合仅需发送简单、非流式静态消息或对实时性要求不高的轻量级通知场景。
常见问题
pi-feishu-bridge 能用来做什么？
主要用于在飞书中开发支持流式输出（如AI逐句回复、实时日志推送）的智能机器人或应用卡片。
使用前需要什么准备？
需要拥有飞书开放平台的企业开发者账号，并已创建具备发送消息权限的机器人应用。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-feishu-bridge/raw/index.md 读取 pi-feishu-bridge 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-feishu-bridge/raw/index.md（查看排版版本）