# @firefliesai/n8n-nodes-fireflies 中文文档

规范地址：https://npmcn.com/package/%40firefliesai/n8n-nodes-fireflies/

版本：2\.3\.0
npm 元数据更新时间：2026-10-09T17:49:42.490Z
中文译文更新时间：2026-11-14T19:35:33.493Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40firefliesai/n8n-nodes-fireflies
原文对照：https://npmcn.com/package/%40firefliesai/n8n-nodes-fireflies/?lang=original
项目主页：https://fireflies.ai/
源码仓库：https://github.com/firefliesai/n8n-nodes-fireflies

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：455 kB，283 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：0 个
- peer 依赖：n8n-workflow \*
- 首次发布：2025-05-13T12:01:21.863Z
- 最新版本发布：2026-10-09T17:49:42.167Z
- 近 30 天下载量：6510（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：14（近 12 个月 5 个）

## 中文简介

为Fireflies.ai API提供的n8n集成,可以使工作流程自动化,与来自Fireflies的会话记录,分析,摘要等对话数据相通. AI的会议助理.

## 安装

```sh
npm install @firefliesai/n8n-nodes-fireflies
```

也可以使用：`pnpm add @firefliesai/n8n-nodes-fireflies`、`yarn add @firefliesai/n8n-nodes-fireflies`、`bun add @firefliesai/n8n-nodes-fireflies`

## README

# n8n-节点-萤火虫

这是一个n8n社区节点. 它让你在N8n工作流程中使用了"萤火虫".ai.

萤火虫是一个AI会话助手,可以自动记录,转录,分析您的会话. 它与受欢迎的视频会话平台相融合,帮助团队通过重要的会话内容来捕捉和搜索.

