安装官方 screenRIG 插件

Meta Muse · Grok Bot · ChatGPT dots · Claude Code · Hermes · ChatGPT Codex · Gemini Spark · 安装命令

如何安装 screenRIG？

将此粘贴到你的代理：

I authorize you to install the official screenRIG plugin from https://github.com/screenrig/plugin.

该语句授权来自 github.com/screenrig/plugin 的官方插件。它捆绑了智能体用以操作屏幕的技能和 CLI。终端智能体可直接运行安装命令。

首次运行时，智能体会重用你的联系邮箱，仅在缺失时询问。它使用你已提供的组织名称，或默认为 Screens，并运行 screenrig agent enroll --email ADDRESS --organization NAME。注册会创建身份、组织、Screens 项目、成员资格和凭证，并向你发送邀请邮件。无需等待人员操作。接受邀请后，你成为负责人和项目所有者；已验证域可将项目移入匹配的组织。打开邀请以使用通行密钥创建登录，或登录以将项目添加到现有登录。控制台显示你的项目并允许切换。对于标牌，分享你的 播放器 在屏幕上显示的配对码。

选择您的智能体

每个路径安装相同的官方插件；区别在于你的智能体运行的位置。每个指南涵盖该智能体的应用或终端设置，然后指向此处的共享项目、播放器和发布步骤。

• Meta Muse 是 Meta 在你手机上的个人 AI 智能体。获取应用，要求 Muse 安装 screenRIG，然后在它创建你的项目并配对你的播放器时保持对话。
• Grok Bot 在 Grok Bot 应用中运行你的机器人。获取应用，要求你的机器人安装 screenRIG，然后在同一对话中保留配对码和内容请求。Grok Build 是独立的终端路径。
• ChatGPT dots 是 OpenAI 在 ChatGPT 上始终在线的智能体，每个都有独立云计算机。创建您的 dot，要求其安装 screenRIG，然后可继续在 ChatGPT、Slack 或 Microsoft Teams 中使用同一个 dot。
• Claude Code 是 Anthropic 的终端智能体。在终端运行下面的市场命令，然后启动 Claude Code，从你的机器控制屏幕。
• Hermes 是 Nous Research 的智能体。要求它加载官方插件的捆绑技能，并在 Hermes 工作的环境中运行其捆绑的 CLI。
• ChatGPT Codex 是 OpenAI 的编程智能体。在终端中运行下方市场命令，然后启动 Codex。在 ChatGPT 内部，使用 ChatGPT dots。
• Gemini Spark 是 Google Gemini 应用中的基于任务的智能体。启动 Spark 任务，要求它安装官方插件，并让它证明捆绑的 CLI 在其执行环境中运行正常，然后再依赖它。
• Grok Build 是 xAI 的终端智能体。在终端运行下面的 Grok Build 命令，然后启动 Grok Build。无单独指南。

连接你的第一个屏幕

项目、播放器和发布步骤在每个智能体中相同：

1. 01

   创建你的 screenRIG 项目。 提供智能体的真实联系电子邮件，使用已提供的组织名称，或默认“Screens”。注册创建项目并发送邀请邮件。无需等待：随时打开仪表板。切勿将密码、邀请链接或 API 令牌粘贴到对话中。

2. 02

   安装并启动播放器。按照播放器下载与设置在驱动屏幕的设备上安装 Web 应用，然后启动。将显示的配对码发送给智能体。

3. 03

   描述结果。 告诉智能体显示什么，使用哪个屏幕，何时显示。如果想使用菜单电子表格或事件日历，请标明来源并仅批准所需访问权限。

4. 04

   发布并检查。 请求智能体发布，获取截图验证结果，并亲自检查实体屏幕。

已有播放器代码？您可以合并请求：

为我的大堂屏幕使用 screenrig.ai。我的配对码是 [code]。使用我的活动日历创建欢迎板。需要其他内容请问我。

