中文 · 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