第 1 步：连接智能体，或为代码连接服务客户端
对于 AI 智能体，只需把一句话粘贴给它，它就会安装官方 screenRIG 插件，插件捆绑了技能和 screenrig CLI。首次运行时它会完成注册：创建你的组织和项目，并给你发送邀请邮件。快速入门页面提供这句话以及适用于各个智能体的安装命令。
Claude、ChatGPT 或 Grok 这类 MCP 客户端也可以改为连接远程 MCP 服务器：由人在控制台中批准，并为其选择只读、提议或管理。对只负责监视的智能体来说，只读就够了，就像上面的会话那样。插件补充在你的机器上运行的步骤，例如转换媒体和打包应用。连接 MCP 客户端页面提供服务器地址和登录方式。
对于脚本、CI 任务或你自己的服务，创建一个仅具备所需权限的服务客户端：
screenrig service-client create --name "rollout-pipeline" --access manage只读客户端适合监控类任务，提议客户端所做的更改会等待有人审核。服务客户端页面介绍如何用密钥（key）或机密（secret）登录。
第 2 步：为每块屏幕选择播放器
请选择能自行启动、并且可以远程恢复的设备。采用自助终端安装的 Raspberry Pi 或 Linux 电脑、BrightSign 播放器、Windows 电脑或托管 Android 设备都能按指令重启；电视棒和电视应用更便宜，但做不到。如何选择数字标牌播放器对它们做了比较，下载页面列出了所有设备。
第 3 步：用设备群链接部署，而不是配对码
配对码用于一块屏幕就够了。如果有十块，设备群链接则是一个播放器 URL：每台打开它的设备都会成为你项目中的一块独立屏幕，自动带上链接设定的标签、字段和播放列表，无需念出任何代码。
screenrig fleet-links create --name "Kitsilano counters" --tag Kitsilano --tag Counter --playlist-id pl_MENU --max-screens 6 --expires-at 2026-11-30T23:59:59Z返回结果里带有该 URL。它是可以创建屏幕的凭据，所以只能交给设备设置使用，绝不要放到页面或聊天中。然后把它放在设备能找到的位置：
- Raspberry Pi 和 Linux。用该链接以自助终端方式运行安装程序：
curl -fsSL https://screenrig.ai/linux/install.sh | sh -s -- --kiosk --fleet-link URL。设备随后直接启动进入播放器，加入项目，断电后也会自行恢复。 - Android、Google TV 和 Amazon Signage Stick。在设备管理器里，把
fleet_link键设置到应用的托管配置中（包名ai.screenrig.player）。 - 已恢复出厂设置、带摄像头的 Android 10 或更高版本设备。在欢迎界面扫描链接的 Android 设备所有者二维码。托管播放器会自动安装为设备的主屏幕应用，全屏运行，无需设备管理器。
- Mac、Apple TV、iPhone 和 iPad。在 MDM 的托管应用配置中设置
fleet_link。 - ChromeOS。在 Google 管理控制台中，把链接填入自助终端应用的 URL。
--max-screens 和 --expires-at 可防止泄露的链接无限创建屏幕；它已经创建的屏幕会继续播放。设备被恢复出厂设置或重新安装后，只要旧身份静默满十分钟，就会作为同一块屏幕回来。播放器指南列出了各种设备管理器的设置。
第 4 步：为每块屏幕设置时区和开启时段
排程按每块屏幕自己的时区运行，所以先设置时区，再告诉屏幕何时开启：
screenrig screen set-timezone scr_KITS_COUNTER_1 --timezone America/Vancouver
screenrig screen display-schedule set --tag Window --file store-hours.json显示器排程在播放器上运行，所以即使门店的网络中断，屏幕也会在打烊时熄灭。支持的播放器通过 HDMI-CEC、DDC/CI 或背光直接控制电视本身；其余播放器则让画面黑屏。参见数字标牌的 HDMI-CEC。每个套餐都可设置重启排程，在安静时段重启设备，例如 "Mon-Sun 04:00-04:30"。
第 5 步：发布，并确认正在播放
智能体一句话就能发布。在代码中，screen publish 根据准备好的文件创建播放列表、分配它，并等待播放器报告它正在显示：
screenrig screen publish scr_KITS_COUNTER_1 menu.json
screenrig screen screenshot --tag Kitsilano --output shots/分配并不证明已经播放，因此发布会等待 Player，截图则显示屏幕上实际有什么。设备群的更改按标签或文件夹进行，无论触达多少屏幕，一次设备群操作都是一个请求。写入可以带修订检查（--expect-rev），这样两个写入方不会悄悄互相覆盖。
第 6 步：屏幕需要你时收到通知
每个项目默认在屏幕离线满 10 分钟时给其所有者发一封邮件。再添加你关心的条件：
screenrig notifications create --email owner --conditions screen_offline,display_disconnected,not_playing,glass_blank,glass_frozen --tag Kitsilano通知还可以监视设备过热、存储已满、内容更新卡住、播放器反复崩溃，以及播放列表停止推进。电子邮件和带签名的 webhook 包含在所有套餐中；路由到 Slack、Teams、PagerDuty 或 Telegram 则包含在 Plus 中。对于自行做出反应的智能体，screenrig events follow 会流式传送项目事件，而屏幕事件在监听流上是免费的。
每个播放器每十五分钟报告一次健康状况，显示器连接或电源发生变化时则立即报告：运行时间、内存、温度（设备具备时）、网络和崩溃。screen show 会连同屏幕的设备能力一起返回，因此智能体在动手之前就知道这块屏幕能做什么。
第 7 步：无需上门即可恢复
屏幕出故障时，智能体从成本最低的修复方式开始逐级尝试，并且只使用该播放器声明支持的操作：
- 查看。
screen show会报告屏幕最近一次中断；健康报告判定后，还会给出可能的原因：设备重启、应用崩溃、网络或 screenRIG。截图则显示屏幕上实际显示的内容。 - 重新加载。
screen reload刷新内容，不触碰设备本身。 - 重启应用或清除缓存。
screen restart-app重启播放器；screen clear-cache丢弃已下载的内容，保留配对，并重新下载。 - 重启。
screen reboot会在支持的播放器上重启设备。发给离线屏幕时，它会排队等待最长 24 小时，屏幕恢复在线后执行。你主动发起的重启不会在设备重启期间触发离线警报。 - 更换硬件。设备损坏后，配对替换设备并运行
screen replace：新设备会接手旧屏幕的名称、标签、时区、播放列表、排程和历史记录。
CLI 参考列出了所有设备命令及支持它们的播放器。
部署清单
- 已连接智能体，或权限仅限所需的服务客户端
- 在上门维护成本高的地方，选用支持远程重启的播放器
- 每家门店或每个分组一个设备群链接，附带标签、播放列表、屏幕数量上限和有效期
- 已设置每块屏幕的时区
- 为非营业时间需要熄屏的屏幕设置显示器排程
- 首次发布已用每块屏幕的截图验证
- 针对离线、显示器断开、未在播放，以及画面空白或卡住的通知
- 指定一位接收警报的负责人
常见问题
我到底需要控制台吗？
不需要。本指南中的所有操作都可以通过智能体、CLI 或 API 完成。控制台只是又一个客户端，在有人想看一看时很有用。
能否不用念配对码就完成部署？
可以。设备群链接会注册每一台打开它的设备，方式包括设备管理器、Linux 安装程序参数或 Android 二维码。
门店断网时会发生什么？
原生播放器会继续播放已下载的内容，显示器排程也继续在设备上运行。屏幕离线时间达到你设定的等待时长后，你会收到离线通知。
一次部署要花多少钱？
screenRIG 免费，Standard 套餐的屏幕数量不限。付费套餐增加的内容见定价。