nessie

Настройка на отдалечен изпълнител

Инсталирайте, сдвоете и управлявайте компютър, който работи с агентите на Nessie.

Изпълнителят свързва компютър, който управлявате, с Nessie. Инсталирайте го под потребителския акаунт в ОС, чиито файлове и програми трябва да използва. Не ви трябват Node.js или локално копие на изходния код.

macOS

CLI изисква macOS 15 или по-нова версия на Apple Silicon:

brew install unlikeotherai/tap/nessie-executor

За пълното настолно приложение Nessie или за самостоятелния изпълнител с неговия локален прозорец за права:

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

Изберете интерфейса, който искате да използвате. Пускайте по един надзорник за всяко сдвояване. В приложението на изпълнителя Настройки → Отваряне на Nessie Executor при влизане в системата управлява автоматичното стартиране.

Debian и Ubuntu

Използвайте подписания APT репозиторий на x86_64 Debian 12+ или Ubuntu 22.04+:

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 и AlmaLinux

Използвайте подписания RPM репозиторий на x86_64 Fedora или Rocky Linux / AlmaLinux 9+:

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

Фоновите услуги на Linux изискват systemd. Пакетите включват изпълнителната среда; APT или DNF инсталира Git и tmux като зависимости.

Изпълнител за Windows

Инсталирайте подписания самостоятелен изпълнител с WinGet:

winget install --exact --id UnlikeOtherAI.NessieExecutor

Отворете Nessie Executor от Старт или от системната област. Новите връзки към екипи се изпълняват като вашия акаунт в Windows, в който сте влезли. Инсталаторът предоставя и независимия надзорник на акаунт на услуга. Интерактивните терминални програми се изпълняват само във връзка в потребителската сесия, където са достъпни данните им за вход.

Сдвояване на екип

Стартирайте CLI с обикновения си акаунт, без sudo:

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

За собствения си Nessie сървър заменете nessie с неговия HTTPS адрес на API. Добавяне на екип в настолния изпълнител стартира същия процес.

  1. Копирайте осемцифрения код, показан на компютъра.
  2. В Nessie отворете Администрация › Компютри › Добавяне на компютър. Поставете кода, изберете организацията, екипа и обхвата на достъп и проверете отпечатъка.
  3. Потвърдете на компютъра заявената организация и екип.
  4. Проверете дали изпълнителят е онлайн, прегледайте възможностите му в Nessie и дайте достъп на предвидените агенти.

Кодовете изтичат след десет минути и работят веднъж. Повторете login или Добавяне на екип, за да сдвоите друг екип. Всяка връзка има собствен машинен ключ, собствени папки, собствени правила за команди и собствена услуга за стартиране.

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 *"

По подразбиране са разрешени всички команди, при условие на структурни проверки за безопасност; локалният списък за отказ има предимство пред списъка за разрешаване. Правата за папки и команди се съхраняват само на този компютър и не могат да се променят през Nessie. Nessie контролира кои хора и агенти могат да използват връзката в рамките на нейния екип. Спрете локалния демон, преди да промените правата, и после го стартирайте отново.

Агентите могат също да стартират Codex, Gemini, Claude, shell или коя да е друга инсталирана програма в интерактивен терминал на този компютър, доколкото тези правила за команди позволяват; нищо друго не е конфигурирано. Такива програми трябва вече да са инсталирани и с вход в същия акаунт, а macOS и Linux се нуждаят от tmux. Терминалната програма има достъпа на акаунта в ОС, а папката й не е сандбокс. Изолираният command.run изисква отделно гостевата изпълнителна среда.

Стартиране, статус и обновления

Интерактивното login включва автоматично стартиране, след като потвърдите сдвояването. На macOS launchd агент стартира този екип, когато влезете в системата. На Linux потребителска услуга systemd и lingering я поддържат свързана при излизане и рестартиране.

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

disable спира услугата, без да изтрива сдвояването или правата й. За сесия на преден план първо изключете нейната услуга, после използвайте nessie-executor daemon --executor <executor-id>. Сдвоявания, създадени с изричен --state-dir, използват надзор на преден план.

Журналите на CLI на Mac са в ~/Library/Logs/NessieExecutor/<executor-id>.log. Журналите на Linux са достъпни с journalctl --user -u nessie-executor@<executor-id>.

Обновете с мениджъра си на пакети:

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

На Windows използвайте winget upgrade --exact --id UnlikeOtherAI.NessieExecutor. След обновяване рестартирайте всяка CLI услуга с disable, последвано от enable. Ключовете за сдвояване на CLI и локалните права се намират в ~/.local/state/nessie-executor/. Настолните приложения съхраняват състоянието си в директорията за данни на приложенията на акаунта. И двете са извън инсталирания пакет, така че обновяванията ги запазват.

За да премахнете софтуера, изключете всяка CLI услуга или изключете настройката за стартиране при влизане на приложението и го затворете, после деинсталирайте през същия мениджър на пакети. Деинсталирането запазва състоянието на сдвояването. Прекъсване на връзката или Изтриване на изпълнителя в Nessie отменя достъпа; изтриването само на локалните файлове не отменя записа на сървъра.

За подробности за локалната конфигурация вижте локалните контроли.