中文 · English

🧰 Chubby Skills

信息流会忘，知识库会记，Agent 会用。

把视频、播客、文章和本地文档保存为 Markdown，整理成能搜索、能回查来源、能交给 Agent 使用的素材库。

快速开始 · 安装到 Agent · Skill 目录 · 文档 · 更新日志

这是什么

Chubby Skills 是一套面向内容创作者和个人知识库的 14 个 Agent Skills 与命令行工具。你可以按需安装技能，让 Agent 处理素材；也可以直接运行命令，把采集、入库、搜索和资料包导出串起来。

适合经常收藏视频、文章和播客，希望在写作时找到原文、核对出处的人。产物保存在本地 Markdown 文件中，可以用 Obsidian、文本编辑器或你的 Agent 继续处理。

链接 / 本地文档 → Markdown 原文与附件 → 本地搜索 → 带出处的资料包 → Agent 整理选题

你想做什么	项目提供什么
保存平台素材	视频字幕与转录、播客转录、文章和图文采集
导入已有资料	Markdown、TXT、PDF 文字层导入，保留来源和引用的本地附件
写作时找回证据	关键词搜索、可选语义检索、原文读取；采集入库后自动更新索引
整理一份选题资料	导出 Markdown / JSON 资料包，包含原文摘录、行号、来源和文件摘要
让 Agent 使用知识库	独立技能包，以及提供搜索、原文读取等工具的可选 MCP 服务
持续跟踪可靠来源	订阅公开 RSS / Atom / JSON Feed、YouTube 频道与用户自带 Provider 输出；发现、审核、转录与入库分离

先看输出样例，或直接运行下面的本地示例。

平台可用性速览

声明能力（非实时探测），最近逐平台实测见真实平台验证，完整失败模式见平台状态：

平台	状态	轻量路径
B站 / YouTube	稳定	字幕优先，仅需 yt-dlp
公众号	测试	HTML 需 beautifulsoup4，PDF 兜底
抖音 / TikTok / 微博 / 知乎	测试·重依赖	视频转录需 funasr + ffmpeg
播客	重依赖	funasr（SenseVoice-Small），可选 DashScope / Groq 云转录
X / 小红书	手动兜底	零依赖采集正文；X 长文章可配 X_COOKIES 抓登录态全文，失败可手动补全文。凭据怎么拿、上次是否成功：chubby doctor --credentials
RSS / YouTube 频道订阅	P0 + P1	公开 Feed；支持 RSSHub / RSS-Bridge BYO 标签，默认只发现
本地文档	稳定	零依赖，Markdown/TXT/PDF 文字层

本项目不做反爬对抗，选择轻量接口加手动兜底，原因与适用边界见为什么不对抗风控。

快速开始

核心链路只用 Python 标准库：不装第三方包、不配 API Key、不下载模型。需要 Python 3.11 及以上——先 python3 --version 确认一下：macOS 自带的是 3.9，核心命令能跑，但 subscribe 订阅链路会在导入时失败，建议 brew install python@3.12 或直接用下面的 venv 步骤。

60 秒跑通（一）：抓一条真实链接

X 推文和小红书图文都走 Python 标准库，不需要 yt-dlp、ffmpeg 或任何模型（逐平台能力与失败模式见平台状态）：

git clone https://github.com/chubbyguan/chubbyskills.git
cd chubbyskills
python3 tools/chubby.py init --vault "$PWD/creator-vault"
python3 tools/chubby.py ingest "https://x.com/OpenAI/status/1663696190960173056" --no-enrich
python3 tools/chubby.py search "ChatGPT"

✅ 已写入配置：/path/to/chubbyskills/chubby.yaml
✅ 已准备队列：/path/to/chubbyskills/inbox/links.txt
✅ 已准备状态：/path/to/chubbyskills/.chubby/runs.jsonl
✅ 已准备报告目录：/path/to/chubbyskills/runs

✅ 完成：success=1 / failed=0 / dry_run=0
🧾 报告：/path/to/chubbyskills/runs/2026-10-05.md
/path/to/chubbyskills/creator-vault/00_Inbox/The-ChatGPT-iOS-app-is-now-available-in---<来源哈希>.md

The ChatGPT iOS app is now available in
  00_Inbox/The-ChatGPT-iOS-app-is-now-available-in---<来源哈希>.md
  # The ChatGPT iOS app is now available in   > 👤 OpenAI @OpenAI | 👍 754 · 💬 115 …

抓下来的笔记自带来源、作者、时间和互动数，引用时能回查到原帖：

title: "The ChatGPT iOS app is now available in "
platform: x
source: "https://x.com/OpenAI/status/1663696190960173056"
author: "OpenAI @OpenAI"
created: 2023-05-30
likes: 754

把链接换成你要存的任意推文或小红书图文即可。

