bilibili-transcribe

中文 · English

🧰 Chubby Skills

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

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

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

这是什么

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

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

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

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

平台可用性速览

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

快速开始

建议使用 Python 3.11 或 3.12，macOS / Linux shell。下面用一份示例 Markdown 跑通「导入 → 搜索 → 资料包」，无需安装第三方 Python 包、配置 API Key 或下载模型。

1. 获取项目并配置知识库

git clone https://github.com/chubbyguan/chubbyskills.git
cd chubbyskills
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -e .   # 可选：获得 chubby 命令，等价于 python3 tools/chubby.py
python3 tools/chubby.py init --vault "$PWD/creator-vault"

init 会创建 chubby.yaml 和知识库目录。下面的命令在仓库根目录运行，沿用这份配置。已有知识库可将 --vault 换成它的根目录；已有配置的调整见创作者工作流。

2. 导入一份文档

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

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

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

将示例路径换成自己的 .md、.markdown 或 .txt 文件即可导入真实材料。已知原始网页时，加 --source-url "原始网页地址"；本地文件默认记录文件 URI。

3. 搜索并导出资料包

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

你会得到：

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

打开资料包核对引用，然后交给 Agent 整理选题。brief 在本地导出证据，不调用云模型，也不判断原文观点是否正确。上面的演示材料是人工样例；平台采集需要下一节对应的依赖。

再次导出时请换一个输出文件名；确认要替换已生成的资料包后再加 --force。

处理你的素材

平台链接

按所需能力安装运行依赖。以 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 目录选择平台，并按下表补依赖：

平台抓取受 Cookie、字幕、地区和页面变化影响。失败时查看平台状态和替代处理方式，也可以保存正文后走本地导入。支持范围与最近的实测结果分开记录，见真实平台验证。

本地文档与 PDF

python3 tools/chubby.py import "/你的资料目录/report.md" --no-enrich
python3 tools/chubby.py import "/你的资料目录/report.pdf" \
  --source-url "https://example.org/original-report" --no-enrich

导入器保留原文件，把文档引用的目录内附件复制到产物旁；缺失或越界的本地附件会报错。PDF 只提取文字层，不做 OCR；扫描件需先由其他工具识别。详见文档导入。

播客与可选云转录

默认在本地转录音频：

python3 tools/chubby.py ingest "/你的音频目录/episode.mp3" \
  --skill podcast --provider local --no-enrich

v0.13.0 新增 Atlas Cloud / MuAPI 实验后端。需要主动选择 provider 并配置对应凭据；云服务会接收音频并可能计费。任务 ID 和完成结果持久保存，轮询失败或进程中断后可恢复；--resubmit 会明确创建新任务，可能再次计费。

播客自动下载仅接受公网 HTTP(S) 直连地址，不跟随重定向，也不使用代理。需要跳转或代理的资源，先自行下载，再传本地文件。配置和恢复方法见云转录说明。云服务的真实转录尚未完成验收。

重复采集、批量与重试

相同来源、处理参数和目的地的有效产物会复用；原文件或引用附件变化后会重新导入。--refresh 重新处理并保留旧版本。

把链接逐行放入 inbox/links.txt，再运行：

python3 tools/chubby.py run --queue inbox/links.txt --no-enrich
python3 tools/chubby.py status --failed
python3 tools/chubby.py retry --all-failed

采集入库后和统一查询前，索引会增量同步。更多例子见创作者工作流；已有索引的迁移和重建见知识库自动化。

订阅 YouTube、播客和 RSS

P0 将订阅扫描和媒体处理拆开：首次同步只建立已见基线，新条目先进入待审队列；确认来源质量后，可对该来源开启 auto_ingest，让 YouTube / 播客复用现有字幕优先和转录路径。

python3 tools/chubby.py subscribe init
python3 tools/chubby.py subscribe add \
  --id yt-3blue1brown --name "3Blue1Brown" \
  --kind youtube_channel --channel-id UCYO_jab_esuFRV4b17AJtAw \
  --content-profile video --mode discover_only
python3 tools/chubby.py subscribe sync --all    # 首次只建立基线
python3 tools/chubby.py subscribe pending

定时运行使用 python3 tools/chubby.py subscribe tick --due --process-limit 3，交给 macOS launchd 或 Linux cron 每小时触发。支持用户自带 RSSHub、RSS-Bridge 或其它 Provider 的最终公开 Feed；该标签不会启用平台抓取、认证或代理。X、小红书、抖音、B站、公众号账号扫描尚未支持。完整命令、调度、Provider 边界和失败恢复见订阅与调度，真实兼容性标准见Provider 7 天验收。

安装到 Agent

按需安装技能

在完整仓库根目录运行。以 Codex 为例，安装知识库技能：

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

查看技能列表；如果选择全部安装，用 --all 替代上面的单技能安装，并指定一个没有同名技能的目标目录：

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

Claude Code、OpenCode、OpenClaw、Hermes 等客户端使用各自实际配置的 skills 目录作为 --dest，并按客户端方式启用技能。运行环境中的 Python 和系统依赖仍需另外配置。

安装器会打包仓库内依赖，生成可独立搬移的技能目录；setup.sh 负责安装运行依赖。已有同名技能时安装器会拒绝覆盖，升级时先安装到临时目录核对自己的修改。请使用安装器或 Release 技能包，避免只下载单个源码目录漏掉公共模块。完整安装指南

首页的 tools/chubby.py 统一流程需要完整仓库。独立知识库技能使用其自带的 tools/import_document.py、tools/vault_index.py 和 tools/evidence_brief.py，命令见文档导入。

通过 MCP 连接知识库

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

MCP 提供搜索、语义检索、读取原文、最近笔记、重新索引和统计共 6 个工具。上面的命令用临时知识库检查真实服务启动和交互；连接自己的 Agent 时，还需配置服务器命令与 VAULT_DIR。见 MCP 配置。

Skill 目录