Community: egyszer telepíted, bárhonnan indítod

A community kiadás személyes asszisztens. Egyszer telepíted, a modell
végpontod és API-kulcsod egy helyen marad, és azon a mappán dolgozol, amelyet
választasz — a böngészőben, vagy úgy, hogy abból a mappából indítod a
Codumentort. Lásd: A mappa kiválasztása, amin a Codumentor dolgozik.

Hol mi lakik

Két független tengely:

Tengely	Jelentés	Alapértelmezés (community)
Példány-home	Hol tárolódnak a beszélgetések, naplók, indexek	$CODUMENTOR_HOME (~/.codumentor)
Config-rétegek	Mit hisz a folyamat	Csomagolt flavor-alap → felhasználói overlay → opcionális projekt-YAML

A codumentor indítása a ~/src/foo mappában nem ír codumentor.yaml-t
vagy ./data-t a fooba. A chatek a user home alatt maradnak. A foo indexe
külön van a ~/src/bar indexétől.

A személyes beállítások (modell URL, API-kulcs, auth) a
$CODUMENTOR_HOME/config.yaml fájlban vannak, alapértelmezetten
~/.codumentor/config.yaml (Windowson
C:\Users\<felhasználó>\.codumentor\config.yaml). Ez a **felhasználói
overlay**. Egyszerű szövegfájl: bármilyen szövegszerkesztővel módosíthatod,
a változás a Codumentor újraindítása után lép életbe.

Ha itt egy bővítmény beállításán változtatnál (például a
Google Workspace
kliensazonosítóját adnád meg), vegyél fel egy plugins_overrides: bejegyzést
az adott bővítmény nevével. Ebbe a fájlba ne írj plugins: listát: az a teljes
beépített listát lecseréli, és szó nélkül kikapcsol minden bővítményt, amelyet
nem soroltál fel.

Első indítás: modellszolgáltató választása

Amikor először indítod terminálból, és a felhasználói overlay még nem létezik,
a Codumentor három dolgot kérdez: melyik szolgáltató, melyik modell (Enter
megtartja a javasoltat), és az API-kulcs.

Menüpont	Kulcs-változó	Embedding
OpenRouter	OPENROUTER_API_KEY	van
OpenAI	OPENAI_API_KEY	van
Google Gemini	GEMINI_API_KEY (vagy GOOGLE_API_KEY)	van
DeepSeek	DEEPSEEK_API_KEY	nincs
Z.ai (GLM)	ZAI_API_KEY	nincs
Moonshot AI (Kimi)	MOONSHOT_API_KEY	nincs
Mistral	MISTRAL_API_KEY	van
Ollama (helyi)	—	van (embeddinggemma)
LM Studio (helyi)	—	van (nomic-embed-text)
Más OpenAI-kompatibilis végpont	az URL-t te adod meg	ugyanazon az URL-en feltételezve
ChatGPT-előfizetés (Plus/Pro) — bejelentkezés a böngészőben	— (bejelentkezel)	nincs
Kihagyás — modell beállítása később a böngészőben	—	—

• Ha a kulcsnál Entert nyomsz, a kulcs nem kerül a fájlba. A config ekkor a szolgáltató változójára hivatkozik, pl. ${OPENROUTER_API_KEY}, és minden indításkor onnan olvassa. Ha e változók közül valamelyik már be van állítva, az a szolgáltató lesz a menü alapértelmezése.
• Ha beilleszted a kulcsot, a fájlba kerül. Gépelés közben nem látszik, és a fájlt csak te olvashatod.
• Minden, ami a választásból következik, a fájlba íródik: végpont, modell- azonosítók, embedding-modell, és az a néhány szolgáltatófüggő beállítás, amire szükség van (hőmérséklet, a gondolkodás kérésének módja, kontextus- ablak), mindegyik mellett egy megjegyzéssel, hogy miért. Futásidőben semmi nem dől el. Szolgáltatót váltani a fájl szerkesztésével lehet, vagy töröld, és indítsd újra.
• Az embedding nélküli szolgáltatókkal is lehet beszélgetni. A személyes emlékezethez és a repók indexeléséhez a models.embedding_* beállításoknak olyan szolgáltatóra kell mutatniuk, amelyiknek van.
• A ChatGPT-előfizetés és a Kihagyás a böngészőben fejeződik be: a Beállítások > Modellek oldalon válaszd a Sign in with ChatGPT gombot (vagy adj meg ott egy API-kulcsot). Az első ChatGPT-bejelentkezés lesz az új beszélgetések modellje, hacsak nem választottál már egyet. Mindkettő a beépített modellekkel írja ki a fájlt, így legközelebb nem kérdez újra.
• Ctrl-D vagy Ctrl-C bármelyik kérdésnél: semmi nem íródik ki, legközelebb újra kérdez. Terminál nélkül (szolgáltatásként, csővezetékben) nem kérdez.

Megnyitás a böngészőben és bejelentkezés

Amikor a Codumentor fut, nyisd meg a böngészőben a
http://127.0.0.1:2638/app címet (a 2638 az
alapértelmezett port). A Codumentor ablakát hagyd nyitva munka közben; ha
bezárod, az asszisztens leáll.

A bejelentkezési képernyő felhasználónevet és jelszót kér:

• Felhasználónév: admin
• Jelszó: az első indításkor jön létre, és egyszer kiíródik a Codumentor ablakába, egy Codumentor admin password feliratú sárga keretben. A beállítási mappádban, az admin_password fájlban is megtalálod (~/.codumentor/admin_password; Windowson C:\Users\<felhasználó>\.codumentor\admin_password), így bármikor visszanézheted.

Ha saját jelszót szeretnél, indítás előtt állítsd be a
CODUMENTOR_ADMIN_PASSWORD környezeti változót.

A projekt-YAML overlay, nem a példány

Ha egy könyvtárban van codumentor.yaml (vagy a flavor fájlneve), és azt
felfedeztük — nem adtad át --config-ként —, a community projekt-overlayként
kezeli arra a mappára:

• Reposokat és projekt-pluginokat megadhat.
• Nem változtathatja a modellvégpontot vagy az auth-t. Azok a user overlayben maradnak.
• Először rákérdez, megbízol-e a fájlban. A --config mindig megbízható, soha nem kérdez. --trust-project / --no-trust-project kihagyja a kérdést erre a futtatásra (a --no-trust-project nem jegyez meg skipet).

A full kiadású workspace-szerverek továbbra is példányként kezelik a lemezen
lévő YAML-t, ha az a termékforma. A két tengelyt az
admin konfigurációs útmutató írja le.

Beszélgetések

Felhasználói home esetén az oldalsáv alapból Ez a mappa: a jelenlegi
workspace-szel címkézett chatek. Az Összes minden beszélgetést mutat,
beleértve a szűrő előtti, címkézetleneket is.

Kapcsolók

Kapcsoló	Hatás
`--home user\	workspace\
--ephemeral	Rövidítés: --home ephemeral
--config PATH	Az a YAML a példány (megbízható; általában workspace home)
--trust-project / --no-trust-project	Felfedezett overlay elfogadása vagy kihagyása kérdés nélkül