跳转至

输出与续跑

Arbor 记录一次运行产生的一切,让你能检视它、复现它,并从你停下的地方继续。

会话产物

每次运行都有自己的会话目录,默认位于目标项目下:

<project>/.arbor/sessions/<run_name>/

<run_name> 默认是一个时间戳;用 --run-name 显式设定,或用 --workspace-dir 整体迁移该目录。

里面你会找到本次运行的检查点(想法树 + 消息历史)、日志,以及最终报告。你启动时所用的确切指令 会记录在会话日志中,而本次运行完全解析后的设置会保存到 <run_name>/.coordinator/config_snapshot.yaml(合并了每一层配置,密钥已脱敏)。

复用一套设置

若要在一次全新运行中以相同设置重复一项研究,把那份 config_snapshot.yaml 复制到项目根目录 并命名为 arbor.yaml——Arbor 下次会自动加载它。见 准备基准 → 保存并复用一套设置

REPORT.md

一次运行结束时,Arbor 写出一个 REPORT.md——这项研究的人类可读成稿:尝试了什么、什么奏效、 每个结论背后的证据,以及最终结果。用 arbor report 处理它,运行过程中用 /report 斜杠命令 打印产物路径。

默认情况下 Arbor 随后会打开一个只读问答提示,让你就这次已完成的运行进行追问(用 --no-followup 关闭)。

实验分支

每个实验都在自己的 git 分支、隔离的 worktree 上运行过。已合并的改进在 trunk 上;探索过但未合并的 想法仍以分支 ref 的形式存在,供你检视。运行过程中,/branches 列出探索过的分支 ref,/tree 打印想法树快照。

续跑被中断的运行

如果一次运行被中断——你停了它、机器重启、预算耗尽——从它的检查点续跑,而不是从头再来:

arbor --resume --run-name my-study

--resume 从现有会话重新加载想法树与消息历史,并在同一工作空间里继续。把它与 --run-name (或 --workspace-dir)配合,指向你想续跑的那个会话。

Tip

由于想法树是持久的共享状态,续跑恢复的不只是运行停在哪,还有它已经学到了什么——已合并的 改进、被剪掉的分支以及反向传播的洞见都完好无损。

运行时监控

  • 终端仪表盘 —— 实时循环状态、想法树与成本。
  • 只读 Web 监控 —— 自动在靠近 8765 的端口启动(用 --webui-port 改端口,--no-webui 关闭)。
  • /cost —— 随时打印 token 用量。