从 AI Skills 学实战技能（六）：让 AI 帮你总结网页、PDF、视频

每天面对几十个浏览器标签页、收藏夹里堆积的上百篇"稍后读"文章、YouTube 订阅里未看的课程视频....信息过载让人焦虑。如何快速提取关键信息？本篇要介绍的这个工具，可以让 AI 帮你自动总结这些内容。

summarize: clawhub.ai/steipete/su...

这是一个非常受欢迎，且非常实用的 Skill。本篇就来深入拆解这个 Skill 的使用方法、技术原理和实际应用场景。

---

一、Summarize 是什么？

一句话总结：

让 AI 自动总结任何 URL、本地文件和 YouTube 视频的内容。

安装之后，你可以在终端里，或通过 AI Agent，直接做这些事情：

• 总结网页文章内容
• 提取 PDF 文档要点
• 分析图片中的信息
• 转录并总结音频内容
• 快速获取 YouTube 视频字幕或摘要

---

二、效果展示

安装并配置好后，你可以通过 AI Agent 实现以下场景：

场景 1：快速总结技术文章

AI 会自动提取网页内容，帮你在几秒内掌握文章核心观点。

场景 2：提取或总结 PDF 内容

对于 PDF，可以获取详细的内容或提炼要点。

场景 3：理解图片内容

指定图片，快速理解图片内容，生成对应描述。

场景 4：YouTube 视频速览

无需观看完整视频，直接获取视频内容的文字摘要和关键信息点。

---

三、安装与配置

Summarize 的安装过程相对简单，主要分为三个步骤。

3.1 安装 Summarize CLI

使用 Homebrew 安装（macOS/Linux）：

brew install steipete/tap/summarize 

 

这会从作者的 Homebrew tap 安装 summarize 命令行工具。

3.2 配置 API Keys

Summarize CLI 支持多个 AI 模型提供商，你需要配置至少一个 API Key：

OpenAI（GPT 系列）

OPENAI_API_KEY="your-openai-api-key" 

 

Anthropic（Claude 系列）

ANTHROPIC_API_KEY="your-anthropic-api-key" 

 

xAI（Grok 系列）

XAI_API_KEY="your-xai-api-key" 

 

Google（Gemini 系列）

GEMINI_API_KEY="your-gemini-api-key" 

 

OpenRouter 系列

OPENROUTER_API_KEY="your-openrouter-api-key" 

 

注：

如果为了体验或免费日常使用，可以直接使用 OpenRouter，注册后，选择免费的模型即可使用。

如 ~/.summarize/config.json 配置：

{ 

  "model": "openrouter/arcee-ai/trinity-large-preview:free", 

  "env": { 

    "OPENROUTER_API_KEY": "your-openrouter-api-key" 

  }, 

  "models": { 

    "free": { 

      "rules": [ 

        { 

          "candidates": [ 

            "openrouter/arcee-ai/trinity-large-preview:free" 

          ] 

        } 

      ] 

    } 

  } 

} 

 

3.3 可选服务配置

为了应对一些特殊场景，Summarize CLI 还支持两个可选服务：

Firecrawl（用于被屏蔽的网站）

某些网站会屏蔽爬虫访问，这时可以使用 Firecrawl 作为后备方案：

export FIRECRAWL_API_KEY="your-firecrawl-key" 

summarize "https://blocked-site.com" --firecrawl auto 

 

Apify（YouTube 视频后备方案）

当 YouTube 视频无法直接提取时，可以使用 Apify：

export APIFY_API_TOKEN="your-apify-token" 

summarize "https://youtu.be/xxx" --youtube auto 

 

3.4 创建配置文件（可选）

如果你有常用的模型偏好，可以创建配置文件 ~/.summarize/config.json：

{ 

  "model": "openai/gpt-5.2", 

  "length": "medium" 

} 

 

这样每次使用时就不需要重复指定参数了。

3.5 安装 AI Skill

如果你使用支持 Claw Skills 的 AI Agent（如 Cursor、Windsurf 等），可以直接安装 Skill:

1. 访问 clawhub.ai/steipete/su...
2. 下载 Skill 文件
3. 将 Skill 文件放入 Agent skills 目录

安装后，AI 就能理解你的自然语言指令，自动调用 summarize 命令。

---

四、核心功能与参数

虽然实际使用中，我们通过自然语言发送指令，但进一步了解 Summarize CLI 参数，可以让我们知道其深层次有哪些功能，从而反向指引我们自然语言指令的描述。

4.1 基础用法

