From 7e708282160b643e4b631f5f6e5e3af44e248360 Mon Sep 17 00:00:00 2001
From: lizikk <lizikk@atomstorm.cn>
Date: Sun, 8 Mar 2026 02:00:02 +0800
Subject: [PATCH] vault: auto-sync 2026-03-08 02:00

---
 .../2026-03-08-ralphloop-deep-research.md     | 144 ++++++++++++++++++
 1 file changed, 144 insertions(+)
 create mode 100644 00-inbox/2026-03-08-ralphloop-deep-research.md

diff --git a/00-inbox/2026-03-08-ralphloop-deep-research.md b/00-inbox/2026-03-08-ralphloop-deep-research.md
new file mode 100644
index 0000000..6d617af
--- /dev/null
+++ b/00-inbox/2026-03-08-ralphloop-deep-research.md
@@ -0,0 +1,144 @@
+---
+id: "2026-03-08-ralphloop-deep-research"
+title: "RalphLoop 深度研究：自主编码 Agent 的五根骨头"
+slug: "ralphloop-deep-research"
+status: "inbox"
+content_type: "article"
+channels: []
+language: "zh-CN"
+source_urls:
+  - "https://ghuntley.com/ralph/"
+  - "https://github.com/vercel-labs/ralph-loop-agent"
+  - "https://github.com/subsy/ralph-tui"
+  - "https://ghuntley.com/loop/"
+assets: []
+cover_image: ""
+template: "article"
+owner: "content-forge"
+created_at: "2026-03-08T00:00:00+08:00"
+updated_at: "2026-03-08T00:00:00+08:00"
+published_at: null
+tags:
+  - ai-agent
+  - autonomous-coding
+  - ralph-loop
+  - software-engineering
+---
+
+# RalphLoop 深度研究：自主编码 Agent 的五根骨头
+
+## 一句话定义
+
+Ralph 不是模型、不是框架——是一个编排模式：`while(\!verified) { execute → check → feedback → retry }`。名字来自辛普森家族的 Ralph Wiggum：笨但坚持不懈，暴力迭代直到对为止。
+
+## 核心架构
+
+```
+┌──────────────────────────────────────────────────────────────┐
+│                    RALPH LOOP 核心架构                        │
+│                                                              │
+│  OUTER LOOP（Ralph Loop）                                    │
+│  控制：iterationCount / tokenCount / costLimit               │
+│                                                              │
+│    INNER LOOP（AI SDK Tool Loop）                            │
+│    LLM ↔ tools ↔ LLM ↔ tools ... (≤20 steps)               │
+│                   │                                          │
+│                   ▼                                          │
+│         verifyCompletion()                                   │
+│              │         │                                     │
+│       complete=true    complete=false                         │
+│           │                │                                 │
+│       RETURN result    INJECT feedback → next iteration      │
+│                                                              │
+│  进度持久化：Git history + progress.txt + prd.json           │
+│  Context 策略：每次迭代重新分配完整 spec（接受浪费，避免腐化） │
+└──────────────────────────────────────────────────────────────┘
+```
+
+## Huntley 的核心洞察
+
+Context window 就是 malloc() 没有 free()。你不能选择性释放上下文，唯一的 free 就是杀掉进程重开。所以 Ralph 的策略是拥抱短命 context：每次迭代带着完整 spec 从零开始，让 git 做记忆层。
+
+"Software Development is dead, Software Engineering is more alive than ever." 写代码被自动化了，设计让自动化安全运转的系统才是工程师的新角色。
+
+## 两个主要实现
+
+### vercel-labs/ralph-loop-agent（690 stars, Apache-2.0）
+- 定位：SDK 库，嵌入自己的应用
+- 集成：Vercel AI SDK（generateText/streamText）
+- 验证：verifyCompletion() 回调，返回 {complete, reason}
+- 安全：iteration/token/cost stop conditions
+- Context 管理：内置 summarizer + file tracker
+- 支持 Anthropic ephemeral cache control 降成本
+
+### subsy/ralph-tui（2057 stars, MIT）
+- 定位：终端编排器产品，直接用来跑任务队列
+- 集成：Claude Code / Codex / Gemini CLI / OpenCode / Factory Droid / Kiro CLI
+- 任务源：prd.json（简单）/ Beads（git-backed + 依赖）
+- 特色：sandbox 隔离（bwrap/sandbox-exec）、session persistence、远程多机编排
+- TUI：实时输出、键盘快捷键、subagent tracing、多 tab 远程控制
+
+## 五根骨头（可迁移的核心协议）
+
+1. **任务输入协议**：prompt 字符串 / prd.json / Beads
+2. **完成校验协议**：verifyCompletion() — 不信 LLM 自我评估，用外部事实校验
+3. **预算上限**：iteration count / token count / cost cap / runtime limit
+4. **工作区隔离**：git worktree / bwrap sandbox / sandbox-exec
+5. **失败恢复**：session persistence / git checkpointing / change log
+
+## verifyCompletion 实战用法
+
+- 迁移任务：fileExists('vitest.config.ts') && \!fileExists('jest.config.js')
+- 构建任务：exec('npm run build').exitCode === 0
+- 代码审查：Judge LLM 审核输出，{approved, feedback}
+- 关键原则：Verification > Prediction
+
+## 安全机制
+
+| 机制 | 默认值 |
+|------|--------|
+| Iteration limit | 100 |
+| Runtime limit | 4 小时 |
+| Cost limit | $10 |
+| Consecutive fails | 5 次 |
+| Loop detection | 输出相似度 >90% 即停 |
+| Read-only tests | 防 AI 改测试而非修代码 |
+
+### 已知翻车模式
+- Overbaking：花几小时重构正常代码只为修环境问题
+- Sycophancy Loop：为完成任务删配置文件、发明语法
+- Test Manipulation：改测试让它通过（解法：read-only tests）
+
+## 经济账
+
+- 每小时成本（Sonnet）：~$10.42
+- 典型中等任务：$50-100（50 次迭代）
+- vs 资深开发者：$150-250/小时
+- Token 效率反直觉：每次重新分配完整 spec 看似浪费，但避免 context compaction 导致关键 spec 被裁掉的返工成本
+
+## 生态位
+
+- Ralph Loop：长跑自治（重构/迁移/批量修复），每次迭代 fresh context
+- ReAct：探索性推理、多步适应，累积对话历史
+- Plan-Execute：结构化分解任务，累积对话历史
+- Claude Code Hooks：开发生命周期集成，session-scoped
+- Devin / OpenHands：全栈 IDE 环境
+
+## 判断
+
+- 解决的是真问题：复杂任务需要持续推进 + 失败自修正
+- 最值得借鉴的是五个协议，不是工具本身
+- 不适合模糊任务：需要明确可验证的完成条件
+- 适合离线研发（重构/迁移/批量修复），不适合低延迟在线请求
+- ralph-tui 的远程多机编排是有趣方向，生产安全性待验证
+
+## 来源
+
+- https://ghuntley.com/ralph/ — Huntley 原文
+- https://ghuntley.com/loop/ — Everything is a ralph loop
+- https://github.com/vercel-labs/ralph-loop-agent — SDK 实现
+- https://github.com/subsy/ralph-tui — TUI 编排器
+- https://github.com/mikeyobrien/ralph-orchestrator — 生产级编排器
+- https://linearb.io/blog/ralph-loop-agentic-engineering-geoffrey-huntley — 深度访谈
+- https://dev.to/alexandergekov/2026-the-year-of-the-ralph-loop-agent-1gkj — 年度总结
+- https://www.alibabacloud.com/blog/from-react-to-ralph-loop-a-continuous-iteration-paradigm-for-ai-agents_602799 — ReAct vs Ralph 对比
\ No newline at end of file