Документация

Как пользоваться Subquill

Практическое руководство по настройке, генерации конспектов, экспорту Markdown и тому, где живут ваши данные. Исходники — в репозитории GitHub.

Обзор

Subquill — десктопное приложение для macOS и Windows на Tauri 2 (React-фронт над ядром на Rust). Оно делает конспекты из официальных субтитров публичных видео Bilibili и YouTube на любой OpenAI-совместимой модели, которую вы настроите.

  • Вставьте одну или несколько ссылок на видео — Bilibili (BV-ссылки) или YouTube
  • Забирает настоящие дорожки субтитров, включая AI и закрытые логином дорожки Bilibili, если настроен cookie SESSDATA
  • Пишет Markdown-конспект: Summary плюс разбор секций с таймкодами hh:mm:ss из субтитров
  • Копируйте, экспортируйте .md или автосохраняйте каждый готовый конспект в выбранную папку

С чего начать

Установите Subquill и откройте. Первый запуск проведёт через онбординг:

  • Base URL OpenAI-совместимого API
  • Model name
  • API Key — сразу пишется на диск и больше не показывается в интерфейсе
  • Язык интерфейса: китайский, английский или как в системе
  • Необязательный cookie SESSDATA Bilibili — нужен только для закрытых логином или части AI-дорожек
Кнопка Test connection в онбординге и в Settings проверяет endpoint и модель до любой генерации. Endpoint ещё нет? Subquill AMP, наш хостинг-шлюз в формате OpenAI, доступен с этого сайта.

Subquill распространяется только исходным кодом — готовые установщики не публикуются. Клонируйте репозиторий, установите Node.js LTS и Rust, выполните требования Tauri 2 для вашей ОС и запустите npm install и npm run tauri build.

Генерация конспектов

В рабочей области вставьте по одной ссылке на видео в строке и нажмите Generate. До старта задачи Subquill покажет метаданные каждого видео, чтобы было видно, что оно нашло:

  • Название и длительность видео и какую часть (P) вы целите — добавьте ?p=2 к URL Bilibili, чтобы выбрать часть
  • «Caption tracks detected», когда субтитры есть
  • Подсказку про cookie, если видео Bilibili требует SESSDATA, плюс предупреждение, если сохранённое значение больше не работает

Длинные транскрипты режутся на куски, генерируются по кускам и склеиваются. Прогресс — процент по каждой задаче, с кнопкой отмены; готовое превью можно переключить, если в одной пачке было несколько ссылок.

У видео должны быть онлайн-субтитры. Если их нет, Subquill скажет об этом до того, как потратит tokens.

Копирование и экспорт

  • Copy Markdown — кладёт конспект в буфер обмена
  • Save as .md — открывает системный диалог сохранения
  • Reveal in folder — прыгает к автосохранённому файлу, если папка конспектов настроена
  • Превью конспекта — очищенный Markdown: сырой HTML никогда не рисуется
Без папки конспектов результаты живут только в превью приложения — экспортируйте их до новой задачи.

Settings

В Settings можно обновить endpoint модели и снова проверить связь, выбрать папку сохранения конспектов и стереть сохранённые секреты:

  • Clear API Key — перед генерацией придётся ввести ключ снова
  • Clear cookie — часть видео Bilibili больше не получится забрать
  • Clear notes folder — автосохранение останавливается; уже лежащие файлы не трогаются

Где что лежит

Файл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 и необязательный SESSDATA Bilibili. Оба файла лежат вне репозитория и вне бандла приложения — никуда их не коммитьте.

Приватность и сеть

  • Subquill не держит бэкенд-сервисов; телеметрии нет, аккаунта нет
  • Запросы субтитров идут с вашей машины напрямую на API Bilibili / YouTube
  • Генерация конспекта отправляет куски транскрипта только на endpoint модели, который вы настроили
  • Cookie SESSDATA используется исключительно против официального API Bilibili
  • После онбординга секреты остаются в слое Rust; интерфейс показывает заглушки “configured” и никогда открытый текст

Обновления

Subquill распространяется только исходным кодом. Получите последний код на GitHub и пересоберите локально — готовых установщиков и бинарных обновлений в приложении нет.