# 总结网页 

summarize "https://example.com" 

 

# 总结本地文件 

summarize "/path/to/document.pdf" 

 

# 总结 YouTube 视频 

summarize "https://youtu.be/video-id" 

 

4.2 控制摘要长度

通过 --length 参数控制输出详细程度：

# 预设长度级别 

summarize "url" --length short      # 简短摘要 

summarize "url" --length medium     # 中等长度（默认） 

summarize "url" --length long       # 详细摘要 

summarize "url" --length xl         # 超长摘要 

summarize "url" --length xxl        # 极详细摘要 

 

# 自定义字符数 

summarize "url" --length 500        # 约 500 字符 

 

4.3 选择 AI 模型

# 使用 OpenAI GPT 

summarize "url" --model openai/gpt-5.2 

 

# 使用 Anthropic Claude 

summarize "url" --model anthropic/claude-4-opus 

 

# 使用 Google Gemini 

summarize "url" --model google/gemini-3-flash-preview 

 

# 使用 xAI Grok 

summarize "url" --model xai/grok-3 

 

4.4 高级选项

仅提取内容，不总结

summarize "url" --extract-only 

 

这在你只需要获取干净的文本内容时很有用。

机器可读的 JSON 输出

summarize "url" --json 

 

适合用于自动化脚本或进一步的数据处理。

限制输出 Token 数量

summarize "url" --max-output-tokens 1000 

 

精确控制 AI 生成的内容长度，避免超出预算。

---

五、实战应用场景

Summarize CLI 的进一步放大的价值，在于与 AI Agent 结合，构建自动化工作流。

场景一：技术文章速读助手

作为开发者，每天要阅读大量技术博客和文档。通过 AI Agent + Summarize，可以实现：

用户："总结 Hacker News 首页前 10 篇文章" 

 

AI 执行流程： 

1. 爬取 Hacker News 首页链接 

2. 对每篇文章调用 summarize 

3. 汇总生成一份综合报告 

4. 保存到笔记系统 

 

这个流程可以每天自动运行，让你在早晨查看昨日技术圈的精华内容。

适合人群：技术开发者、产品经理、技术博主

场景二：学术论文研究助手

研究人员需要快速筛选大量论文，找到相关研究：

用户："总结这 20 篇 AI 论文的核心观点，找出与强化学习相关的" 

 

AI 执行流程： 

1. 批量调用 summarize 处理 PDF 文件 

2. 提取每篇论文的研究方法、结论 

3. 筛选出与强化学习相关的论文 

4. 生成对比表格和研究综述 

 

适合人群：科研人员、研究生、学术工作者

场景三：视频课程笔记生成器

在线学习时，可以自动生成课程笔记：

用户："总结这个 YouTube 播放列表的所有视频" 

 

AI 执行流程： 

1. 获取播放列表中的所有视频链接 

2. 逐个调用 summarize --youtube auto 

3. 按章节组织内容 

4. 生成结构化的学习笔记 

5. 导出为 Markdown 或 PDF 

 

适合人群：在线学习者、培训师、知识工作者

场景四：竞品分析自动化

产品经理可以用它来追踪竞品动态：

用户："每周总结竞品 A、B、C 官网的更新内容" 

 

AI 执行流程： 

1. 定期访问竞品网站 

2. 调用 summarize 提取内容 

3. 与上周内容对比，识别变化 

4. 生成竞品动态周报 

5. 发送到团队协作平台 

 

适合人群：产品经理、市场分析师、运营人员

场景五：个人知识库构建

将碎片化的阅读转化为结构化知识：

用户："把我这周收藏的 50 篇文章都总结一下，按主题分类" 

 

AI 执行流程： 

1. 从浏览器书签或稍后读服务获取链接 

2. 批量调用 summarize 

3. 使用 AI 进行主题聚类 

4. 生成知识图谱 

5. 保存到个人知识库 

 

适合人群：终身学习者、内容创作者、知识管理爱好者

---

六、核心技术原理

要理解 Summarize CLI 的工作机制，我们需要从三个层面来分析：内容提取、AI 处理，以及 Skill 集成。

6.1 内容提取架构

Summarize CLI 的第一步是从不同来源提取内容，这是整个系统的基础。

网页内容提取

对于普通网页，Summarize 采用多层次提取策略：

1. 直接抓取：使用 HTTP 客户端获取 HTML 内容
2. 智能解析：识别并提取正文内容，过滤广告、导航栏等噪音
3. Markdown 转换：将 HTML 结构转换为干净的 Markdown 格式

