summarize 工具总结

一站式提取和摘要管道：从文章、视频、音频到本地文件，先做真实内容提取，再交给任意已接入的模型生成摘要。支持本地、付费和免费模型。

核心功能

📄

真实提取

Readability 提取文章，markitdown 处理文件，Firecrawl 兜底对抗反爬站点。

🎬

媒体感知

YouTube 和播客优先取已公布字幕，退化用 Whisper 转写（Groq / 本地 ONNX / 云端）。

🧠

模型无关

xAI、OpenAI、Google、Claude、Ollama，甚至本地 CLI 提供者（Claude Code、Codex 等）。

📦

多种输出

流式 ANSI Markdown、纯文本管道、JSON envelope，以及 --no-color 去色模式。

🖼️

视频幻灯片

--slides 抽取场景关键帧并内联显示（Kitty / iTerm），也可保存到磁盘。

🔒

保持本地

可选守护进程 + Chrome 侧边栏配对当前标签页，只绑定 127.0.0.1，共享令牌鉴权。

快速上手

# 网页摘要（默认模型，输出流式 Markdown）
summarize "https://example.com/article"
      

# YouTube — 优先字幕，退化用 yt-dlp + Whisper
summarize "https://youtu.be/I845O57ZSy4"
      

# 本地文件（PDF、图片、音视频）
summarize ./report.pdf --model openai/gpt-5-mini
      

# 仅提取干净内容（适合管道调用）
summarize "https://example.com" --extract --format md | wc -w
      

# 粘贴板 / 标准输入
pbpaste | summarize -
      

# JSON 输出给脚本（含 prompt 和指标）
summarize "https://example.com" --json --metrics detailed
      

处理流程

提取内容

文章用 Readability，文件用 markitdown，反爬站点用 Firecrawl 兜底。

媒体转写

优先已公布字幕（YouTube / 播客），缺失时走 Whisper 本地或云端。

模型摘要

交给已配置模型（auto 自动选择，可切换任意提供方）。

格式化输出

终端 / 管道 / JSON / 幻灯片，不同场景不同形态。

默认配置

// ~/.summarize/config.json
{
  "model": "auto",
  "output": {
    "length": "long",
    "language": "auto"
  },
  "models": {
    "free": [
      "openai/gpt-oss-120b:free",
      "z-ai/glm-4.6:free"
    ]
  },
  "cache": {
    "enabled": true,
    "maxMb": 512
  }
}
      

“--extract 跳过 LLM 只打印干净内容；--json 在 stdout 输出稳定 envelope，进度、提示和警告走 stderr —— 管道永远干净可解析。”

行动建议

第一次使用：先跑 npm i -g summarize，照着 Quickstart 五分钟上手。
遇到顽固网站：切换 Website mode 并利用 Firecrawl 覆盖器选择与自动降级路径。
处理音频/视频：优先依赖官方字幕，缺失时启用 ONNX 本地转写，省钱又隐私。
想固定默认值：把 model、length、language 写进 config.json，用 flags 做覆盖。
脚本自动化：用 --json --metrics detailed 拿结构化输出，stderr 保持纯净。

项目信息

MIT 许可证活跃开发中 github.com/steipete/summarize Chrome 扩展已上架