本指南适用于Codex,OpenAI 的编码智能体,在你自己的终端中。插件安装并运行于智能体可执行命令的环境;普通 ChatGPT 聊天回复本身不设置任何内容。要在 ChatGPT 内运行 screenRIG,请使用ChatGPT dots:你的点会在其云端计算机上安装插件。在手机上,你还可以使用Meta Muse或Grok Bot。返回开始。
获取 Codex
Codex 是 OpenAI 的编码智能体 CLI。按照OpenAI 的 Codex 文档在您的机器上安装。捆绑的 screenRIG CLI 需要 Node.js 22.23.4+、24.22.1+ 或 26.12.1+(不包括 23.x 和 25.x);开始前请检查node --version。
安装官方插件
在终端运行这些命令,不要在 Codex 内运行:
codex plugin marketplace add https://github.com/screenrig/plugin.git --ref main --json
codex plugin add screenrig@screenrig --json
要确认它已注册,请运行 codex plugin list --json。然后在你的项目目录启动 Codex。如果已在运行,请重启以加载插件。
创建你的 screenRIG 项目
提供 Codex 你的实际联系邮箱,并使用已提供的组织名称,或默认为 Screens。你的智能体运行 screenrig agent enroll --email ADDRESS --organization "Screens" 来创建其身份、组织、Screens 项目和成员资格,并向你发送成员邀请邮件。该邮件是你的控制台登录凭证,无需等待:你的智能体会直接配对屏幕并制作内容。每当你想让控制台创建通行密钥,或使用现有登录添加项目时,打开它即可。控制台显示你的项目并允许你切换。
要将此安装登录到你所属的项目,请使用 screenrig login:你检查它显示的代码,然后在控制台选择项目及其访问权限。切勿将密码、邀请链接或 API 令牌粘贴到对话中。参见 项目访问。
配对你的播放器并发布
- 01
安装并启动播放器。在驱动屏幕的设备上打开play.screenrig.ai/player/或按照播放器下载与设置操作。播放器 Web 应用(PWA)即为播放器。启动它,将显示的配对码发送给 Codex,并保持 Web 播放器在前台。
- 02
描述结果。 告诉 Codex 显示什么,使用哪个屏幕,何时显示。如果想使用菜单电子表格或事件日历,请标明来源并仅批准所需访问权限。
- 03
发布并检查。 请求 Codex 使用
screen publish发布,获取截图验证结果,并亲自检查实体屏幕。
已有播放器代码?您可以合并请求:
为我的大堂屏幕使用 screenrig.ai。我的配对码是 [code]。使用我的活动日历创建欢迎板。需要其他内容请问我。
如果设置卡住
如果 Codex 报错,请让它按照“首次运行失败时”表格操作。插件技能会自动找到自己的 CLI,无需手动设置。