Dokumentasi
Memakai Subquill
Panduan praktis untuk penyiapan, membuat catatan, mengekspor Markdown, dan di mana data Anda tinggal. Untuk sumber, lihat repositori GitHub.
Ikhtisar
Subquill adalah aplikasi desktop untuk macOS dan Windows, dibangun di atas Tauri 2 (front end React di atas inti Rust). Aplikasi membuat catatan belajar dari subtitle resmi video Bilibili dan YouTube yang publik, memakai model kompatibel OpenAI yang Anda atur.
- Tempel satu atau banyak URL video — Bilibili (tautan BV) atau YouTube
- Mengambil trek subtitle yang nyata, termasuk trek AI dan yang butuh login di Bilibili ketika SESSDATA cookie sudah diatur
- Menulis catatan Markdown: Ringkasan plus uraian Bagian dengan stempel waktu hh:mm:ss dari subtitle
- Salin, ekspor .md, atau simpan otomatis setiap catatan yang selesai ke folder pilihan Anda
Mulai
Pasang Subquill dan buka. Peluncuran pertama menuntun Anda lewat onboarding:
- Base URL dari API kompatibel OpenAI
- Nama model
- API Key — disimpan ke disk segera dan tidak pernah diulang di UI
- Bahasa antarmuka: Tionghoa, Inggris, atau ikuti sistem
- SESSDATA cookie Bilibili opsional, hanya dibutuhkan untuk trek yang butuh login atau sebagian trek subtitle AI
Subquill hanya didistribusikan sebagai sumber — tidak ada penginstal siap pakai. Klon repositori, instal Node.js LTS dan Rust, penuhi prasyarat Tauri 2 untuk OS Anda, lalu jalankan npm install dan npm run tauri build.
Membuat catatan
Di ruang kerja, tempel satu URL video per baris lalu tekan Generate. Sebelum pekerjaan mulai, Subquill mempratinjau metadata tiap video supaya Anda tahu apa yang ditemukan:
- Judul dan durasi video, dan bagian (P) mana yang Anda sasar — tambahkan ?p=2 ke URL Bilibili untuk memilih bagian
- “Caption tracks detected” ketika subtitle tersedia
- Petunjuk cookie ketika video Bilibili butuh SESSDATA, plus peringatan cookie kedaluwarsa ketika nilai tersimpan tidak lagi bekerja
Transkrip panjang dipecah menjadi potongan, dibuat potongan demi potongan, lalu digabung. Progres ditampilkan sebagai persentase per pekerjaan dengan tombol batal; pratinjau yang selesai bisa dialihkan kembali ketika Anda membuat beberapa tautan dalam satu batch.
Menyalin & mengekspor
- Salin Markdown — menaruh catatan di papan klip
- Simpan sebagai .md — membuka dialog simpan native
- Tampilkan di folder — lompat ke file yang disimpan otomatis, jika folder catatan sudah diatur
- Pratinjau catatan adalah Markdown yang dibersihkan: HTML mentah tidak pernah dirender
Pengaturan
Pengaturan memungkinkan Anda memperbarui endpoint model dan menguji ulang koneksi, memilih folder simpan catatan, dan menghapus rahasia tersimpan:
- Hapus API Key — Anda harus memasukkannya lagi sebelum membuat catatan
- Hapus cookie — sebagian video Bilibili tidak lagi bisa diambil
- Hapus folder catatan — menghentikan simpan otomatis; file yang sudah ada tidak disentuh
Di mana semuanya disimpan
| File | 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 menyimpan API Key dan SESSDATA Bilibili opsional. Kedua file tinggal di luar repositori dan di luar bundel aplikasi — jangan pernah meng-commit-nya ke mana pun.
Privasi & jaringan
- Subquill tidak mengoperasikan layanan backend; tidak ada telemetri dan tidak ada akun
- Permintaan subtitle ke API Bilibili / YouTube langsung dari mesin Anda
- Pembuatan catatan hanya mengirim potongan transkrip ke endpoint model yang Anda atur
- SESSDATA cookie dipakai semata-mata terhadap API resmi Bilibili
- Setelah onboarding, rahasia disimpan di lapisan Rust; UI menampilkan placeholder “sudah diatur” dan tidak pernah nilai plaintext
Pembaruan
Subquill hanya didistribusikan sebagai sumber. Tarik kode terbaru dari GitHub dan bangun ulang secara lokal — tanpa penginstal siap pakai atau pembaruan biner dalam aplikasi.