Chubby Skills：中文内容采集与个人知识库管理技能集

这是什么

Chubby Skills 是一套面向内容创作者和个人知识库的 14 个 Agent Skills 与命令行工具，由作者 chubbyguan 开发，采用 MIT 协议开源。它能把抖音、B站、小红书、公众号、X（Twitter）、播客等中文全渠道内容采集进个人知识库，统一转换为带来源信息的 Markdown 文件，方便搜索、回查和交给 Agent 使用。

项目核心理念是“信息流会忘，知识库会记，Agent 会用”。你收藏的视频、文章、播客，通过这套工具可以变成结构化的本地素材库，支持关键词搜索、原文逐字摘录、资料包导出，甚至可以通过 MCP 服务让 Claude Code、Codex 等 Agent 直接查询和引用。

适合谁

内容创作者：经常收集灵感素材，写作时需要引用原文和出处。
知识管理者：使用 Obsidian 等工具搭建“第二大脑”，希望自动化采集和整理。
AI Agent 使用者：想让 Claude Code、Codex 等 Agent 基于自己的知识库回答问题、整理选题。
播客爱好者：希望把播客转成文字稿，方便搜索和回顾。

能做什么

这套技能集覆盖了从采集到应用的完整流程：

平台素材保存：支持 B站、YouTube、抖音、TikTok、微博、知乎视频的字幕优先转录；小红书图文和视频、X 正文和图片、公众号文章和 PDF 的采集。
本地文档导入：Markdown、TXT、PDF 文字层导入，保留来源和引用的本地附件。
搜索与证据找回：关键词搜索、可选语义检索、原文读取；采集入库后自动更新索引。
资料包导出：生成 Markdown / JSON 资料包，包含原文摘录、行号、来源和文件摘要，方便写作时核对。
知识库管理：文档导入、索引、归档，以及可选的 MCP 服务，让 Agent 直接搜索和读取。
工作流自动化：行业情报雷达（多源扫描 X/即刻/V2EX/HN）、学习笔记自动化（转录→知识点→闪卡→知识图谱）。

使用前准备

建议使用 Python 3.11 或 3.12，macOS / Linux shell。
基础导入、搜索、资料包功能仅需 Python 标准库，无需额外安装包。
处理不同平台需要安装对应依赖，例如：
- B站 / YouTube 字幕：python3 -m pip install yt-dlp
- 本地视频转录：bash setup.sh video（需要系统 ffmpeg）
- 本地播客转录：bash setup.sh podcast（使用 faster-whisper）
- 公众号处理：bash setup.sh wechat
- 通用 PDF 导入：python3 -m pip install 'pymupdf>=1.24'
可选配置 API Key：DeepSeek（内容加工、翻译）、OpenAI（向量检索）、Atlas / MuAPI（云转录）等，按需启用。

安装方法

获取项目并初始化知识库：

git clone https://github.com/chubbyguan/chubbyskills.git
cd chubbyskills
python3 -m venv .venv
source .venv/bin/activate
python3 tools/chubby.py init --vault "$PWD/creator-vault"

安装到 Agent（以 Codex 为例）：

python3 tools/install_skill.py knowledge-base-management --dest ~/.codex/skills

查看技能列表或全部安装：

python3 tools/install_skill.py --list
python3 tools/install_skill.py --all --dest /path/to/agent/skills

通过 MCP 连接知识库：

python3 -m pip install -r knowledge-base-management/requirements-mcp.txt
python3 tools/mcp_smoke.py --json

使用示例

导入一份本地文档：

python3 tools/chubby.py import demo-input/notes.md --no-enrich

搜索并导出资料包：

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

处理平台链接（以 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 run --queue inbox/links.txt --no-enrich
python3 tools/chubby.py status --failed
python3 tools/chubby.py retry --all-failed

风险与注意事项

平台合规：采集类技能仅用于个人学习与研究，请遵守来源平台条款、robots.txt 和相关法律，不要用于批量抓取、商用爬取或二次分发。
数据隐私：素材默认保存在本地。但使用云服务（如 DeepSeek、OpenAI、Atlas/MuAPI）时，内容会发送至对应 API，请注意敏感信息，密钥和 Cookie 不要写入笔记或提交到仓库。
平台稳定性：平台抓取受 Cookie、字幕、地区和页面变化影响，可能失败。项目提供了平台状态文档和替代处理方式。
云转录计费：Atlas / MuAPI 为实验后端，需要主动选择 provider 并配置凭据，云服务可能计费；任务失败重试可能再次计费。
本地依赖：视频转录需要 ffmpeg 和本地模型，首次运行可能下载较大文件。
版权声明：原内容版权归原作者，引用与转载需取得授权并注明来源。代码采用 MIT 协议，但不授予第三方内容的使用权。