快速开始
RemoteCI 有三项运行组件：ClassIsland 插件、RemoteCI 服务端和 Wear OS 客户端。只在同一局域网内使用时可以直连插件；需要跨网络、账号管理或集中控制时，应部署服务端。
准备工作
| 组件 | 要求 |
|---|---|
| 教室电脑 | 已安装并可正常运行的 ClassIsland 2.x |
| 手表 | Wear OS 3 或更高版本，RemoteCI 手表应用 0.3.1 |
| 服务端 | 支持 Docker 的 NAS 或 Linux 服务器，建议有域名和 HTTPS |
| 网络 | 局域网直连默认使用 TCP 8765，设备扫描固定使用 UDP 48765；服务端默认使用 TCP 8080 |
发布包从 GitHub Releases 获取：服务端提供 linux-x64 与 win-x64 压缩包，插件提供 CIPX，手表提供 APK。如果 Releases 尚无可用版本，需要从 RemoteCI 源码自行构建，见文档同步规则。
一、部署服务端
按照服务端部署使用仓库自带的 compose.yaml 完成部署。首次启动时，服务端会创建管理员账号和一次性插件配对码。
请先查看容器日志并妥善保存：
docker logs remoteci如果部署时没有显式设置初始密码和配对码，日志中会显示自动生成的值。首次登录后应立即在“个人账号”页面修改管理员密码。
二、连接 ClassIsland 插件
- 在 ClassIsland 中安装 RemoteCI 插件（0.3.1）。
- 打开“设置”中的“RemoteCI 设置”。
- 普通设置中确认局域网端口（默认
8765）；局域网服务默认开启，关闭开关只在“RemoteCI 开发者设置”中显示。 - 填写云端服务端的完整地址；普通设置不提供关闭云端中转的开关。
- 登录服务端 WebUI，在概览页点击“生成插件配对码”，把显示的一次性配对码填入插件设置。
- 保存设置并重启 ClassIsland。
配对码在使用前持续有效，成功配对后立即作废；插件换到长期凭据后会清空本地配对码。
地址写法
本机测试可以填写 http://localhost:8080。手表真机跨网络访问时，应填写带 HTTPS 的公网地址，例如 https://remoteci.example.com。
三、创建手表账号
登录服务端 WebUI 的“人员权限”页面，为手表使用者创建账号：
- ID：登录唯一标识，3-32 位字母、数字、点、下划线或短横线。
- 用户名：显示名，1-40 个字符，会出现在通知的“由用户名发送：”前缀中。
- 初始密码：8-128 位；密码只用于登录，不会下发到插件或写入手表。
- 角色：普通用户或管理员；管理员固定拥有全部权限。
- 附加权限：WebUI、人员管理、发送与清除通知、老师来了、换课、主界面与电源控制。
如果 ID、用户名或初始密码校验失败，页面只清空对应的无效字段，其他输入、角色与权限勾选保持不变。服务端错误响应不会回传密码或其他表单原值。
建议只授予实际需要的权限。普通用户默认只能查看当前课程，需要操作时再按需勾选。
四、连接 Wear OS 客户端
- 打开手表端“设置 → 连接”。
- 填写服务端创建的 ID（不是显示名）；密码只用于本次登录，不写入手表设置。
- 已知云服务器地址时可以直接填写并登录，服务端会把插件的局域网地址与端口补充到手表。
- 不知道云服务器地址时，在登录页点击“扫描局域网设备”，选择运行 ClassIsland 的电脑；手表会从插件读取并显示云服务器地址。
- 确认显示的云服务器域名或 IP 正确后点击“安全登录”。密码只发往云服务器，不会经过插件。
登录成功后，30 天设备会话由 Android Keystore 加密保存在手表上。云端先连接时，插件上报的全部局域网候选地址和端口会补充到手表；局域网扫描先连接时，插件会反向补充云服务器地址。应用依次尝试局域网候选地址并记住第一个成功地址，局域网失败时再自动续登云端。Android 模拟器访问宿主机时可使用 10.0.2.2；真机不能使用这个地址。
只有“设置 → 开发者”允许关闭云端中转或局域网直连。即使开发者关闭云端后退出账号，下一次密码登录也会临时使用云端完成认证，不需要先恢复开关。
登录后可在“设置 → 外观”切换 Material Design 3 配色方案（默认淡紫，另含经典紫、蓝、绿、橙、粉），选择会保存在手表本机。
五、确认连接
- 手表首页在上课中显示当前课程；下课或即将上课时改为显示下一节课，而不是连接错误。
- 服务端概览显示插件在线和在线手表数。
- ClassIsland 切换课程状态后，手表能收到更新。
- 有权限的账号可以提交一次非破坏性操作（例如发送通知）并看到真实回执。