Skip to content

README.pl.md

Latest commit

 

History

History
136 lines (111 loc) · 5.43 KB

README.pl.md

File metadata and controls

136 lines (111 loc) · 5.43 KB
Raw

EPUB Translator Studio

Jezyk: English | Polski | Deutsch | Espanol | Francais | Portugues

Desktopowy zestaw narzedzi do tlumaczenia i redakcji plikow EPUB z AI.

KEYWORDS: tlumacz EPUB, narzedzie do tlumaczenia EPUB, tlumaczenie AI, tlumacz ebookow, Ollama, Google Gemini, Translation Memory, QA gate, Tkinter, Python.

Unikalne cechy (rzadko spotykane w narzedziach EPUB)

  • idempotentny pipeline z ledgerem segmentow (done/processing/error/pending) i bezpiecznym resume po awarii
  • zarzadzane migracje bazy z backupem i rollbackiem (migration_runs, startup notice, panel DB Update)
  • security-first gate'y runtime (twardy EPUBCheck + QA severity gate)
  • Smart Context (segmenty sasiednie) dla lepszej spojnosci form i odniesien
  • asynchroniczny preflight providerow (Ollama + Google) z telemetryka (status/opoznienie/liczba modeli) bez blokowania UI
  • opcjonalny async dispatch batchy translacji (--io-concurrency) z limitem wspolbieznosci i bezpiecznym resume z ledgera
  • Series Memory: termy serii, style rules, lorebook, historia zmian, import/export profilu serii
  • orkiestracja batcha serii jednym kliknieciem + raport zbiorczy (series_batch_report_*.json/.md)

Cechy standardowe projektu (jak w dobrych narzedziach klasy pro)

  • tlumaczenie EPUB (translate) i redakcja (edit)
  • walidacja EPUB
  • Translation Memory (TM) i cache segmentow
  • presety promptow w GUI pod provider/model
  • workflow findings QA i QA gate
  • operacje EPUB: wizytowka, usuwanie okladki/grafik, edytor segmentow
  • praca kolejka projektow (pending, run all)

Warianty aplikacji

  • project-tkinter/
    • glowna aplikacja desktop w Python + Tkinter
    • najpelniejszy zestaw funkcji
  • legacy/
    • zarchiwizowane skrypty z dawnego ukladu (legacy/launcher_classic.py, legacy/translation_engine.py)
    • nie jest to zalecana sciezka uruchamiania

Szybki start

Tkinter (glowny)

cd project-tkinter
python app_main.py --variant classic

Dostepne launchery:

  • python launcher_classic.py
  • python launcher_horizon.py

Pierwsze uruchomienie

  • Potrzebujesz jednej z drog:
    • AI lokalnie: zainstalowana Ollama + co najmniej jeden model,
    • AI online: poprawny klucz API (GOOGLE_API_KEY) + internet.

Komendy instalacji Ollama

Windows (PowerShell):

winget install Ollama.Ollama
ollama pull llama3.1:8b

Linux:

curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3.1:8b

macOS:

brew install ollama
ollama pull llama3.1:8b

Klucz API dla providera online

Windows (PowerShell):

setx GOOGLE_API_KEY "<TWOJ_KLUCZ>"

Linux/macOS:

export GOOGLE_API_KEY="<TWOJ_KLUCZ>"

Wymagania

  • Lokalny AI (Ollama): zainstalowana Ollama oraz pobrany co najmniej jeden model (np. ollama pull llama3.1:8b).
  • AI online (np. Google Gemini): ustawiony poprawny klucz API (GOOGLE_API_KEY lub pole w GUI).
  • Dla providerow online potrzebny jest internet.

Architektura (Tkinter core)

  • wspolna logika runtime jest w project-tkinter/runtime_core.py
  • kanoniczny translator: project-tkinter/translation_engine.py
  • oba warianty UI (classic, horizon) korzystaja z tej samej logiki runtime
  • katalog presetow promptow: project-tkinter/prompt_presets.json
  • warstwa abstrakcji state-store (krok Repository): project-tkinter/studio_repository.py

Dokumentacja

  • manual uzytkownika Tkinter (PL): project-tkinter/MANUAL_PL.md
  • workflow Git na wielu komputerach: project-tkinter/GIT_WORKFLOW_PL.md
  • informacje o wsparciu: SUPPORT_PL.md
  • portal dokumentacji online: https://piotr-grechuta.github.io/epub-translator-studio/
  • gdzie widac postep/UI/Wiki: docs/08-Status-UI-i-Wiki.md

Bezpieczenstwo

  • Ochrona brancha main wymusza wymagane checki i wymagany review.
  • Workflow CI security (.github/workflows/security-scans.yml) uruchamia:
    • gitleaks (wykrywanie sekretow),
    • pip-audit (raport JSON) + blokujacy gate progu CVE (project-tkinter/scripts/pip_audit_cve_gate.py),
    • trivy z bramka HIGH,CRITICAL.
  • Workflow CodeQL jest skonfigurowany w .github/workflows/codeql.yml.
  • Dependabot updates sa skonfigurowane w .github/dependabot.yml.
  • Rekomendacja: wlacz w ustawieniach repo funkcje GitHub Security (Dependabot alerts, Secret scanning, Secret scanning push protection).

Wsparcie

  • Sponsor: https://github.com/sponsors/Piotr-Grechuta
  • link wsparcia jest tez bezposrednio w UI aplikacji Tkinter (Wesprzyj projekt)
  • gotowy szablon PL do uzupelnienia GitHub Sponsors: .github/SPONSORS_PROFILE_TEMPLATE_PL.md
  • gotowy pakiet PL do promocji (posty/CTA do release): .github/SPONSORS_OUTREACH_PACK_PL.md
  • szablony community (zgloszenia i PR): .github/ISSUE_TEMPLATE/, .github/PULL_REQUEST_TEMPLATE.md
  • pakiet ustawien strony repo (description/website/topics): .github/REPO_PROFILE_SETUP_PL.md
  • gotowy szkic pierwszego release (PL): .github/RELEASE_DRAFT_PL.md

Licencja

  • Licencja: EPUB Translator Studio Personal Use License v1.0 (LICENSE)
  • Ten projekt jest source-available i nie jest open source (OSI/FSF).
  • Darmowe jest prywatne uzycie niezmienionej wersji.
  • Kazda modyfikacja, redystrybucja lub uzycie komercyjne wymaga pisemnej zgody (COMMERCIAL_LICENSE.md).
  • Proste przyklady:
    • EN: LICENSE_GUIDE_EN.md
    • PL: LICENSE_GUIDE_PL.md
    • DE: LICENSE_GUIDE_DE.md
    • ES: LICENSE_GUIDE_ES.md
    • FR: LICENSE_GUIDE_FR.md
    • PT: LICENSE_GUIDE_PT.md