这个过程类似于 Readability 算法，但针对 AI 处理做了优化。

反爬虫应对机制

现代网站常用 JavaScript 渲染和反爬虫技术，Summarize 的应对策略是：

• 主策略：尝试直接提取静态 HTML
• 后备方案：当检测到反爬虫时，自动切换到 Firecrawl 服务
• 用户控制 ：通过 --firecrawl 参数可以强制使用或禁用

Firecrawl 是一个专门的网页提取服务，它使用浏览器自动化技术，能够处理复杂的 JavaScript 渲染场景。

PDF 文档处理

PDF 文件的处理涉及：

1. 文本提取：使用 PDF 解析库提取文本内容
2. 布局识别：识别标题、段落、列表等结构
3. 图表处理：对于包含图表的 PDF，可以提取图像并通过视觉模型分析

多媒体内容处理

对于音频和视频：

• 音频：使用语音识别（Speech-to-Text）转录为文字
• 视频：提取音轨进行转录，或使用视频理解模型直接分析
• YouTube 特殊处理：优先尝试获取字幕文件，失败时使用 Apify 服务进行转录

6.2 AI 模型调用机制

提取内容后，Summarize 将其发送给 AI 模型进行总结。

统一的模型接口

Summarize CLI 支持多个 AI 提供商，但对外提供统一的接口。这是通过适配器模式实现的：

用户命令 → 模型路由器 → 提供商适配器 → API 调用 

当你指定 --model openai/gpt-5.2 时：

1. 模型解析 ：将 openai/gpt-5.2 解析为提供商（openai）和模型名（gpt-5.2）
2. API Key 查找 ：自动查找 OPENAI_API_KEY 环境变量
3. 请求构造：根据 OpenAI API 规范构造请求
4. 响应处理：统一处理返回结果

这种设计让你可以轻松切换不同的模型，而不需要修改使用方式。

智能 Prompt 工程

Summarize 的核心价值在于它的 Prompt 设计。根据不同的参数，它会动态调整发送给 AI 的指令：

长度控制的实现

--length short  → "请用 2-3 句话总结核心观点" 

--length medium → "请用 200-300 字总结主要内容，包括关键论点" 

--length long   → "请详细总结，包括背景、论点、论据和结论，约 500-800 字" 

 

内容类型适配

Summarize 会根据内容类型调整 Prompt：

• 技术文档："重点提取技术细节、API 用法、代码示例"
• 新闻文章："提取 5W1H（谁、什么、何时、何地、为何、如何）"
• 学术论文："总结研究问题、方法、实验结果、结论和贡献"
• 视频内容："按时间线组织，提取关键观点和演示内容"

Token 优化策略

对于超长内容，Summarize 采用分块处理：

1. 内容分割：将长文本按语义边界分成多个块
2. 并行总结：对每个块独立生成摘要
3. 层级合并：将各块摘要再次总结，生成最终结果

这种方法既能处理任意长度的内容，又能控制 API 成本。

6.3 Skill 集成原理

Summarize 作为一个 Claw Skill，能够被 AI Agent 理解和调用。

SKILL.md 的作用

Skill 文件本质上是一个"使用说明书"，它告诉 AI：

## Summarize 

 

Fast CLI to summarize URLs, local files, and YouTube links. 

 

## Quick start 

summarize "https://example.com" --model google/gemini-3-flash-preview 

 

## Useful flags 

- --length short|medium|long 

- --max-output-tokens <count> 

- --extract-only 

- --json 

</count> 

 

这个文件包含：

1. 功能描述：AI 理解这个工具是干什么的
2. 使用示例：AI 学习如何构造正确的命令
3. 参数说明：AI 知道有哪些可选项
4. 最佳实践：AI 了解在什么场景下使用什么参数

AI Agent 的调用流程

当用户说"总结这篇文章"时，AI Agent 的决策过程是：

1. 意图识别：理解用户想要"内容总结"
2. 工具匹配：在已安装的 Skills 中找到 summarize
3. 参数推理：
4. • 从用户消息中提取 URL 或文件路径
   • 根据上下文推断合适的 --length 参数
   • 选择合适的模型（考虑成本和速度）
5. 命令构造：生成完整的 CLI 命令
6. 执行与解析：运行命令并将结果转换为自然语言

多步骤工作流编排

更强大的是，AI 可以将 summarize 与其他工具组合：

用户："总结这 10 篇文章，找出共同主题，生成思维导图" 

 

AI 执行流程： 