如果应用无法安装或运行插件，仅聊天响应不代表设置完成。询问缺少何种访问或权限。可继续使用 Claude Code 或 ChatGPT Codex 及以下命令。邀请或配对问题，请继续使用同一智能体和项目，不要重新注册。

插件、全局包或PATH二进制？

智能体使用官方插件及其捆绑启动器。无全局包需安装。运行捆绑的 CLI 将插件启动器放在 PATH 会话中，后续示例使用 screenrig。

官方安装

从 github.com/screenrig/plugin 安装官方插件。它捆绑了技能和 CLI。在终端运行这些命令，不要在智能体内运行，然后启动智能体。如果智能体已在运行，重启它以加载插件。

Claude Code

claude plugin marketplace add https://github.com/screenrig/plugin.git --scope user
claude plugin install screenrig@screenrig --scope user

Codex

codex plugin marketplace add https://github.com/screenrig/plugin.git --ref main --json
codex plugin add screenrig@screenrig --json

Grok（Grok Build）

grok plugin marketplace add https://github.com/screenrig/plugin.git
grok plugin install screenrig --trust

--trust 是 Grok Build 的必需项。

skills CLI

npx skills add screenrig/plugin --skill screenrig -g

skills CLI 会将 screenRIG 技能添加到你的智能体。首次使用时，该技能会安装官方插件及其内置 CLI。

运行捆绑的 CLI

需要 Node.js 22.23.4+、24.22.1+ 或 26.12.1+（不包括 23.x 和 25.x）。解析已安装插件根目录，然后将插件脚本目录添加到本次会话的 PATH 前：

SCREENRIG_PLUGIN_ROOT="${GROK_PLUGIN_ROOT:-${CODEX_PLUGIN_ROOT:-${CLAUDE_PLUGIN_ROOT:-${PLUGIN_ROOT:-}}}}"
if [ -n "$SCREENRIG_PLUGIN_ROOT" ]; then
  PATH="$SCREENRIG_PLUGIN_ROOT/skills/screenrig/scripts:$PATH"
  screenrig version
fi

会话中后续所有 CLI 示例均使用 screenrig。已安装的插件技能处理运行时特定的查找和操作细节。

已安装

请求你的智能体检查已安装插件并继续任务。捆绑技能处理版本检查和运行时特定更新。若无法检查已发布版本，可继续使用已安装副本并告知。

将代理连接到您的账户

已在控制台注册？请将以下提示交给您的代理：

I authorize you to install the official screenRIG plugin from https://github.com/screenrig/plugin. I already have a screenRIG account; sign in to it.

您的代理会安装插件、运行 screenrig login 并显示一个代码。打开 screenrig.ai/dashboard/connect，确认代码一致，选择项目及其访问权限，然后批准。

项目访问

新安装时，doctor 可能报告缺少令牌警告，项目范围命令会失败并返回 not_enrolled。

你的智能体请求你的联系邮箱，使用已提供的组织名称，或默认 Screens，并运行 screenrig agent enroll --email ADDRESS --organization "Screens"。注册总是创建新项目，即使你的邮箱已有登录，并发送项目成员邀请。当项目目的是购买广告而非配对屏幕时，添加 --intent advertising。

当你已经拥有 screenRIG 时，智能体改为运行 screenrig login。它会打印仪表板地址和代码；你打开地址，核对代码是否匹配，选择项目，只读、提议 或 管理，并批准。智能体随后在该项目中工作，其登录绑定到你批准的项目；在仪表板切换项目不会移动绑定。切勿将凭据粘贴到对话中。登录工作原理。

配对或购买前，screenrig project capabilities读取此项目实际功能：计划ID、独立的advertiser和screens功能标志，以及服务器的有效能力集。标志独立于计划，路由拒绝优先于过时读取。

