Příručka AIHook Desktop

1. Co je AIHook Desktop

AIHook Desktop je počítačová aplikace pro Windows, která spojuje na jednom místě:

• Chat s AI modely - stovky modelů různých poskytovatelů (Anthropic, OpenAI, Google, Mistral, Meta a další) přes jeden účet a jeden kredit.
• Code tab - lokální programátorský agent, který čte, upravuje a sestavuje kód přímo ve vašem projektu na disku.
• Agenty - hotové pracovní postupy (např. zpracování skenovaných dokumentů, OCR, export do Wordu nebo XML).
• Paměť (RAG) - model si pamatuje vaše dokumenty a starší konverzace.

Co je důležité vědět:

• Jeden kredit, všechny modely. Platíte jen za spotřebu podle ceníku modelu (v eurech). Žádné předplatné.
• Data zůstávají u vás. Konverzace, projekty a paměť jsou uloženy lokálně v databázi vedle aplikace. Na server se posílají jen požadavky na AI model.
• Přenosné. Aplikaci i s daty můžete mít na USB disku a spustit ji na jiném počítači.
• Jedna produkční adresa. Nainstalovaná aplikace komunikuje výhradně se serverem https://app.aihook.dev.

2. Instalace a první spuštění

2.1 Dvě formy distribuce

2.2 Kde jsou data

Data jsou vždy vedle programu:

<složka aplikace>\
  AIHook.exe
  data\        <- databáze konverzací, paměť (RAG), nastavení
  projects\    <- pracovní složky projektů (pokud je aplikace vytváří)

Důsledky:

• Zálohu uděláte zkopírováním celé složky.
• Při přesunu na jiný disk/PC se uložené cesty automaticky přepočítají (pracovní složky pod složkou aplikace se ukládají relativně).
• Aktualizace na novou verzi: nainstalujte novou verzi přes stávající nebo rozbalte zip do stejné složky - data v data\ zůstanou.
• Při odinstalaci se data standardně ponechají.

2.3 První spuštění

1. Zobrazí se uvítací okno s přihlášením (e-mail + heslo k účtu AIHook).
2. Jazyk: při úplně prvním spuštění aplikace použije jazyk vašeho operačního systému (slovenština, čeština, němčina, angličtina), jinak angličtinu. Jazyk můžete přepnout tlačítky v úvodním okně nebo později v Nastavení; vaše volba se již nemění.
3. Po přihlášení aplikace stáhne seznam modelů a agentů.
4. Pokud ještě nemáte na ploše odkaz, aplikace vám ho nabídne (nikdy nepřepíše existující).
5. Dobijte kredit (Nastavení → Účet → Dobít kredit) a můžete psát.

Účet a kredit se spravují na webu app.aihook.dev (registrace, faktury, týmy). Aplikace slouží k práci s AI.

3. Rozložení okna

┌────────────────────────────────────────────────────────────┐
│ ● AIHook          název konverzace      (€ 12.34) 🌙 ⚙ – ▢ ✕│  titulní lišta
├───────────────┬────────────────────────────────────────────┤
│ ⌂ Chat │ </> Code │ ⚡ Agent │                                │
│ + Nová konverzace  │       oblast chatu / agenta            │
│ 🔍 Hledat…    │                                            │
│ PROJEKTY      │                                            │
│ DNES          │  ───────────────────────────────────────── │
│  konverzace   │  [vstupní řádek + panel nástrojů]           │
│ Můj účet   ⚙ │                                            │
└───────────────┴────────────────────────────────────────────┘

Titulní lišta

• Zůstatek kreditu (zelená tečka + částka v €), po kliknutí nastavení/účet.
• Přepínač tématu (tmavé/světlé), nastavení (ozubené kolo).
• Minimalizovat / maximalizovat / zavřít. Zavření (✕) skryje aplikaci do systémové lišty - běží dál. Úplné ukončení: pravé tlačítko na ikoně v liště → Ukončit.

Levý panel (sidebar)

• Tři karty: Chat, Code, Agent.
• Tlačítko Nová konverzace, vyhledávání v konverzacích.
• Projekty (rozbalitelné), pod nimi konverzace seskupené podle dne.
• Dole: přihlášený uživatel, zůstatek a ozubené kolo.

4. Chat (karta ⌂ Chat)

Běžný rozhovor s AI modelem.

4.1 Odeslání zprávy

