Príručka AIHook Desktop

1. Čo je AIHook Desktop

AIHook Desktop je počítačová aplikácia pre Windows, ktorá spája na jednom mieste:

• Chat s AI modelmi - stovky modelov rôznych poskytovateľov (Anthropic, OpenAI, Google, Mistral, Meta a ďalší) cez jeden účet a jeden kredit.
• Code tab - lokálny programátorský agent, ktorý číta, upravuje a zostavuje kód priamo vo vašom projekte na disku.
• Agentov - hotové pracovné postupy (napr. spracovanie skenovaných dokumentov, OCR, export do Wordu alebo XML).
• Pamäť (RAG) - model si pamätá vaše dokumenty a staršie konverzácie.

Čo je dôležité vedieť:

• Jeden kredit, všetky modely. Platíte len za spotrebu podľa cenníka modelu (v eurách). Žiadne predplatné.
• Dáta ostávajú u vás. Konverzácie, projekty a pamäť sú uložené lokálne v databáze vedľa aplikácie. Na server sa posielajú len požiadavky na AI model.
• Prenosné. Aplikáciu aj s dátami môžete mať na USB disku a spustiť ju na inom počítači.
• Jedna produkčná adresa. Nainštalovaná aplikácia komunikuje výhradne so serverom https://app.aihook.dev.

2. Inštalácia a prvé spustenie

2.1 Dve formy distribúcie

2.2 Kde sú dáta

Dáta sú vždy vedľa programu:

<priečinok aplikácie>\
  AIHook.exe
  data\        <- databáza konverzácií, pamäť (RAG), nastavenia
  projects\    <- pracovné priečinky projektov (ak ich appka vytvára)

Dôsledky:

• Zálohu urobíte skopírovaním celého priečinka.
• Pri presune na iný disk/PC sa uložené cesty automaticky prepočítajú (pracovné priečinky pod priečinkom aplikácie sa ukladajú relatívne).
• Aktualizácia na novú verziu: nainštalujte novú verziu cez existujúcu alebo rozbaľte zip do toho istého priečinka - dáta v data\ ostanú.
• Pri odinštalovaní sa dáta predvolene ponechajú.

2.3 Prvé spustenie

1. Zobrazí sa uvítacie okno s prihlásením (e-mail + heslo k účtu AIHook).
2. Jazyk: pri úplne prvom spustení appka použije jazyk vášho operačného systému (slovenčina, čeština, nemčina, angličtina), inak angličtinu. Jazyk môžete prepnúť tlačidlami v uvítacom okne alebo neskôr v Nastaveniach; vaša voľba sa už nemení.
3. Po prihlásení appka stiahne zoznam modelov a agentov.
4. Ak ešte nemáte na ploche odkaz, appka vám ho ponúkne (nikdy neprepíše existujúci).
5. Dobite kredit (Nastavenia → Účet → Dobiť kredit) a môžete písať.

Účet a kredit sa spravujú na webe app.aihook.dev (registrácia, faktúry, tímy). Aplikácia slúži na prácu s AI.

3. Rozloženie okna

┌────────────────────────────────────────────────────────────┐
│ ● AIHook          názov konverzácie     (€ 12.34) 🌙 ⚙ – ▢ ✕│  titulný pruh
├───────────────┬────────────────────────────────────────────┤
│ ⌂ Chat │ </> Code │ ⚡ Agent │                                │
│ + Nová konverzácia │       oblasť chatu / agenta            │
│ 🔍 Hľadať…    │                                            │
│ PROJEKTY      │                                            │
│ DNES          │  ───────────────────────────────────────── │
│  konverzácie  │  [vstupný riadok + panel nástrojov]         │
│ Môj účet   ⚙ │                                            │
└───────────────┴────────────────────────────────────────────┘

Titulný pruh

