ドキュメント

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 字幕トラックにだけ必要です
初期設定と設定にある接続テストボタンで、何か生成する前にエンドポイントとモデルを確認できます。まだエンドポイントがなければ、このサイトからホスト型の OpenAI 互換ゲートウェイ Subquill AMP が使えます。

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 警告

長い字幕はチャンクに分け、チャンクごとに生成してつなぎます。進捗はジョブごとにパーセントとキャンセルボタンで出ます。一度に複数リンクを生成した場合は、完成したプレビューに戻せます。

動画にはオンライン字幕が必要です。字幕がなければ、トークンを使う前に Subquill が知らせます。

コピーと書き出し

  • Markdown をコピー —— ノートをクリップボードへ
  • .md として保存 —— ネイティブの保存ダイアログを開く
  • フォルダで表示 —— ノートフォルダを設定していれば、自動保存したファイルへジャンプ
  • ノートプレビューはサニタイズされた Markdown です。生の HTML は描画しません
ノートフォルダを設定していない場合、結果はアプリのプレビューにだけあります。新しいジョブを始める前に書き出してください。

設定

設定ではモデルのエンドポイントの更新と再テスト、ノート保存フォルダの選択、保存した秘密の消去ができます。

  • API Key を消去 —— 生成の前に再度入力が必要です
  • Cookie を消去 —— 一部の Bilibili 動画は取得できなくなります
  • ノートフォルダを消去 —— 自動保存は止まります。既存ファイルはそのままです

保存場所

ファイル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 と任意の Bilibili SESSDATA があります。どちらのファイルもリポジトリとアプリバンドルの外にあります。どこにもコミットしないでください。

プライバシーとネットワーク

  • Subquill はバックエンドサービスを運営しません。テレメトリもアカウントもありません
  • 字幕リクエストは、あなたのマシンから Bilibili / YouTube API へ直接行きます
  • ノート生成は、字幕チャンクだけを設定したモデルのエンドポイントへ送ります
  • SESSDATA Cookie は Bilibili 公式 API に対してだけ使います
  • 初期設定のあと、秘密は Rust 層に残ります。画面は「設定済み」のプレースホルダーだけで、平文は出しません

更新

Subquill はソースのみ配布です。GitHub から最新コードを取得してローカルで再ビルドしてください。プリビルドのインストーラーやアプリ内のバイナリ更新はありません。