平台采集会波动。 上面是一条样本，不构成成功率：没有登录态时可能被风控拦住，X 长文章默认只取到预览。失败时先看平台状态和替代处理方式，或保存正文后走下面这条。

60 秒跑通（二）：导入自己的文件

这条完全不碰外网，任何环境都能跑通。导入一份文档，再把它搜回来（把示例换成你自己的 .md、.markdown 或 .txt；已知原始网页时加 --source-url "原始网页地址"）：

mkdir -p demo-input
cat > demo-input/notes.md <<'NOTE'
# 内容复用笔记

内容复用从保留原文和来源开始。同一份材料可以用于选题、文章和播客，但引用前要重新核对上下文。
NOTE

python3 tools/chubby.py import demo-input/notes.md --no-enrich
python3 tools/chubby.py search "内容复用"

✅ 完成：success=1 / failed=0 / dry_run=0
🧾 报告：/path/to/chubbyskills/runs/2026-10-05.md
/path/to/chubbyskills/creator-vault/00_Inbox/内容复用笔记--<来源哈希>.md

内容复用笔记
  00_Inbox/内容复用笔记--<来源哈希>.md
  # 内容复用笔记  内容复用从保留原文和来源开始。同一份材料可以用于选题、文章和播客，但引用前要重新核对上下文。

最后导出带出处的资料包——这是这个项目真正产出的东西：

python3 tools/chubby.py brief --topic "内容复用" \
  --output "$PWD/creator-vault/30_Output/brief.md"

{
  "markdown": "/path/to/chubbyskills/creator-vault/30_Output/brief.md",
  "json": "/path/to/chubbyskills/creator-vault/30_Output/brief.json"
}

brief.md 里是逐字摘录、原文行号、来源链接和文件 SHA-256，可以直接回查（文件名后缀由来源路径推导，SHA-256 覆盖导入副本的内容与元数据，两者都会随你实际使用的路径和时间变化）：

## E1 · 内容复用笔记

笔记相对路径：`00_Inbox/内容复用笔记--c2f47ab83782202c.md`
原始来源：未提供可打开的网页链接。
采集时间：2026-10-05T10:54:57+08:00
文件 SHA-256：`<导入副本的内容哈希>`

原文第 22–22 行：

产物落在三处：

• creator-vault/00_Inbox/：带来源信息的 Markdown 和引用的本地附件。
• creator-vault/30_Output/brief.md 与 brief.json：资料包本体。
• .chubby/runs.jsonl 与 runs/：任务状态和运行报告，方便检查失败与重试。

brief 全程在本地完成，不调用云模型，也不判断原文观点是否正确；上面的演示材料是人工样例。再次导出请换一个文件名，确认要替换已生成的资料包后再加 --force。

可选：把 chubby 装成命令

上面用的是 python3 tools/chubby.py，不装也能跑。想要 chubby init 这种形式：

python3 -m venv .venv && source .venv/bin/activate
python3 -m pip install -e .   # 提供 chubby 命令，等价于 python3 tools/chubby.py

也可以装成普通包（pip install .，或 pipx install git+https://github.com/chubbyguan/chubbyskills.git）。非 editable 安装下，知识库命令全部可用——init / import / search / brief / index / doctor / subscribe（含 digest 与 site build），用户状态写在你当前所在目录，不会写进安装目录。

平台采集 ingest 同样可用：14 个 skill 目录随包一起安装（目录名 bilibili-transcribe 不是合法 Python 包名，构建时映射为 bilibili_transcribe，你不需要关心）。想把这些 skill 直接装进 Agent 而不是通过 CLI 调用，仍从仓库跑 tools/install_skill.py；两种方式互不影响。

已有知识库时把 --vault 换成它的根目录（例如 docs/quickstart.md 里的 $HOME/Documents/creator-vault）；已有配置的调整见创作者工作流。

处理你的素材

平台链接

按所需能力安装运行依赖。以 YouTube 字幕为例：

bash setup.sh light
python3 -m pip install yt-dlp
python3 tools/chubby.py doctor --platform youtube
python3 tools/chubby.py ingest "替换为你的真实链接" --no-enrich
python3 tools/chubby.py search "原文中的关键词"

light 检查 Python 并提示轻量路径，不安装字幕或转录依赖。B站和 YouTube 优先取字幕；没有字幕时需要视频转录依赖。查看 Skill 目录选择平台，并按下表补依赖：

处理路径	安装 / 配置
Markdown / TXT 导入、关键词检索、资料包	Python 标准库，无需额外包
X / 小红书图文	Python 标准库；bash setup.sh light 检查环境，登录态与平台限制仍可能影响采集
B站 / YouTube 字幕	python3 -m pip install yt-dlp
本地视频转录	`bash setup