A világ első, teljes értékű, nyílt forráskódú AI-irodai programcsomagja.
Word-, Excel-, PowerPoint- és PDF-fájlok, amelyeket te és az AI-d szerkesztetek, és amelyek valódi formátumban mentődnek vissza.
English · Español · Português · Deutsch · Français · 简体中文 · 繁體中文 · 한국어 · 日本語 · العربية · Русский · Italiano · Nederlands · Polski · Čeština · Bahasa Indonesia · Bahasa Melayu · ไทย · हिन्दी · עברית · Tiếng Việt · Türkçe · Magyar
Letöltés · Képességek · CLI · MCP · Weboldal · Közösség · X · Adatvédelem
A GenOffice a Microsoft Office ingyenes, nyílt forráskódú alternatívája macOS, Windows és Linux rendszerre. Natív `.docx`, `.xlsx` és `.pptx` fájlokat nyit meg és ment, PDF-, Markdown- és HTML-fájlokat szerkeszt, és minden dokumentum mellé tesz egy AI-ügynököt — nem egy utólag odatoldott csevegőablakot, hanem egy szerkesztőt, amely beolvassa a fájlt, elvégzi a módosítást, és pontosan megmutatja, mit változtatott meg. Az ODF-fájlok (`.odt`, `.ods`, `.odp`, valamint a `.ott`/`.ots`/`.otp` sablonok) szerkeszthető OOXML-másolatként nyílnak meg, ugyanígy a régebbi Word `.doc`/`.dot`, Excel 97 `.xls` és PowerPoint 97–2003 `.ppt` fájlok, valamint a Hancom-dokumentumok (`.hwp`, `.hwpx`); az import csak megnyitásra szolgál — a mentés mindig OOXML-be ír, soha az eredeti formátumba. - **Valódi formátumok, bájtpontos megőrzéssel.** Csak az íródik újra, amit te szerkesztesz. A fájlban minden más bájtról bájtra változatlan marad, így a dokumentumok továbbra is működnek Wordben, Excelben és PowerPointban. - **Olyan AI, amit ellenőrizhetsz.** A módosítások változáskövetéssel és diffként jelennek meg, egyetlen kattintással visszavonhatók. A táblázatok élő képleteket kapnak, beillesztett számok helyett. A diák és oldalak közvetlenül a vásznon jönnek létre, és teljesen szerkeszthetők maradnak. Ha elrejtesz egy kijelölést a Docsban vagy egy cellatartományt a Sheetsben a modell elől, az AI csak egy elnevezett helyőrzőt lát; az eredeti szöveg a fájlban marad, és utána visszakerül. Az elrejtés az alkalmazás AI-ját érinti — a CLI, az MCP-eszközök és a felület nélküli exportálás közvetlenül olvassa a fájlt, ott ezek a szövegek továbbra is látszanak. - **Alapból helyi.** A fájlokat a saját gépeden nyithatod meg, szerkesztheted, mentheted és konvertálhatod. A PDF → Word / Excel / PowerPoint, a Markdown → Word és a HTML → Word konverziók mind az eszközön futnak. Csak az AI-hívások hagyják el a gépet, az általad választott szolgáltatóhoz. - **Fájlok keresése a tartalmuk alapján.** A kezdőképernyő a `.docx`, `.xlsx`, `.pptx`, PDF-, Markdown- és HTML-fájljaid nevében, mappájában és teljes szövegében keres, egy helyi SQLite-indexből, a kínai, japán és koreai (CJK) szöveget is beleértve. Igény szerint a legjobb találatokat a **[TypeSafe Jev](https://typesafe.ai/)** — a System One értékelő modellje — rendezi újra, hogy a kérdésedre válaszoló fájl kerüljön legfelül. - **Kérdezd a fájljaidat, forrásokkal.** Csillagozz meg egy dokumentumkészletet, és a kezdőképernyőn az **AI kérdezése** a rájuk vonatkozó kérdésekre válaszol, minden állításhoz feltüntetve a mögötte álló fájlt, így azt megnyithatod, és ellenőrizheted. - **Saját kulccsal vagy anélkül.** Jelentkezz be Gensparkkal, így nincs szükség kulcsra, vagy használd a saját kulcsodat: Claude, OpenAI, Gemini, DeepSeek, Kimi, GLM, Qwen, Doubao, MiniMax, Grok, Mistral, OpenRouter, Requesty, Opper, Cheaper Inference, Atlas Cloud, illetve bármely OpenAI-kompatibilis végpont, a helyi szervereket is beleértve. - **Szkriptelhető és ügynökbarát.** Az alkalmazás `genoffice` parancssort és egy képességet (skillt) mellékel a Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode és Windsurf számára, így egy kódoló ügynök valódi Office-fájlokat hozhat létre, konvertálhat, olvashat és szerkeszthet a gépeden, ablak megnyitása nélkül. **Töltsd le:** [macOS](https://github.com/genspark-ai/genoffice/releases/latest) (Apple Silicon és Intel) · [Windows](https://github.com/genspark-ai/genoffice/releases/latest) (x64 és Arm) · [Linux](https://github.com/genspark-ai/genoffice/releases/latest) (deb, rpm, AppImage) — a részletekkel és a rendszerkövetelményekkel a [Letöltés](#download) részben találod. ## Demó Hat alkalmazás, egy AI-panel, egy TypeSafe Jevvel újrarendezett fájlkereső, egy AI kérdezése funkció, amely a csillagozott fájljaidból válaszol forrásokkal, valamint egy parancssor a kódoló ügynöködnek. Minden képernyőkép a valódi alkalmazást mutatja macOS-en, az AI-t pedig olyan prompt vezérli, amelyet elolvashatsz a panelen. ### 1 · Docs — `.docx` megnyitása és szerkesztése olyan AI-val, amelyet ellenőrizhetsz![]() |
![]() |
A fájl úgy nyílik meg, ahogy a Word rendezi — kéthasábos szakaszok, szélig érő képek, árnyékolt táblázatok, élőfejek és élőlábak, tördelés a Word sormetrikái szerint. A stílusok, megjegyzések, változáskövetés, egyenletek, tintaírás és tartalomvezérlők mentéskor érintetlenül megmaradnak. A Levelezés lap a dokumentumot körlevélsablonná alakítja: válassz .xlsx vagy .csv címzettlistát, szúrj be valódi MERGEFIELD-eket, nézd meg rekordonként az előnézetet, és egyesíts egyetlen dokumentumba, vagy rekordonként külön .docx-be. |
Kérj szerkesztést — az AI beolvassa a szükséges blokkokat, átírja az Áttekintést, és új, felsorolásos szakaszt szúr be. Minden AI-lépés egy pillanatfelvétel, amelyre visszagörgethetsz; bekapcsolt Változáskövetéssel a módosítások Word-stílusú javaslatokként érkeznek. Kérj helyette gondolattérképet, és a válasz a teljes dokumentum interaktív diagramja lesz: összecsukható ágakkal, nagyítással és pásztázással, a csomópontra kattintva újabb kérdést tehetsz fel, a hivatkozások pedig visszaugranak arra a blokkra, amelyből származnak. |
![]() |
![]() |
Építsd fel — egyetlen mondatból az ügynök egy Összegzés munkalapot vesz fel valódi SUMIF-ekkel régiónként és kategóriánként, beszúr egy oszlopdiagramot, és mind a 43 módosítást egyetlen, egyben visszavonható kötegként alkalmazza. |
Kérdezd meg — a munkafüzetről feltett kérdésekre a magyarázattal együtt megkapod a pontos cellákat is, kattintható hivatkozásként. A motorháztető alatt: saját fejlesztésű Rust .xlsx motor, kimutatások, szeletelők, feltételes formázás, képletkövetés, valamint cellába ágyazott képek az Excel natív gazdag értékeiként (rich value) — az Excel újranyitáskor is a cellában tartja őket. A cellajegyzetek képet is hordozhatnak, amely a jegyzet felugró ablaka alatt jelenik meg. |
![]() |
![]() |
Egyetlen sor bemenetként — „Készíts egy 10 diás befektetői pitch bemutatót az Aurora Home számára…”. A GenOffice megtervezi a történetszálat, utánajár a számoknak, és minden diát valódi .pptx-ként vázol fel a vásznon. |
Kész bemutató kimenetként — tizenegy megtervezett dia egységes tipográfiával, képi világgal és záró felhívással; szerkeszd tovább diamintákkal, elrendezésekkel, intelligens segédvonalakkal és nem roncsoló vágással, vagy kérd meg a panelt az átformázásra, átírásra és átrendezésre. Szúrj be egy .glb fájlt, és az valódi 3D-modell lesz: forgasd el húzással a szerkesztőben; úgy tárolódik, ahogy a PowerPoint a 3D-t tárolja, ezért a PowerPointban is 3D marad. |
.pptx-be mentődnek, és a PowerPoint ugyanígy játssza vissza őket.
### 4 · PDF — PDF-szöveg szerkesztése a helyén, PDF konvertálása Wordbe az eszközön
![]() |
![]() |
| Szerkessz közvetlenül az oldalon — a Szöveg szerkesztése mód körvonalakkal jelöli az összes szövegblokkot, hogy a szöveget a helyén írd át; a tartalomfolyam a PDFiumon keresztül íródik újra az eredeti betűtípusokkal, nem eltakaró jegyzetként. Kérdezd az AI-t egy hosszú jelentésről, és oldalhivatkozásokkal ellátott választ kapsz. | Konvertálj az eszközön — a PDF-konvertáló → PDF Wordbe szerkeszthető .docx-et állít elő, amely a Docsban nyílik meg a forrás mellett, a címsorok, statisztikai sorok és bekezdések érintetlenül maradnak. Az Excel és PowerPoint célformátum ugyanígy működik; a beolvasott (szkennelt) oldalakat a rendszer OCR-je olvassa be. |
![]() |
![]() |
| Egyetlen promptból generálva — hatásos hero-szakasz, funkciókártyák, árazás és várólistás jelentkezési űrlap a Lumenhez, a Midnight Studio irányban megépítve. Kattints bármelyik elemre az átformálásához, kattints duplán a szöveg szerkesztéséhez, vagy válts át a CodeMirror forrásnézetre. | Ugyanaz a design, új irány — egyetlen Átformázás kérés kicseréli a brief tokenjeit, és az oldal követi: meleg papír, talpas betűs címsorok, napnarancs kiemelőszín, semmit nem kell újraírni. Vetítsd teljes képernyőn, vagy exportáld PDF-be vagy natívan szerkeszthető Word-dokumentumba. |
![]() |
![]() |
| UI-makettek — a „személyes irányítópult” kiinduló sablon egy felhasználói személyleírásból (persona) működő elrendezést formál: bal oldali sáv, üdvözlet, számlázható órák értékgörbéje, számla- és kihasználtságkártyák, mindez valódi HTML, amelyet átadhatsz egy fejlesztőnek. | Adattörténetek — az „adatjelentés” kiinduló sablon szerkesztőségi, újságszerű (broadsheet) oldalt épít: talpas betűs lapcím, egyetlen főszám, vonalakkal elválasztott statisztikasor, inline SVG-diagramok és módszertani megjegyzés. |
![]() |
![]() |
| Kérdezd az AI-t egy kijelölésről — jelölj ki bármelyik szövegrészt, és megjelenik egy AI kérdezése chip: írj be egy utasítást, vagy válassz egy javaslatot, küldd el azonnal, vagy tegyél sorba több, szövegrészhez kötött szerkesztést, és futtasd őket egy menetben. Ugyanez a funkció minden alkalmazásban megtalálható. | Megjelenítve, egyszerű Markdownként mentve — címsorok, listák, táblázatok, képek, kódblokkok és Mermaid diagramok egy Tiptap blokkszerkesztőben, visszaírva egyszerű .md-ként, teljesen helyi Markdown → Word exporttal. |
![]() |
![]() |
| Ugyanazok a szavak, más válaszok — a „laptop frissítési szabályzat” szó szerint egyezik egy böngésző-gyorsítótár frissítési szabályzattal, egy márkafrissítési tervvel és egy irányítópult-frissítési ütemezéssel, így a teljes szöveges rangsorolás ezeket teszi előre. A Jev elolvassa a részleteket, és az eszközszabványok dokumentumát — amely kimondja a hároméves csereciklust — a lista tetejére helyezi. A találatok száma melletti Jev jelvény jelzi, ha a sorrend a modelltől származik. | Alapból kikapcsolva, egyetlen kapcsolóval bekapcsolható — Beállítások → AI média és keresés → Helyi fájlkeresés. Válaszd az OpenRoutert vagy a közvetlen TypeSafe-elérést, illessz be egy kulcsot, nyomd meg a Kapcsolat tesztelése gombot. Csak bekapcsolt állapotban hagyják el a gépet a legjobb találatok részletei; maga az index soha. |
Az AI kérdezése ugyanazt a helyi, teljes szövegű indexet keresi, mint a
[Keresés](#7--search--find-the-file-that-answers-the-question-with-typesafe-jev),
és oldalanként olvassa a fájlokat, így a modell csak a találatokat és a kért szakaszokat látja, az általad választott szolgáltatón keresztül. Emellett meghívhatja a beépített
`genoffice` CLI-t is, hogy teljes fájlokat építsen; mindegyik fájl kártyaként jelenik meg a válasz alatt, és egy kattintással megnyílik.
### 9 · CLI — a kódoló ügynököd vezérli a GenOffice-t, a saját gépeden
A GenOffice egy `genoffice` parancssort és egy ügynök-képességet mellékel. Telepítsd a képességet, és a Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode vagy
Windsurf valódi Office-fájlokat tud létrehozni, konvertálni, olvasni és szerkeszteni ugyanazokkal a motorokkal, mint az alkalmazások, ablak megnyitása nélkül.
![]() |
![]() |
Egy prompt az ügynöködhöz — „Készíts egy nyolc diás bemutatót a Naprendszerről.” Az ügynök elolvassa a képességet, megír egy stíluslapot, egy vázlatot és diánként egy oldalleírást, legenerálja a két fotót a genoffice image paranccsal, és hagyja, hogy a genoffice slides check elutasítson mindent, ami túlnyúlik vagy átfedésben van, mielőtt a genoffice create összeállítja a .pptx-et, és a slides render diánként egy PNG-t ad vissza megtekintésre. |
Telepítsd egyszer, a Beállítások → Integrációk menüből — a GenOffice felsorolja azokat a kódoló ügynököket, amelyeket ezen a számítógépen talál, és minden kiválasztottba beírja a képességet. Vagy töltsd le a képességet zip-ként, vagy futtasd az npx skills add genspark-ai/genoffice parancsot. A parancsok és a teljes munkafolyamat a Parancssor és ügynök-képesség részben található. |
![]() |
![]() |
Egy prompt, 38 eszközhívás, shell nélkül — „Készíts egy nyolc diás befektetői áttekintést a megújuló energiáról 2026-ban, valódi fotóval a borítón és mindenütt, ahol egy fotó segít.” Az ügynök a számokat és fotókat a search-szel húzza be, megkérdezi a media-t, hogy minden jelölt kép valódi fotó-e, meghívja a deck_start-ot stíluslappal és vázlattal, majd a deck_page-et diánként egyszer; minden oldalt a vázlat és a paletta alapján ellenőriz, mielőtt megtartaná, a deck_build összeállítja a .pptx-et, a slides_audit túlfolyást keres, a slides_render diánként egy PNG-t ad vissza képtartalomként, amelyet a modell meg tud nézni, és a deck_replace kijavítja a három oldalt, amely nem tetszett neki. |
Csatlakoztass egyszer, a Beállítások → Integrációk menüből — másold ki a claude mcp add sort a Claude Code-hoz, vagy a JSON blokkot a Cursorba, Claude Desktopba vagy bármely más MCP-kliensbe. A B opció bekapcsolja a helyi HTTP-kiszolgálót a látható Word-szerkesztőhöz. Mindkettő leírása a MCP-kiszolgáló részben található. |
## Miért a GenOffice
- **Nyílt forráskód**, Apache-2.0, nyíltan fejlesztve a GitHubon.
- **Nálad fut.** Natív alkalmazások macOS-re, Windowsra és Linuxra; a fájljaid a saját lemezeden maradnak, és minden szerkesztés, mentés és átalakítás a te gépeden történik.
- **Valódi Office-fájlok.** Natív `.docx`, `.xlsx` és `.pptx`, bájtpontosan: a fájl azon részei, amelyeket nem érintettél, pontosan úgy másolódnak át, ahogy voltak.
- **Olyan AI, amely magát a dokumentumot szerkeszti.** Változáskövetés a Docsban, élő képletek és diagramok a Sheetsben, a diák közvetlenül a vászonra kerülnek – és minden AI-lépés egy pillanatkép, amelyre visszagörgethetsz.
- **Saját modell, saját kulcs.** Jelentkezz be a Gensparkkal, vagy hozz saját kulcsot a Claude-hoz, az OpenAI-hoz, a Geminihez, a DeepSeekhez és sok máshoz – a helyi kiszolgálókat és bármilyen OpenAI-kompatibilis végpontot is beleértve.
- **Rendesen megoldott PDF.** Szerkeszd a szöveget közvetlenül az oldalon, és konvertáld a PDF-et Word-, Excel- vagy PowerPoint-formátumba az eszközön, szkennelt lapoknál a rendszer OCR-jével.
- **Markdown és HTML is**, ugyanazzal az AI-panellel és helyi Word-exporttal.
- **Olyan keresés, amely a választ találja meg, nem a kulcsszót.** Teljes szöveges keresés a mappáidban lévő összes dokumentumban, helyben indexelve, igény szerint a TypeSafe Jev, a System One értékelő modellje általi átrendezéssel.
- **Kérdezz az AI-tól a fájljaidról.** Csillagozd meg a fontos fájlokat, és tegyél fel kérdéseket természetes nyelven; minden válasz megnevezi a forrásfájlt, amely egy kattintással megnyitható.
- **Képességek.** Előre elkészített képességek vagy a saját `SKILL.md`-ed, csatolva bármely AI-panel **+** menüjéből.
- **Szkriptelhető.** Egy `genoffice` parancssori eszköz, egy ügynök-képesség és egy MCP-kiszolgáló a Claude Code, a Claude Desktop, a Codex, a Cursor és más ügynökök szolgálatába állít minden motort – ez is helyben, a gépeden.
- **Ingyenes**, magánszemélyeknek és csapatoknak egyaránt.
## AI-háttérrendszerek
**Jelentkezz be a Gensparkkal**, és nincs mit beállítani: a modellhívások a Genspark-proxyn keresztül mennek (Claude, GPT és Gemini modellcsaládok), az ügynökök pedig webes és képkeresést, képgenerálást, valamint kép-, hang- és videóelemzést kapnak.
**Vagy hozz saját kulcsot.** A Beállítások → AI alatt a Claude, az OpenAI, a Gemini, a DeepSeek, a Kimi, a GLM, a Qwen, a Doubao, a MiniMax, a Grok, a Mistral, az OpenRouter, a Requesty, az Opper, a Cheaper Inference, az Atlas Cloud, a SiliconFlow, a PPIO, a Command Code és az OpenCode Zen/Go szerepel a listán, valamint egy egyéni szolgáltatói hely bármilyen OpenAI-kompatibilis végponthoz (alap URL + kulcs), a helyi modellkiszolgálókat is beleértve. A keresés és a média az **AI média és keresés** alatt funkciónként külön szolgáltatóval rendelkezik: webes keresésre a Serper, a Serply, a SearchApi, a Tavily, a Parallel, a Keenable, az Exa vagy a Firecrawl, képgenerálásra és kép-/videóelemzésre az OpenAI, a Gemini, a Doubao/Seedream, a GLM, a Grok, a Qwen, a MiniMax, a Stability, a FLUX vagy bármilyen OpenAI-kompatibilis képvégpont, képelemzésre pedig a DeepSeek V4.1 Flash.
A **TypeSafe Jev** átrendezi a kezdőképernyő fájlkeresését. Az **AI média és keresés → Helyi fájlkeresés** beállításnál kapcsold be a Jev keresési átrendezését, és válassz végpontot: [OpenRouter](https://openrouter.ai/typesafe) (modell: `typesafe/jev-1.13`) vagy a TypeSafe saját API-ja. A kulcs kizárólag ezen az eszközön tárolódik. Alapértelmezetten ki van kapcsolva; bekapcsoláskor a legjobb 20 helyi találat részletei mennek el értékelésre, és semmi más nem hagyja el a gépet.
A **Parallel** fiók nélkül is működik: az ingyenes Search MCP-je (korlátozott hívásszámú) akkor az alapértelmezett webes keresés, ha se Genspark-bejelentkezés, se keresési kulcs nincs beállítva, és a DuckDuckGo-oldalak kaparásos (scraping) keresése előtt fut. A Webes keresés alatt válaszd a Parallelt, és adj meg egy [Parallel](https://platform.parallel.ai/) kulcsot, ha helyette a Search API-t szeretnéd használni. A Keenable is kulcs nélkül működik; a kulcs csak a hívási korlátokat emeli meg.
A teljes csomag világos, sötét és rendszer szerinti témákkal érkezik. A témák csak a képernyőn látottakat változtatják meg: az exportálások, a nyomtatások és a mentett fájlok mindig a dokumentum saját színeit őrzik.
## Képességek
Egy képesség egy `SKILL.md`, amely elmondja az AI-nak, hogyan oldjon meg egy adott feladatot jól: heti jelentés, NDA, óraterv. A GenOffice egy készletet szállít belőlük, és fogadja a sajátjaidat is, ugyanabban a formátumban, amelyet a kódoló ügynökök használnak.
- **Beállítások → Képességek.** **Telepíts** egy ajánlott képességet, vagy **Importálj** egy mappát, egy zipfájlt vagy egyetlen `SKILL.md`-t. Importáláskor semmi nem fut le. Az **Összes** lap egy helyen sorolja fel a teljes ajánlott katalógust, az alkalmazás nyelvét követő leírásokkal.
- **Csevegésben.** Nyisd meg a **+** menüt bármely AI-panel beviteli mezője mellett, válaszd a **Képességek** pontot, pipálj be egyet, és küldd el. A képesség csak azt az üzenetet kíséri.
---
## Parancssor és ügynök-képesség
Amit az alkalmazások egy fájllal tudnak, azt a `genoffice` parancssor is elvégzi terminálból:
megvizsgál, konvertál, létrehoz, olvas és szerkeszt Word-, Excel-, PowerPoint-,
PDF-, Markdown- és HTML-fájlokat, ugyanazokra a motorokra épülve, grafikus felület nélkül.
A GenOffice-szal együtt települ, nincs szüksége saját futtatókörnyezetre, és egyetlen
dokumentumot sem küld el sehova. A beépített **ügynök-képességgel** párosítva a kódoló
ügynök olyan dokumentummunkássá válik, amely Markdown-közelítések helyett valódi
Office-fájlokat állít elő.
**Működik vele:** Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot,
OpenCode és Windsurf azonnal, további beállítás nélkül, valamint bármely más ügynök, amelyik
képességeket tud olvasni, és – az [MCP-kiszolgálón](#mcp-server) keresztül – a Claude Desktop
meg minden MCP-kliens.
### A képesség telepítése
| Hogyan | Mi történik |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Beállítások → Integrációk** az alkalmazásban | Felsorolja a gépen megtalált ügynököket; egy kattintás beírja a képességet mindbe, amelyiket választod. **Frissítés** gomb jelenik meg, ha egy új GenOffice-kiadás frissebb képességet hoz. |
| **Letöltés zipként** ugyanazon az oldalon | Olyan felépítés, amelyet a claude.ai, a Claude asztali alkalmazásai és más asszisztensek feltöltött képességként elfogadnak. |
| `npx skills add genspark-ai/genoffice` | Ebből a tárolóból telepít bármely képesség-kompatibilis ügynökbe. |
Ezután indíts új csevegést, és kérj egy dokumentumot. A képesség megtanítja az ügynöknek,
mikor nyúljon a `genoffice`-hoz, hogyan olvasson be egy fájlt a szerkesztés előtt, és
hogyan ellenőrizze a saját munkáját.
### Gyorsindítás a terminálból
```bash
genoffice --version
genoffice info report.docx --json # headings and blocks; or sheets, slides, pages
genoffice convert report.md --to pdf # md/html/docx/xlsx/pptx → pdf, pdf → docx/xlsx/pptx/md/html, odt/ods/odp → docx/xlsx/pptx, doc/dot → docx, ppt → pptx, …
genoffice create --type docx --from notes.md --out notes.docx
genoffice create --type xlsx --from table.json --out sales.xlsx # "=SUM(B2:B9)" cells stay live formulas
genoffice docs read report.docx --range 0-9 --json # then `docs apply --ops edits.json` edits in place
genoffice docs compare original.docx revised.docx --out redline.docx # the differences as tracked Word revisions
genoffice render report.docx --out shots/ # one PNG per page, to look at what you made
genoffice open sales.xlsx # hand the result to the editor
```
Minden parancs egy egysoros összefoglalót ír ki, `--json` esetén pedig egyetlen
JSON-objektumot ad vissza. A szerkesztések atomiak: egy elutasított op érintetlenül hagyja
a fájlt, és megoldási útmutatást adó hibaüzenettel tér vissza. A `genoffice help` felsorolja az aktuális
parancskészletet; a teljes referencia a [packages/cli/README.md](../../packages/cli/README.md) fájlban található.
### Mit futtat az ügynök valójában
A [demó](#demo) Naprendszer-bemutatója egyetlen promptból készült el a Claude Code-ban.
A háttérben az ügynök a képesség szakaszos munkafolyamatát követte, és a CLI minden
szakaszt ellenőrzött, mielőtt a következő elindult volna:
```bash
genoffice capabilities --json # which cloud tools GenOffice has configured
genoffice guide slides design # the deck workflow and layout library
genoffice image "the eight planets in a row …" --aspect 16:9 --out deck/assets/cover.jpg
genoffice slides check deck/outline.json --json # 8 pages, no findings
genoffice slides check deck/pages/01.json --json # builds one slide, audits overflow and overlap
… # one page file per slide, fixed until each check is clean
genoffice create --type pptx --spec deck/pages --outline deck/outline.json --out deck/solar-system.pptx --json
genoffice slides render deck/solar-system.pptx --out deck/shots --json
genoffice slides audit deck/solar-system.pptx --json # 8 slides, no layout issues
genoffice slides replace deck/solar-system.pptx --slide 4 --spec deck/pages/05.json --json
genoffice open deck/solar-system.pptx
```
A `genoffice`-on belül nem történik modellhívás: a gondolkodást az ügynök végzi,
az építést és az ellenőrzést a CLI, az eredmény pedig közönséges `.pptx`-ként nyílik meg
a GenOffice-ban vagy a PowerPointban.
### MCP-kiszolgáló
Ugyanezek a parancsok [Model Context Protocol](https://modelcontextprotocol.io)-eszközként is
elérhetők, olyan asszisztenseknek, amelyek nem tudnak terminált futtatni, vagy amelyeknek
inkább nem adnál egyet. Két út vezet hozzá, mindkettőhöz másolásra kész kódrészletek
tartoznak a **Beállítások → Integrációk → MCP** panelen:
| Mód | Mi ez |
| ---------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **A · `genoffice mcp`** (ajánlott) | Egy stdio-kiszolgáló, amelyet az asszisztens maga indít el; a GenOffice-nak nem kell nyitva lennie. Parancsonként egy eszköz (`info`, `convert`, `create_docx`, `create_xlsx`, `create_pptx`, `create_pdf`, `docs_read` / `docs_apply` / `docs_check`, `sheet_*`, `slides_*`, `render`, `guide`, `search`, `image`, `media`, `open`), plusz a szakaszos bemutatófolyamat: `deck_start` → `deck_page` → `deck_build` → `deck_replace`. Az opok, a specifikációk és a Markdown inline adódik át, így egy fájlrendszer nélküli kliens is működik. |
| **B · Helyi HTTP-kiszolgáló** | A GenOffice alkalmazáson belül fut, a `http://127.0.0.1:3093/mcp` címen (Streamable HTTP, örökölt SSE-vel). Az eszközei egy látható Word-szerkesztő lapot vezérelnek: `create_session`, `insert_content`, `replace_blocks`, `apply_ops`, `read_document`, `save_session` – és közben nézheted, ahogy a dokumentum formát ölt. Alapból kikapcsolva; ugyanabban a beállítási panelen kapcsolhatod be. |
| **C · `genoffice mcp --http`** | A stdio-eszközkészlet Streamable HTTP-kiszolgálóként, más gépeken futó klienseknek: konténer, sandbox vagy a hálózatodon lévő megosztott gép. A fájlok a hívásokkal együtt utaznak: a `PUT /files/