【免费下载链接】loki-modeAutonomous software factory. Give it a GitHub issue, a spec or a one-line task; get back a pull request with a signed receipt anyone can re-check offline. Runs on your machine with your own keys: Claude, Codex, OpenCode.项目地址https://gitcode.com/gh_mirrors/lo/loki-mode点击查看免费下载Loki Mode 是一个自主软件工厂autonomous software factory给它一个 GitHub issue、一份 spec 或一行任务它会还你一份带签名回执signed receipt的 pull request。这篇文章带你拆解它的核心架构——为什么它把文件系统当作系统总线又是怎么靠 checkpoint 实现崩溃恢复与断点续跑的。看完你会明白状态不放在内存里而是落在.loki/目录的一组文件里这是整个系统可检查、可恢复、可重放的根基。一、为什么用文件系统当系统总线很多编排系统用共享内存、Redis 或消息队列来协调组件Loki Mode 选择了最朴素的方案所有长期协调都通过.loki/目录下的状态文件进行。组件之间不共享内存只读写文件。官方架构文档 docs/ARCHITECTURE.md 把这条列为核心设计原则Filesystem as the system bus. Components do not share memory. They communicate through.loki/state files, which makes the system inspectable, resumable, and crash-tolerant.这个目录长这样概念上的布局.loki/ ├── state/orchestrator.json # 当前阶段、迭代数、指标 ├── autonomy-state.json # 重试次数、退出码、运行状态 ├── queue/ # pending / in-progress / completed 任务队列 ├── checkpoints/ # 断点快照见第三节 ├── events/pending/ # 事件总线待处理事件 └── CONTINUITY.md # 会话级工作记忆与交接上下文文件系统总线带来三个实打实的好处可检查inspectable构建跑到哪一步ls .loki/一看便知不用接调试器。多入口共享同一状态CLIautonomy/loki、MCP 服务mcp/server.py、REST APIapi/server.ts和控制台 Dashboard 读写的都是同一份文件天然同步。崩溃容忍crash-tolerant进程被杀文件还在——这就是断点续跑的前提。上图的 Task Queue 看板并不是界面自己记了一份账它读的就是.loki/queue/下那几个 JSON 文件。看板是果文件是因。没有消息队列事件怎么广播事件总线同样是文件实现的。events/bus.ts 是一个基于文件的发布/订阅实现emit()把事件 JSON 原子写入.loki/events/pending/订阅方轮询消费后归档到archive/并用processed.json去重只保留最近 1000 个事件 ID。写入时通过.lock锁文件防止并发损坏——这套文件锁 轮询的模式替代了重量级消息中间件。并发安全方面autonomy/lib/lock.sh 提供了一个跨平台的原子锁flock在 macOS 上不存在它改用 POSIX 下原子操作的mkdir当互斥锁并在锁内写 PID 哨兵文件做死锁检测——持锁进程挂了超过 30 秒锁会被自动回收不会把系统卡死。二、崩溃恢复状态不随进程消失原子写入写一半也算没写状态文件最经典的死法是写到一半进程挂了。loki-ts/src/runner/state.ts 的实现完全镜像了 bash 引擎的写法先写.tmp.$$临时文件再rename覆盖正式文件。POSIX 下rename是原子操作——读者永远只看到旧文件或完整的新文件绝不会看到半个 JSON。加载时还会做一次孤儿 tmp 文件清扫orphan sweep把上次kill -9留下的半成品清掉。崩溃现场留证.loki/crash/进程非正常退出时崩溃捕获钩子autonomy/crash.sh autonomy/lib/crash_capture.py会组装崩溃上下文经脱敏白名单处理后写入.loki/crash/fingerprint-时间戳.json。同一次崩溃会算出相同指纹方便归并分析。失败分类 → 确定动作恢复策略表loki-ts/src/runner/recovery_policy.ts 是整个崩溃恢复的大脑。它把每次失败分类然后映射到唯一一个动作且受硬预算默认 3 次尝试 / 30 分钟约束动作触发场景retry瞬时网络抖动原样再试revise活干错了不是传输问题带反馈重试checkpoint_rollback工作树损坏冲突标记、半截写入回滚到已知好快照failover当前 provider 不可用请求切换模型层级escalate预算耗尽交给人或更强的模型层级stop没有任何动作能成功省预算收手还有一个细节很能体现工程严谨性编译失败只认构建命令的退出码绝不用正则去匹配模型输出的文字——因为一个正在写编译器或 linter 的 agent它的正常输出里就会包含 compilation failed 这种词用正则会把健康构建误判成失败。此外失败历史以 JSONL 追加在.loki/state/failure-history.jsonl上限 50 条同一个失败签名连续出现 3 次就触发熔断器避免把整个预算烧在一个注定失败的失败上。三、断点续跑checkpoint 与 rollback 的完整链路每个关键步骤都落一个快照检查点子系统在 loki-ts/src/runner/checkpoint.ts字节级镜像 bash 引擎的create_checkpoint()。每过一轮有效迭代就在.loki/state/checkpoints/下建一个cp-{iteration}-{时间戳}/目录里面复制了恢复所需的全部状态state/orchestrator.json、autonomy-state.json——编排进度queue/下的 pending、completed、in-progress、current-task 四个队列文件CONTINUITY.md——会话级交接上下文迭代到一半的思考与踩坑记录metadata.json——迭代号、git sha、分支、provider、阶段等 9 个字段另有一条只追加的index.jsonl作为快照索引重建时用 tmp rename 原子改写。每会话最多保留 50 个快照超出后剪掉最旧的。loki rollback把状态拨回去loki-ts/src/commands/rollback.ts 提供了用户可见的回退入口loki rollback list # 列出所有快照最新在前 loki rollback to id # 恢复到指定快照 loki rollback latest # 恢复到最近一个快照恢复的是状态而非代码orchestrator 进度、任务队列、CONTINUITY.md都会被还原源码不被动需要的话可以用 checkpoint 时锚定的 git stash 引用自己恢复。并且每次回滚前都会先强制拍一个回滚前快照——反悔的反悔也支持。恢复状态后重新跑loki start即从断点继续而不是从头再来。退出码契约让平台知道该不该重试在 k8s Job 这类无人值守环境里崩溃恢复还依赖一个退出码契约由LOKI_DURABLE_STATE1开启退出码0干净的完成/暂停如council_approved、paused——不要重试退出码20确定性失败budget_exceeded、max_iterations_reached、某个 gate 反复卡死——重试也只会以同样方式失败不要重试其他非零退出码真正的崩溃进程被 SIGKILL、未知异常——平台应该重试并从中断点恢复。这样跑完但没过验收和中途崩了被严格区分开自动化平台不会在一个注定失败的构建上反复烧预算。四、可离线复核的信任签名回执架构文档里另一条原则是Verified completion over claimed completion——构建不是模型说完成就算完成而是 git diff 非空、测试真实跑过且退出码为 0、没有跳过任何 gate 才算完成。每个运行产出一份 Evidence Receipt把确定性事实diff SHA、测试命令与退出码、各 gate 判定与 AI 的主观评估评审委员会意见分开最终的红黄绿灯只由事实计算得出。任何人都能用loki verify离线重新推导一遍——这也是它带签名回执的 PR承诺的技术含义详见 docs/SIGNED-RECEIPTS.md。五、一张表看懂关键模块模块路径职责架构总览docs/ARCHITECTURE.md设计原则、组件图、数据流RARV-C 编排引擎loki-ts/src/runner/autonomous.ts默认 TS 运行时的迭代主循环状态持久化loki-ts/src/runner/state.ts原子写状态、损坏自愈检查点/回滚loki-ts/src/runner/checkpoint.ts快照创建、索引、恢复恢复策略loki-ts/src/runner/recovery_policy.ts失败分类、预算熔断事件总线events/bus.ts文件式发布/订阅跨平台锁autonomy/lib/lock.shmkdir 原子锁 死锁回收崩溃捕获autonomy/lib/crash_capture.py脱敏后的本地崩溃留痕控制台 Dashboard 则把所有这些都变成了可见的画面——下面这张图里每个 agent 卡片运行时长、任务数、模型层级背后都对应着.loki/里一份可离线检查的状态文件结语朴素的文件系统硬核的可靠性Loki Mode 架构最值得新手借鉴的地方恰恰是最不炫的选择不引入消息中间件、不依赖共享内存把状态写成文件、用原子 rename 保完整、用 append-only 日志留历史、用退出码契约告诉平台崩了该重试、失败了别折腾。文件系统就是系统总线——状态可见所以可恢复证据落盘所以可复核。这套思路小到脚本任务、大到多 agent 流水线都完全可以照搬。赞分享【免费下载链接】loki-modeAutonomous software factory. Give it a GitHub issue, a spec or a one-line task; get back a pull request with a signed receipt anyone can re-check offline. Runs on your machine with your own keys: Claude, Codex, OpenCode.项目地址https://gitcode.com/gh_mirrors/lo/loki-mode点击查看免费下载相关推荐Akavache平台适配问题解决iOS、Android、MAUI的完整教程Akavache平台适配问题解决iOS、Android、MAUI的完整教程 Akavache是一个异步、持久化的键值存储库专为编写桌面和移动应用程序而创建BuilderPulse入门指南如何在10分钟内开始使用这个AI信号分析工具BuilderPulse入门指南如何在10分钟内开始使用这个AI信号分析工具 BuilderPulse是一个AI驱动的每日情报工具专门为独立开发者和创业者设水文系统揭秘:prehistoric-animal-museum 海岸河流与水面渲染是怎么实现的(完整指南)水文系统揭秘:prehistoric animal museum 海岸河流与水面渲染是怎么实现的 完整指南 在开源项目 prehistoric animal m创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考