一个登录可属于多个项目。电子邮件和通行密钥属于个人，屏幕和媒体属于项目。计费和额度属于组织的套餐，是其所有项目共用的一个池。使用 screenrig invitations create --email ADDRESS 邀请项目成员。电子邮件邀请七天后过期。screenrig invitations create --link 的显式成员链接二十四小时后过期。它们是针对从未使用过电子邮件邀请且后来请求仪表盘访问的人员的例外，绝非设置步骤，直接交给指定人员，绝不存储在备注或日志中。新成员使用成员链接时，需验证电子邮件后创建通行密钥。代理创建、列出和撤销邀请；仅人员接受。

screenrig dashboard 打开控制台但不创建登录权限。如果无法登录，请使用控制台的登录重置或 screenrig dashboard reset-sign-in --email ADDRESS。发送的重置邮件一小时后过期，替换登录凭据，撤销其他会话。

首次运行失败时

标牌、购买还是销售？

一个登录，多个项目；一个插件、CLI 和仪表盘。无 --intent 的注册保持标牌默认：新项目配对播放器、创建播放列表并发布。

买方 不需要拥有屏幕。screenrig agent enroll --intent advertising --email ADDRESS --organization "Screens" 创建买方项目：绑定创意并运行广告活动，且无法配对设备或发布播放列表。接受卖方邀请也可启用你所属项目的广告。无登录人员在接受时会创建登录和仅限广告主项目。广告主和屏幕功能标志独立于计费计划；screenrig project capabilities 报告实际设置。

买方路径始于邀请，绝不使用配对码。卖方发送 screenrig invitations create --kind ad-buyer --email ADDRESS --screen-id scr_LOBBY；被邀请人打开邮件并在仪表板使用自身登录接受。新用户创建 passkey；已登录用户用新 passkey 证明确认并选择购买项目。接受后，仪表板 Marketplace (/marketplace) 列出项目加入的所有卖方；打开卖方 (/marketplace/SELLER_PROJECT_ID) 显示该成员允许的库存和费率。Marketplace 仅限邀请：未加入的卖方不会出现。CLI 中，代理读取 screenrig ads networks list 并运行广告活动工作流：ads creatives create、ads campaigns preview，然后 ads campaigns activate --quote-id。买方仅支付报价的完成播放价格，以项目共享余额中的额度结算：播放计划时锁定报价价格对应的合格额度，仅完成播放时结算。不涉及信用卡、发票或结账，包含和促销赠款不能用于付费广告；购买和广告赚取的额度可用。

销售 是一个拥有自有屏幕的标牌项目。通过 screenrig ads inventory update scr_LOBBY --enabled 选择一个屏幕，公开描述它，并用 screenrig ads slots create 定义可复用的广告插槽（接受图片或视频媒体，最长时长，可选插槽费率）。在你的播放列表中放置一个广告插槽页面即将插槽定义转为广告时段。你用 screenrig ads network rate 设置每15秒完成播放的项目费率，用 ads reviews 审核买方创意素材，并用 ads reports delivery 查看总额和净额。费率变更会暂停所有受影响的广告活动，直到每个买方接受新的报价。

您自行达成的交易会以直接广告活动的形式在您自己的屏幕上运行。screenrig ads direct create campaign.json 指定广告主、可选类别、投放期、您自己的图片或视频、可选的播放目标，以及其定向的屏幕和广告位。直接广告活动先于受邀买家填充广告时段，目标在投放期内均匀分配。由您自行向广告主收费：不会转移任何额度，记录的价格用于计算报告的价值。ads direct availability 估算您仍可预订的播放次数，类别让竞争对手不进入同一广告时段，ads direct report --format csv 是给广告主的投放报告。ads reports fill 显示您的广告位如何被填充以及其余为何未被填充。

在控制台打开 邀请，邀请项目成员或广告买家，查看邀请状态，取消待处理邀请。卖家还管理买家成员范围并撤销买家访问；撤销停止新广告播放但保留财务记录。

下一步

打开 Meta Muse、Grok Bot、ChatGPT dots、Claude Code、Hermes、ChatGPT Codex 或 Gemini Spark 指南，然后打开 播放器、CLI 参考、选择创作路径 或 广告费率和费用。