• Enter odešle, Shift+Enter vloží nový řádek.
• Odpověď se zobrazuje postupně (streaming). Zastavit ji můžete tlačítkem stop.
• Pod poslední odpovědí je Regenerate - znovu vygeneruje odpověď.
• Každá odpověď má tlačítko Kopírovat. Odpovědi obsahující JSON mají export do Wordu (DOC) a DASTA XML (pro zdravotnické agenty).
• Bloky ```svg se vykreslí jako obrázek s tlačítky stažení SVG / PNG / JPG.

4.2 Výběr modelu

Kliknutím na název modelu nad vstupním polem se otevře výběr modelu:

• Auto - automatický výběr podle kontextu.
• Vyhledávání podle názvu.
• Filtry: Všechny, ★ Oblíbené, EU/GDPR, Code, Reasoning, Tools.
• Značky u modelů: EU (evropský poskytovatel), Code, Reason, Vision (vidí obrázky), OCR, Tools (podporuje nástroje/soubory).
• Hvězdička ★ přidá model do oblíbených.
• Řazení podle ceny.
• Cena modelu je vždy prodejní cena v €:
• IN = cena za vstup (to, co posíláte), OUT = cena za výstup (odpověď),
• modely účtované za stranu (OCR) mají €x.xxxx/str,
• „—" = cena není k dispozici, „zdarma" = bezplatný model.
• Výběr se ukládá ke každé konverzaci zvlášť.

Jednotku ceny přepnete v Nastavení (1K = za 1 000 tokenů, výchozí, nebo 1M = za milion tokenů).

4.3 Indikátor kontextu

U modelu je údaj Xk / Yk (Z %) - kolik z kontextového okna modelu je využito. Barva: šedá → oranžová (od 50 %) → červená (od 80 %).

Při zaplnění aplikace automaticky zkomprimuje starou historii (shrnutí levným modelem, poslední zprávy zůstanou) - viz Nastavení → Komprimace.

4.4 Panel nástrojů u vstupu

4.5 Zmínky @

V poli napište @ a vyberte:

• @soubor - vloží obsah souboru z pracovní složky,
• @složka - vloží strom složky,
• @url - vloží obsah webové stránky.

4.6 Koncepty a rozepsané texty

Rozepsaný text se ukládá jako koncept ke každé konverzaci - při přepnutí na jinou konverzaci a zpět se neztratí a po odeslání se smaže.

5. Konverzace a projekty

Konverzace

• Název se vytvoří automaticky z první zprávy (prvních 60 znaků); přejmenovat ho můžete dvojklikem.
• Starší obsah se donačítá postupně (po 50 zprávách) při posunu nahoru.
• Mazání vyžaduje potvrzení v okně aplikace.
• Konverzaci můžete přetáhnout myší do projektu (nebo zpět do sekce dne).

Projekty

Projekt seskupuje konverzace a dává jim společná nastavení:

• Systémový prompt projektu - platí pro všechny chaty v projektu.
• Pracovní složka projektu - Code/agent v projektu pracuje v této složce (konverzace ji může přepsat vlastní).
• RAG zdroje projektu - společná paměť pro všechny konverzace projektu.
• Kontextové menu (⋯): Přejmenovat / Systémový prompt / RAG / Smazat.
• ＋ u projektu vytvoří nový chat přímo v něm.

6. Paměť (RAG)

RAG umožní modelu odpovídat na základě vašich souborů a minulých rozhovorů, nejen vlastních znalostí.

Jak to funguje

1. Vyberete zdroj (složku se soubory) a aplikace ji zaindexuje - rozdělí na úseky a vytvoří embeddingy (číselné otisky významu) přes server.
2. U každé zprávy aplikace vyhledá nejpodobnější úseky (podobnost minimálně 0,25) a přidá je modelu jako kontext.
3. Po každé odpovědi se dvojice otázka+odpověď automaticky uloží do paměti chatu.

Zdroj paměti

• 💬 Chat - jen aktuální konverzace.
• 🗂 Projekt - všechny konverzace a soubory projektu (zobrazí se, když je konverzace v projektu).

Panel paměti (pravý klik na ikonu 🗄 nebo „RAG" v menu projektu)

• seznam zdrojů a souborů, filtr, hledání v obsahu, odstranění souborů,
• osiřelé soubory - soubory, které byly indexovány, ale na disku už nejsou (Odstranit / Ponechat / Zavřít),
• průběh indexování, vymazání paměti.

Změna embedding modelu V Nastavení můžete změnit embedding model. Změna přebuduje všechny embeddingy - zobrazí se okno s průběhem, které nelze zavřít, aplikace nejde ukončit a po restartu pokračuje tam, kde skončila. V Nastavení → RAG se model vybírá ze seznamu, který vrátí server (název a cena podle zvolené jednotky 1K/1M, bez označení původu). Díky tomu můžete přejít k jinému dodavateli, pokud jeden vypadne. Pokud zvolený model server již nenabízí, je označen „nedostupný“ a je třeba vybrat jiný.

Poplatky: embeddingy se účtují z kreditu jako ostatní volání.

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

Code tab je AI asistent, který pracuje přímo s vaším projektem na disku: čte soubory, hledá v nich, upravuje je, spouští příkazy a kompiluje.

7.1 Začátek práce

1. Nová relace.
2. Vyberte pracovní složku (tlačítko 📁). Agent se nikdy nedostane mimo povolené složky bez vašeho souhlasu.
3. Zadejte úkol a stiskněte Enter.

7.2 Tři modely: Scout, Coder, Chat

V Code tabu nastavujete až tři nezávislé modely, každý může být jiný:

Každý výběr je malý rozbalovací seznam s cenou, stejně jako v Chatu.

7.3 Dva režimy práce

Dual (Scout → Coder)

1. Scout (levný model) přečte projekt, najde relevantní místa a připraví pro Codera shrnutí a úryvky z velkých souborů.
2. Coder (dražší model) dostane čistý kontext a provede změny.
3. Pokud jde jen o otázku nebo vysvětlení, Scout odpoví sám a Codera nevolá - ušetříte.

Výhoda: drahý model nespaluje tokeny na prohledávání projektu.

Plan/Act (jeden model)

1. Plan - model projekt prozkoumá a navrhne postup (nezapisuje).
2. Act - tentýž model plán provede se všemi nástroji.

Výhoda: jednodušší, jeden model, plný kontext.

Během běhu vidíte štítek fáze: 🔭 Scout analyzuje → 📋 Plánování → ⚡ Kódování / Provádění, a počítadlo Iterace X/30 (agent má strop 30 kroků). Tlačítkem stop ho kdykoli přerušíte.

7.4 Myšlení (Thinking)

Pro modely s rozšířeným uvažováním nastavíte úroveň: Vyp., Nízké, Střední, Vysoké, Max (rozpočet přibližně 1 024 / 8 192 / 32 768 / 65 536 tokenů na uvažování). Vyšší úroveň = kvalitnější, ale pomalejší a dražší odpověď. Nastavení se ukládá. Je zde také limit výstupních tokenů (Max tok.).

7.5 Nástroje agenta

Každé volání nástroje vidíte v rozbalovací „bublině" s argumenty a výsledkem.

7.6 Oprávnění a bezpečnost

Při zápisech a příkazech se zobrazí okno oprávnění:

• Povolit jednou - jen tato operace,
• Vždy pro složku - po zbytek relace pro danou složku,
• Auto (pracovní složka) - agent smí zapisovat v celé pracovní složce bez ptaní (zelený štítek 🔓 Auto; kliknutím ho vypnete),
• Zamítnout. Bez odpovědi do 5 minut se operace zamítne.

7.7 Zálohy souborů (Checkpoints / Undo)

• Před každou změnou souboru agent automaticky uloží zálohu do .aihook\checkpoints\ v projektu (jedna záloha na soubor za relaci, max 30).
• Tlačítko 🕐 v liště složky zobrazí zálohy a ↩ Obnovit vrátí předchozí stav.
• Vypnout se dá v Nastavení (standardně zapnuto).

7.8 Náhled a editor souborů

Pravý panel zobrazuje soubory, které agent vytvořil nebo změnil, a otevřít můžete i vlastní:

• Editor se zvýrazněním syntaxe (včetně Pascal/Delphi) a ukládáním,
• HTML náhled, DOCX, XLSX/CSV, obrázky,
• více karet najednou, strom projektu (🗂), „Otevřít soubor z disku".

7.9 Sestavení (build)

V liště složky je tlačítko build. Rozpozná jazyk projektu podle souborů a nabídne příkaz, který si můžete upravit:

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 se zobrazuje průběžně, chyby a upozornění jsou barevně zvýrazněny.
• 🤖 Oprav chyby pošle chyby automaticky agentovi.
• Úprava příkazu se ukládá do .aihook\build.json v projektu.
• Pro Delphi je nativní integrace: výběr verze kompilátoru, Win32/Win64, Debug/Release, počet chyb.

7.10 Chat vs. agent - kdy co

8. Agent tab (⚡ Agent)

Agenti jsou hotové pracovní postupy nastavené správcem na serveru (model, prompt, nástroje). Vy jen vyberete agenta a zadáte vstup.

8.1 Použití

1. Klikněte na výběr agenta a vyberte ho (vyhledávání podle názvu).
2. Napište zprávu nebo přiložte soubor/sken (PDF, obrázky).
3. Agent zpracuje vstup a vrátí výsledek.

Konverzace se v bočním panelu filtrují podle vybraného agenta.

8.2 Co agenti umí

• Skenovaná PDF se rozloží na stránky a zpracují po jedné (průběh „Konvertuji strany x/y").
• OCR s dvoufázovým zpracováním: nejprve se okamžitě zobrazí vyextrahovaný text, poté ho model zstrukturuje (např. do JSON).
• Export výsledků: Word (DOC) a DASTA XML (windows-1250, strukturovaný název souboru; při více dokumentech se uloží do vybrané složky).
• Pracovní složka a nástroje (agent může číst/zapisovat soubory s povolením).

8.3 Watchdog (sledování složky)

Agent může sledovat složku (👁): když tam přibude nový soubor, automaticky ho zpracuje a výsledek uloží do výstupní složky. Zelený indikátor ukazuje, že sledování běží. Při startu se zpracují i soubory, které už ve složce jsou.

8.4 Skener

Tlačítko skenování zavolá NAPS2 s vaším profilem (Nastavení → Obecné → Skener). Naskenovaný dokument se přiloží ke zprávě.

8.5 Viditelnost agentů

Nastavení → Agenti: přepínači určíte, které agenty chcete vidět v seznamu. Počet a přístup k agentům určuje správce účtu (globální / vybraní / soukromí).

9. Nastavení (⚙)

Komprimace historie

• Komprimační model - levný model na shrnutí (prázdné = použije se aktivní).
• Práh (%) - při jakém zaplnění kontextu se historie zkomprimuje (standardně 80 %).
• Poslední zprávy zůstávají v původním znění.

Synchronizace modelů

• Seznam modelů se obnovuje při startu, po přihlášení a každou hodinu.
• Pod tlačítky vidíte čas poslední synchronizace, nebo chybu a tlačítko pro opakování.
• Modely, které server už nevrací, se ze seznamu odstraní.
• Vyčistit cache modelů smaže lokální seznam a stáhne ho znovu.

10. Kredit a ceny

• Kredit se odečítá po každém volání podle spotřeby tokenů (nebo stran u OCR).
• Zůstatek je vždy v titulní liště; po každé odpovědi se aktualizuje.
• Při nulovém zůstatku modely nefungují, dokud kredit nedobijete.
• Zobrazené ceny jsou prodejní ceny v eurech.
• Dobití: Nastavení → Účet → Dobít kredit (platební brána v samostatném okně), po zavření se zůstatek obnoví sám.

11. Soukromí a bezpečnost

• Konverzace, projekty a paměť jsou lokální na vašem disku.
• Na server se odesílá jen to, co je potřeba k zodpovězení: zprávy, vybrané úryvky souborů a obsah RAG, který se přidává jako kontext.
• Zápisy a příkazy agenta vyžadují vaše povolení (viz 7.6).
• API klíč se ukládá lokálně; v Nastavení je jen pro čtení.
• Modely s označením EU/GDPR zpracovávají data u evropských poskytovatelů.
• Citlivé dokumenty nevkládejte do modelů, kterým nedůvěřujete; vždy kontrolujte označení modelu.

12. Klávesové zkratky

13. Řešení problémů

14. Často kladené otázky

Potřebuji vlastní API klíče k OpenAI/Anthropic? Ne. Všechny modely jsou dostupné přes účet AIHook a jeden kredit.

Mohu používat aplikaci offline? Prohlížení konverzací ano, odpovědi AI vyžadují připojení.

Mohu mít Scout a Coder od různých poskytovatelů? Ano, každá role má vlastní výběr modelu.

Kolik stojí jedna odpověď? Odhad najdete ve výběru modelu (IN/OUT za 1K nebo 1M tokenů). Skutečná spotřeba se odečte z kreditu po odpovědi.

Dá se zálohovat? Zkopírováním složky data\ (aplikace musí být zavřená).

Je aplikace dostupná pro macOS/Linux? Aktuálně jen pro Windows.

15. Plánované funkce

• Automatická aktualizace a upozornění na novou verzi.
• Hlasový vstup.
• Zobrazení rozdílů (diff) před aplikováním změn agenta s potvrzením.
• Podpora MCP serverů a hooků.
• Git integrace, sub-agenti, plánované spouštění agentů.
• Seskupování konverzací podle data v bočním panelu.