Commit 3b9bdaf0 authored by Kourser's avatar Kourser
Browse files

feat: lecteur Calibre avec béquille française, narration et résumés

Première version de Podbook : lire ses e-books Calibre en anglais avec
une aide en français, et continuer à avancer dans le livre quand on ne
peut pas lire.

CalibreKit parle à l'API de calibre-server, relevée dans son code source
faute de documentation — son mainteneur indique que la surface /ajax
n'est ni publique ni stable. Catalogue paginé, téléchargement des formats
et des couvertures, conversion de formats par HTTP, positions de lecture,
recherche plein texte et commandes calibredb. La nature du serveur est
détectée au branchement, avec repli OPDS pour Calibre-Web, et tous les
décodages sont tolérants.

PodbookUI porte la coquille SwiftUI : connexion, bibliothèque paginée,
fiche livre avec conversion côté serveur, lecteur EPUB par le Readium
Swift Toolkit et PDF par PDFKit. Traduction d'un passage sélectionné par
le framework Translation d'Apple, avec cache indexé par empreinte du
texte source et carnet de vocabulaire exportable en TSV Anki. Narration
par la voix système, en arrière-plan, titre sur l'écran du véhicule et
commandes au volant — sans aucun entitlement. Résumés parlés en cinq
formats et quatre angles, par LM Studio sur le Mac par défaut, Anthropic
en option, avec compteur de dépense et plafond mensuel.

Lecture et écoute partagent une seule position, ce qui est le point du
projet : on écoute en voiture le matin, on ouvre le livre le soir, il est
au bon paragraphe.

Projet Xcode multiplateforme — un seul schéma pour iPhone, iPad et Mac —
et scripts/release.sh sur le modèle de skingomz-app, à une différence
assumée près : l'envoi App Store y est sur demande et non par défaut,
le plan étant un build privé (docs/FAISABILITE.md, risque 2).

142 tests au vert, sans serveur ni appareil. Mais rien n'a encore touché
un vrai calibre-server, aucun EPUB n'a été ouvert, aucune traduction
n'est passée par Apple, aucun son n'a été produit et aucun modèle de
langage n'a été interrogé : Calibre n'est pas installé sur cette machine
et son simulateur iOS est hors service.

Co-Authored-By: default avatarClaude Opus 5 <noreply@anthropic.com>
parents
Loading
Loading
Loading
Loading

.gitignore

0 → 100644
+21 −0
Changes for .gitignore: 21 added lines, 0 removed lines.
Original line number Diff line number Diff line
# macOS
.DS_Store

# Xcode
build/
DerivedData/
*.xcuserstate
xcuserdata/
*.xcscmblueprint
*.xccheckout

