Origin

打开 Origin

• 在电脑或手机浏览器打开 origingame.ai/agent，用 OriginGame 账号登录。手机上是同一个工作区，布局换成底部标签栏。
• 原生 iOS App 目前通过 TestFlight 分发，可以查看游戏库和会话、回答问题、引导和停止 Origin、全屏试玩。
• Origin 目前只对内测成员开放。账号没有加入内测时，/agent 显示「Origin 正在内测」，可以点「申请内测」，通过后会收到通知。
• 网页本身不运行命令，也不保存任何密钥：对话保存在服务器上，代码保存在游戏仓库里，命令在执行器里运行（见命令在哪里执行）。

游戏库与游戏工作区

/agent 是游戏库：列出你的游戏（需要你处理的和失败的排在前面，其余按最新排序），可以搜索，并提供四种开始方式：

打开一个游戏进入它的工作区（/agent/<游戏 ID>）。一个游戏可以有多个会话，每个会话是一段独立的对话，有自己的目标；用「新会话」开始另一个方向的工作。

• 对话：Enter 发送（Origin 正在工作时会排队），Cmd/Ctrl+Enter 立即引导当前这一轮，也可以停止。可以附图片、用麦克风语音输入、用 @ 提到协作成员。Origin 提问时，你的下一条消息就是回答。
• 侧栏有三个视图：「方案」显示设计、当前里程碑和六个步骤（设计、构建、试玩、评测、打包、发布）的进度；「预览」运行当前构建；「发布」显示打包、已发布的版本和玩家数据。
• 面板：「版本」看改动、检查点和并入；「制品」看截图、录像等产物；「分支探索」同时尝试几个方向；「评测」看评测记录；「分享」邀请成员。
• 命令面板：Cmd/Ctrl+K 搜索会话、游戏和操作。设置在 /agent/settings：连接状态与余额、模式和模型、用量、外观、快捷键。

在「预览」里可以玩、暂停、单步、重新加载，用「指点」在画面上圈出问题发给 Origin，用「调参」拖动游戏公开的参数并实时看到效果（「保留这些值」让 Origin 把它们写回源码），或者录制 10 秒。有些构建不支持「调参」等控件，这时按钮不可用并说明原因。手机上的「预览」不嵌入画面：点「开始游玩」，当前构建在全屏游玩页打开，返回即回到会话。

每个游戏是一个 Git 仓库

• 游戏的源码保存在 OriginGame 托管的 Git 仓库里。main 是游戏的主线，每个会话在自己的分支上工作。
• 每一轮成功结束时，会话的改动提交到它的分支。一轮被中断、执行器暂停或更换时，未提交的工作也会先保存，新的执行器接着用，工作不会只留在某一台机器上。
• 会话的改动通过并入（Land）进入 main，只允许快进。Origin 可以在构建通过后自己并入；你也可以在「版本」面板里确认并入。如果 main 已经前进，会话需要先把 main 合并进自己的分支。
• 「版本」面板显示「最新改动」：会话分支相对 main 的差异，按文件列出增删行数。
• 游戏所有者可以在「分享」里生成一次性的邀请链接或邀请码（7 天有效），设置成员角色，撤销邀请或移除成员。

检查点

检查点是对游戏仓库里某一个提交的不可变记录。它不是每轮对话自动产生的，而是在以下操作时创建：

• Origin 打包时：一个打包是某个检查点的不可变构建存档，用于预览和发布。
• Origin 发布时：发布记录指向源码检查点，作品的来源因此可以追溯，这也是作品能被 Remix 的前提。
• 运行试玩测试或评测时：评测针对一个固定的检查点运行。
• 创建分支探索时（固定起点），以及把一个分支合并回来时。

两个操作只在你明确选择时发生：

• 恢复：在「版本」面板的「检查点」列表里点「恢复到这里」并确认。main 上会新建一个提交，把文件恢复成该检查点的内容，历史不会被改写。之后其他会话需要先合并 main 再继续。
• 分支探索：从一个会话出发，同时开 2 到 4 个分支，每个分支一个方向（可以自己写，也可以让平台提议）。完成后对比各分支的画面、评测、设计差异和提交，选一个合并回原会话，其余分支归档；也可以丢弃。

另外，执行器会记录 Origin 的每次文件编辑，Origin 可以撤销自己的某一次编辑。这类撤销记录不出现在检查点列表里。

命令在哪里执行

Origin 的命令（构建、运行、截图、测试）在执行器里运行，执行器有两种：

在会话输入框旁的执行器图标里选择本会话在哪里运行：「自动」（Runner 具备此模式所需的工具时用它，否则用云沙箱）、某一台 Runner，或「云沙箱」。计费方式见 计费。

安装 Origin Runner

1. 先在 Origin 里创建至少一个游戏：Runner 令牌由游戏仓库授权。
2. 打开 /agent/runners，运行下面的安装命令。
3. 在同一页面填一个名称（例如 laptop），点「生成令牌」。令牌只显示一次。
4. 运行页面给出的连接命令：login 时粘贴令牌，然后把 ~/Games 交给 Runner，并安装常驻服务。
5. Runner 在 /agent/runners 的列表里显示为在线，并列出它服务的目录和报告的工具。不再使用时可以在这里撤销。

安装命令（macOS、Linux）：

curl -fsSL https://origingame.ai/downloads/runner/install.sh | sh

Windows 在 PowerShell 里运行 irm https://origingame.ai/downloads/runner/install.ps1 | iex，不需要管理员权限。

连接命令（macOS、Linux；页面上的命令已经填好你的 Runner ID）：

~/.origin/bin/origin-runner login
mkdir -p ~/Games
~/.origin/bin/origin-runner service install --server https://origingame.ai --runner-id <RUNNER_ID> --dir ~/Games

• 网页上创建的游戏第一次在这台 Runner 上运行时会被克隆进 ~/Games，每个会话在旁边有自己的 Git 工作树。克隆和推送使用每次下发的短期凭据，凭据不会写入磁盘。
• Linux 上 service install 会开启 lingering，无人登录时 Runner 也会开机启动。
• macOS 版 Origin Kit 自带 Runner，可以在 Kit 里托管它。Windows 版 Runner 尚未在真实 Windows 主机上验证。

从 Origin 发布

1. 让 Origin 打包，或在「发布」里点「发布…」：输入框里会填好一条消息，请 Origin 发布最新的打包，并先给你看商店页文案和封面图。
2. 确认后，Origin 用与其他 Agent 相同的发布接口（deploy_create 新建，deploy_update 更新）发布，并把源码检查点记录在发布上。没有源码检查点的发布仍然可以玩，但不能被 Remix。
3. 提交前，平台会在 Player 里检查游戏能否正常加载并报告就绪；检查失败时什么都不会发布。
4. 发布后，「发布」视图列出各个版本并标出正在上线的版本。点某个版本的「上线」并在 5 秒内再按一次确认，即可切换到该版本。

版本、回滚和发布后得到什么，见 发布游戏。