用途：通过 Fathom 官方 API 处理会议、转录、摘要、团队、团队成员和官方 Webhook 相关任务。默认优先使用官方 API 驱动的 CLI，而非浏览器自动化；机器使用时优先加 --json；导出前先做筛选；需要跨摘要/转录做内容搜索时使用 meetings grep。
安装：若 PATH 中缺少 fathom，可执行 npm i -g fathom-video-cli，或在一次性命令前加 npx -y fathom-video-cli。
默认流程：先运行 fathom doctor --json 做检查；用 fathom meetings list --limit 25 --json 浏览近期会议；用 --team、--created-after、--query 等按元数据缩小范围；用 fathom meetings get <recording_id_or_url> --with summary,transcript --json 获取单个会议；用 fathom recordings transcript <recording_id> --json 和 fathom recordings summary <recording_id> --json 拉取精确内容。
常见任务：fathom meetings grep "关键词" --limit 50 --json 搜索内容；fathom meetings export --all --zip 导出整包；fathom meetings export --team Operations --created-after 2026-03-01 --format json,md,txt --json 导出筛选切片；fathom teams --json 查看团队；fathom team-members --team Operations --json 查看成员；fathom webhooks create --destination-url https://example.com/fathom-webhook --triggered-for my_recordings --include transcript,summary 创建 Webhook。
认证：若 doctor 报告缺少认证，可临时用 FATHOM_API_KEY=... fathom doctor --json；未全局安装时用 FATHOM_API_KEY=... npx -y fathom-video-cli doctor --json；也可用 fathom auth set 保存本地配置，或 printf '%s' "$FATHOM_API_KEY" | fathom auth set --stdin 做非交互自动化。避免把完整密钥粘贴到日志或聊天中。公开分享链接是例外：即使未配置 API 密钥，fathom meetings get <share_url> --with transcript --json 也可通过公开分享页解析。
限制：没有官方 whoami 端点；meetings get 是派生辅助命令，因为 Fathom 未发布单会议获取端点；它可能通过公开分享页解析，此时结果可能含 source: "public_share_page" 且 official_recording_id: null；recordings transcript 和 recordings summary 在提供 --destination-url 时切换为回调模式；Webhook 密钥仅在创建时出现，如需签名验证应立即保存。契约要点：--json 时 stdout 应只含一个 JSON 对象，进度与状态输出到 stderr；退出码 0 成功、1 请求/上游失败或检查失败、2 需要认证/用户操作或输入无效；常见错误码包括 AUTH_MISSING、NOT_FOUND、RATE_LIMITED、UPSTREAM_5XX、TIMEOUT、VALIDATION、CHECK_FAILED。