research-flywheel

本模板按当前 Onlyne 契约运行。role 会话使用 pi 插件工具，supervisor 的 admin 面使用带身份 gate 的 shell 命令。

一个本地多智能体自动科研模板。你给它一个研究问题和验收标准，五个 AI 角色在本地互相派活、逐轮推进：侦察员找证据、建模员做推导与形式化、实验员跑数据、写手成稿、审稿员定生死。每轮的过程件、实测数据、成稿、判词全部落成磁盘文件，顺着 runs/ 与 ledger 能回溯整条科研链。

飞轮是反应式的：没有入站任务时环不动。第一发任务落地后，推进全靠角色之间的接力边自转，人在旁边旁观，用一条命令终结任务族。

workspace 表示一个 role 的长期工作区，里面有记忆、设定、历史文件。session 表示这个 role 当前手上的一件工作。任务、session、一跳是一回事。飞轮按"射后不理"工作：恢复上下文 → 工作 → onlyne_handoff 激发下游（可选）→ 写文件 → onlyne_complete 交活退出。role 不等下游回执。投递后立即返回一行 receipt JSON。过程与回执都写进 server ledger。结果通过文件返回。下一条接力任务会唤醒下一个 role。

最省事的路：让 agent 干完全程

在仓库根目录打开 pi（orca/herdr 里用 omp 打开本仓库即可），把下面整段粘给它，它会把装配、通电全部做完，你只回答三个问题、最后在几个 tab 里粘几行命令。

验收清单（agent 报完你核对）：onlyne server status 的 socket_present 为真；onlyne roles 五个角色全 connected；第一发后 onlyne ledger 出现 scout 的在途行；runs/ 下新生出 /idea.json。

环长什么样

三种走法：照下面五步自己走；把上面那段话粘给 pi 让 agent 干完全程；在 orca/herdr 里用 omp 打开本仓库口头问它。

快速起步（新手照这条走）

第 0 步：装工具（一次性）

• Onlyne 工具链来自 Rust crates，先装 cargo。升级＝同一条命令加 --force 重跑。
• pi 是角色会话的 agent 后端，npm:pi-onlyne 是它的 onlyne 插件。role 模板 .pi/settings.json 的 packages 已经写着它。
• 手册按 role 与 supervisor 两种席位导出：

• 会话宿主三者有其一：herdr、orca、zellij。选择链是 ONLYNE_BACKEND（非空） 工作区 config.toml 的 backend auto；auto 探测序 herdr→orca→zellij。
• 验收：onlyne version 输出 protocol:1；pi list 里有 npm:pi-onlyne。

要跟 onlyne 仓 main 上尚未发布的 fix：git clone && cargo build --release，工具链产物放进 PATH。macOS 上 cp 完必做 codesign --force --sign -，复制后的二进制签名失效，直接 exec 收 SIGKILL。