安装 Hostel CLI 并连接
hostel 二进制文件对于人员、AI Agent、服务器和房间机器都是相同的。本技能在个人计算机上安装它，并将该计算机连接到服务器。对于服务器机器，请参见 hostel-server-setup。对于房间机器，请参见 hostel-rooms。
macOS 和 Linux
curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh
该脚本会下载最新的 GitHub 发布版本，对照该版本的 SHA256SUMS 检查文件，并将 hostel 安装到 ~/.local/bin。
选项（在 sh -s -- 之后添加它们）：
| 选项 | 效果 |
|---|---|
--dir DIR | 将二进制安装到 DIR（默认 ~/.local/bin）。 |
--version vX.Y.Z | 安装此发布版本（默认：最新版本）。 |
--server DIR | 同时将房间二进制安装到 DIR/helpers，平台脚本安装到 DIR/platforms。仅用于服务器机器。 |
示例：
curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh -s -- --dir /usr/local/bin
curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh -s -- --version v0.1.0
如果脚本打印 note: ... is not on your PATH，请将该目录添加到 shell 配置文件的 PATH 中，例如：
export PATH="$HOME/.local/bin:$PATH"
支持：运行 amd64 或 arm64 架构的 macOS 和 Linux。环境变量 HOSTEL_INSTALL_URL 可替换下载 URL（用于镜像）。
Windows
在 PowerShell 中（无需管理员权限）：
irm https://raw.githubusercontent.com/csansoon/hostel/main/install.ps1 | iex
该脚本将 hostel.exe 安装到 %LOCALAPPDATA%\Programs\hostel，对照 SHA256SUMS 检查它，并将该目录添加到用户 PATH。首次安装后请打开一个新的终端。$env:HOSTEL_VERSION（例如 v0.1.0）用于选择发布版本；$env:HOSTEL_INSTALL_URL 用于设置镜像。
注意：install.ps1 是新的。如果它失败，请从 GitHub 发布版本下载 hostel-windows-amd64.exe（或 -arm64.exe），将其重命名为 hostel.exe，并放在 PATH 中的某个目录下。
检查安装
hostel --version
hostel help
将计算机连接到服务器
服务器的管理员会给你一个邀请码（hostel1-...）。该邀请码一次性有效，有效期为 24 小时。有关管理员如何创建邀请码，请参见 hostel-users。
hostel connect hostel1-...
hostel connect hostel1-... --name "Alice Example"
- 默认名称来自
git config user.name。在终端中，connect会提示输入名称。 - 输出显示服务器、固定的 TLS 密钥（适用于拥有自己证书的服务器）、你的角色以及计算机名称。
- 连接信息存储在
~/.config/hostel/config.toml（权限 0600）。在 Windows 上，位于%USERPROFILE%下的相同路径。 - 一台计算机最多只有一个连接。如果已存在连接，
connect会在替换前进行询问。--yes可直接替换而不询问。 - 此计算机上的 Agent 使用同一个连接。他们不需要自己的连接。
检查连接：
hostel status
断开连接（服务器会删除此计算机的令牌）：
hostel disconnect
对于测试和 CI，环境变量 HOSTEL_SERVER、HOSTEL_TOKEN 和 HOSTEL_SERVER_KEY 会覆盖文件中的配置。
Hostel 应用
在终端中运行 hostel（不带参数）。它会打开一个全屏应用：
- 未连接：Check in（粘贴邀请码，然后输入姓名）或 Leave。
- 大厅（Lobby）：平台、它们的空闲机器、队列和等待状态。
- 房间（Rooms）：机器、它们的状态以及使用它们的人员。
- 前台（Front desk）：服务器和你；Invite a guest（管理员）、Add your other computer（成员）、Guest list、Add a room（管理员）、Check out（断开连接）。
按键：1 2 3 分别跳转到大厅、房间、前台；? 列出所有按键；q 退出。
NO_COLOR=1 关闭颜色。如果没有终端（Agent 或管道），hostel 会打印帮助信息。Agent 使用 hostel status（纯文本）。
更新
再次运行相同的安装命令。它会替换二进制文件。
curl -fsSL https://raw.githubusercontent.com/csansoon/hostel/main/install.sh | sh
hostel --version
在 Windows 上，再次运行 irm ... | iex 命令。连接会保留。
对于服务器机器，更新后还需重启服务（参见 hostel-server-setup 中的“更新”部分）。
下一步
- 使用房间：
hostel-use。 - 如果出现问题：
hostel-troubleshoot。