pp-fireflies

Fireflies.ai — Printing Press CLI

前提条件：安装 CLI

此技能会使用 fireflies-pp-cli 二进制文件。**在调用此技能中的任何命令之前，必须确认 CLI 已安装。**如果尚未安装，请先安装：

1. 使用 Printing Press 安装程序安装。在 macOS/Linux 上，二进制文件默认安装到 $HOME/.local/bin；在 Windows 上，默认安装到 %LOCALAPPDATA%\Programs\PrintingPress\bin：

   npx -y @mvanhorn/printing-press-library install fireflies --cli-only
   

2. 验证：fireflies-pp-cli --version
3. 确保报告的安装目录位于将调用此技能的 Agent/运行时的 $PATH 中。

如果 npx 安装失败（没有 Node、处于离线状态等），请改用直接通过 Go 安装的方式（需要 Go 1.26.6 或更高版本）：

go install github.com/mvanhorn/printing-press-library/library/productivity/fireflies/cmd/fireflies-pp-cli@latest

如果安装后 --version 报告“command not found”，说明运行时无法在 $PATH 中找到二进制文件目录。在验证成功之前，不要继续运行此技能的命令。

何时使用此 CLI

当你需要大规模挖掘会议历史记录时，请使用 fireflies-pp-cli：查找遗漏的待办事项、在通话前了解完整的关系背景、跟踪数周内的情绪或主题趋势，或离线搜索数千条会议语句。它不能替代 Fireflies 控制面板来进行日常录制配置或记笔记。

独特功能

这些功能是此 API 的其他任何工具都不具备的。

可持续积累的本地状态

• transcripts search — 对所有已同步的会议转录进行全文搜索，不消耗任何 API 配额。

  用于查找所有会议中提及特定主题的记录，且不会消耗受速率限制的 API 调用。

  fireflies-pp-cli transcripts search "pricing objection" --agent --select id,title,dateString
  

• action-items list — 汇总指定日期范围内所有会议的待办事项，一条命令即可完成每周承诺审查。

  用于在周末汇总会议中作出的所有承诺，并将其写入 TODO 文件。

  fireflies-pp-cli action-items list --from 7 --agent
  

• transcripts find — 按参与者邮箱、频道名称、关键词或日期范围查找会议；所有操作均在客户端完成，不受失效的 API 日期筛选器影响。

  用于查找与特定人员或频道相关的会议；当会议名称中不含参与者姓名时，API 的标题搜索会失效。

  fireflies-pp-cli transcripts find --participant [email protected] --from 30 --processed-only --agent
  

• transcripts status — 预先显示近期会议的 PROCESSED / PROCESSING / FAILED 状态，让你在获取前了解情况。

  用于获取当天或次日上午的会议，避免反复遇到“会议尚未准备就绪”的失败。

  fireflies-pp-cli transcripts status --since 48h --agent
  

• topics list — 列出指定日期范围内所有会议中最常见的主题，了解会议时间实际花在了哪些事情上。

  用于季度规划期间识别反复出现的主题，再决定将时间投入到哪些方面。

  fireflies-pp-cli topics list --from 30 --top 15 --agent
  

• digest — 汇总所有近期会议，包括标题、概要、主题和待办事项，并以结构化形式输出。

  用于在会话开始时或晨间 cron 任务中了解昨天发生的事情，再采取行动。

  fireflies-pp-cli digest --since 24h --agent
  

• transcripts export — 将转录导出为 Markdown 文件，保存到知识库目录并自动生成 YYYY-MM-DD_title.md 文件名；也可通过 --output（-o）或其别名 --file 指定文件路径。

  用于客户会议结束后，将格式化的转录直接保存到正确的项目文件夹。

  fireflies-pp-cli transcripts export abc123 --vault ~/vaults/VBT/Projects/1_Active/Ryder/transcripts/ --agent
  fireflies-pp-cli transcripts export abc123 --file /tmp/dennis_1on1.md --agent
  

以个人为中心的智能分析

• person timeline — 显示与特定人员的会议历史时间线，包含每场会议的主题、待办事项和发言比例。

  用于在 QBR 或续约通话前重建完整的关系历史，无需阅读每份转录。

  fireflies-pp-cli person timeline [email protected] --from 90 --agent
  

命令参考

sync — 将 API 数据同步到本地 SQLite

• fireflies-pp-cli sync — 将转录稿、频道和用户同步到本地 SQLite
• fireflies-pp-cli sync --full — 从头开始完整重新同步
• fireflies-pp-cli sync --resources transcripts,channels — 同步指定资源

