Documentation

Utiliser Subquill

Un guide pratique pour la configuration, la génération de notes, l'export Markdown, et l'endroit où vivent vos données. Pour le code source, voir le dépôt GitHub.

Aperçu

Subquill est une appli desktop pour macOS et Windows, construite sur Tauri 2 (un front React au-dessus d'un cœur Rust). Elle génère des notes d'étude à partir des sous-titres officiels de vidéos Bilibili et YouTube publiques, via n'importe quel modèle compatible OpenAI que vous configurez.

  • Collez une ou plusieurs URL vidéo — Bilibili (liens BV) ou YouTube
  • Récupère de vraies pistes de sous-titres, y compris les pistes IA et celles derrière connexion Bilibili quand un cookie SESSDATA est configuré
  • Rédige une note Markdown : un Résumé plus un découpage en sections avec des horodatages hh:mm:ss issus des sous-titres
  • Copiez, exportez en .md, ou enregistrez automatiquement chaque note terminée dans un dossier de votre choix

Pour commencer

Installez Subquill et ouvrez-la. Le premier lancement vous guide dans l'onboarding :

  • Base URL d'une API compatible OpenAI
  • Nom du modèle
  • API Key — enregistrée sur le disque immédiatement et jamais réaffichée dans l'UI
  • Langue de l'interface : chinois, anglais, ou suivre le système
  • Cookie SESSDATA Bilibili optionnel, seulement nécessaire pour les pistes derrière connexion ou certaines pistes de sous-titres IA
Un bouton Test connection dans l'onboarding et dans les Paramètres vérifie votre endpoint et votre modèle avant de générer quoi que ce soit. Pas encore d'endpoint ? Subquill AMP, notre passerelle hébergée compatible OpenAI, est disponible depuis ce site.

Subquill est distribué uniquement en source — aucun installateur précompilé. Clonez le dépôt, installez Node.js LTS et Rust, respectez les prérequis Tauri 2 pour votre OS, puis lancez npm install et npm run tauri build.

Générer des notes

Dans l'espace de travail, collez une URL vidéo par ligne et appuyez sur Generate. Avant que la tâche démarre, Subquill affiche les métadonnées de chaque vidéo pour que vous sachiez ce qu'elle a trouvé :

  • Titre et durée de la vidéo, et quelle partie (P) vous visez — ajoutez ?p=2 à une URL Bilibili pour choisir une partie
  • « Caption tracks detected » quand des sous-titres sont disponibles
  • Un indice cookie quand une vidéo Bilibili a besoin de SESSDATA, plus un avertissement de cookie périmé quand la valeur stockée ne fonctionne plus

Les longs transcripts sont découpés en morceaux, générés morceau par morceau, puis fusionnés. La progression s'affiche en pourcentage par tâche avec un bouton d'annulation ; un aperçu terminé peut être réaffiché quand vous avez généré plusieurs liens d'un coup.

La vidéo doit avoir des sous-titres en ligne. Si elle n'en a pas, Subquill vous le dit avant de dépenser le moindre token.

Copier & exporter

  • Copier Markdown — met la note dans le presse-papiers
  • Enregistrer en .md — ouvre la boîte de dialogue native
  • Afficher dans le dossier — saute vers le fichier enregistré automatiquement, si un dossier de notes est configuré
  • L'aperçu des notes est du Markdown assaini : le HTML brut n'est jamais affiché
Sans dossier de notes configuré, les résultats n'existent que dans l'aperçu de l'appli — exportez-les avant de lancer une nouvelle tâche.

Paramètres

Les Paramètres vous permettent de mettre à jour l'endpoint de modèle et de retester la connexion, de choisir le dossier d'enregistrement des notes, et d'effacer les secrets stockés :

  • Effacer l'API Key — vous devrez la ressaisir avant de générer
  • Effacer le cookie — certaines vidéos Bilibili ne seront plus récupérables
  • Effacer le dossier de notes — arrête l'enregistrement automatique ; les fichiers existants ne sont pas touchés

Où les choses sont stockées

FichiermacOS / LinuxWindows
settings.json~/.config/subquill/settings.json%APPDATA%\subquill\settings.json
auth.json~/.local/share/subquill/auth.json%LOCALAPPDATA%\subquill\auth.json

auth.json contient l'API Key et le SESSDATA Bilibili optionnel. Les deux fichiers vivent hors du dépôt et hors du bundle de l'appli — ne les commitez jamais nulle part.

Confidentialité & réseau

  • Subquill n'opère aucun service backend ; il n'y a pas de télémétrie et pas de compte
  • Les requêtes de sous-titres vont aux API Bilibili / YouTube directement depuis votre machine
  • La génération de notes n'envoie des morceaux de transcript qu'à l'endpoint de modèle que vous configurez
  • Le cookie SESSDATA n'est utilisé que contre l'API officielle de Bilibili
  • Après l'onboarding, les secrets restent dans la couche Rust ; l'UI affiche des placeholders « configuré » et jamais la valeur en clair

Mises à jour

Subquill est distribué uniquement en source. Récupérez le dernier code sur GitHub et recompilez localement — pas d’installateurs précompilés ni de mises à jour binaires dans l’app.