Tài liệu
Dùng Subquill
Hướng dẫn thực tế về cài đặt, tạo ghi chú, xuất Markdown, và dữ liệu của bạn nằm đâu. Mã nguồn xem kho GitHub.
Overview
Subquill là ứng dụng desktop cho macOS và Windows, dựng trên Tauri 2 (front React trên lõi Rust). Nó tạo ghi chú học tập từ phụ đề chính thức của video Bilibili và YouTube công khai, dùng bất kỳ mô hình tương thích OpenAI nào bạn cấu hình.
- Dán một hoặc nhiều URL video — Bilibili (liên kết BV) hoặc YouTube
- Lấy track phụ đề thật, kể cả track AI và track Bilibili cần đăng nhập khi đã cấu hình cookie SESSDATA
- Viết ghi chú Markdown: một Summary cộng bản phân đoạn với mốc thời gian hh:mm:ss từ phụ đề
- Sao chép, xuất .md, hoặc tự lưu mỗi ghi chú xong vào thư mục bạn chọn
Getting started
Cài Subquill rồi mở. Lần chạy đầu dẫn bạn qua onboarding:
- Base URL của API tương thích OpenAI
- Tên mô hình
- API Key — lưu ngay xuống đĩa và không bao giờ hiện lại trên giao diện
- Ngôn ngữ giao diện: tiếng Trung, tiếng Anh, hoặc theo hệ thống
- Cookie SESSDATA Bilibili tùy chọn, chỉ cần cho track cần đăng nhập hoặc một số track AI
Subquill chỉ phân phối mã nguồn — không phát hành trình cài đặt dựng sẵn. Clone repo, cài Node.js LTS và Rust, đáp ứng yêu cầu Tauri 2 cho OS của bạn, rồi chạy npm install và npm run tauri build.
Generating notes
Trong workspace, dán một URL video mỗi dòng rồi nhấn Generate. Trước khi việc bắt đầu, Subquill xem trước metadata từng video để bạn biết nó tìm được gì:
- Tiêu đề và thời lượng video, cùng phần (P) bạn đang nhắm — thêm ?p=2 vào URL Bilibili để chọn phần
- “Đã phát hiện track phụ đề” khi có phụ đề
- Gợi ý cookie khi video Bilibili cần SESSDATA, cộng cảnh báo cookie cũ khi giá trị lưu không còn dùng được
Transcript dài được cắt khúc, tạo từng khúc rồi ghép. Tiến độ hiện theo phần trăm mỗi việc, có nút hủy; bản xem trước đã xong có thể chọn lại khi bạn tạo nhiều liên kết trong một lô.
Copying & exporting
- Copy Markdown — đưa ghi chú lên clipboard
- Save as .md — mở hộp thoại lưu gốc
- Reveal in folder — nhảy tới file tự lưu, nếu đã cấu hình thư mục ghi chú
- Xem trước ghi chú là Markdown đã làm sạch: HTML thô không bao giờ được render
Settings
Settings cho phép bạn cập nhật endpoint mô hình và kiểm tra lại kết nối, chọn thư mục lưu ghi chú, và xóa bí mật đã lưu:
- Clear API Key — bạn phải nhập lại trước khi tạo
- Clear cookie — một số video Bilibili sẽ không lấy được nữa
- Clear notes folder — dừng tự lưu; file đã có không bị đụng
Where things are stored
| 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 giữ API Key và SESSDATA Bilibili tùy chọn. Cả hai file nằm ngoài kho mã nguồn và ngoài gói app — đừng commit chúng đi đâu.
Privacy & network
- Subquill không vận hành dịch vụ backend nào; không telemetry, không tài khoản
- Yêu cầu phụ đề đi tới API Bilibili / YouTube trực tiếp từ máy bạn
- Tạo ghi chú chỉ gửi các khúc transcript tới endpoint mô hình bạn cấu hình
- Cookie SESSDATA chỉ dùng với API chính thức của Bilibili
- Sau onboarding, bí mật nằm ở lớp Rust; giao diện hiện chỗ giữ chỗ “đã cấu hình”, không bao giờ hiện plaintext
Cập nhật
Subquill chỉ phân phối mã nguồn. Kéo mã mới nhất từ GitHub và build lại cục bộ — không có trình cài đặt dựng sẵn hay cập nhật nhị phân trong app.