transcripts — 列出、搜索和管理会议转录稿

• fireflies-pp-cli transcripts list — 列出本地存储中的转录稿
• fireflies-pp-cli transcripts get <id> — 从本地存储获取转录稿（或使用 --live 从 API 获取）
• fireflies-pp-cli transcripts find — 按参与者、频道、关键词或日期查找
• fireflies-pp-cli transcripts search <query> — 离线全文搜索
• fireflies-pp-cli transcripts recent — 显示最近处理的转录稿
• fireflies-pp-cli transcripts status — 显示 PROCESSED / PROCESSING / FAILED 状态
• fireflies-pp-cli transcripts pull <id> — 从 API 获取完整转录稿并存储到本地
• fireflies-pp-cli transcripts export <id> — 将转录稿导出为 Markdown 文件（--output/-o/--file）或知识库路径
• fireflies-pp-cli transcripts update <id> — 更新标题或隐私设置
• fireflies-pp-cli transcripts share <id> — 与外部电子邮件地址共享
• fireflies-pp-cli transcripts delete <id> — 删除转录稿

summary — AI 生成的会议摘要

• fireflies-pp-cli summary <id> — 获取摘要（格式：overview、bullets、gist、topics、keywords、actions）

action-items — 提取行动事项

• fireflies-pp-cli action-items get <id> — 获取特定转录稿中的行动事项
• fireflies-pp-cli action-items list — 汇总指定日期范围内的行动事项

topics — 提取和分析主题

• fireflies-pp-cli topics get <id> — 获取特定转录稿中的主题
• fireflies-pp-cli topics list — 获取所有转录稿中出现频率最高的主题

keywords — AI 提取的关键词

• fireflies-pp-cli keywords <id> — 获取转录稿的关键词

speakers — 按发言者统计分析

• fireflies-pp-cli speakers <id> — 按发言者统计发言时长、词数、填充词和提问次数

analytics — 会议分析

• fireflies-pp-cli analytics team — 团队整体分析（需要 Business+ 计划）
• fireflies-pp-cli analytics meeting <id> — 单场会议的发言者分析

person — 以个人为中心的视图

• fireflies-pp-cli person timeline <email-or-name> — 与某人的会议历史时间线
• fireflies-pp-cli person complaints <email-or-name> — 跨会议查找负面情绪相关提及

digest — 汇总会议简报

• fireflies-pp-cli digest — 在一个视图中汇总所有近期会议

channels — 频道管理

• fireflies-pp-cli channels <id> — 获取单个频道

users — 用户管理

• fireflies-pp-cli users — 获取用户信息

查找合适的命令

知道自己想做什么，但不确定该用哪个命令时，可以直接询问 CLI：

fireflies-pp-cli which "<capability in your own words>"

which 会根据自然语言能力查询，从此 CLI 精选的功能索引中匹配最合适的命令。退出代码 0 表示至少找到一个匹配项；退出代码 2 表示没有把握找到匹配项，此时可改用 --help 或使用范围更窄的查询。

使用示例

晨间速览：昨天的会议发生了什么

fireflies-pp-cli transcripts list --from 24h --agent --select id,title,dateString,duration,summary.gist

列出昨天的会议并附上 AI 生成的一句话摘要 — 如果已完成同步，则不会调用 API。

查找客户提及定价的所有记录

fireflies-pp-cli search "pricing" --from 90d --agent --select id,title,speaker_name,text

在已同步的句子中进行全文搜索。--select 点路径可深入访问嵌套字段。

准备 QBR 并查看客户历史记录

fireflies-pp-cli person timeline "Acme" --from 180 --agent

按时间顺序查看每场提到 “Acme” 的会议 — 包括主题、行动事项和发言占比。

汇总本周的行动事项

fireflies-pp-cli action-items list --from 7 --append ~/vaults/VBT/TODO.md

汇总过去 7 天所有会议中的行动事项，并追加到 Markdown TODO 文件中。

查找本月最常讨论的主题

fireflies-pp-cli topics list --from 30 --top 15 --agent

汇总过去 30 天所有会议中出现频率最高的主题 — 看看会议时间实际都花在了哪些事情上。

身份验证设置

需要将 Fireflies API 密钥设置为 FIREFLIES_API_KEY。API 访问需要 Business 计划或更高级别。前往 app.fireflies.ai → Settings → Developer 获取密钥。

运行 fireflies-pp-cli doctor 验证设置。

Agent 模式

为任何命令添加 --agent。它会展开为：--json --compact --no-input --no-color --yes。

