夜雨聆风
🔒 隐私优先：这是一个本地运行、注重隐私的项目。所有数据都在你的电脑上处理，不会上传到任何云端服务器。
下面这张图展示了整个工具的工作流程：
💡 关于使用场景：本工具面向个人学习与知识管理场景，只帮你整理自己已经看到的公开内容，不涉及任何非公开数据的获取或传播。请尊重原创内容版权。
一句话概括：它是一个本地运行的 Obsidian 插件，可以把各平台的分享链接快速导入 Obsidian，自动生成结构化笔记。
复制分享链接 在 Obsidian 中打开插件界面（左侧边栏点击相机图标），粘贴链接
选择 「转写文稿」 模式
粘贴链接、选择模式，就可以转写视频文案和缓存素材，无需安装任何 Obsidian 插件。
前端的 Obsidian 插件（Douyin Capture）：负责调用后端 API，把生成好的内容写入 Obsidian 笔记库
后端的本地服务（obsidian-content-capture-backend）：负责实际的网络请求、素材处理、音频提取和 Whisper 转写
这个插件在设计之初就确定了一个基本原则——所有处理都在本地完成。
所有的语音转写工作都通过本地运行的 Faster-Whisper 来完成。这个模型是 OpenAI Whisper 的优化版本，使用 CTranslate2 重新实现，运行速度比原始 Whisper 有一定提升，同时内存占用更低。因为计算都在你的个人电脑上进行，所以不需要购买付费 API 服务，也不用担心隐私和数据泄露风险。
实际上，Faster-Whisper 在学术界也受到广泛认可。根据一项针对四种语音识别模型的定量比较，Faster-Whisper 在准确性和延迟方面均优于其他模型，是边缘设备部署的有力候选。它支持 int8 量化压缩、多线程 CPU 推理以及可选的 CUDA GPU 加速，足以在你的电脑上流畅运行绝大多数语音转写任务。
而且 Whisper 模型本身就较为优秀——它是 OpenAI 在 2022 年发布的多语言语音识别模型，对嘈杂音频和不同口音都具有较好的鲁棒性，经过 68 万小时的音频数据弱监督训练。Faster-Whisper 则是在保持接近原始模型精度的前提下，将推理速度提升了数倍，为本地实时语音处理提供了可行方案。
Douyin Capture 的一个关键区别在于两点：
本地化：前面说了，所有处理都在本地完成，本地 Faster-Whisper 转写，数据都在你自己的电脑上。在隐私和数据安全方面，这是云端方案难以比拟的优势。
专一而精：目前专注在内容平台的深度适配，功能清晰且界面简洁友好。同时提供 Obsidian 插件版和浏览器网页版两种使用方式，不管你是不是 Obsidian 重度用户，总能找到适合自己的玩法。
这两种用法相辅相成，互补但不冲突：
如果你已经在用 Obsidian 构建个人知识库 → 安装插件版，顺畅接入工作流
如果你只是想偶尔缓存个视频素材 → 打开浏览器 Web 页面就行，轻量又方便
obsidian-content-capture-backend 是整个工具运行的基础服务。安装流程清晰，你可以按照以下步骤完成：
Python 3.10 或更高版本
FFmpeg
macOS：
brew install ffmpegUbuntu/Debian：
sudo apt install ffmpegWindows：从 ffmpeg.org 官网下载并添加到环境变量
Git 客户端（用于克隆代码库）
⚠️ 首次使用注意：第一次运行 Whisper 转写时，系统会自动下载模型文件（约 1-2 分钟），这是正常现象。模型会缓存在本地，之后离线也能正常使用。
打开 Obsidian
复制分享链接 在 Obsidian 左侧边栏点击相机图标，粘贴链接到输入框 根据需要选择导入模式：
选择「转写文稿」 → 缓存素材 + 本地 Whisper 转写 + 生成完整笔记
选择「缓存视频」 → 仅缓存素材，不进行转写
Web 界面同样支持复制链接、选择模型（tiny/base/small）、选择处理模式，无需安装 Obsidian 插件就可以直接转写视频文案和缓存素材。适合临时使用或不常使用 Obsidian 的场景。
运行起来后，数据的流向在个人电脑闭环，没有信息会被上传到外部服务器。这正是本地优先架构在数据安全和隐私保护层面的核心优势——你的笔记内容、保存的视频素材、转写的文案，都存储在本地硬盘中，由用户掌控。
插件默认使用 small 级别的模型，在准确度和速度之间提供了不错的平衡。你可以在插件设置中根据需要调整 Whisper 模型类型：
tiny | ||
base | ||
small | 默认选项 | |
medium | ||
large-v2 |
small 模型通常已经足够好用了。
笔记文件夹：默认是 Douyin，你可以改成自己常用的目录Inbox/Douyin
附件文件夹：存放保存的视频和图片，默认为 attachments，建议单独设置，避免和笔记文件混在一起
嵌入视频：如果不想在笔记里直接嵌入播放器（预览大文件可能卡顿），可以关闭这个选项，笔记内只显示保存链接
创建后打开笔记：开启后导入完成自动打开新笔记，方便你立刻查看或编辑
✅本地运行，隐私友好——计算和数据都在你的个人电脑上处理,不依赖外部服务
✅开源项目，项目本身不收取费用
✅结构化输出，易于管理——自动生成标题、标签、YAML frontmatter
✅两种使用模式并行——既可以深度集成 Obsidian，也可以用浏览器快捷处理
✅容错机制——即使视频或部分图片保存失败，只要文案抓取成功，仍然会生成笔记并给出降级说明，不会因为个别环节失败而丢失内容
✅支持多种链接形式——兼容各平台的短链和完整链接，甚至直接粘贴整段分享文案，都可以正常处理 重要声明（请务必阅读）
仅限个人使用：本工具仅供个人学习和研究用途，请勿用于商业目的。
遵守平台条款：你提取和保存的内容版权归原作者所有，请遵守相关平台的用户协议，不要侵犯他人知识产权。
合理使用原则：建议仅保存你真正需要的内容，避免大量无意义的采集行为。
作者免责声明：作者不对因使用本工具产生的后果承担法律责任。请自行评估使用风险。
Obsidian 插件仓库：lyxdream/obsidian-douyin-capture
本地后端仓库：lyxdream/obsidian-content-capture-backend
如果你在使用过程中遇到任何问题，或者有改进建议，欢迎在 GitHub 上提交 Issue 或 PR。
欢迎给项目点个 Star ✨，让更多人看到。
