文档
使用 Subquill
一份实用指南:配置、生成笔记、导出 Markdown,以及你的数据都存在哪里。源码见GitHub 仓库。
概览
Subquill 是一款 macOS 与 Windows 桌面应用,基于 Tauri 2 构建(React 前端 + Rust 核心)。它抓取公开的 Bilibili 与 YouTube 视频的官方字幕,用你配置的任意 OpenAI 兼容模型生成学习笔记。
- 粘贴一条或多条视频链接 —— Bilibili(BV 号)或 YouTube
- 拉取真实字幕轨道;配置 SESSDATA Cookie 后可含 Bilibili AI 与需登录字幕
- 生成 Markdown 笔记:总结 + 按字幕时间码(hh:mm:ss)的分段讲解
- 复制、另存 .md,或把完成的笔记自动保存到你选择的目录
开始使用
克隆 Subquill 源码、本地构建并打开,首次启动会引导你完成初始化:
- OpenAI 兼容 API 的 Base URL
- 模型名
- API Key —— 立即保存到磁盘,界面不再回显
- 界面语言:中文、英文或跟随系统
- 可选的 Bilibili SESSDATA Cookie,仅登录可见或部分 AI 字幕轨道需要
初始化与设置里都有「测试连接」按钮,生成前即可验证端点与模型是否可用。还没有端点?官网提供的官方 OpenAI 兼容网关 Subquill AMP 可以直接使用。
Subquill 仅以源码分发,不发布预编译安装包。克隆仓库,安装 Node.js LTS 与 Rust,满足你操作系统的 Tauri 2 前置条件,然后运行 npm install 与 npm run tauri build。
生成笔记
在工作区每行粘贴一条视频链接并点击生成。任务开始前,Subquill 会先预览每个视频的元数据,让你清楚它找到了什么:
- 视频标题与时长、当前定位的分 P —— Bilibili 链接末尾加 ?p=2 可指定分 P
- 字幕可用时提示「检测到字幕轨道」
- Bilibili 视频需要 SESSDATA 时给出 Cookie 提示;已存的 Cookie 失效时也会警告
长字幕会被拆分成块,逐块生成后再合并。进度按任务以百分比呈现,可随时取消;一次批量生成多条链接后,可在预览中点选切换查看。
视频必须有在线字幕。若没有,Subquill 会在消耗任何 token 之前如实告诉你。
复制与导出
- 复制 Markdown —— 把笔记复制到剪贴板
- 另存为 .md —— 打开原生保存对话框
- 在文件夹中显示 —— 跳转自动保存的文件(需已配置笔记目录)
- 笔记预览为安全的净化 Markdown:从不渲染原始 HTML
未配置笔记目录时,结果只存在于应用预览中 —— 请在开始新任务前及时导出。
设置
在设置里可以更新模型端点并重新测试连接、选择笔记保存目录、清除已存的凭据:
- 清除 API Key —— 需重新填写后才能继续生成
- 清除 Cookie —— 部分 Bilibili 视频将无法拉取字幕
- 清除笔记目录 —— 停止自动保存;已保存的文件不受影响
文件存放位置
| 文件 | macOS / Linux | Windows |
|---|---|---|
| settings.json | ~/.config/subquill/settings.json | %APPDATA%\subquill\settings.json |
| auth.json | ~/.local/share/subquill/auth.json | %LOCALAPPDATA%\subquill\auth.json |
auth.json 保存 API Key 与可选的 Bilibili SESSDATA。两个文件都在仓库与应用安装包之外 —— 切勿把它们提交到任何地方。
隐私与网络
- Subquill 不运营任何后端服务;没有遥测,也没有账号体系
- 字幕请求由你的机器直连 Bilibili / YouTube API
- 笔记生成只把字幕分块发往你配置的模型端点
- SESSDATA Cookie 仅用于请求 Bilibili 官方 API
- 初始化完成后,凭据只保留在 Rust 层;界面显示「已配置」占位,永不回显明文
更新
Subquill 仅以源码分发。从 GitHub 拉取最新代码并在本地重新构建即可更新,不提供预编译安装包或应用内二进制更新。