summarize 是一个快速命令行工具,用于对 URL、本地文件和 YouTube 链接进行摘要,或从其中提取文本与转录内容。它适合在用户提出「这个链接/视频讲了什么」「摘要这篇文章」「转录这个 YouTube 视频」等需求时使用,其中视频转录属于尽力而为的提取,不依赖 yt-dlp。
主要用法:通过 summarize 命令传入链接或文件路径,并可指定模型。例如 summarize "https://example.com" --model google/gemini-3-flash-preview、summarize "/path/to/file.pdf" --model google/gemini-3-flash-preview、summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto。若只需转录而非摘要,可在 YouTube 链接上使用 --extract-only。若转录内容过长,可先返回简短摘要,再询问用户希望展开哪一部分或时间范围。
模型与密钥:需为所选提供方设置 API key,包括 OPENAI_API_KEY、ANTHROPIC_API_KEY、XAI_API_KEY,以及 Google 的 GEMINI_API_KEY(别名 GOOGLE_GENERATIVE_AI_API_KEY、GOOGLE_API_KEY)。未设置时默认模型为 google/gemini-3-flash-preview。
常用参数包括 --length(short|medium|long|xl|xxl 或字符数)、--max-output-tokens、--extract-only(仅 URL)、--json(机器可读)、--firecrawl auto|off|always(备用提取)、--youtube auto(设置 APIFY_API_TOKEN 时使用 Apify 备用)。
可选配置文件为 ~/.summarize/config.json,可设置如 { "model": "openai/gpt-5.2" }。可选服务包括 FIRECRAWL_API_KEY(用于被封锁的站点)与 APIFY_API_TOKEN(用于 YouTube 备用)。