nessie

设置远程执行器

安装、配对并管理可与 Nessie 智能体协同工作的电脑。

执行器可将你控制的电脑连接到 Nessie。请在操作系统中使用其文件和程序应当被使用的那个账户进行安装。无需安装 Node.js，也无需检出源代码。

macOS

CLI 需要 Apple 芯片上的 macOS 15 或更高版本：

brew install unlikeotherai/tap/nessie-executor

如需完整的 Nessie 桌面应用，或带有本地权限窗口的独立执行器：

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

选择你想使用的界面。每个配对只运行一个监督进程。在执行器应用中，Settings → Open Nessie Executor when I log in 用于控制自动启动。

Debian 和 Ubuntu

在 x86_64 架构的 Debian 12 及以上或 Ubuntu 22.04 及以上版本中，使用已签名的 APT 软件源：

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

在 x86_64 架构的 Fedora，或 Rocky Linux / AlmaLinux 9 及以上版本中，使用已签名的 RPM 软件源：

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 地址。桌面执行器中的 Add team 会启动相同的流程。

  1. 复制电脑上显示的八位数字代码。
  2. 在 Nessie 中打开 Admin › Computers › Add a computer。粘贴代码，选择组织、团队和访问范围，并核对指纹。
  3. 在电脑上确认所声明的组织和团队。
  4. 确认执行器处于在线状态，在 Nessie 中查看其能力，并为目标智能体授予访问权限。

代码十分钟后过期，且只能使用一次。如需配对另一个团队，请重复执行 login 或 Add team。每个连接都有各自的机器密钥、文件夹、命令规则和启动服务。

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 创建的配对采用前台监督。

Mac CLI 的日志位于 ~/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。升级后，依次执行 disable 和 enable 来重启每个 CLI 服务。CLI 配对密钥和本地权限保存在 ~/.local/state/nessie-executor/ 中。桌面应用则将其状态保存在该账户的应用数据目录中。两者都位于已安装的软件包之外，因此升级时会予以保留。

要卸载该软件，请先禁用所有 CLI 服务，或关闭应用的登录设置并退出应用，然后通过同一软件包管理器卸载。卸载不会删除配对状态。若要撤销访问权限，请在 Nessie 中 Disconnect 或 Delete 该执行器；仅删除本地文件并不会撤销服务器上的记录。

有关本地配置的详细信息，请参阅 本地控制。