joeseesun/qiaomu-clipper

选用指南

AI 根据 README 整理 · 2026/10/16 20:06:47

适用场景

适合阅读文章、观看视频或收听播客时，将内容整理为 Obsidian 笔记，并利用 AI 提问和字幕翻译。

查看 README 依据

下载最新正式 release 的 -chrome-local.zip，解压并指导我加载扩展；同时安装对应版本的 helper：macOS 下载 qiaomu-clipper-helper.pkg 并指导我双击安装，其他系统按仓库文档安装。已有旧版先备份并保留数据，最后检查扩展与助手连接，指导我选择 Obsidian 笔记库。 ``` ## 你可以用它做什么 | 场景 | 操作 | 留下什么 | |---|---|---| | 读到一篇值得保存的文章 | `aaa` 阅读，划线、问 AI，`eee` 编辑后剪藏 | 整理好的 Markdown 笔记 | | 看课程或访谈，想回到某一句话 | 打开学习播放器，搜索字幕、点时间戳 | 可检索、可回看的文稿 | | 外语视频看得慢 | 翻译字幕，原文与中文对照 | 带时间戳的原文、译文或双语笔记 | | 播客或录音没有文字稿 | 选择本机或云端识别，生成字幕 | 随播放滚动的文字稿 | | 听到一句话，突然有了自己的理解 | 学习页按 `N`，任意网页按 `iii` | 带摘录、来源和时间点的日记记录 | | 保存时不想反复打开 Obsidian | 安装 helper，选好笔记库 | 直接写入指定库和文件夹 |

目标用户

面向使用 Obsidian 管理笔记的用户，以及需要处理音视频学习内容的用户。

查看 README 依据

<div align="center"> # 乔木剪藏 · Qiaomu Clipper **中文** | [English](#english) **读文章、看视频、听播客，把理解留下来。** 正文、播放器、字幕和 AI 对话放在一起，学习笔记直接存进 Obsidian。 Read, watch, listen, and turn what you learn into Obsidian notes. [安装指引](#快速开始) · [功能巡游](#功能巡游) · [快捷键](#三连击快捷键) · [反馈问题](https://github.com/joeseesun/qiaomu-clipper/issues) 

使用方式

通过 Chrome 扩展使用，支持快捷键操作，可安装本地助手以增强功能。

查看 README 依据

界面完整支持 **简体中文、繁體中文、English、日本語、한국어、Español、Français、Deutsch、Português do Brasil**，覆盖设置、弹窗、阅读与学习界面、字幕生成和本地助手提示。其他语言保留已有的部分翻译，新增功能回退到英文。更改界面语言后，请刷新已打开的媒体网页；音视频字幕仍优先匹配原语言。阅读、复制正文和已有字幕无需配置 AI；提问、翻译和云端识别使用你自己的服务与凭证。 ## 快速开始 ### 推荐：等 1.15.8 上架后，从商店安装 在[商店页面](https://chromewebstore.google.com/detail/jniolfihillilkoajpnonlbkhfkiicoo)确认版本已更新到 **1.15.8 或更高**，再安装。需要保存笔记时，请先安装 Obsidian 并创建或打开一个笔记库。 安装扩展后，打开文章或支持的视频、音频页面，在非输入框内连按三次 `A`。也可以点页面字幕栏的学习入口，或扩展弹窗里的「阅读」：文章进入阅读页，支持的媒体页面进入学习播放器。 ### 现在体验：让 Agent 安装 复制页面顶部的安装 prompt 给有本机终端权限的 Agent。它会按仓库文档下载插件和 helper；需要你完成的浏览器加载、安装器授权会给出具体指引。 <details>

日常测试默认使用商店版：`npm run build:store && npm run test:prepare`。固定加载 `~/Documents/乔木剪藏测试/extension`，以后只重新加载这个目录。测试独立版专属功能时运行 `npm run build:local && npm run test:prepare -- --edition local`，路径不变。请使用专用测试浏览器资料，详见 [开发与测试流程](docs/BUILD-TESTING.md)。 </details> ### 新 helper：macOS 双击安装，不用配 Python **helper 是可选的本地助手。** 不装助手也能阅读、编辑、复制或下载 Markdown；保存到 Obsidian 可使用 URI 方式。静默写入笔记库、追加学习日记和生成字幕需要助手。

部署要求

需要 Chrome 浏览器和 Obsidian；AI 功能需自备服务与凭证。

查看 README 依据

界面完整支持 **简体中文、繁體中文、English、日本語、한국어、Español、Français、Deutsch、Português do Brasil**，覆盖设置、弹窗、阅读与学习界面、字幕生成和本地助手提示。其他语言保留已有的部分翻译，新增功能回退到英文。更改界面语言后，请刷新已打开的媒体网页；音视频字幕仍优先匹配原语言。阅读、复制正文和已有字幕无需配置 AI；提问、翻译和云端识别使用你自己的服务与凭证。 ## 快速开始 ### 推荐：等 1.15.8 上架后，从商店安装 在[商店页面](https://chromewebstore.google.com/detail/jniolfihillilkoajpnonlbkhfkiicoo)确认版本已更新到 **1.15.8 或更高**，再安装。需要保存笔记时，请先安装 Obsidian 并创建或打开一个笔记库。 安装扩展后，打开文章或支持的视频、音频页面，在非输入框内连按三次 `A`。也可以点页面字幕栏的学习入口，或扩展弹窗里的「阅读」：文章进入阅读页，支持的媒体页面进入学习播放器。 ### 现在体验：让 Agent 安装 复制页面顶部的安装 prompt 给有本机终端权限的 Agent。它会按仓库文档下载插件和 helper；需要你完成的浏览器加载、安装器授权会给出具体指引。 <details>

已知限制

主要验收目标是 Chrome 与 macOS，Firefox/Safari 和 Windows 体验仍需验证；部分媒体功能依赖平台和网络。

查看 README 依据

| `aaa` | 文章阅读；支持的媒体页面进入学习播放器 | | `eee` | 整页编辑 | | `qqq` | 按默认模板直接剪藏 | | `iii` | 任意网页打开学习笔记卡片 | | `N`（阅读 / 学习页） | 打开学习笔记卡片 | | 选中文字 → 右键「保存到日记」 | 打开卡片并带入摘录 | 在非输入框内快速连按同一个键三次，相邻按键间隔不超过约 0.6 秒。三连击按键可自定义、留空关闭或按网站禁用；输入框和 Ctrl / Cmd / Alt / Shift 组合不会触发。浏览器内部页不允许扩展脚本。 ## 隐私与适用范围 - **RSS 分享默认关闭**。开启后内容会公开，请在保存私人页面前确认分享选项。 - AI 提问、字幕翻译与模板解读向你选择的服务商发送所需内容。云端语音识别上传音频；本机识别不上传识别音频。选择本地文件只会先交给本机助手，后续是否上传取决于你选择的识别方式。 - 对话历史、草稿与识别缓存保存在本机；部分设置、模板或凭证可使用浏览器同步。导出文件和迁移备份可能含凭证，请自行保管。 - 当前主要验收目标是 Chrome 与 macOS。Firefox / Safari 提供构建包，Windows helper 有自动测试；跨浏览器与 Windows 真机体验仍需验证。