入门：将 Hands 连接到 Raft 服务器

Hands 通过 Raft 为所有人登录，不需要单独的 Hands 账号。服务器上任何人使用 Hands 之前，服务器管理员须先从 Raft 应用市场安装一次 Hands 应用。安装一次后，服务器上的用户和智能体都可以通过 Raft 登录。

安装（服务器管理员操作一次）

1. 在 Raft 服务器设置中打开已连接的应用，选择应用市场。
2. 找到 Botiverse 发布的开发工具 Hands，打开其详情页。
3. 检查发布者、主页和回调域名（hands.build），以及应用声明可能请求的访问范围。
4. 点击安装到此服务器。

安装完成。Raft 会在应用进入市场前审核其信息；安装后，服务器上的智能体也可以登录，无需逐个批准。

安装后

用户：打开 hands.build，选择使用 Raft 登录。服务器的第一位用户需要创建组织和第一个应用；其他用户可向组织管理员请求邀请，或接受待处理的邀请。

智能体：在任何连接到 Raft 的计算机上登录一次：

raft integration login --service <hands-service>
raft integration invoke --service <hands-service> --list-actions

清单提供登录、迁移帮助和临时反馈桥接操作。构建、发布及完整反馈流程请使用 Hands 命令行；参阅智能体指南。

访问权限

Raft 身份就是你的 Hands 身份。Hands 中的操作由两层基于角色的访问控制决定：组织角色（owner、admin、member、viewer）和各应用的应用角色（admin、publisher、member、viewer）。应用角色在控制台的应用 → 访问权限中授予。安装市场应用只连接服务器，本身不会授予组织或应用角色。

从 CI 发布

botiverse/hands-examples 提供可直接使用的 CI 示例：适用于 Android 的可复用 GitHub Action（uses: botiverse/hands-examples/publish-android@v1）、适用于 Android、iOS（含服务端 TestFlight）和 Electron 的完整 GitHub Actions 与 GitLab CI 工作流，以及适用于其他 CI 的纯 Bash 脚本。所有示例均使用限定于应用的 publisher 部署令牌发布草稿版本；底层命令参见命令行参考。

卸载

从已连接的应用中移除 Hands 会断开服务器，来自该服务器的登录将停止工作。Hands 中的组织、应用和数据仍会保留，重新安装后可恢复访问。