Cursor Metrics — testovací balíček
==================================

Co je v balíčku
---------------
  Python skripty aplikace (tray ikona + okno s využitím Cursor účtu).
  Aplikace NENÍ .exe — běží přes nainstalovaný Python na vašem PC.
  Přihlášení k Cursor API se bere automaticky z lokální instalace Cursoru
  (soubor state.vscdb). Do configu se nic nekopíruje, cookie nepotřebujete.


Požadavky (musí být na PC předem)
---------------------------------
  - Windows 10 nebo 11
  - Python 3.11 nebo novější
      Stáhnout: https://www.python.org/downloads/
      Při instalaci ZAPNĚTE: "Add python.exe to PATH"
      (tkinter je součástí standardní instalace Pythonu na Windows)
  - Nainstalovaný Cursor IDE a přihlášený účet
      Aplikace Cursor musí být alespoň jednou spuštěná, aby existoval
      soubor s tokenem: %APPDATA%\Cursor\User\globalStorage\state.vscdb


Co dělá install.bat (jednorázově, před prvním spuštěním)
-------------------------------------------------------
  install.bat NESPOUŠTÍ aplikaci. Pouze připraví prostředí ve složce,
  kam jste balíček rozbalili.

  1) Ověří, že příkaz "python" funguje (Python je v PATH).
     Když ne — skončí s chybou a návodem nainstalovat Python.

  2) Vytvoří složku .venv (virtuální prostředí Pythonu), pokud ještě neexistuje.
     .venv = izolovaná kopie Pythonu jen pro tuto aplikaci;
     nezasahuje do systémových balíčků ani jiných projektů.

  3) Do .venv nainstaluje závislosti z requirements.txt:
       - pystray   (ikona v systémové liště u hodin)
       - Pillow    (generování ikony a grafiky v okně)
     Před instalací ještě aktualizuje pip.

  Co install.bat NEINSTALUJE:
     - Python (musí být už nainstalovaný)
     - Cursor IDE
     - tkinter (součást Pythonu)

  Po úspěchu uvidíte "Hotovo. Spustte start.vbs nebo start.bat".
  install.bat stačí spustit jednou; při aktualizaci balíčku ho spusťte znovu.


Spuštění aplikace (po install.bat)
----------------------------------
  Doporučeno:  start.vbs     — bez černého okna konzole
  Alternativa: start.bat     — stejné chování

  Oba skripty spouštějí main.py přes .venv\Scripts\pythonw.exe
  (pokud existuje .venv; jinak systémové pythonw).

  V liště u hodin se objeví ikona s procentem využití.
  Klik na ikonu = otevře/zavře okno s detaily.
  Pravý klik = menu (Refresh, Open Dashboard, Quit).


Obsah složky (stručně)
----------------------
  main.py, auth.py, api.py, errors.py, ui.py, linux_setup.py, … — kód aplikace
  requirements.txt                   — seznam balíčků pro pip
  config.toml                        — interval refresh, pozice okna
  install.bat                        — příprava .venv (viz výše)
  start.vbs / start.bat              — spuštění aplikace
  VERSION                            — číslo verze balíčku


Řešení problémů
---------------
  "Python neni v PATH"
      → Přeinstalujte Python se zaškrtnutým "Add to PATH",
        nebo spusťte install.bat znovu z nového terminálu.

  "pip install selhal"
      → Zkuste ručně: .venv\Scripts\pip.exe install -r requirements.txt

  cursorAuth/accessToken missing
      → Přihlaste se v Cursoru, aplikaci restartujte.

  API 401 / 403
      → Session vypršela — znovu se přihlaste v Cursoru.

  Aplikace nic neukáže / hned zmizí
      → Spusťte v konzoli pro zobrazení chyby:
        .venv\Scripts\python.exe main.py

  V tabulce jen model "default"
      → U některých účtů očekávané chování (auto/composer bucket).


Verze: viz soubor VERSION
