核心用法
feishu-cli 是面向开发者和AI Agent的飞书开放平台全功能命令行工具，提供飞书生态的完整程序化操控能力。
文档与知识库：支持Markdown↔飞书文档双向无损转换（doc import/export、wiki export），Mermaid/PlantUML图表自动转为可编辑矢量画板，是AI生成内容同步飞书的核心桥梁。
电子表格：提供类Excel的精细化读写能力（sheet read/write/style），支持范围操作和样式设置，适合自动化报表、数据同步场景。
消息与协作：覆盖文本消息发送、群聊搜索、协作者权限管理（msg send、perm add），可构建自动化通知工作流。
日历与任务：完整支持日程创建（calendar create-event）和待办管理（task create），实现会议自动化编排。
显著优点
- 双向无损转换：Markdown与飞书文档格式互转保留完整结构，解决AI内容落地的格式痛点
- 全能力覆盖：单工具集成文档/表格/消息/日历/权限/云空间，无需切换多套API
- AI Agent原生设计：命令行交互模式天然适配自动化脚本和Agent调用
- 安装便捷：一键curl安装，配置方式灵活（环境变量或交互式配置）
潜在局限
- 凭证门槛：需自建飞书应用并获取App ID/Secret，对非开发者有一定配置成本
- 权限依赖：实际可用功能受飞书应用权限申请范围限制
- 网络要求：飞书API调用需稳定访问飞书服务器
适合人群
飞书企业用户中的开发者、自动化工程师、AI Agent构建者，以及需要将Markdown内容批量同步至飞书的知识管理团队。
常规风险
- 凭证泄露风险：App Secret需安全存储，避免硬编码或日志泄露
- 权限越界：批量操作前需确认目标范围，防止误删或误发
- API限流：高频自动化场景需注意飞书开放平台频率限制