[无 8n](https://n8n.io/) 是一个 [获得公平代码许可](https://docs.n8n.io/reference/license/) 工作流程自动化平台.

[安装](https://npmcn.com/package/%40firefliesai/n8n-nodes-fireflies/#readme-installation)  
[业务](https://npmcn.com/package/%40firefliesai/n8n-nodes-fireflies/#readme-operations) [使用量](https://npmcn.com/package/%40firefliesai/n8n-nodes-fireflies/#readme-usage) [全权证书](https://npmcn.com/package/%40firefliesai/n8n-nodes-fireflies/#readme-credentials)  
[资源](https://npmcn.com/package/%40firefliesai/n8n-nodes-fireflies/#readme-resources)  
[版本历史](https://npmcn.com/package/%40firefliesai/n8n-nodes-fireflies/#readme-version-history)

## 安装

跟着 [安装指南](https://docs.n8n.io/integrations/community-nodes/installation/) 在n8n社区节点文档中.

## 业务

这个 **萤火虫** 节点支持12个资源和42个操作,覆盖公共API的每一个查询和突变,通过 [萤火虫.ai API](https://docs.fireflies.ai/)。 。 。 .

### 大赦国际应用程序

-   **获取 AI App 输出** ——从安装在工作空间的AI应用获取结果;可选过滤器: `appId`, (中文(简体) ), `transcriptId`, (中文(简体) ), `skip`, (中文(简体) ), `limit`

### 问Fred

AskFred是萤火虫的人工智能助手,负责以自然语言查询您的会议.

-   **获取线索** ——列出所有 AskFred 对话线索;可选过滤器 : `transcriptId`
-   **获取线索** ——获得一个包含所有信息的特定线索
-   **创建线索** 开始新的对话;支持会议过滤器(`dateRange`, (中文(简体) ), `participants`, (中文(简体) ), `organizers`, (中文(简体) ), `channels`, (中文(简体) ), `transcriptIds`)和对策(`language`, (中文(简体) ), `format`, (中文(简体) ), `generateSuggestions`(中文(简体) )
-   **继续线索** 在现有线索中添加后续问题
-   **删除线索** ——去掉一条线程及其所有消息

### 音频

-   **上传音频** ——从 URL 上传音频文件进行转录;可选: `webhook`, (中文(简体) ), `customLanguage`, (中文(简体) ), `meetingDate`, (中文(简体) ), `saveVideo`, (中文(简体) ), `bypass_size_check`, (中文(简体) ), `download_auth` (持牌人/基本认证/无), `attendees`, (中文(简体) ), `client_reference_id`
-   **上传文件** ——直接上传二进制音频或视频文件(不需要公共URL);可选: `title`, (中文(简体) ), `customLanguage`, (中文(简体) ), `contentType`, (中文(简体) ), `attendees`. 需要直接上载访问,但一般不可用

### 审计活动

-   **获得多个** • 贵小组的审计活动(会议、小组、用户和认证活动) `category`; 可选过滤器 : `action`, (中文(简体) ), `actorEmail`, (中文(简体) ), `actorUserId`, (中文(简体) ), `dateFrom`, (中文(简体) ), `dateTo`, (中文(简体) ), `cursor`; 支持返回全部。 需要团队管理企业号

### 咬伤

贝斯是短视频或音频剪辑,由笔录所创造.

-   **获取列表** ——列表咬伤片段;可选过滤器: `mine`, (中文(简体) ), `transcriptId`, (中文(简体) ), `myTeam`, (中文(简体) ), `limit`, (中文(简体) ), `skip`
-   **获取** ——通过ID获得特定的咬口
-   **创建** - 从记录稿中取出一条咬口 `transcriptId`, (中文(简体) ), `startTime`, (中文(简体) ), `endTime`; 可选 : `name`, (中文(简体) ), `mediaType` (音频/视频), `privacies`

### 频道

-   **获取列表** ——列出工作空间中的所有频道
-   **获取** ——通过ID获取一个特定的频道

### 联系人

-   **获取列表** — 列出工作空间中的所有联系人

### 会议

-   **获取活动会议** — 列出当前活动/实况会议;可选过滤器: `email`, (中文(简体) ), `states` (活动/ 暂停)
-   **添加到 Live 会话** - 在一次积极的会议上增加萤火虫机器人 `meetingLink`; 可选 : `title`, (中文(简体) ), `meetingPassword`, (中文(简体) ), `duration` (15至120分钟), `language`, (中文(简体) ), `attendees`
-   **暂停或恢复记录** - 暂停或在现场会议上恢复机器人
-   **创建实时动作项目** ——请弗雷德在现场会议上用平话创作一个动作项目 `prompt`
-   **创建 Live 音响** ——请弗雷德在现场见面时用平话创造出声音 `prompt`
-   **获取 Live 动作项目** 列出在现场会议上创建的动作项目

四个现场会议行动需要从 **获取活动会议**. 每个小时限为10个请求,两个Fred业务使用AI信用.

### 规则执行

-   **获得多个** 自动化规则处决按会议分类;可选过滤器: `ruleId`, (中文(简体) ), `meetingId`, (中文(简体) ), `dateFrom`, (中文(简体) ), `dateTo`、试验或生产处决, `logsPerMeeting`, (中文(简体) ), `cursor`; 支持返回全部。需要企业计划

### 团队分析

-   **获取团队分析** ——获得整个团队的分析;需要管理员权限;可选: `startTime`, (中文(简体) ), `endTime` (ISO 日期字符串)

### 语录

-   **获取** ——通过身份证获得完整的笔录
-   **获取列表** 带有可选过滤器的清单记录: `limit`, (中文(简体) ), `skip`, (中文(简体) ), `title`, (中文(简体) ), `fromDate`, (中文(简体) ), `toDate`, (中文(简体) ), `hostEmail`, (中文(简体) ), `organizerEmail`, (中文(简体) ), `participantEmail`, (中文(简体) ), `userId`, (中文(简体) ), `mine`, (中文(简体) ), `keyword`, (中文(简体) ), `scope`, (中文(简体) ), `organizers`, (中文(简体) ), `participants`, (中文(简体) ), `channelId`
-   **获取摘要** 获得AI生成的摘要作为笔录
-   **获取分析** 获得分析(同意、专题、参与)以获得记录
-   **获取音频 URL** ——获取音频下载URL以获取笔录
-   **获取视频 URL** ——获取视频下载URL以获取笔录
-   **删除** ——永久删除笔录
-   **份额** 共享电子邮件地址的会议;可选: `expiryDays`, (中文(简体) ), `shareType` (电子邮件/密码链接), `password`
-   **取消共享访问** ——取消特定电子邮件地址的共享访问
-   **更新标题** - 更新会议名称
-   **更新隐私** - 改变隐私设置(`link` 编号 : `owner` 编号 : `participants` 编号 : `participatingteammates` 编号 : `teammates` 编号 : `teammatesandparticipants`(中文(简体) )
-   **更新频道** ——将会议移至不同的频道

### 用户

-   **获取** ——通过用户ID获取队友的简介
-   **获取当前用户** 获取认证用户的配置
-   **获取列表** — 列出工作空间中的所有用户
-   **获取组** ——列表用户组;可选过滤器: `mine`
-   **添加到组** 编号 : **从组中删除** ——通过电子邮件管理用户组成员;需要团队管理业务或以上事务
-   **设置角色** ——改变用户角色(`admin` 编号 : `user`; 需要管理员权限

* * *

## 使用量

### 获取和链条记录

这个 **获取列表** 在 Transcript 下操作检索基于可选过滤器的相加会议列表 :

-   `hostEmail`, (中文(简体) ), `organizerEmail`, (中文(简体) ), `participantEmail`
-   `title`, (中文(简体) ), `userId`, (中文(简体) ), `mine`
-   `fromDate` 编号 : `toDate`
-   `keyword`, (中文(简体) ), `scope`
-   `organizers`, (中文(简体) ), `participants` (合并分离)
-   `channelId`

这往往是工作流程的第一步。 记录在寄回的笔录上,然后传到:

-   **获取** - 获取全部记录内容
-   **获取摘要** ——检索 [目录](https://docs.fireflies.ai/schema/summary) 和关键外卖
-   **获取分析** ——准入 [分析](https://docs.fireflies.ai/schema/analytics) 情感 话题提取 还有更多

这些操作链自然用于报告、见解或下游自动化.

关于记录字段和反应结构的充分参考,见 [萤火虫转写Schema](https://docs.fireflies.ai/schema/transcript)。 。 。 .

### 与贝斯合作

贝斯是从记录中剪下来的短片 使用 **创建** 通过提供 `transcriptId`, (中文(简体) ), `startTime`,以及 `endTime`您可以设置 `name`选择 `mediaType` (音频或视频),并控制能见度 `privacies`。 。 。 .

使用 **获取列表** 浏览已有的被咬,可选择过滤到自己的剪辑(`mine`)或者你的团队的(`myTeam`) (中文(简体) ).

### 现场会议

使用 **获取活动会议** 了解目前正在举行哪些会议。 一旦你有一个会议链接, **添加到 Live 会话** 送"萤火虫"来加入并记录. 你可以通过一个可选 `title`, (中文(简体) ), `meetingPassword`,预期 `duration`,并抄录 `language`。 。 。 .

### 团队分析

**获取团队分析** 返回全工作空间分析,并需要管理员权限。 过 `startTime` 财务报告和审定财务报表 `endTime` 作为ISO 日期字符串将报告范围扩大到特定时期.

### 费率限额

Fireflies API执行按计划要求的限制(Free and Pro上每天每分钟一次);当前数字在 [限制](https://docs.fireflies.ai/fundamentals/limits) 文档。 当一项请求被拒绝时 `too_many_requests`,节点等待API要求的时间(`Retry-After`),并重复最多2次,只要等待时间约1分钟或更短(每分钟限制). 一个较长的等待,比如每天的配额,会同时使项目失败,错误以秒表示等待,例如. `Fireflies API rate limit reached. Retry after 3600 seconds.`,所以一个工作流程 从来没有屏蔽几个小时。 与 **继续失败** 带有错误的项目 `retryAfterSeconds` 财务报告和审定财务报表 `retryAt`,则该运行的剩余输入项不发送(每个都得到相同的错误项,标记) `skipped`),因为每个在块间发出的请求都会扩展. 零8纳 **重试失败** 无法覆盖这样的等待( 最多5次尝试, 最多相隔5秒) , 只能延长块; 分支 打开 `retryAt` 或暂停 **单单** 取而代之的是节点,然后发送其余的项目.

## 全权证书

要使用萤火虫节点,您需要用您的萤火虫 API 键进行认证 .

1.  登录到您的 [萤火虫.ai](https://fireflies.ai/) 账户
2.  转到设置 > 开发者设置
3.  生成或复制您的 API 密钥
4.  在您 n8n 的萤火虫节点证书中使用此 API 密钥

该节点使用API密钥认证来安全地连接到"萤火虫".ai API.

## 资源

-   [n8n 社区节点文档](https://docs.n8n.io/integrations/community-nodes/)
-   [萤火虫.ai API 文档](https://docs.fireflies.ai/)

## 版本历史

### 2.3.0 (单位:千美元)

-   🚦 **费率限制处理**(单位:千美元) `429 Too Many Requests` 编号 : `too_many_requests` 响应在 API 之后重试 `Retry-After` (最多两次重复,等待大约一分钟或更短的时间);较长的等待立即失败,错误说明等待时间为秒并连接 [限制](https://docs.fireflies.ai/fundamentals/limits) 医生。 与 **继续失败** 带有错误的项目 `retryAfterSeconds` 财务报告和审定财务报表 `retryAt`,而运行的剩余项目被跳过而不是被送入块
-   ✨ **API全覆盖**: 公共API的每一个查询和变异现在都可以使用
    -   **新资源**: 审计活动`Get Many`执行规则`Get Many`)),两者都带有"返回"(Return All Pagination)
    -   **会议**数字 : `Pause or Resume Recording`, (中文(简体) ), `Create Live Action Item`, (中文(简体) ), `Create Live Soundbite`, (中文(简体) ), `Get Live Action Items`· ; `Get Active Meetings` 通过电子邮件和状态过滤; `Add to Live Meeting` 带走参与者
    -   **用户**数字 : `Get` (通过身份证), `Add to Group`, (中文(简体) ), `Remove From Group`
    -   **音频**数字 : `Upload File` 用于直接二进制上传(需要直接加载访问); `Upload Audio` 需要开会日期
    -   **语录**数字 : `Share` 支持密码链接; `Update Privacy` 增加参与的队友; `Get List` 返回更多字段(日期、持续时间、隐私、参与者、频道和更多)和 `Scope` 是下拉;摘要包括 `notes`
    -   **问Fred**数字 : `Create Thread` 财务报告和审定财务报表 `Continue Thread` 能够产生建议的后续问题
-   🐛 **修补**数字 : `Upload Audio` 现在按API接受的形状发送参与者并下载认证(两者在之前都被拒绝了); `Create Bite` 介质类型是下拉
-   🧪 **测试**: 一个杰斯特套房(`npm test`,运行在每一个拉出请求上)覆盖了限制费率和每一个新的操作,并且对每个GraphQL文档,每个API操作和每个enum选项进行合同测试,以对抗公共API计划

### 2.2.0 (中文(简体) )

-   ✨ **新资源**:会议、频道、咬、接触、分析组
-   🆕 **新操作**数字 :
    -   **语录**数字 : `Delete`, (中文(简体) ), `Share`, (中文(简体) ), `Revoke Shared Access`, (中文(简体) ), `Update Title`, (中文(简体) ), `Update Privacy`, (中文(简体) ), `Update Channel`
    -   **用户**数字 : `Get Groups`, (中文(简体) ), `Set Role`
    -   **会议**数字 : `Get Active Meetings`, (中文(简体) ), `Add to Live Meeting`
    -   **频道**数字 : `Get`, (中文(简体) ), `Get List`
    -   **咬伤**数字 : `Get`, (中文(简体) ), `Get List`, (中文(简体) ), `Create`
    -   **联系人**数字 : `Get List`
    -   **团队分析**数字 : `Get Team Analytics` (需要管理员特权)
-   🔍 **扩展过滤器**数字 : `Get Transcripts List` 现在通过关键词、范围、组织者、参与者和频道ID支持过滤
-   🔧 **音频增强**数字 : `Upload Audio` 现在支持 `bypass_size_check` 财务报告和审定财务报表 `download_auth` 用于认证下载的(携带者/基本)

### 2.1.0 国家

-   ✨ **新资源**: 添加 AskFred 资源用于AI驱动会议QQA
-   🆕 **新操作**数字 :
    -   `Get Threads`: 列出所有 AskFred 对话框线索
    -   `Get Thread`: 获取带有所有信件的特定线索
    -   `Create Thread`: 开始与 AskFred 的新对话
    -   `Continue Thread`: 在现有线索中添加后续问题
    -   `Delete Thread`: 删除线索及其信件
-   🔍 **会话过滤器**: 创建线索支持按日期范围过滤,参与者,组织者,频道,以及笔录ID
-   🌐 **回应选项**: 可配置的响应语言和格式模式(标记下/平面文本)

### 2.0.0 (韩语)

-   ✨ **新操作**: 已添加 `GetTranscriptVideoUrl` 财务报告和审定财务报表 `GetTranscriptAudioUrl` 媒体直接接入业务
-   🔧 **强化错误处理**: 有详细错误代码和关联性ID的综合GraphQL错误检测
-   🏗️ **建筑改进**: 在所有业务中实施通用错误处理系统,以一致地回答错误
-   📚 **代码质量**: 重构代码库,以更好地维持和减少重复
-   ⚠️ **中断更改**: 删除 `audio_url` 财务报告和审定财务报表 `video_url` 从 `GetTranscript` 由于 GraphQL API 的部分数据响应行为而运行

### 1.0.7 国家

-   所有作业的固定节点处理

### 1.0.6 (中文(简体) )

-   从 getAiAppOutput 操作中删除未支持的字段

### 1.0.5 (简体中文)

-   处理输入数据时修复错误

### 1.0.4 国家

-   将代码分为资源和业务的主要重构

### 1.0.3 (中文(简体) )

-   因构建不一致而跳出版本

### 1.0.2 联合国

-   萤火虫节点执行
-   替换为 http 帮助
-   证书附加测试

### 1.0.1 (中文(简体) )

-   阵列响应中的固定错误

### 1.0.0 (单位:千美元)

-   添加操作 获取 AI App 输出、 获取会话分析、 获取会话摘要、 获取转写、 获取转写列表、 获取用户和上传音频
-   N8n的Fireflies.ai节点的初始发布

## 常见问题

### @firefliesai/n8n-nodes-fireflies 是什么？

为Fireflies\.ai API提供的n8n集成,可以使工作流程自动化,与来自Fireflies的会话记录,分析,摘要等对话数据相通\. AI的会议助理\.

### 如何安装 @firefliesai/n8n-nodes-fireflies？

在项目目录运行 npm install @firefliesai/n8n-nodes-fireflies，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：n8n-workflow（\*）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @firefliesai/n8n-nodes-fireflies 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @firefliesai/n8n-nodes-fireflies 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @firefliesai/n8n-nodes-fireflies 可以商用吗？

@firefliesai/n8n-nodes-fireflies 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @firefliesai/n8n-nodes-fireflies 的下载量有多少？

根据 npm 官方下载统计，@firefliesai/n8n-nodes-fireflies 在 2026/10/15 – 2026/11/13 这 30 天内被下载 6,510 次，日均约 217 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @firefliesai/n8n-nodes-fireflies 还在维护吗？

最新版本 2\.3\.0 发布于 2026/10/10（1 个月前）；至今共发布 14 个版本，其中过去 12 个月发布了 5 个；首次发布于 2025/05/13。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。