• 可通过管道传递 — JSON 输出到 stdout，错误输出到 stderr

• 可筛选 — --select 保留一部分字段。点分路径可深入嵌套结构；数组会逐元素遍历。对于内容冗长的 API，此功能对于保持上下文精简至关重要：

  fireflies-pp-cli transcripts list --agent --select id,title,dateString,summary.gist
  

• 可预览 — --dry-run 显示请求但不发送

• 适合离线使用 — 同步/搜索命令在本地 SQLite 存储可用时可以使用它

• 非交互式 — 不会提示输入，每项输入都是一个标志

• 显式重试 — 仅当已存在的创建操作应视为成功时才使用 --idempotent；仅当缺少删除目标应视为成功时才使用 --ignore-missing

响应封装

从本地存储或 API 读取的命令会将输出封装在来源信息中：

{
  "meta": {"source": "live" | "local", "synced_at": "...", "reason": "..."},
  "results": <data>
}

解析 .results 获取数据，并查看 .meta.source 判断数据来自实时 API 还是本地。当 stdout 是终端时，只会向 stderr 打印易读的 N results (live) 摘要；通过管道传输的客户端/Agent 使用者在 stdout 上会获得纯 JSON。

Agent 反馈

当你（或 Agent）发现此 CLI 有任何不妥之处时，请记录下来：

fireflies-pp-cli feedback "the --since flag is inclusive but docs say exclusive"
fireflies-pp-cli feedback --stdin < notes.txt
fireflies-pp-cli feedback list --json --limit 10

条目会保存在本地 ~/.fireflies-pp-cli/feedback.jsonl。只有在设置了 FIREFLIES_FEEDBACK_ENDPOINT，并且传入了 --send 或 FIREFLIES_FEEDBACK_AUTO_SEND=true 时，条目才会通过 POST 发送。默认行为仅在本地保存。

写下让你感到意外的事情，而不是提交错误报告。简短、具体、一行即可：这才是能不断积累价值的部分。

输出交付

每条命令都接受 --deliver <sink>。输出会写入指定的 sink，同时输出到 stdout（或替代 stdout），以便 Agent 路由命令结果，而无需手动通过管道传递。支持三种 sink：

Sink	效果
stdout	默认；仅写入 stdout
file:<path>	将输出原子性地写入 <path>（临时文件 + 重命名）
webhook:<url>	将输出正文 POST 到 URL（使用 --compact 时，内容类型为 application/json 或 application/x-ndjson）

未知 scheme 会被拒绝，并返回列出受支持 scheme 的结构化错误。Webhook 请求失败会返回非零状态，并在 stderr 中记录 URL 和 HTTP 状态码。

命名配置

配置是保存的一组标志值，可在多次调用中重复使用。当定时 Agent 每次运行都以相同配置调用同一命令时，可使用它——即 HeyGen 的 “Beacon” 模式。

fireflies-pp-cli profile save briefing --json
fireflies-pp-cli --profile briefing transcripts list
fireflies-pp-cli profile list --json
fireflies-pp-cli profile show briefing
fireflies-pp-cli profile delete briefing --yes

显式标志始终优先于配置值；配置值优先于默认值。agent-context 会在 available_profiles 下列出所有可用配置，以便 Agent 在运行时发现这些配置。

退出代码

Code	含义
0	成功
2	用法错误（参数错误）
3	未找到资源
4	需要身份验证
5	API 错误（上游问题）
7	请求受限（等待后重试）
10	配置错误

参数解析

解析 $ARGUMENTS：

1. 为空、help 或 --help → 显示 fireflies-pp-cli --help 输出
2. 以 install 开头 → 以 mcp 结尾 → 安装 MCP；否则 → 参见上文的先决条件
3. 其他任何内容 → 直接使用（作为 CLI 命令执行，并带上 --agent）

MCP 服务安装

1. 安装 MCP 服务：

   go install github.com/mvanhorn/printing-press-library/library/productivity/fireflies/cmd/fireflies-pp-mcp@latest
   

2. 在 Claude Code 中注册：

   claude mcp add fireflies-pp-mcp -- fireflies-pp-mcp
   

3. 验证：claude mcp list

直接使用

1. 检查是否已安装：which fireflies-pp-cli 如果未找到，请提供安装选项（参见本技能开头的先决条件）。
2. 将用户查询与上方“独特功能”和“命令参考”中的最佳命令匹配。
3. 使用 --agent 标志执行：

   fireflies-pp-cli <command> [subcommand] [args] --agent
   

4. 如果不明确，请查看子命令帮助：fireflies-pp-cli <command> --help。