# Swift Package Manager
.build/
.swiftpm/
Packages/*/.build/

# Local xcodebuild SPM clone cache
.build-spm/

# Release secrets (Apple ID, app-specific password, GitLab token) — never commit
scripts/release.env

CHANGELOG.md

0 → 100644
+89 −0
Changes for CHANGELOG.md: 89 added lines, 0 removed lines.
Original line number Diff line number Diff line
# Changelog

Toutes les évolutions notables de Podbook sont consignées ici.

Le format suit [Keep a Changelog](https://keepachangelog.com/fr/1.1.0/) et le projet
adopte le [versionnage sémantique](https://semver.org/lang/fr/).

## [Non publié]

### Ajouté
- Résumés parlés : cinq formats (flash, chapitre, le livre en 20 minutes,
  conversation à deux voix, approfondissement) et quatre angles (fidèle, idées
  clés, débutant, critique), sur tout le livre ou à partir de la page lue.
- Connecteur compatible OpenAI — LM Studio ou Ollama sur le Mac par défaut,
  Mammouth.ai, OpenRouter, OpenAI — et connecteur Anthropic. Compteur de
  dépense et plafond mensuel qui bloque les modèles payants.
- Génération en deux passes quand le livre dépasse la fenêtre de contexte :
  notes de lecture par morceau, puis une seule rédaction finale.
- La conversation à deux voix alterne réellement deux voix système.
- Les scripts sont conservés par livre et par plan : régénérer avec un autre
  angle n'écrase pas le précédent.
- Narration à voix haute par la voix système, pour l'EPUB comme pour le PDF :
  débit de 0,75× à 3×, choix de la voix, phrase suivante et précédente.
- L'audio continue écran éteint et en arrière-plan, le titre s'affiche sur
  l'écran du véhicule et les commandes au volant pilotent la lecture — sans
  aucun entitlement Apple.
- L'écoute et la lecture partagent la même position : « Écouter » reprend au
  paragraphe affiché, et la position est enregistrée à chaque changement de
  phrase.
- Béquille française dans le lecteur : sélectionner un passage, « Traduire »
  dans le menu de sélection, traduction sur l'appareil par le framework
  `Translation` d'Apple — gratuite, hors-ligne, sans clé. Fonctionne pour
  l'EPUB comme pour le PDF.
- Cache de traduction indexé par empreinte du texte source : une phrase ne
  coûte qu'une traduction pour toute la bibliothèque, et survit à une
  réimportation ou une reconversion du livre.
- Carnet de vocabulaire : terme, traduction, phrase d'origine et livre, en
  journal `.jsonl` append-only, avec export TSV pour Anki.
- La disponibilité du modèle de langue est affichée au lieu d'échouer sans
  explication.
- Lecteur EPUB par le Readium Swift Toolkit 3.11.1, côté iOS et iPadOS. La
  dépendance est conditionnée à la plateforme et le code gardé par
  `canImport`, pour que le paquet continue de compiler et de se tester sur
  macOS ; `PodbookCapabilities` expose la différence et un test la verrouille.
- Position de lecture conservée pour l'EPUB (`Locator` Readium) comme pour le
  PDF (numéro de page) : écriture locale immédiate, poussée différée vers
  Calibre, et préférence donnée à une position plus récente venue d'un autre
  appareil à l'ouverture du livre.

## [0.1.0] - 2026-10-30

Première coquille utilisable : se brancher sur un serveur Calibre, parcourir sa
bibliothèque, préparer un livre et lire un PDF. Rien n'a encore été confronté à
un vrai serveur.

### Ajouté
- `CalibreKit` : client de l'API du serveur Calibre — catalogue paginé
  (`/ajax/*`), téléchargement des formats et des couvertures, conversion côté
  serveur (`/conversion/*`), positions de lecture, recherche plein texte
  (`/fts/*`) et commandes `calibredb` (`/cdb/cmd/*`). Détection de la nature du
  serveur au branchement, avec repli OPDS pour Calibre-Web.
- Écran de connexion : adresse tolérante à la saisie, identifiants optionnels,
  mot de passe dans le Keychain cloisonné par hôte et par compte, et un relevé
  de ce que le serveur sait réellement faire.
- Bibliothèque : grille de couvertures paginée, recherche et tri délégués au
  serveur, repère sur les livres qui demandent une conversion.
- Fiche livre : métadonnées Calibre, liste des fichiers, et une action unique
  qui télécharge ou fait convertir par le serveur, avec progression et
  interruption.
- Lecteur PDF via PDFKit.
- `calibre-probe` : sonde en ligne de commande qui dit, pour un serveur donné,
  ce que l'application pourra faire.
- Projet Xcode multiplateforme — un seul schéma pour iPhone, iPad et Mac — et
  `scripts/release.sh` sur le modèle de skingomz-app.

### Connu
- Les résumés ne sont pas encore synthétisés en fichiers audio ni en voix
  cloud : ils sont lus par la voix système, à la volée.
- La narration n'est pas encore pré-générée en fichiers : elle est produite à la
  volée, ce qui suffit hors-ligne mais consomme plus de batterie qu'un `.m4a`
  fabriqué la nuit.
- Le `PublicationSpeechSynthesizer` de Readium n'est pas utilisé : dans la
  3.11.1, les lignes de débit et de hauteur de son `AVTTSEngine` sont
  commentées dans le source, donc la vitesse de lecture ne peut pas changer.
  Readium sert à extraire le texte et les locators ; la voix est la nôtre.
- Pas de lecteur EPUB : il passera par le Readium Swift Toolkit, dont les
  positions stables conditionnent tout le pont lecture ↔ écoute.
- Rien n'a été testé contre un serveur Calibre réel, ni exécuté sur iPhone ou
  iPad.
+14 −0
Changes for ExportOptions-iOS.plist: 14 added lines, 0 removed lines.
Original line number Diff line number Diff line
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>method</key>
	<string>app-store-connect</string>
	<key>teamID</key>
	<string>88NB46UUP7</string>
	<key>signingStyle</key>
	<string>automatic</string>
	<key>destination</key>
	<string>upload</string>
</dict>
</plist>
+14 −0
Changes for ExportOptions-macOS-appstore.plist: 14 added lines, 0 removed lines.
Original line number Diff line number Diff line
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>method</key>
	<string>app-store-connect</string>
	<key>teamID</key>
	<string>88NB46UUP7</string>
	<key>signingStyle</key>
	<string>automatic</string>
	<key>destination</key>
	<string>upload</string>
</dict>
</plist>

ExportOptions.plist

0 → 100644
+12 −0
Changes for ExportOptions.plist: 12 added lines, 0 removed lines.
Original line number Diff line number Diff line
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
	<key>method</key>
	<string>developer-id</string>
	<key>teamID</key>
	<string>88NB46UUP7</string>
	<key>signingStyle</key>
	<string>automatic</string>
</dict>
</plist>
Loading