summarize 是一个快速命令行工具(CLI),用于对 URL、本地文件和 YouTube 链接进行摘要或文本/转录提取。
用途 该工具主要用于快速获取链接、文章、本地文件或视频内容的摘要。当用户提出“这个链接/视频讲了什么”“总结这个 URL/文章”“转录这个 YouTube/视频”等需求时,可使用该技能。对于 YouTube 视频,它提供尽力而为的转录提取,无需 yt-dlp。
主要能力
- 对 URL 进行摘要。
- 对本地文件(如 PDF)进行摘要。
- 对 YouTube 链接进行摘要或转录提取。
- 支持多种模型提供商:OpenAI、Anthropic、xAI、Google。
- 默认模型为 google/gemini-3-flash-preview(未设置时)。
- 提供长度控制、最大输出 token、仅提取、JSON 输出、Firecrawl 回退提取等参数。
使用方式 快速开始示例: 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 摘要与转录: 尽力而为的转录(仅 URL): summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto --extract-only 如果用户要求转录但内容很大,先返回紧凑摘要,再询问要展开哪个部分或时间范围。
模型与密钥: 需为所选提供商设置 API 密钥:
- OpenAI: OPENAI_API_KEY
- Anthropic: ANTHROPIC_API_KEY
- xAI: XAI_API_KEY
- Google: GEMINI_API_KEY(别名:GOOGLE_GENERATIVE_AI_API_KEY、GOOGLE_API_KEY)
实用参数: --length short|medium|long|xl|xxl|<chars> --max-output-tokens <count> --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 回退
适用场景
- 快速了解网页文章或链接内容。
- 对本地 PDF 等文件生成摘要。
- 获取 YouTube 视频的摘要或转录文本。
- 需要机器可读输出(JSON)的自动化场景。
限制
- YouTube 转录为尽力而为,可能不完整。
- 部分功能依赖外部服务密钥(Firecrawl、Apify)。
- 具体收费、价格、平台支持范围等未在资料中提供。