文档

使用 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 / LinuxWindows
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 拉取最新代码并在本地重新构建即可更新,不提供预编译安装包或应用内二进制更新。