ドキュメント
Subquill の使い方
セットアップ、ノート生成、Markdown の書き出し、データの置き場所についての実務ガイドです。ソースは GitHub リポジトリ をご覧ください。
概要
Subquill は macOS と Windows 向けのデスクトップアプリで、Tauri 2(React フロントエンドと Rust コア)で作られています。公開されている Bilibili と YouTube の公式字幕から、設定した任意の OpenAI 互換モデルで学習ノートを生成します。
- 動画 URL をひとつでも複数でも貼る —— Bilibili(BV リンク)または YouTube
- 本物の字幕トラックを取得。SESSDATA Cookie を設定すると、Bilibili の AI 字幕やログイン必須トラックも含みます
- Markdown ノートを書く:Summary に加え、字幕の hh:mm:ss タイムスタンプ付き Section 解説
- コピー、.md の書き出し、または完成したノートを好きなフォルダへ自動保存
はじめ方
Subquill をインストールして開いてください。初回起動では初期設定が案内されます。
- OpenAI 互換 API の Base URL
- モデル名
- API Key —— すぐにディスクへ保存され、画面には二度とエコーしません
- 画面の言語:中国語、英語、またはシステムに合わせる
- 任意の Bilibili SESSDATA Cookie。ログイン必須、または一部の AI 字幕トラックにだけ必要です
Subquill はソースのみ配布で、プリビルドのインストーラーは公開されません。リポジトリをクローンし、Node.js LTS と Rust をインストールし、OS の Tauri 2 前提条件を満たしてから npm install と npm run tauri build を実行してください。
ノートの生成
ワークスペースに動画 URL を一行ずつ貼って、生成を押してください。ジョブの前に Subquill は各動画のメタデータをプレビューし、何が見つかったかを知らせます。
- 動画タイトルと尺、対象のパート(P)—— Bilibili の URL に ?p=2 を付けるとパートを選べます
- 字幕があるときは「字幕トラックを検出」
- Bilibili の動画に SESSDATA が必要なときの Cookie ヒントと、保存した値がもう効かないときの古い Cookie 警告
長い字幕はチャンクに分け、チャンクごとに生成してつなぎます。進捗はジョブごとにパーセントとキャンセルボタンで出ます。一度に複数リンクを生成した場合は、完成したプレビューに戻せます。
コピーと書き出し
- Markdown をコピー —— ノートをクリップボードへ
- .md として保存 —— ネイティブの保存ダイアログを開く
- フォルダで表示 —— ノートフォルダを設定していれば、自動保存したファイルへジャンプ
- ノートプレビューはサニタイズされた Markdown です。生の HTML は描画しません
設定
設定ではモデルのエンドポイントの更新と再テスト、ノート保存フォルダの選択、保存した秘密の消去ができます。
- API Key を消去 —— 生成の前に再度入力が必要です
- Cookie を消去 —— 一部の Bilibili 動画は取得できなくなります
- ノートフォルダを消去 —— 自動保存は止まります。既存ファイルはそのままです
保存場所
| ファイル | 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 と任意の Bilibili SESSDATA があります。どちらのファイルもリポジトリとアプリバンドルの外にあります。どこにもコミットしないでください。
プライバシーとネットワーク
- Subquill はバックエンドサービスを運営しません。テレメトリもアカウントもありません
- 字幕リクエストは、あなたのマシンから Bilibili / YouTube API へ直接行きます
- ノート生成は、字幕チャンクだけを設定したモデルのエンドポイントへ送ります
- SESSDATA Cookie は Bilibili 公式 API に対してだけ使います
- 初期設定のあと、秘密は Rust 層に残ります。画面は「設定済み」のプレースホルダーだけで、平文は出しません
更新
Subquill はソースのみ配布です。GitHub から最新コードを取得してローカルで再ビルドしてください。プリビルドのインストーラーやアプリ内のバイナリ更新はありません。