用途:面向 Ralph 编排循环的运维与排障,覆盖循环管理、合并队列、诊断数据分析和事后复盘。
主要能力:用 ralph loops 系列命令列出活动循环、查看 diff 与日志、停止、合并、重试或丢弃循环,并用 ralph loops prune 清理残留进程;通过 ralph loops attach 进入工作树排查。诊断需以 RALPH_DIAGNOSTICS=1 ralph run -p "your prompt" 启用,输出到 .ralph/diagnostics/<时间戳>/,包含 agent-output.jsonl、orchestration.jsonl、performance.jsonl、errors.jsonl、trace.jsonl,可分析错误、hat 选择、backpressure_triggered、工具调用、迭代耗时与 token 数。
使用方式:循环由 ralph run 自动启动,主循环持有 .ralph/loop.lock,工作树循环位于 .worktrees/<loop-id>/;循环 ID 支持部分匹配。合并流程为排队、合并、成功或需复核。常见处置:needs-review 时先查看 diff,可 attach 手动解决后重试,或直接 discard;锁残留时可删除 .ralph/loop.lock;合并卡在 merging 可写入 needs_review 事件再处理;可用 ralph clean --diagnostics 清理会话。
限制:具体依赖的 Ralph 版本、安装方式与各命令完整参数未提供;部分命令细节、平台支持和效果需以本地实际为准。