File-as-Bus - 长时 Agent 的持久工作区总线模式
What it is
File-as-Bus 指用文件系统作为人与 agent、agent 与 agent 之间的共享状态总线:各方通过读写同一份持久文件来协调,而不是通过消息传递、共享内存或数据库。文件是单一事实来源,所有其他界面(网页、手机端、其他 agent)都是它的副本或视图。
Why it matters
- 持久性:会话结束消息即消失,文件跨会话保留。
- 可检查性:文件可直接读取审计,中间状态即调试界面。
- 并发与恢复:文件系统天然支持多读写方,任务可从文件状态恢复。
- 实证:AiScientist 研究显示,移除 File-as-Bus 后 PaperBench 和 MLE-Bench Lite 性能显著下降(@omarsar0 总结,2026-04-16)。
- 个人尺度同样成立:Ben Tossell 的 to-do board 案例显示,单一 markdown 文件可以承担人与多个 agent 之间的全部共享状态。
Key points
- 单一事实来源规则:页面、网站、每个 agent 都读写同一份文件,其他一切是副本。
- 一行即一条目:变更只编辑一行,其余字节不动;元数据(状态、日期、区域)以行尾标签表达,因为 agent 直接编辑文件。
- 冲突规则要显式:Ben 的同步脚本规定"同一行两边都改,文件赢";网站不可读时不做任何变更。
- append-only 工作日志:每个 agent 做出重要产物时追加一行(时间、agent、区域、内容、路径),主要读者是其他 agent。
- 原子写入:先写临时文件再 rename,避免半写状态被其他读者看到。
- 编排器不持有状态:调度归编排器,状态归文件系统。
Evidence across sources
| Source | Key Claim | Relevance |
|---|---|---|
| 2026-04-16 RIP Pull Requests(AiScientist 研究,@omarsar0 总结) | 薄编排器通过 /workspace/artifacts/ 协调专业 agent;移除文件总线后基准性能显著下降 | 研究侧实证,多 agent 工作区尺度 |
| Ben Tossell: I wanted to see my to-dos | todos.md 作为人与 agent 共享看板的唯一事实来源;Site Data 是副本;launchd 每 10 分钟同步;文件赢冲突规则;work-log.md append-only | 个人单文件尺度,人与 agent 共享同一文件,含手机端双向同步 |
两个来源覆盖不同尺度:研究侧是多 agent 工作区 artifacts,个人侧是单一 markdown 文件。共同结论:文件系统是比消息和内存更可靠的总线。
Open questions
- 文件尺度上限:单个 todos.md 在数百行内工作良好;大规模项目状态(数千条目)是否需要分层文件结构?
- 冲突规则"文件赢"在多人(而非人与 agent)场景是否仍然合理?
- 没有独立基准复现 Ben 的同步模式,其可靠性证据只有个案自述。
Prompts for witness
- 你的 personal_daily 工作区(Obsidian vault 加 raw/ 加 wiki/ 加 outputs/)本质上已经是一个 file-as-bus 系统。Dobby 与 cron 上的各个 agent 都在读写同一批文件。回看哪一次协作最顺、哪一次最卡?"文件赢"规则在你的 vault 里成立吗?
- Ben 的 work log 主要写给 agent 而不是自己。你的 wiki/log.md 目前主要读者是你自己。如果改成"主要写给 agent",格式和内容会有什么变化?
Related
- harness-engineering/folder-is-the-agent:文件夹即 Agent,File-as-Bus 是其通信机制
- harness-engineering/factory-missions-architecture:185 次 Agent 运行依赖持久工作区
- harness-engineering/prototype-then-pick-design-iteration:Ben 案例的另一面,变体原型设计迭代
- harness-engineering/self-verification-loops:验证闭环需要持久化的中间结果
- harness-engineering/agent-session-history-as-asset:会话历史作为资产的互补视角
2026-10:权威源协议的完整实现
来源:AI Briefing 2026-10-06、Ben's Bites 2026-10-21
Ben's Bites 的 everything app 报道给出了文件总线协议的完整实现,与本页 Ben Tossell 案例一脉相承:
- todos.md 单文件是唯一事实源:网页、在线库等其余界面都是副本。
- 单行原子更新:以行号 + 原始文本匹配定位目标行,冲突即拒绝写入,而不是猜测意图。
- Agent 间 handoff 约定:别名即线程,agent 通过约定俗成的别名交接任务。
可见性是 agent 工作流的基础设施:任务、产物、负责人、状态需要外部可查的视图,做地图和日志比加更多 agent 更能降低混乱。
另一项基础设施变化:Google Drive / Docs 在 2026-10 原生支持 Markdown,"底层文件保持 Markdown、人类在文档界面审阅"成为主流办公套件的现实,消除了 agent 工作流的同步边界。