summarize 是一个快速 CLI 工具,用于总结网址、本地文件和 YouTube 链接的内容,也可尽力提取文本或转录。典型触发场景包括:用户要求“使用 summarize.sh”、“这个链接/视频讲了什么”、“总结这个网址/文章”,或“转录这个 YouTube/视频”(尽力提取转录,无需 yt-dlp)。
主要能力:对 URL、本地文件(如 PDF)和 YouTube 链接生成摘要;对 URL 尽力提取转录;支持通过 --extract-only 仅提取文本;支持 --length 控制长度(short、medium、long、xl、xxl 或指定字符数);支持 --max-output-tokens、--json(机器可读)、--firecrawl(auto/off/always,用于受阻站点回退提取)、--youtube auto(设置 APIFY_API_TOKEN 时使用 Apify 回退)。
基本用法示例: 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 仅提取转录:summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto --extract-only
模型与密钥:需为所选提供商设置 API key——OpenAI 用 OPENAI_API_KEY,Anthropic 用 ANTHROPIC_API_KEY,xAI 用 XAI_API_KEY,Google 用 GEMINI_API_KEY(别名 GOOGLE_GENERATIVE_AI_API_KEY、GOOGLE_API_KEY)。未设置时默认模型为 google/gemini-3-flash-preview。可选配置文件为 ~/.summarize/config.json,例如 {"model": "openai/gpt-5.2"};可选服务密钥包括 FIRECRAWL_API_KEY(访问受阻站点)和 APIFY_API_TOKEN(YouTube 回退)。
限制:转录为尽力提取,且 --extract-only 仅适用于 URL;其他未在资料中说明的限制暂未提供。