joeseesun/qiaomu-clipper

中文 | English 别让好文章和好视频，停在「收藏过」。 边读边问 AI，边看视频边记理解，把内容与想法存进 Obsidian。 Read, watch, ask AI, and turn what you learn into Obsidian notes. 安装并体验最新功能 · 看功能截图 · 快捷键 · 反馈问题 ¹ 写入今天日记需要安装本地助手并启用 Obsidian「日记」核心插件，详见学习笔记。 需要：Node.js 22+、npm、Chrome；保存笔记需要 Obsidian。 先试一条完整流程： 打开视频 → aaa → 点时间戳回看 → 按 N 写理解。只想读文章和复制字幕，无需配置 AI；写入日记需先装下方助手。 不想安装 Node.js？直接下载 1.14.4 已发布安装包 下载 Chrome ZIP，解压后在 chrome://extensions 开启「开发者模式」，点「加载已解压的扩展程序」选择解压目录。发布说明。装好后请刷新已打开的 YouTube 页面，字幕工具栏才会出现；请勿使用 1.10.0 及更早版本，它们没有视频字幕工具栏。装好后请刷新已打开的 B 站页面；B 站只给已登录账号提供字幕。 想静默写入笔记库，或把学习笔记追加到今天日记？ 安装可选的 本地助手：需要 Python 3.9+，支持 macOS / Linux 的 Chrome 系浏览器（Chrome / Edge / Brave / Arc 等），也提供 Windows 安装支持（尚待真机验证）。先装好扩展，再在仓库里运行（无需任何参数，自动识别扩展 ID 和 Obsidian 库）： TED 官方字幕优先：从 TED 页面直接读取官方文字稿及视频地址，默认原语言，优先使用官方 VTT 的逐句起止时间（含片头偏移）；原网页和学习页均可切换官方字幕语言。YouTube、B 站学习页也显示网站提供的字幕语言，切换保留播放进度；无官方字幕时才提供生成入口。TikTok 字幕条跟随当前视频，抖音优先插入右侧推荐列表上方，TED 插入播放器下方；窄窗口使用收起的备用入口。新位置仍需真实页面验收。 译文一起剪藏：翻译后 Transcript 标题右侧显示剪藏字幕选项「原文／译文／双语」，默认双语。保留时间戳、正文、模板属性和 AI 笔记；翻译未完成时保留未译原文，禁用「仅译文」。复制和下载跟随当前界面：显示中文译文时导出双语，关闭翻译时仅原文；剪藏及转到编辑页按字幕保存选项。翻译进度在字幕标题附近显示，完成反馈约 3 秒后淡出，失败保留重试入口。切换官方字幕语言会清除旧语言的翻译任务。模型返回不规范 JSON 时，仅对失败字幕组自动重试一次，保留已完成译文；仍失败时提供继续重试。 抖音提示 Fresh cookies 时：在学习页选择原视频所在的浏览器，点「使用浏览器状态重试」。不一定需要登录；本机工具读取该浏览器 Cookie 后重试。即使带 Cookie，抖音的下载解析仍可能失败，此时不能视为该站点已完整验证。 从商店 1.7.1 升级到 1.14.4 请同时更新本地助手：仅重载扩展不会更新助手。请使用 1.14.4 源码重新运行 python3 native/install.py（Windows 使用 python native\install.py），再刷新阅读页；旧助手可能导致 X 阅读页缺少帖子正文和视频播放器。 输出 "ok": true 即安装成功，然后在 chrome://extensions 重新加载扩展。遇到「本地保存助手未连接」，运行 python3 native/install.py --check 诊断。 让 AI agent 代装：把这句话发给 Claude Code /…