用途：为 Fireflies GraphQL API 构建类型化、有边界的客户端，替代临时拼凑的调用方式。Fireflies 提供的是 GraphQL API，而非必需的第一方语言 SDK，因此传输层应保持标准做法，类型仅依据经审核的 schema 证据生成或手工维护。
主要能力：每次调用携带操作名、静态文档、类型化变量、显式字段选择、超时，以及同时处理 data 与 errors 的响应解析器；集中管理端点、Bearer 注入、超时、请求 ID、脱敏与 GraphQL 错误归一化；返回保留可空性与部分数据语义的领域结果；将客户端注入调用方，并提供用于测试的 fixture 传输层；固定依赖并加入 schema 漂移检查。
使用方式：认证操作从批准的密钥管理器注入 FIREFLIES_API_KEY，仅以 Authorization: Bearer REDACTED_KEY 发送至 https://api.fireflies.ai/graphql。切勿打印、提交、放入 URL、转发到浏览器或在证据中包含密钥。Webhook 签名密钥是独立凭据，不得复用为 API 密钥。禁止将值插值进 GraphQL 源码。
适用场景：需要规范化 Fireflies 集成、统一错误与脱敏处理、便于测试与依赖注入的项目。
限制：新增 mutation、暴露新字段、启用租户级访问或替换传输依赖前需审批；生产环境不得启用不受限的 introspection；仅因调用本技能不得查询 Fireflies、获取会议内容、创建 AskFred 线程、上传媒体、更改账户状态、重放事件或部署。部分数据伴随错误时不得静默视为完整。未知字段应与当前第一方 schema 文档比对。依赖字段、过滤器、事件、权限、套餐限制、mutation 或处理状态前，请先阅读官方 Fireflies.ai 证据。