feishu-minutes

Feishu Minutes Skill 是一款面向飞书用户的命令行工具，专注于解决企业会议资产的本地化备份与管理需求。通过调用飞书开放平台的官方 API，该工具能够将妙记中的会议元数据、观看统计、原始字幕、可读文本及音视频媒体完整导出到本地指定目录，实现会议数据从云端到本地的无缝迁移。

在核心用法方面，用户只需获取妙记链接中的 Token，执行简单的 CLI 命令即可完成全量数据拉取。工具支持自定义输出目录，默认会将文件整理到项目目录下的独立文件夹中，生成包括 info.json（基础信息）、stats.json（互动数据）、subtitle.json（原始字幕）、transcript.md（Markdown 格式文本）及 media.mp4（音视频文件）在内的五种标准化输出，满足不同的二次处理需求。

该工具的显著优势在于其数据主权设计理念。所有敏感凭证（APP_ID/APP_SECRET）均通过环境变量或配置文件注入，避免硬编码风险；获取的会议内容完全存储于本地文件系统，不会上传至任何第三方服务器，有效满足企业的数据合规要求。同时，工具实现了完善的错误处理机制，网络请求配备 5 秒超时和 3 次重试策略，确保在网络波动场景下的稳定性。

然而，作为一款 T3 级别的个人开发者项目，该 Skill 也存在一定局限性。首先，输入验证机制相对基础，缺乏对 Token 格式的严格校验，可能存在无效请求的风险。其次，项目依赖的维护完全由个人开发者承担，长期更新和技术支持的可持续性存在不确定性。此外，工具要求用户具备一定的技术背景（Node.js 环境配置、命令行操作），对非技术用户门槛较高。

该工具特别适合需要批量归档会议记录的企业法务团队、需要将会议内容集成到内部知识库的技术团队，以及对数据隐私有严格要求、希望将会议资产保留在本地防火墙内的组织。对于偶尔使用妙记的个人用户，官方提供的导出功能可能更为便捷。

在使用过程中，用户需注意以下风险：确保运行环境的 Node.js 依赖（特别是 node-fetch、yargs、dotenv）及时更新以规避已知 CVE 漏洞；妥善保管飞书应用的密钥信息，避免通过版本控制系统泄露；在共享服务器上使用时，需严格设置输出目录的文件权限（建议 600 或 700），防止敏感会议内容被未授权访问。虽然工具本身不执行危险操作，但泄露的 minutes_token 可能导致会议内容被恶意获取，建议定期轮换飞书应用凭证。