feishu-cli 与 AI 集成:打造你的智能飞书助手,实现自动化工作流

📅 2026/7/28 5:50:56 👁️ 阅读次数 📝 编程学习
feishu-cli 与 AI 集成:打造你的智能飞书助手,实现自动化工作流

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-notes

3. 自动化消息与卡片交互

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 飞书助手

准备工作

  1. 安装 feishu-cli:
git clone https://gitcode.com/gh_mirrors/fe/feishu-cli cd feishu-cli make install
  1. 配置 AI 授权:
# AI Agent 推荐的后台授权模式 feishu-cli auth login --json

示例 1:AI 文档摘要助手

创建一个自动提取飞书文档摘要的 AI 工作流:

  1. AI 助手使用以下命令获取文档内容:
feishu-cli doc read <doc_id> --format markdown > document.md
  1. 将文档内容发送给 AI 模型生成摘要

  2. 使用以下命令创建摘要文档:

feishu-cli markdown create --title "文档摘要" --content-file summary.md

示例 2:智能会议安排助手

构建一个自动安排会议的 AI 助手:

  1. AI 助手获取参会人空闲时间:
feishu-cli calendar freebusy --user-emails "user1@example.com,user2@example.com" --format json
  1. 查找合适的会议室:
feishu-cli calendar room find --capacity 8 --floor 3 --format json
  1. 创建会议:
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),仅供参考