这个项目能做什么

by2kb 是一个开源工具,旨在将视频内容转换为结构化、持久的知识库工件。其主要功能是接收视频 URL(目前支持 Bilibili 和 YouTube)或本地媒体文件,并生成三种特定的 Markdown 输出:保留证据的原始转录文本、用于快速评估的简短摘要,以及长篇学习笔记。 该工具采用“代理优先”架构,意味着它优化了与 AI 代理(如 Hermes)的配合使用,这些代理可以利用自己的模型认证来处理媒体检索和摘要生成。然而,它也支持通过 OpenAI 兼容的 API 密钥进行独立使用。by2kb 处理媒体处理流程,包括获取音频、通过本地 faster-whisper 或云端提供商(如豆包)执行自动语音识别(ASR),以及规范化转录文本。 主要功能包括: 1. **成本高效流程:** 它首先尝试获取原生字幕(成本最低),然后回退到音频流提取和 ASR,最后在必要时进行完整媒体下载。 2. **关注点分离:** 它严格区分“原始”转录文本(证据)与“更新”或“摘要”输出(AI 生成的摘要),以防止幻觉或数据丢失。 3. **可定制技能:** 用户可以定义可重用的基于 Markdown 的处理指令(技能),用于标点清理、章节检测或特定摘要格式等任务。 4. **集成:** 它与 IM 机器人(通过 Hermes 插件)和本地知识库(如 Obsidian 或文件系统)集成。 by2kb 需要 Python 3.12+、pipx 和 ffmpeg。它适合希望归档和研究视频内容而不依赖浏览器扩展或纯云服务的用户,强调本地控制和可移植的 Markdown 工件。