1. [summarize] 对每篇文章生成摘要 

2. [AI 内部] 分析摘要，提取共同主题 

3. [AI 内部] 识别主题间的关系 

4. [其他工具] 调用思维导图生成工具 

5. [AI 内部] 将结果整合并呈现 

 

这个过程中，AI 需要：

• 理解每个工具的能力边界
• 决定调用顺序和数据传递
• 处理中间结果的格式转换
• 应对可能的错误和异常

6.4 安全性与隐私考虑

使用 Summarize CLI 时，有几个安全要点需要注意：

数据流向

本地文件/URL → Summarize CLI → AI 提供商 API 

                              ↓ 

                         可选：Firecrawl/Apify 

 

这意味着：

1. 内容会离开本地：你总结的内容会发送到 AI 提供商的服务器
2. API Key 安全：妥善保管你的 API Keys，不要泄露到公共代码仓库
3. 敏感信息：不要用它处理包含敏感信息的文档（如公司机密、个人隐私）

可选服务的权衡

• Firecrawl：当使用时，目标网站的 URL 会发送到 Firecrawl 服务
• Apify：YouTube 视频链接会发送到 Apify 进行处理

如果你对隐私特别敏感，可以：

• 使用 --firecrawl off 禁用 Firecrawl
• 不配置 APIFY_API_TOKEN，只处理有公开字幕的视频
• 选择自建的 AI 模型（如本地运行的 Ollama）

Homebrew Tap 的信任

Summarize 通过第三方 Homebrew tap 安装（steipete/tap），这意味着：

• 你需要信任作者 Peter Steinberger（ @steipete）
• 建议在安装前查看 GitHub 仓库的源代码
• ClawHub 提供了 VirusTotal 扫描报告，显示为"Benign"（良性）

---

七、与其他方案的对比

在内容总结领域，还有其他一些工具和方案，我们来做个对比。

7.1 浏览器插件方案

代表产品：各种 "Summarize" 浏览器扩展

优势：

• 使用方便，点击即可总结当前页面
• 无需命令行知识

劣势：

• 只能处理网页，不支持本地文件
• 无法批量处理
• 难以集成到自动化工作流
• 通常功能单一，缺乏高级参数

Summarize 的优势：可以处理任意文件类型，支持批量操作，可编程可自动化。

7.2 在线服务方案

代表产品：各种在线 PDF 总结、视频总结网站

优势：

• 无需安装，即开即用
• 通常有友好的图形界面

劣势：

• 需要上传文件，隐私风险高
• 通常有文件大小和数量限制
• 无法本地化部署
• 难以集成到现有工作流

Summarize 的优势：数据在本地处理（除了发送到你选择的 AI 提供商），无文件限制，完全可控。

7.3 AI Agent 原生能力

代表产品：ChatGPT、Claude 的网页总结功能

优势：

• 无需额外工具
• 与对话界面深度集成

劣势：

• 通常需要手动复制粘贴内容，或发送链接
• 对长文档支持有限
• 无法处理本地文件（除非上传）
• 缺乏专门优化的提取和处理流程
• YouTube 视频，没法直接提取字幕或摘要。

Summarize 的优势：专门优化的内容提取，支持多种格式，可以处理超长文档，以及直接提取 YouTube 视频字幕或摘要。

7.4 综合对比

特性	Summarize	浏览器插件	在线服务	AI Agent 原生
支持文件类型	网页、PDF、音视频	仅网页	部分类型	需手动输入
批量处理	✓	✗	部分支持	✗
本地文件	✓	✗	需上传	需上传
自动化集成	✓	困难	API 收费	困难
隐私控制	高	中	低	中
模型选择	多种	固定	固定	固定
成本控制	精确	订阅制	订阅制	订阅制

---

八、结语

从浏览器插件到在线服务，再到如今的 CLI + AI Agent 模式，内容总结工具的进化反映了一个趋势：工具正在从孤立的应用变成可编程的能力模块。

Summarize CLI 的价值不仅在于它能总结内容，更在于它提供了一个标准化的接口，让 AI Agent 能够理解和调用。这种设计理念与我们之前介绍的 Google Workspace CLI 如出一辙------都是在构建"AI 可操作"的能力层。

当越来越多的工具采用这种模式，我们将看到：

• 人 → AI → 工具的交互范式成为主流
• 复杂的多步骤工作流可以用自然语言描述和执行
• 个人和团队的生产力将迎来新的跃升

如果你也深受信息过载困扰，不妨试试 Summarize。