chubbyguan/chubbyskills

Chubby Skills – 面向创作者的本地知识库工具包

它是什么

• 一个包含 14 个 Agent Skills 和命令行界面的集合，让您可以捕获视频、播客、文章和本地文档，将其转换为可搜索的 Markdown 文件，并导出代理可以消费的 基于证据 的材料包。
• 核心工作流程完全离线运行 – 除非您启用可选的转录或增强功能，否则不需要第三方包、API 密钥或模型下载。

关键能力

领域	您可以做什么
捕获	从 B 站/YouTube 获取字幕，转录 TikTok/抖音/微博/知乎视频，拉取 X/Twitter 帖子，抓取微信公众号文章，导入本地 Markdown/TXT/PDF（仅文本层）。
导入与索引	将所有内容转换为带有 front-matter（标题、来源 URL、作者、时间戳、点赞数等）的 Markdown，在本地存储附件，并构建可搜索索引（关键词 + 可选的语义精简版）。
搜索与检索	按关键词查找片段（如果您安装可选的向量存储，则支持语义搜索），查看原始行号、来源 URL 和用于验证的 SHA-256 哈希。
导出	生成 简报 – 一个 Markdown/JSON 包，包含精确摘录、其行号、来源元数据和哈希，可供 LLM 代理用于起草或选题。
订阅	设置 RSS/YouTube 频道或播客订阅，定期拉取新项目，将其排队等待摄取，并可选择生成每日摘要（无需 LLM，可选的 DeepSeek 摘要）。
代理集成	将知识库技能包安装到 Claude Code、OpenCode 等代理中，或运行一个提供搜索、检索和索引 API 的轻量级 MCP 服务器。

如何开始（快速运行）

1. 克隆仓库并初始化一个 vault：

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

2. 捕获一个公开的 X 帖子（无需额外依赖）：

   python3 tools/chubby.py ingest "https://x.com/OpenAI/status/1663696190960173056" --no-enrich
   python3 tools/chubby.py search "ChatGPT"
   

3. 导出一个带来源的简报：

   python3 tools/chubby.py brief --topic "ChatGPT" --output "$PWD/creator-vault/30_Output/brief.md"
   

   生成的 brief.md 包含精确摘录、其行号、原始 URL 和 SHA-256 哈希。

安装选项

• 零依赖 CLI – 克隆后直接运行 python3 tools/chubby.py …（Python 3.11+）。
• 可编辑包 – pip install -e . 为您提供 chubby 命令。
• 完整技能安装 – python3 tools/install_skill.py --all --dest /path/to/agent/skills 将 14 个技能目录复制到代理的技能文件夹中。
• 可选附加功能 – bash setup.sh light（仅检查 Python），bash setup.sh video（添加 ffmpeg 和本地转录模型），bash setup.sh podcast（添加 funasr），或安装 yt-dlp、pymupdf 等，如 平台能力 表中所述。

典型用例

• 内容创作者 需要保留个人素材档案（推文、YouTube 视频、播客），并带有完整的引用数据以供后续写作。
• 研究人员 / 知识工作者 构建本地证据库，可由 LLM 代理查询，而无需将原始内容发送到云端。
• 代理 需要可搜索的知识库 – MCP 服务器公开 search、read、index 和其他实用程序，以实现无缝集成。

限制与注意事项

• 平台抓取尊重网站的公共 API；它 不 绕过反抓取措施。某些网站可能只返回预览（例如，X 长文章），除非您提供有效的 cookies。
• 视频/音频转录依赖外部工具（ffmpeg、funasr、可选的 Qwen-ASR），首次运行时可能需要下载模型。
• 语义搜索和内容增强（摘要、标签）是可选的，需要 API 密钥（DeepSeek、OpenAI 等） – 它们不是核心离线流程的一部分。
• PDF 导入仅提取文本层；扫描的 PDF 需要事先进行 OCR。
• 该工具仅供个人、非商业用途。用户在存储和重用内容时必须尊重版权和平台条款。

了解更多

• 快速入门指南和详细文档位于 docs/ 文件夹下（安装、创作者工作流程、订阅、MCP 配置、平台回退等）。
• 示例输出位于 examples/README.md。
• 社区讨论、错误报告和功能请求位于仓库的 Discussions 和 Issues 部分。

---

Chubby Skills 弥合了原始互联网内容与结构化、富含引用的知识库之间的差距，该知识库可以直接提供给 AI 代理，同时将数据保留在您自己的机器上。