feishu-cli 与 AI 集成:打造你的智能飞书助手,实现自动化工作流
【免费下载链接】feishu-clifeishu-cli 是一个功能完整的飞书开放平台命令行工具。它将飞书文档、知识库、电子表格、消息、日历、任务等操作封装为简洁的命令行接口,核心能力是 Markdown ↔ 飞书文档双向无损转换。项目地址: https://gitcode.com/gh_mirrors/fe/feishu-cli
feishu-cli 是一个功能完整的飞书开放平台命令行工具,它将飞书文档、知识库、电子表格、消息、日历、任务等操作封装为简洁的命令行接口,核心能力是 Markdown 与飞书文档双向无损转换。除了传统的 CLI 用法,feishu-cli 还为 AI 编程助手提供了 9 个开箱即用的领域技能,让 AI Agent 能够直接创建文档、发送消息、管理权限,无需任何额外配置。
为什么选择 feishu-cli 构建 AI 助手?
feishu-cli 专为 AI Agent 设计,提供了一系列原生支持特性,让智能助手能够无缝操控飞书生态:
- JSON 事件流输出:
auth login --json命令提供标准化的 JSON 事件流,AI 助手可轻松解析认证状态和进度 - Scope 预检机制:
auth check --scope "REQ_SCOPES"命令让 AI 助手在执行任务前验证所需权限,避免操作失败 - 结构化数据返回:所有命令支持
--format json输出,确保 AI 能够准确提取和处理飞书数据 - 9 个领域技能覆盖:从文档处理到会议管理,全面覆盖飞书核心功能,AI 助手即装即用
feishu-cli 与 AI 助手协作架构示意图,展示了命令行工具如何作为桥梁连接 AI 与飞书开放平台
核心 AI 集成能力解析
1. 文档智能处理工作流
feishu-cli 的 Markdown 双向转换能力为 AI 文档处理提供了坚实基础:
- AI 生成内容直接发布:使用
markdown create --content-file ai_generated.md命令,将 AI 生成的 Markdown 文档直接上传为飞书文档,保留原始格式和代码块 - 文档内容智能更新:通过
markdown overwrite命令,AI 助手可以安全更新现有文档,保持 file_token 不变,确保分享链接持久有效 - 文档摘要与分析:结合
doc read命令获取文档内容,AI 可快速生成摘要、提取关键信息或生成目录
实用技巧:AI 每天迭代同一份文档时,使用
markdown overwrite而非删除重建,避免破坏用户收藏链接。配置FEISHU_OWNER_EMAIL环境变量可自动授予文档编辑权限。
2. 智能会议管理系统
feishu-cli 让 AI 助手能够全面管理飞书会议生命周期:
- 智能会议安排:
calendar suggestion命令提供会议室推荐和时段建议,AI 可根据参会人日程自动安排最佳会议时间 - 会议纪要处理:
vc note命令获取会议纪要及 AI 产物(摘要、待办事项、章节划分),支持逐字稿下载 - 会议信息聚合:
vc detail命令一次性获取会议信息、纪要 ID 和妙记令牌,为 AI 分析提供完整数据
# 获取会议详情及 AI 产物 feishu-cli vc note <meeting_id> --with-artifacts --download-transcript --output-dir ./meeting-notes3. 自动化消息与卡片交互
AI 助手可以通过 feishu-cli 发送富媒体消息和交互式卡片:
- 智能卡片模板:使用
skills/feishu-cli-messaging/references/workflows/card/templates/目录下的模板,快速创建 AI 流式输出卡片、审批卡片和数据仪表盘 - 消息状态更新:通过 CardKit Open API 动态更新卡片元素,实现 AI 生成进度展示和实时状态反馈
- @ 标签自动修正:
msg send命令在--text模式下自动修正 AI 易写错的 @ 标签格式,确保消息正确发送
4. 视觉内容 AI 生成与导入
feishu-cli 支持将 AI 生成的视觉内容无缝导入飞书:
- SVG 转画板工作流:通过
scripts/svg_to_board.py脚本,将 AI 生成的 SVG 图形转换为飞书画板,每个元素可单独编辑 - 自由作图方案:使用
board upload_image命令导入 AI 生成的飞轮图、鱼骨图、路线图等复杂可视化内容 - HTML 交互内容:通过
htmlbox功能嵌入 AI 生成的交互式内容,如动态流程图、3D 模型等
快速开始:构建你的第一个 AI 飞书助手
准备工作
- 安装 feishu-cli:
git clone https://gitcode.com/gh_mirrors/fe/feishu-cli cd feishu-cli make install- 配置 AI 授权:
# AI Agent 推荐的后台授权模式 feishu-cli auth login --json示例 1:AI 文档摘要助手
创建一个自动提取飞书文档摘要的 AI 工作流:
- AI 助手使用以下命令获取文档内容:
feishu-cli doc read <doc_id> --format markdown > document.md将文档内容发送给 AI 模型生成摘要
使用以下命令创建摘要文档:
feishu-cli markdown create --title "文档摘要" --content-file summary.md示例 2:智能会议安排助手
构建一个自动安排会议的 AI 助手:
- AI 助手获取参会人空闲时间:
feishu-cli calendar freebusy --user-emails "user1@example.com,user2@example.com" --format json- 查找合适的会议室:
feishu-cli calendar room find --capacity 8 --floor 3 --format json- 创建会议:
feishu-cli create_event --title "项目周会" --attendees "user1@example.com,user2@example.com" \ --start "2023-11-10 14:00" --end "2023-11-10 15:00" --room "会议室A"高级技巧:提升 AI 助手能力
事件订阅与实时响应
AI 助手可以通过 feishu-cli 订阅飞书事件,实现实时响应:
# 订阅消息事件,AI 助手可实时处理新消息 feishu-cli event consume --event-key im.message.receive_v1 --max-events 100 --json技能扩展与定制
feishu-cli 的技能系统允许你扩展 AI 助手能力:
- 查看所有可用技能:
ls skills/ - 自定义技能:在
skills/目录下创建新的技能包 - 技能工作流参考:
skills/feishu-cli-platform/references/workflows/
错误处理与重试机制
AI 助手应处理可能的错误情况:
# 检查权限是否满足 if feishu-cli auth check --scope "docs:read calendar:write"; then # 执行操作 else # 请求权限或提示用户 fi总结:释放飞书生产力的 AI 助手
feishu-cli 为 AI 助手提供了强大的飞书操控能力,通过简洁的命令行接口和标准化的数据格式,让智能助手能够轻松处理文档、会议、消息等日常工作。无论是自动化报告生成、智能会议安排还是实时消息处理,feishu-cli 都能帮助你构建高效的 AI 工作流。
开始探索 feishu-cli 的 AI 集成能力,打造属于你的智能飞书助手,让工作更高效、更智能!更多详细文档和示例,请参考项目中的skills/目录和README.md。
【免费下载链接】feishu-clifeishu-cli 是一个功能完整的飞书开放平台命令行工具。它将飞书文档、知识库、电子表格、消息、日历、任务等操作封装为简洁的命令行接口,核心能力是 Markdown ↔ 飞书文档双向无损转换。项目地址: https://gitcode.com/gh_mirrors/fe/feishu-cli
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考