
orx exp命令组完全指南研究智能体实验从status到wait全流程教程【免费下载链接】OpenResearchTurn your coding agents into research agents项目地址: https://gitcode.com/GitHub_Trending/op/OpenResearchOpenResearchorx是一个本地优先的研究智能体工作区能把 Claude Code、Codex、Cursor 等编码智能体变成可以跑实验、看证据、写报告的研究智能体。它的orx exp 命令组正是驱动实验全流程的核心一条status看状态、一条run启动、cancel中止、wake唤醒、wait等待结果。本文带你从零理解这 5 个动词如何串成一条完整的自动化研究循环。 orx exp 是什么按实验节点操作的最小命令组在 OpenResearch 中一个项目就是一棵实验树根节点是 baseline每个子节点是一个假设运行run挂靠在实验节点上。exp命令组与项目级命令不同每个动词都接收一个实验 IDexpId你可以先运行orx project view projectId查到所有节点的 id。整个命令组的定义在 src/main.rs实现入口在 src/commands/exp.rs一共 5 个子命令命令作用一句话理解orx exp status expId查看状态体检卡分支、运行命令、最近一次 runorx exp run expId启动实验点火在本地或远程计算上跑起来orx exp cancel expId取消运行急停中止进行中的 runorx exp wake expId唤醒智能体闹钟run 结束后自动把智能体叫醒orx exp wait …等待完成循环心脏阻塞到 run 到达终态上图是研究智能体在实验 run 中产出的典型证据缩放定律曲线图示例数据见 demo 目录。 一键体检orx exp status 查看实验全貌orx exp status expId一条命令输出 4 类关键信息实验名称与智能体状态、分支branch与父节点、运行命令run command、以及最近一次 run 的 id / 状态 / commit / 耗时。这是你改代码前该养成的第一个习惯——先确认这个节点测的是什么。实现逻辑在 src/plane/local_plane.rs它只读本地 SQLite 存储不做任何轮询毫秒级返回。新手提示如果command显示— (not set)说明项目和实验都没设运行命令先用orx project edit配置默认 run command否则exp run会报错。 点火启动orx exp run 指定计算后端orx exp run expId --backend local orx exp run expId --backend hf --flavor a10g-smallrun会启动一个orx 托管的 run提交作业后一个独立的监督进程supervisor在后台持续记录状态和日志即使你关掉终端它也不会死。后端选择非常丰富见 src/main.rs 的参数说明local— 本机分离进程零配置hf / modal / k8s / ssh / slurm / ray— 你自己的 Hugging Face Jobs、Modal、K8s 集群、SSH 机器、Slurm、Ray 集群openresearch— OpenResearch 托管的临时 GPU/CPU 机器tinker— 本地控制 远程模型计算如果之前配置过默认计算目标甚至可以省略--backend。启动成功后命令行会直接打印下一步该敲什么orx exp wait expId或orx logs runId。 急停开关orx exp cancel 中止进行中的运行orx exp cancel expId取消针对该实验所有非终态 run会先持久化取消意图再通知后端即使 run 变成孤儿也会有新监督进程接手。如果实验没有进行中的 run会提示No run in flight for this experiment。实现见 src/plane/local_plane.rs。⏰ 智能体闹钟orx exp wake 让 Agent 自动回来orx exp wake expId这是研究智能体专属的命令只能在本地orx up的智能体会话内使用给最近一次 run 挂上闹钟run 成功或失败时自动把智能体唤醒继续干活。注意它的语义——被取消的 run 不会安排唤醒已送达的唤醒不会重复触发src/commands/exp.rs。⏳ 循环心脏orx exp wait 的两种等待模式wait是为智能体驱动研究循环而设计的阻塞命令默认每 5 秒轮询一次最长等 1800 秒后以非零码退出可用--interval和--timeout调整。它有两种互斥模式src/commands/exp.rs模式一等待单个实验expIdorx exp wait expId电平触发轮询该实验的最新 run直到到达终态done / failed / cancelled才返回。适合我就盯着这一炮的场景。模式二等待整个项目首个完成--projectorx exp wait --project projectId边沿触发对全项目 run 做快照只要有第一个run 完成立即返回——这就是一个槽位刚空出来的信号。没有任何进行中的 run 时会立刻打印drained: no runs in flight并返回。这是并行实验预算打满循环的关键src/plane/local_plane.rs。⚠️ 新手常踩的坑wait --project只是睡眠到变化的信号不是真相来源。run 可能在你分析上一个结果时就跑完了所以每次被唤醒后要重新执行orx runs projectId对账处理所有新进入终态的 run。 最佳实践从 status 到 wait 的自动研究循环官方 orx-experiment-tree 技能 给出了完整的心法核心循环只有 4 步看—orx exp status expId确认节点、分支与运行命令跑—orx exp run childId --backend b把本轮的兄弟节点并行发出去等—orx exp wait --project projectId一个 tick 一次返回即分析决— 读日志后四选一修复原地修分支重跑、补位启动排队节点、晋升胜者成为下一轮父节点、停止目标达成loop: orx exp wait --project projectId # 睡到第一个 run 完成 orx runs projectId # 重新对账所有 run 状态 → 分析结果 / 补位 / 晋升 / 停止 # 看到 drained: no runs in flight 即退出配合orx exp wake整条流水线可以完全无人值守智能体点火 → 睡觉 → run 结束自动醒 → 分析 → 再点火直到目标达成。 延伸阅读 实验树完整方法论agent-skills/orx-experiment-tree/SKILL.md 计算后端与技能参考agent-skills/orx-compute/SKILL.md CLI 命令分发入口src/commands/mod.rs 实验状态输出实现src/plane/local_plane.rs一句话总结status是体检、run是点火、cancel是急停、wake是闹钟、wait是心脏——掌握orx exp命令组你就握住了研究智能体自动实验循环的全部方向盘。【免费下载链接】OpenResearchTurn your coding agents into research agents项目地址: https://gitcode.com/GitHub_Trending/op/OpenResearch创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考