用途:该技能提供 scripts/fireflies 命令行工具,直接调用 Fireflies.ai 的 GraphQL 端点,把 API 响应以 JSON 输出,用于查询会议转录、会议笔记、摘要、联系人、频道、AI 会议分析、AskFred、音频上传以及 Webhook 签名校验。只读发现操作是安全的。
主要能力:transcripts list 按关键词查找转录元数据;transcripts get 读取会议、摘要、句子、分析与录制链接;users、channels、groups、contacts、apps 管理相关对象;analytics 与 meetings active 查看会议分析或进行中的会议;askfred create/get 提问并读取线程;users set-role 分配角色;meetings update-channel 移动会议到频道;live add-to 按链接加入实时会议;live soundbite 创建片段;audio create-upload 与 audio confirm-upload 完成两阶段文件上传;query 执行指定的当前或未来 API 操作;webhook verify 本地校验已投递的 Webhook。
使用方式:先运行 scripts/fireflies --help 及相关子命令帮助查看命令结构。仅在真正发起 API 请求时设置 FIREFLIES_API_KEY,不要暴露或持久化该密钥。从只读发现开始,例如 scripts/fireflies transcripts list --limit 10 --json。每次变更前先用 --dry-run --json 检查确切的 GraphQL 载荷;--dry-run 只预览载荷,不授权写入。变更流程为:确认目标对象 ID 与预期改动,与用户确认目标、范围和回滚路径(删除可能不可逆),用 --dry-run 预览,再用 --confirm 执行已批准的操作,返回响应时不打印凭据。
适用场景:需要以脚本方式查询或管理 Fireflies.ai 会议数据、分析、AskFred 问答、音频上传和 Webhook 校验时。
限制:CLI 不会启动 Webhook 服务器、不存储 API 密钥,也不猜测未文档化的 GraphQL 字段。若现有命令未覆盖所需操作,可用 query 或 mutation 配合已文档化的 GraphQL 文档;通用 mutation 命令仍需 --confirm。更多语法、API 模型、工作流、Webhook 安全与排错信息见技能目录下的 references 文档。