Документация
Как пользоваться 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-дорожек
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, плюс предупреждение, если сохранённое значение больше не работает
Длинные транскрипты режутся на куски, генерируются по кускам и склеиваются. Прогресс — процент по каждой задаче, с кнопкой отмены; готовое превью можно переключить, если в одной пачке было несколько ссылок.
Копирование и экспорт
- Copy Markdown — кладёт конспект в буфер обмена
- Save as .md — открывает системный диалог сохранения
- Reveal in folder — прыгает к автосохранённому файлу, если папка конспектов настроена
- Превью конспекта — очищенный Markdown: сырой HTML никогда не рисуется
Settings
В Settings можно обновить endpoint модели и снова проверить связь, выбрать папку сохранения конспектов и стереть сохранённые секреты:
- Clear API Key — перед генерацией придётся ввести ключ снова
- Clear cookie — часть видео Bilibili больше не получится забрать
- Clear notes folder — автосохранение останавливается; уже лежащие файлы не трогаются
Где что лежит
| Файл | 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 и необязательный SESSDATA Bilibili. Оба файла лежат вне репозитория и вне бандла приложения — никуда их не коммитьте.
Приватность и сеть
- Subquill не держит бэкенд-сервисов; телеметрии нет, аккаунта нет
- Запросы субтитров идут с вашей машины напрямую на API Bilibili / YouTube
- Генерация конспекта отправляет куски транскрипта только на endpoint модели, который вы настроили
- Cookie SESSDATA используется исключительно против официального API Bilibili
- После онбординга секреты остаются в слое Rust; интерфейс показывает заглушки “configured” и никогда открытый текст
Обновления
Subquill распространяется только исходным кодом. Получите последний код на GitHub и пересоберите локально — готовых установщиков и бинарных обновлений в приложении нет.