常见问题
没找到答案，可以在 GitHub 上提问。
该装商店版还是独立版？
没有特殊需求装商店版：自动更新，权限用到时才申请。想比商店更早用到新版本，或想下载 YouTube 视频和音频文件，装 GitHub Release 里的 chrome-local.zip（手动更新，YouTube 下载还需要本地助手）。两个版本的扩展 ID 相同。
一定要装 Obsidian 吗？
不一定。阅读、编辑、复制正文、下载 Markdown 和看字幕都不需要。要把笔记存进笔记库，请先安装 Obsidian 并创建或打开一个库；不装助手时用 Obsidian URI 保存，装了助手可以静默写入。
一定要装本地助手吗？
不用。助手是可选的。静默写入笔记库、把学习笔记追加到今天的日记、生成字幕和下载 YouTube 文件需要它。macOS 双击安装包即可，不用先装 Python、Git 或 Node.js。
AI 功能要付费吗？
乔木剪藏不提供模型。提问、翻译和云端识别用你自己的服务商账号或 API Key，费用由该服务商计算。阅读、复制正文和已有字幕不需要配置 AI。
我的内容会被上传吗？
提问、字幕翻译和模板解读，会向你选择的服务商发送所需内容。云端语音识别会上传音频，本机识别不上传。对话历史、草稿和识别缓存保存在本机；部分设置、模板或凭证可能随浏览器同步。分享到乔木 RSS 默认关闭。完整说明见隐私政策。 隐私说明
分享到乔木 RSS 会公开我的剪藏吗？
只有你勾选之后才会。勾选后，链接、标题、剪藏正文和封面会进入公开的读者提交源。它默认关闭，阅读、编辑和学习日记的保存都不会触发。保存私人页面前，请确认没有勾选。
为什么没有 YouTube 下载？
商店版不提供 YouTube 视频和音频的文件下载，也会拦截来自 YouTube 媒体域名的文件。字幕、文稿复制或导出，以及沉浸学习都可以用。要下载文件，请改装独立版并安装本地助手。
哪些网站的视频能学习？
YouTube、B 站、TED 优先读取官方字幕。播客、录音和本地文件可以粘贴链接或选择文件后生成文稿。抖音、TikTok、X、Vimeo、SoundCloud 等提供入口，实际能否解析取决于网站、登录状态和网络。直播和 DRM 不保证可用。
支持哪些浏览器和系统？
主要验收目标是 Chrome 和 macOS。Firefox 和 Safari 提供构建包，Windows 助手已有实现和自动测试，真机体验仍需验证。
三连击没有反应怎么办？
确认焦点不在输入框里，相邻按键间隔不要超过约 0.6 秒，也不要带 Ctrl、Cmd、Alt、Shift。浏览器内部页面不允许扩展运行。如果这个网站被你禁用了，可以在弹窗的「…」菜单里重新开启。按键本身也可以在设置里修改。
学习笔记保存失败怎么办？
保存到日记需要安装助手，并在 Obsidian 里启用「日记」核心插件，目前要求数字日期格式，且未配置日记模板。不符合时会说明原因。关闭卡片会保留草稿，修好后可以重试。
怎么升级？
商店版自动更新。独立版从 GitHub Release 下载新的 chrome-local.zip，覆盖解压并重新加载扩展，升级前先备份设置。升级扩展时也要更新助手：macOS 安装对应版本的 .pkg。更新后刷新已打开的网页。
怎么卸载本地助手？
在扩展设置页点「卸载助手」，会移除助手、注册文件和已下载的识别引擎。你的笔记不会被删除，需要时可以重新安装。
用什么许可证？和 Obsidian Web Clipper 是什么关系？
乔木剪藏以 MIT 许可证发布，基于 Obsidian Web Clipper，保留上游历史和许可证。网页正文提取使用 Defuddle，图标来自 Lucide。
怎么反馈问题？
在 GitHub 的 Issues 里提问或反馈。安全问题请按仓库里的安全说明联系。