用途
summarize 是一个快速命令行工具,用于总结 URL、本地文件和 YouTube 链接的内容。当用户提出“使用 summarize.sh”“这个链接/视频讲什么?”“总结这个 URL/文章”或“转录这个 YouTube/视频”等请求时,可立即调用该技能。
主要能力
- 总结 URL 内容
- 总结本地文件(如 PDF)
- 总结 YouTube 视频链接
- 尽最大努力提取转录文本(仅限 URL,无需 yt-dlp)
- 支持多种模型提供商:OpenAI、Anthropic、xAI、Google
- 输出长度可调
使用方式
快速开始示例:
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)
默认模型为 google/gemini-3-flash-preview,未设置模型时使用该默认值。
实用参数
--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)进行自动化处理
限制
资料中未提供关于价格、收费、平台支持范围、效果保证或具体配额的信息,相关内容暂未提供。转录提取为“尽最大努力”方式,并非所有视频均可成功提取。