一、简介

summarize 是一个支持多种内容源的智能摘要工具，通过单条命令即可完成对网页、视频、PDF 等内容的总结或转录。

• • https://skills.sh/steipete/clawdis/summarize
• • https://github.com/steipete/clawdis

核心能力

• • 多源支持：URL、YouTube 视频、PDF、本地文件
• • 多模型兼容：OpenAI、Anthropic、xAI、Google Gemini
• • 长度可控：支持 short 、medium到 long 等多档输出长度
• • 格式灵活：支持纯文本与 JSON 两种输出
• • 兜底方案：内置 Firecrawl / Apify 回退机制，处理被屏蔽或难解析的内容
• • YouTube 转录：尽力提取视频字幕文本

触发短语

summarize this URL/article

二、安装

2.1 GitHub自动安装

可能会出现 Failed to clone repository，如果失败使用手动方式安装。

# 安装
npx skills add https://github.com/steipete/clawdis --skill summarize

2.2 手动方式安装

先手动clone下来仓库，再安装。

# 1. 用镜像 clone
git clone https://github.com/steipete/clawdis.git

# 2. 用本地路径安装
npx skills add ./clawdis --skill summarize

三、配置大模型

3.1 环境变量方式

根据你想使用的模型提供商，设置对应的环境变量：

示例（macOS / Linux）：

export GEMINI_API_KEY="your-api-key-here"

示例（Windows PowerShell）：

$env:GEMINI_API_KEY = "your-api-key-here"

如需持久化，可写入 ~/.bashrc、~/.zshrc 或系统环境变量。

3.2 配置文件方式

可在用户主目录下创建配置文件以避免每次重复指定参数：路径：~/.summarize/config.json

1. 最简配置（仅指定模型）

{"model":"openai/gpt-5.2"}

配置后再次执行 summarize 命令时，将默认使用此模型。

2. 自定义 baseUrl（指向代理 / 兼容端点）

当你需要走代理、私有网关或使用 OpenAI 兼容协议（如 OneAPI、本地部署的 Ollama、Azure OpenAI 等）时，可在配置中指定 baseUrl 与 apiKey：

{
"model":"openai/gpt-5.2",
"providers":{
"openai":{
"baseUrl":"https://your-proxy.example.com/v1",
"apiKey":"sk-xxxxxxxxxxxxxxxx"
}
}
}

关键字段说明：

3.3 多提供商示例

可同时配置多个提供商，运行时通过 --model <provider>/<model> 切换：

{
"model":"openai/gpt-5.2",
"providers":{
"openai":{
"baseUrl":"https://api.openai-proxy.com/v1",
"apiKey":"secretref-env:OPENAI_API_KEY"
},
"anthropic":{
"baseUrl":"https://api.anthropic-proxy.com",
"apiKey":"secretref-env:ANTHROPIC_API_KEY"
},
"google":{
"baseUrl":"https://generativelanguage.googleapis.com",
"apiKey":"secretref-env:GEMINI_API_KEY"
}
}
}

3.4 使用环境变量覆盖 baseUrl

如不想把 URL 写死在配置里，也可以通过环境变量覆盖：

# OpenAI 兼容端点（macOS / Linux）
export OPENAI_BASE_URL="https://your-proxy.example.com/v1"
export OPENAI_API_KEY="sk-xxxxxxxx"

# Windows PowerShell
$env:OPENAI_BASE_URL = "https://your-proxy.example.com/v1"
$env:OPENAI_API_KEY  = "sk-xxxxxxxx"

四、使用场景

常用参数

总结一个网页

# 输出短摘要
summarize "https://blog.csdn.net/vbirdbest/article/details/159315710" --length short
# 输出中等长度摘要
summarize "https://example.com/article" --length medium
# 输出长摘要
summarize "https://example.com/article" --length long

# JSON 格式输出，便于二次处理
summarize "https://example.com/article" --json > result.json

总结一个本地 PDF

# 可以使用 --model指定模型
summarize "https://www.cnnic.net.cn/NMediaFile/2024/0911/MAIN1726017626560DHICKVFSM6.pdf" --model google/gemini-3-flash-preview

提取视频转录文本

summarize "https://www.youtube.com/watch?v=t8YD27LZkiQ&list=PLQqbdnAgoRmZGKpEYTew9llwAjkP6wNLr" --youtube auto
# 仅提取视频转录文本（不做摘要）
summarize "https://youtu.be/dQw4w9WgXcQ" --youtube auto --extract-only