飞书
将 通千算智 接入飞书应用
通过飞书自建应用接入 通千算智，支持单聊与群聊（@机器人），使用 WebSocket 长连接模式，无需公网 IP，支持流式打字机回复、语音消息收发。
接入需要是飞书企业用户且具有企业管理权限。
一、接入方式
方式一：扫码一键接入（推荐）
启动 通千算智 后在终端中即可完成扫码创建。或打开 Web 控制台（本地链接：http://127.0.0.1:9899 ），选择 通道 菜单，点击 接入通道，选择 飞书，点击 一键创建飞书应用，使用 飞书 App 扫描二维码即可自动完成应用创建并接入:
lark-oapi依赖版本需要 >=1.5.5- 扫码创建出的应用会自动预置全部所需权限（消息收发、卡片读写、群聊事件等）和事件订阅，无需到开发者后台手动配置。
方式二：手动创建接入
需要先在飞书开放平台创建自建应用并配置权限，再通过 Web 控制台或配置文件接入。
步骤一：创建应用
- 进入 飞书开发平台，点击 创建企业自建应用：
- 在 添加应用能力 中，为应用添加 机器人 能力：
- 在 权限管理 中，将以下权限粘贴到输入框，全选并 批量开通：
代码
im:message,im:message.group_at_msg,im:message.group_at_msg:readonly,im:message.p2p_msg,im:message.p2p_msg:readonly,im:message:send_as_bot,im:resource,cardkit:card:write
- 在 凭证与基础信息 中获取
App ID和App Secret：
步骤二：接入 通千算智
步骤三：发布应用
- 启动 通千算智 后，在飞书开放平台点击 事件与回调，选择 长连接 模式并保存：
-
点击 添加事件，搜索 "接收消息"，选择 接收消息 v2.0 并确认。
-
（可选）在 回调 中添加 卡片回传交互（
card.action.trigger），以启用/tasks定时任务管理命令；添加 撤回消息（im.message.recalled_v1）事件，以支持撤回消息取消任务功能。 -
点击 版本管理与发布，创建版本并申请 线上发布，在飞书客户端审核通过：
二、功能说明
| 功能 | 支持情况 |
|---|---|
| 单聊 | ✅ |
| 群聊（@机器人） | ✅ |
| 文本消息 | ✅ 收发 |
| 图片消息 | ✅ 收发 |
| 语音消息 | ✅ 收发 |
| 引用回复 | ✅ 引用文本与富文本上下文 |
| 流式回复 | ✅（通过 feishu_stream_reply 配置控制，默认开启） |
| Markdown 卡片 | ✅ 静态卡片与流式最终态会将远程图片上传到飞书 |
| 详细卡片 | ✅ 工具调用、思考过程与耗时展示（feishu_detailed_card 控制，默认开启） |
| 定时任务操作卡 | ✅ /tasks 查看、启用、停用与删除 |
流式回复需要机器人具备 cardkit:card:write 权限（一键创建已默认开通），且接收方飞书客户端版本 ≥ 7.20。低版本客户端会显示升级提示，权限或版本不满足时自动降级为普通文本回复。
三、使用
完成接入后，在飞书中搜索机器人名称即可开始单聊对话。
如需在群聊中使用，将机器人添加到群中，@机器人发送消息即可。
私聊发送 /tasks，或在群聊中 @机器人并发送 /tasks，即可管理属于当前会话的定时任务。