• Zostatok kreditu (zelená bodka + suma v €), po kliknutí nastavenia/účet.
• Prepínač témy (tmavá/svetlá), nastavenia (ozubené koleso).
• Minimalizovať / maximalizovať / zavrieť. Zavretie (✕) skryje aplikáciu do systémovej lišty - beží ďalej. Úplné ukončenie: pravé tlačidlo na ikone v lište → Ukončiť.

Ľavý panel (sidebar)

• Tri karty: Chat, Code, Agent.
• Tlačidlo Nová konverzácia, vyhľadávanie v konverzáciách.
• Projekty (rozbaliteľné), pod nimi konverzácie zoskupené podľa dňa.
• Dole: prihlásený používateľ, zostatok a ozubené koleso.

4. Chat (karta ⌂ Chat)

Bežný rozhovor s AI modelom.

4.1 Odoslanie správy

• Enter odošle, Shift+Enter vloží nový riadok.
• Odpoveď sa zobrazuje postupne (streaming). Zastaviť ju môžete tlačidlom stop.
• Pod poslednou odpoveďou je Regenerate - znova vygeneruje odpoveď.
• Každá odpoveď má tlačidlo Kopírovať. Odpovede obsahujúce JSON majú export do Wordu (DOC) a DASTA XML (pre zdravotnícke agenty).
• Bloky ```svg sa vykreslia ako obrázok s tlačidlami stiahnutia SVG / PNG / JPG.

4.2 Výber modelu

Kliknutím na názov modelu nad vstupným poľom sa otvorí výber modelu:

• Auto - automatický výber podľa kontextu.
• Vyhľadávanie podľa názvu.
• Filtre: Všetky, ★ Obľúbené, EU/GDPR, Code, Reasoning, Tools.
• Značky pri modeloch: EU (európsky poskytovateľ), Code, Reason, Vision (vidí obrázky), OCR, Tools (podporuje nástroje/súbory).
• Hviezdička ★ pridá model do obľúbených.
• Zoradenie podľa ceny.
• Cena modelu je vždy predajná cena v €:
• IN = cena za vstup (to, čo posielate), OUT = cena za výstup (odpoveď),
• modely účtované za stranu (OCR) majú €x.xxxx/str,
• „—" = cena nie je k dispozícii, „zadarmo" = bezplatný model.
• Výber sa ukladá ku každej konverzácii zvlášť.

Jednotku ceny prepnete v Nastaveniach (1K = za 1 000 tokenov, predvolené, alebo 1M = za milión tokenov).

4.3 Indikátor kontextu

Pri modeli je údaj Xk / Yk (Z %) - koľko z kontextového okna modelu je využité. Farba: sivá → oranžová (od 50 %) → červená (od 80 %).

Pri zaplnení appka automaticky skomprimuje starú históriu (zhrnutie lacným modelom, posledné správy ostanú) - pozri Nastavenia → Komprimácia.

4.4 Panel nástrojov pri vstupe

4.5 Zmienky @

V poli napíšte @ a vyberte:

• @súbor - vloží obsah súboru z pracovného priečinka,
• @priečinok - vloží strom priečinka,
• @url - vloží obsah webovej stránky.

4.6 Koncepty a rozpísané texty

Rozpísaný text sa ukladá ako koncept ku každej konverzácii - pri prepnutí na inú konverzáciu a späť sa nestratí a po odoslaní sa zmaže.

5. Konverzácie a projekty

Konverzácie

• Názov sa vytvorí automaticky z prvej správy (prvých 60 znakov); premenovať ho môžete dvojklikom.
• Starší obsah sa donačítava postupne (po 50 správach) pri posune nahor.
• Mazanie vyžaduje potvrdenie v okne aplikácie.
• Konverzáciu môžete pretiahnuť myšou do projektu (alebo späť do sekcie dňa).

Projekty

Projekt zoskupuje konverzácie a dáva im spoločné nastavenia:

• Systémový prompt projektu - platí pre všetky chaty v projekte.
• Pracovný priečinok projektu - Code/agent v projekte pracuje v tomto priečinku (konverzácia ho môže prepísať vlastným).
• RAG zdroje projektu - spoločná pamäť pre všetky konverzácie projektu.
• Kontextové menu (⋯): Premenovať / Systémový prompt / RAG / Zmazať.
• ＋ pri projekte vytvorí nový chat priamo v ňom.

6. Pamäť (RAG)

RAG umožní modelu odpovedať na základe vašich súborov a minulých rozhovorov, nielen vlastných vedomostí.

Ako to funguje

1. Vyberiete zdroj (priečinok so súbormi) a appka ho zaindexuje - rozdelí na úseky a vytvorí embeddingy (číselné odtlačky významu) cez server.
2. Pri každej správe appka vyhľadá najpodobnejšie úseky (podobnosť minimálne 0,25) a pridá ich modelu ako kontext.
3. Po každej odpovedi sa dvojica otázka+odpoveď automaticky uloží do pamäte chatu.

Zdroj pamäte

• 💬 Chat - len aktuálna konverzácia.
• 🗂 Projekt - všetky konverzácie a súbory projektu (zobrazí sa, keď je konverzácia v projekte).

Panel pamäte (pravý klik na ikonu 🗄 alebo „RAG" v menu projektu)

• zoznam zdrojov a súborov, filter, hľadanie v obsahu, odstránenie súborov,
• osirelé súbory - súbory, ktoré boli indexované, ale na disku už nie sú (Odstrániť / Ponechať / Zavrieť),
• priebeh indexovania, vymazanie pamäte.

Zmena embedding modelu V Nastaveniach môžete zmeniť embedding model. Zmena prebuduje všetky embeddingy - zobrazí sa okno s priebehom, ktoré sa nedá zavrieť, aplikácia nejde ukončiť a po reštarte pokračuje tam, kde skončila. V Nastaveniach → RAG sa model vyberá zo zoznamu, ktorý vráti server (názov a cena podľa zvolenej jednotky 1K/1M, bez označenia pôvodu). Vďaka tomu môžete prejsť na iného dodávateľa, ak jeden vypadne. Ak zvolený model server už neponúka, je označený „nedostupný“ a treba vybrať iný.

Poplatky: embeddingy sa účtujú z kreditu ako ostatné volania.

7. Code tab (</> Code) - lokálny programátorský agent

Code tab je AI asistent, ktorý pracuje priamo s vaším projektom na disku: číta súbory, hľadá v nich, upravuje ich, spúšťa príkazy a kompiluje.

7.1 Začiatok práce

1. Nová relácia.
2. Vyberte pracovný priečinok (tlačidlo 📁). Agent sa nikdy nedostane mimo povolených priečinkov bez vášho súhlasu.
3. Zadajte úlohu a stlačte Enter.

7.2 Tri modely: Scout, Coder, Chat

V Code tabe nastavujete až tri nezávislé modely, každý môže byť iný:

Každý výber je malý rozbaľovací zoznam s cenou, rovnako ako v Chate.

7.3 Dva režimy práce

Dual (Scout → Coder)

1. Scout (lacný model) prečíta projekt, nájde relevantné miesta a pripraví pre Codera zhrnutie a úryvky z veľkých súborov.
2. Coder (drahší model) dostane čistý kontext a vykoná zmeny.
3. Ak ide len o otázku alebo vysvetlenie, Scout odpovie sám a Codera nevolá - ušetríte.

Výhoda: drahý model nepáli tokeny na prehľadávanie projektu.

Plan/Act (jeden model)

1. Plan - model projekt preskúma a navrhne postup (nezapisuje).
2. Act - ten istý model plán vykoná so všetkými nástrojmi.

Výhoda: jednoduchšie, jeden model, plný kontext.

Počas behu vidíte štítok fázy: 🔭 Scout analyzuje → 📋 Plánovanie → ⚡ Kódovanie / Vykonávanie, a počítadlo Iterácia X/30 (agent má strop 30 krokov). Tlačidlom stop ho kedykoľvek prerušíte.

7.4 Myslenie (Thinking)

Pre modely s rozšíreným uvažovaním nastavíte úroveň: Vyp., Nízke, Stredné, Vysoké, Max (rozpočet približne 1 024 / 8 192 / 32 768 / 65 536 tokenov na uvažovanie). Vyššia úroveň = kvalitnejšia, ale pomalšia a drahšia odpoveď. Nastavenie sa ukladá. Je tu aj limit výstupných tokenov (Max tok.).

7.5 Nástroje agenta

Každé volanie nástroja vidíte v rozbaľovacej „bubline" s argumentmi a výsledkom.

7.6 Povolenia a bezpečnosť

Pri zápisoch a príkazoch sa zobrazí okno povolenia:

• Povoliť raz - len táto operácia,
• Vždy pre priečinok - po zvyšok relácie pre daný priečinok,
• Auto (pracovný priečinok) - agent smie zapisovať v celom pracovnom priečinku bez pýtania (zelený štítok 🔓 Auto; kliknutím ho vypnete),
• Zamietnuť. Bez odpovede do 5 minút sa operácia zamietne.

7.7 Zálohy súborov (Checkpoints / Undo)

• Pred každou zmenou súboru agent automaticky uloží zálohu do .aihook\checkpoints\ v projekte (jedna záloha na súbor za reláciu, max 30).
• Tlačidlo 🕐 v lište priečinka zobrazí zálohy a ↩ Obnoviť vráti predchádzajúci stav.
• Vypnúť sa dá v Nastaveniach (predvolene zapnuté).

7.8 Náhľad a editor súborov

Pravý panel zobrazuje súbory, ktoré agent vytvoril alebo zmenil, a otvoriť môžete aj vlastné:

• Editor s farbením syntaxe (vrátane Pascal/Delphi) a ukladaním,
• HTML náhľad, DOCX, XLSX/CSV, obrázky,
• viac kariet naraz, strom projektu (🗂), „Otvoriť súbor z disku".

7.9 Zostavenie (build)

V lište priečinka je tlačidlo build. Rozpozná jazyk projektu podľa súborov a ponúkne príkaz, ktorý si môžete upraviť:

Delphi/Pascal, C#, Rust, Go, Java (Maven/Gradle), C/C++ (CMake/Make), Elixir, Zig, Haskell, JS/TS (npm/yarn/pnpm), TypeScript, Python (kontrola syntaxe), Arduino/ESP32 (arduino-cli / PlatformIO).

• Výstup sa zobrazuje priebežne, chyby a upozornenia sú farebne zvýraznené.
• 🤖 Oprav chyby pošle chyby automaticky agentovi.
• Úprava príkazu sa ukladá do .aihook\build.json v projekte.
• Pre Delphi je natívna integrácia: výber verzie kompilátora, Win32/Win64, Debug/Release, počet chýb.

7.10 Chat vs. agent - kedy čo

8. Agent tab (⚡ Agent)

Agenti sú hotové pracovné postupy nastavené správcom na serveri (model, prompt, nástroje). Vy len vyberiete agenta a zadáte vstup.

8.1 Použitie

1. Kliknite na výber agenta a vyberte ho (vyhľadávanie podľa názvu).
2. Napíšte správu alebo priložte súbor/sken (PDF, obrázky).
3. Agent spracuje vstup a vráti výsledok.

Konverzácie sa v bočnom paneli filtrujú podľa vybraného agenta.

8.2 Čo agenti vedia

• Skenované PDF sa rozložia na stránky a spracujú po jednej (priebeh „Konvertujem strany x/y").
• OCR s dvojfázovým spracovaním: najprv sa okamžite zobrazí vyextrahovaný text, potom ho model zoštruktúruje (napr. do JSON).
• Export výsledkov: Word (DOC) a DASTA XML (windows-1250, štruktúrovaný názov súboru; pri viacerých dokumentoch sa uložia do vybraného priečinka).
• Pracovný priečinok a nástroje (agent môže čítať/zapisovať súbory s povolením).

8.3 Watchdog (sledovanie priečinka)

Agent môže sledovať priečinok (👁): keď tam pribudne nový súbor, automaticky ho spracuje a výsledok uloží do výstupného priečinka. Zelený indikátor ukazuje, že sledovanie beží. Pri štarte sa spracujú aj súbory, ktoré už v priečinku sú.

8.4 Skener

Tlačidlo skenovania zavolá NAPS2 s vaším profilom (Nastavenia → Všeobecné → Skener). Naskenovaný dokument sa priloží k správe.

8.5 Viditeľnosť agentov

Nastavenia → Agenti: prepínačmi určíte, ktorých agentov chcete vidieť v zozname. Počet a prístup k agentom určuje správca účtu (globálni / vybraní / súkromní).

9. Nastavenia (⚙)

Komprimácia histórie

• Komprimačný model - lacný model na zhrnutie (prázdne = použije sa aktívny).
• Prah (%) - pri akom zaplnení kontextu sa história skomprimuje (predvolene 80 %).
• Posledné správy ostávajú v pôvodnom znení.

Synchronizácia modelov

• Zoznam modelov sa obnovuje pri štarte, po prihlásení a každú hodinu.
• Pod tlačidlami vidíte čas poslednej synchronizácie, alebo chybu a tlačidlo na opakovanie.
• Modely, ktoré server už nevracia, sa zo zoznamu odstránia.
• Vyčistiť cache modelov zmaže lokálny zoznam a stiahne ho znova.

10. Kredit a ceny

• Kredit sa odpočítava po každom volaní podľa spotreby tokenov (alebo strán pri OCR).
• Zostatok je vždy v titulnom pruhu; po každej odpovedi sa aktualizuje.
• Pri nulovom zostatku modely nefungujú, kým kredit nedobijete.
• Zobrazované ceny sú predajné ceny v eurách.
• Dobitie: Nastavenia → Účet → Dobiť kredit (platobná brána v samostatnom okne), po zatvorení sa zostatok obnoví sám.

11. Súkromie a bezpečnosť

• Konverzácie, projekty a pamäť sú lokálne na vašom disku.
• Na server sa odosiela len to, čo je potrebné na zodpovedanie: správy, vybrané úryvky súborov a obsah RAG, ktorý sa pridáva ako kontext.
• Zápisy a príkazy agenta vyžadujú vaše povolenie (viď 7.6).
• API kľúč sa ukladá lokálne; v Nastaveniach je len na čítanie.
• Modely s označením EU/GDPR spracúvajú dáta u európskych poskytovateľov.
• Citlivé dokumenty nevkladajte do modelov, ktorým nedôverujete; vždy kontrolujte označenie modelu.

12. Klávesové skratky

13. Riešenie problémov

14. Často kladené otázky

Potrebujem vlastné API kľúče k OpenAI/Anthropic? Nie. Všetky modely sú dostupné cez účet AIHook a jeden kredit.

Môžem používať appku offline? Prezeranie konverzácií áno, odpovede AI vyžadujú pripojenie.

Môžem mať Scout a Coder od rôznych poskytovateľov? Áno, každá rola má vlastný výber modelu.

Koľko stojí jedna odpoveď? Odhad nájdete v výbere modelu (IN/OUT za 1K alebo 1M tokenov). Skutočná spotreba sa odpočíta z kreditu po odpovedi.

Dá sa zálohovať? Skopírovaním priečinka data\ (appka musí byť zatvorená).

Je aplikácia dostupná pre macOS/Linux? Aktuálne len pre Windows.

15. Plánované funkcie

• Automatická aktualizácia a upozornenie na novú verziu.
• Hlasový vstup.
• Zobrazenie rozdielov (diff) pred aplikovaním zmien agenta s potvrdením.
• Podpora MCP serverov a hookov.
• Git integrácia, sub-agenti, plánované spúšťanie agentov.
• Zoskupovanie konverzácií podľa dátumu v bočnom paneli.