Távoli executor beállítása

Telepítsd, párosítsd és kezeld azt a számítógépet, amely a Nessie-ügynökökkel dolgozik.

Az executor egy általad irányított számítógépet köt össze a Nessie-vel. Az operációs rendszer azon fiókja alatt telepítsd, amelynek fájljait és programjait használnia kell. Nincs szükséged Node.js-re vagy forráskód-másolatra.

macOS

A CLI macOS 15-öt vagy újabbat igényel Apple Silicon-on:

brew install unlikeotherai/tap/nessie-executor

A teljes Nessie asztali alkalmazáshoz, vagy az önálló executorhoz a helyi engedélyek ablakával:

brew install --cask unlikeotherai/tap/nessie
brew install --cask unlikeotherai/tap/nessie-executor-app

Válaszd ki a használni kívánt felületet. Minden párosításhoz egy felügyelőt futtass. Az executor alkalmazásban a Beállítások → Nessie Executor megnyitása, amikor bejelentkezem vezérli az automatikus indítást.

Debian és Ubuntu

Használd az aláírt APT-tárolót x86_64 Debian 12+ vagy Ubuntu 22.04+ rendszeren:

sudo apt-get update
sudo apt-get install -y curl ca-certificates
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://packages.nessie.works/nessie-executor.asc | sudo tee /etc/apt/keyrings/nessie-executor.asc >/dev/null
echo "deb [arch=amd64 signed-by=/etc/apt/keyrings/nessie-executor.asc] https://packages.nessie.works/apt stable main" | sudo tee /etc/apt/sources.list.d/nessie-executor.list >/dev/null
sudo apt-get update
sudo apt-get install nessie-executor

Fedora, Rocky Linux és AlmaLinux

Használd az aláírt RPM-tárolót x86_64 Fedora vagy Rocky Linux / AlmaLinux 9+ rendszeren:

sudo curl -fsSL https://packages.nessie.works/nessie-executor.repo -o /etc/yum.repos.d/nessie-executor.repo
sudo dnf install nessie-executor

A Linux háttérszolgáltatásokhoz systemd szükséges. A csomagok tartalmazzák a futtatókörnyezetet; az APT vagy a DNF a Git-et és a tmux-ot függőségként telepíti.

Windows-executor

Telepítsd az aláírt, önálló executort a WinGet segítségével:

winget install --exact --id UnlikeOtherAI.NessieExecutor

Nyisd meg a Nessie Executor-t a Start-menüből vagy a tálcáról. Az új csapatkapcsolatok a bejelentkezett Windows-fiókodként futnak. A telepítő a független, szolgáltatásfiókos felügyelőt is biztosítja. Az interaktív terminálprogramok csak felhasználói munkamenet-kapcsolatban futnak, ahol a bejelentkezési adataik elérhetők.

Csapat párosítása

A CLI-t a szokásos fiókodként futtasd, sudo nélkül:

nessie-executor login --api nessie --workspace "/path/to/work"

Saját Nessie-szerver esetén a nessie-t cseréld le annak HTTPS API-URL-jére. Az asztali executor Csapat hozzáadása gombja ugyanezt a folyamatot indítja el.

1. Másold ki a számítógépen látható nyolcjegyű kódot.
2. A Nessie-ben nyisd meg az Admin › Számítógépek › Számítógép hozzáadása menüt. Illeszd be a kódot, válaszd ki a szervezetet, a csapatot és a hozzáférési kört, majd ellenőrizd az ujjlenyomatot.
3. Erősítsd meg a számítógépen a megadott szervezetet és csapatot.
4. Ellenőrizd, hogy az executor online van-e, tekintsd át a képességeit a Nessie-ben, és add meg a szándékolt ügynököknek a hozzáférést.

A kódok tíz percig érvényesek, és egyszer használhatók. Másik csapat párosításához ismételd meg a login parancsot, vagy használd a Csapat hozzáadása műveletet. Minden kapcsolatnak saját gépi kulcsa, mappái, parancsszabályai és indítási szolgáltatása van.

nessie-executor teams
nessie-executor permissions --executor <executor-id>
nessie-executor permissions --executor <executor-id> --allow-all --deny "git push *"
nessie-executor permissions --executor <executor-id> --allow "git *,pnpm *"

Alapértelmezés szerint minden parancs engedélyezett, a szerkezeti biztonsági ellenőrzések figyelembevételével; a helyi tiltólista felülírja az engedélylistát. A mappa- és parancsjogosultságok csak ezen a számítógépen tárolódnak, és a Nessie-n keresztül nem módosíthatók. A Nessie szabályozza, mely személyek és ügynökök használhatják a kapcsolatot a csapatán belül. A jogosultságok módosítása előtt állítsd le a helyi démont, majd indítsd újra.

Az ügynökök interaktív terminálban is indíthatnak Codexet, Geminit, Claude-ot, shellt vagy bármely más telepített programot ezen a számítógépen, amennyiben ezt a parancsszabályok engedik; más nincs beállítva. Ezeknek a programoknak már telepítve kell lenniük, és ugyanazon a fiókon belül bejelentkezve; macOS-en és Linuxon pedig szükség van a tmux-ra. A terminálprogram az operációsrendszer-fiók hozzáférésével fut, a mappája pedig nem sandbox. A sandboxolt command.run külön a vendég-futtatókörnyezetet igényli.

Indítás, állapot és frissítések

Az interaktív login a párosítás megerősítése után bekapcsolja az automatikus indítást. macOS-en egy launchd-szolgáltatás indítja el az adott csapatot, amikor bejelentkezel. Linuxon egy systemd felhasználói szolgáltatás és a lingering beállítás tartja fenn a kapcsolatot kijelentkezés és újraindítás után is.

nessie-executor status
nessie-executor enable <executor-id>
nessie-executor disable <executor-id>

A disable leállítja a szolgáltatást a párosítás és a jogosultságok törlése nélkül. Előtérben futó munkamenethez előbb tiltsd le a szolgáltatást, majd használd a nessie-executor daemon --executor <executor-id> parancsot. Az explicit --state-dir kapcsolóval létrehozott párosítások előtérben futó felügyeletet használnak.

A Mac CLI naplói itt vannak: ~/Library/Logs/NessieExecutor/<executor-id>.log. A Linux naplói a journalctl --user -u nessie-executor@<executor-id> paranccsal érhetők el.

Frissíts a csomagkezelőddel:

brew upgrade nessie-executor
sudo apt-get update && sudo apt-get install --only-upgrade nessie-executor
sudo dnf upgrade nessie-executor

Windowson használd a winget upgrade --exact --id UnlikeOtherAI.NessieExecutor parancsot. Frissítés után minden CLI-szolgáltatást indíts újra: előbb disable, majd enable. A CLI párosítási kulcsai és a helyi jogosultságok a ~/.local/state/nessie-executor/ alatt vannak. Az asztali alkalmazások állapotukat a fiók alkalmazásadat-könyvtárában tárolják. Mindkettő a telepített csomagon kívül van, ezért a frissítések megőrzik őket.

A szoftver eltávolításához tiltsd le az összes CLI-szolgáltatást, vagy kapcsold ki az alkalmazás bejelentkezéskori indítását, és lépj ki belőle, majd távolítsd el ugyanazzal a csomagkezelővel. Az eltávolítás megőrzi a párosítási állapotot. A hozzáférés visszavonásához a Nessie-ben a Kapcsolat bontása vagy a Törlés lehetőséget használd az executornál — a helyi fájlok puszta törlése nem vonja vissza a szerveren nyilvántartott rekordot.

A helyi beállításokról lásd: helyi vezérlők.