🚀 Feishu SuperToolkit#

飞书超级工具包 - 文件发送 + 办公自动化一体化解决方案

基于 official/feishu-toolkit 和 feishu-file-sender 合并增强，集成 文件发送（含音频卡片）、 日历管理、 审批流程、 多维表格、 通讯录查询、 考勤管理 六大核心模块。

✨ 功能亮点#

模块能力示例指令📎 文件发送图片预览、音频卡片（内嵌播放器）、视频封面、文档发送"把这首哈萨克语歌曲用卡片形式发到飞书"📅 日历日程 CRUD、会议室预约、忙闲查询"帮我预约明天下午的 8 楼大会议室"✅ 审批发起/查询/同意/拒绝/转交审批"帮我发起一个出差审批"📊 多维表格表格创建、记录增删改查"在项目跟踪表中新增一条任务"👥 通讯录用户/部门查询、组织架构浏览"查一下市场部有哪些成员"⏰ 考勤打卡记录、补卡查询、考勤组管理"查看我这周的打卡记录"

🆕 增强特性#

🎵 音频卡片支持#

• 自动转换为 OPUS 格式
• 内嵌播放器（进度条 + 时间显示）
• 飞书客户端 V7.49+ 支持

🖼️ 图片预览#

• 直接预览显示，无需点击

🌐 UTF-8 编码机制#

• 所有文本内容自动使用 UTF-8 编码
• 支持中文、哈萨克语、阿拉伯语等多语言
• 避免乱码问题

📦 安装#

bash

claw skill install gamma/feishu-supertoolkit

⚙️ 配置#

1. 设置环境变量#

bash

export FEISHU_APP_ID="cli_a93078949238dbb3"
export FEISHU_APP_SECRET="AVJVZYEdlVIPtF8G50aDPdiXIiJXmWyX"

2. 启动服务#

bash

cd server/
uv venv && uv pip install -e ".[dev]"
uv run --env-file .env uvicorn feishu_supertoolkit.main:app --host 127.0.0.1 --port 8002

3. 验证#

bash

curl http://127.0.0.1:8002/ping
# {"message": "pong"}

🔐 权限清单#

模块权限标识说明文件发送im:message:send_as_bot发送消息文件发送im:file:upload上传文件日历calendar:calendar读写日历及日程日历vc:room:readonly查询会议室审批approval:approval读写审批信息审批approval:task审批人操作多维表格bitable:app读写多维表格多维表格drive:drive访问云空间通讯录contact:contact.base:readonly读取通讯录考勤attendance:task:readonly导出打卡数据

📖 详细文档#

• 文件发送
• 日历与会议室
• 审批
• 多维表格
• 通讯录
• 考勤

🔗 相关资源#

• 飞书开放平台
• 飞书开发者文档
• API 调试台

📝 更新日志#

• v1.0.0 (2026-03-26) - 初始版本

  • 合并 official/feishu-toolkit 和 feishu-file-sender
  • 增强消息模块（音频卡片、图片预览）
  • 添加 UTF-8 编码机制
  • 支持多语言（中文、哈萨克语、阿拉伯语）