结论先行
Noop 是胡诚(Jason Lee,huacnlee)做的「个人 AI 团队」: 把 Claude Code 和 Codex 组成一个小队,跑在你自己的电脑上。你给目标、回决策, 中间的拆解、并行、验证、收尾它自己做。
作者底子够硬——Longbridge 技术 VP、Ruby China 联合创始人、Native Shell(NSH)和 GPUI Kit 的作者。 所以这不是外行蹭热点,是他按自己每天的工作流做出来、自己真在用的东西。
所有共享状态都是一堆 Markdown 文件;每台机器存一份本地镜像;同步用逐路径的 CAS;分布式锁就是「谁先提交成功谁赢」。
整体架构
没有中心服务器,也没有数据库集群。一台常开的 Linux 当 primary,其余机器(macOS / Windows)装上就加入,
只做出站连接,上线就认领任务。云端是用户自己的 Cloudflare Worker + Durable Object。
共享状态就是文件
每台机器在本地维护一份 DATA 镜像,agent 直接读写普通 Markdown;
src/sync.ts 负责跟 Worker 同步,提交带 base_version,撞了就返回 409。
每个文件版本留 90 天,随时能回滚——包括 agent 给自己改的规则。
这是整套系统能「自我进化」还不出事的前提:改错了能看见、能退回去。
一分钟主循环
守护进程 src/cli.ts · daemon() 每 60 秒跑一次 tick(),顺序固定:
// 按源码顺序简化 pull() // 拉云端变更,合并本地镜像 heartbeat() // 存活、负载、版本 if primary: runRoutines() // 到点的 routine 生成任务 reapStale() // 机器失联 → 任务重排 wakeParents() // 子任务全完 → 唤醒父任务 proposeBatch() // 攒批提案合成一张卡 commitPush("tick") // CAS 冲突就重来 handleReplies() // 处理你的回复:D-0012 A planInbox() // 最快模型给新任务选址 routeDecisions() // 新决策卡先过 judge ensureDisk() // 磁盘/内存/负载调速 while running < max: // 并发由资源调速器决定 t = pickTask() claim(t) // CAS 抢占,输的人退让 processTask(t) // 起 Claude / Codex 干活
tick() 不阻塞:processTask 是并发的,默认并发是 cores/3(最少 2),
再被磁盘、内存、load 三道闸门压。
例一:定时任务自己发现活
配置里的一条 routine,每 30 分钟检查一次自己仓库里有没有该 review 的 PR:
[[routine]] name = "pr-review" every = "30m" agent = "reviewer" requires = "os:linux" signal = """gh api graphql ... is:pr is:open repo:..."""
-
到点先别叫模型
先跑
signal那条 shell,把 stdout 做 SHA1 和上次存的值比 cli.ts:59。 这条命令特意用 head SHA + CI 状态,而不是 PR 的updatedAt——CI 每跳一下updatedAt就变, 用它会天天白唤醒。哈希没变就直接跳过,一个 token 都不烧。 -
变了才建工单
newTask()core.ts:202 写一个tasks/inbox/T-0042.md: YAML front matter 存 id、agent、cli、requires、priority、source,正文就是给 agent 的 prompt。 -
派活
主机的
planNow()cli.ts:658 把一批新任务丢给最快的模型(Haiku), 让它决定「需不需要 macOS」「用 claude 还是 codex」「算不算 hard」。写回planned字段。 3 分钟内没规划完,就按默认先跑,不卡住。 -
抢任务:CAS 就是分布式锁
任意在线机器
pickTask()core.ts:316 挑一个能干的,然后claim()把文件从inbox/挪到active/,写入claimed_by,再 push。 Worker 按base_version做逐路径 CAS,撞了返回 409,本地回滚。两台机器同时抢,只有一个能赢。 -
拼 prompt
buildPrompt()runner.ts:38 把 agent 档案、它的记忆、全队 policy、你的偏好、 最近 25 条决策先例、近期 journal、花名册、对外签名规则、资源预算、任务正文,全串成一个大字符串。 结尾附RESULT_SPEC——要求最后必须输出一个 json 块。 -
起进程
claude -p --output-format stream-json --verbose \ --permission-mode bypassPermissions \ --model claude-opus-5-5 \ --settings '{"attribution":{"commit":"","pr":""}}' \ --disallowedTools 'Bash(gh pr merge:*)' \ 'Bash(git push origin main:*)' ...
stdin 喂 prompt,cwd 是仓库。stdout 每行 JSON 被解析成「最近在做:gh pr view 814」给界面显示; 20 分钟没输出且没有子 agent 在跑就 kill 重排(最多两次),90 分钟硬超时。 日志落在
logs/runs/T-0042-<时间戳>-claude.log。 -
解析结果:只认最后一个 json 块
parseResult()从后往前找```json,status 五选一:done/needs_decision/failed/waiting/delegated。 土办法,但不用解析自然语言,特别稳。结果契约(节选)
// RESULT_SPEC 要求 agent 最后输出 { "status": "done | needs_decision | failed | delegated | waiting", "summary": "1-3 句:做了什么/发现了什么,带链接", "question": "needs_decision:30 字以内说清要决定什么", "options": ["A: <推荐> — 后果", "B: ... — 后果"], "wait_check": "waiting:一条只读命令,退出码变了就算等到了", "followups": [{ "title": "...", "agent": "reviewer" }] }
-
按 status 分叉
done→ 进tasks/done,只有你派的活才推送;waiting→ 存一条wait_check只读命令 + 唤醒时间,daemon 定时跑它,退出码一变就叫醒,不占并发;delegated→ 拆子任务,父任务停等;failed→ 先分类,额度用完 / 要登录就切账号在本机重跑,真失败才报。 -
决策卡过滤
openDecision()生成decisions/open/D-0017.md,任务挪到blocked。 然后routeDecision()让 judge 先看——详见下一节。 -
你回一句,闸门开一次
你回
D-0017 A,正则([DLP]-[A-Z]?\d{4})抓出来,closeDecision()把答案追加进任务正文, 任务从blocked回inbox,并带上gate_override: D-0017。 下一轮重新认领时,claudeDisallowed(cfg, override=true)返回空数组——那 15 条硬禁只为这一次运行解除,跑完清掉。
例二:你直接说一句话
你说「把 nsh #814 合了,CI 应该是绿的」。路径不同,但很快汇合:
-
消息进云端
App / 微信 → Worker → primary 用
GET /api/host/inbox?wait=25长轮询拿到,不轮询。 -
不是纯指令 → 交给 chat brain
handleOwnerMessage()server.ts:369 判断格式。不是D-xxxx A, 就交给brain.ts:一个预热的 Haiku 进程,跑短的 tool loop,单条消息延迟记在~/.noop/brain.jsonl。 -
工具只有一份定义
brain 能调的工具有唯一定义
cloud/src/tools.ts,MCP 服务器用的也是这一份:get_task/create_task/answer_decision/remember…… 所以 Claude / ChatGPT 通过 MCP 连上来,能力边界和 Noop 自己是同一套。 -
先查再建
它先
get_task看有没有现成的,没有就create_task,来源是owner→ 直接进 inbox,不走 proposed。你派的活不用再批准一次。 -
汇入同一条流水线
agent 跑起来发现要 merge,也知道闸门在,于是返回
needs_decision。后面就是例一的第 8 步往后。 整个过程你只看到两条消息:一条「收到」,一条带 A/B 的决策卡。
决策与闸门:不靠模型自觉
这是整套设计里最值得看的部分。危险动作不是「在 prompt 里求模型别乱来」, 而是在命令行参数里把工具拿掉。
硬闸门:机制,不是判断
src/gates.ts 里是一张死名单,通过 Claude Code 的 --disallowedTools 生效:
Bash(gh pr merge:*) Bash(gh pr review --approve:*) Bash(gh release create:*) Bash(gh repo delete:*) Bash(gh secret:*) Bash(git push --force:*) Bash(git push origin main:*) Bash(cargo publish:*) Bash(npm publish:*) Bash(rm -rf /:*) ...
agent 想 merge,模型层面根本没有这个工具可调。它只能返回 needs_decision,等你点一次,
下一轮才带 gate_override 把名单清空——只清这一次。
judge:先猜你会怎么决定
routeDecision() decisions.ts:159 把问题交给 Opus,喂你的原则、60 条历史决策、
以及你纠正过它的记录,让它给三种判决:
直接按先例答,写回记录,任务自动继续。你看不到这张卡。
问题缺信息、或 policy 已写清楚,退回去让它自己解决。
新判断、高风险、不可逆、或者它没把握。这才推到你手机。
两个额外的保守设计:学习期 judge 只做影子判断,不真答(记录答案,用来算准确率); 合并卡即使 judge 有答案也强制 hold——judge 的答案点不了 merge 按钮。
闭环:它怎么越用越像你
你答完之后,learn() 把你的选择和 judge 的影子答案比,记 shadow_agree。
如果你没采纳 agent 的建议,就往 memory/lessons.md 追加一行。攒到准确率够了,architect 才提议升自主度。
自主度三档
默认最保守。升级由 architect 根据指标提议,但只有 owner 能改。
onboarding
自发的活全部进 tasks/proposed,每 15 分钟或攒够 5 项合成一张提案卡,你一次批。judge 只影子判断。
assisted
judge 可以真的按先例答;follow-up 可按配置放行。你只在没有先例时被打扰。
autonomous
自发生成的任务不再需要批准。硬闸门依然在——自主不等于能 merge、能发布。
另外还有 per-agent 覆盖,比如只把 reviewer 提到 assisted,其他保持保守。
值得抄的三件事
状态即文件
任务、决策、记忆、日志全是 Markdown,带 YAML front matter。可读、可 diff、可手改。 没有黑盒数据库,也没有「迁移」这个概念——换台机器,文件过去就接着跑。
CAS 当锁
提交带 base_version,409 就是「别人赢了」。不用 Redis、不用租约,
分布式抢占只有一种语义;输的那台机器回滚,不会留下半个认领。
闸门在工具层
危险命令从工具列表里删掉,而不是写进提示词。模型没有能力,就没有「不听话」这回事; agent 想绕过,只能开口问你。这是机制设计,不是对齐。
还有一个工程细节值得学:Cloudflare 免费版是硬约束,自己的稳态目标只占免费额度的 1/5。
test/budget.test.ts 模拟一天的真实流量,超了测试就红;规则是「不许放宽标准,改设计」。
所有轮询都被 push 取代,付费的「行读取」有索引约束——这种成本纪律,大多数 agent 项目没有。
风险清单
- 太新。v0.3.x,建仓一周,单人主导。出问题基本只能自己读代码。
- 权限面很大。
curl | bash安装 + agent 跑bypassPermissions+ 绑你的 Cloudflare 账号。架构上是出站 only + 工具闸门,但没有第三方审计。 - 真实成本是订阅额度。软件 MIT 免费,烧的是你自己的 Claude / Codex 额度。多账号轮换只是把额度用得更满。
- 别照抄配置。仓库
templates/config.toml是作者真实在跑的项目和 routine;AGENTS.md里甚至有他自己的 iPhone UDID 和签名身份。一人自用的痕迹很重。 - 「学习你」依赖历史。judge 的先例来自决策记录,冷启动阶段会问得比较多;换工作领域要重新养。
与 OpenClaw 的区别
重叠在「多机 agent 编排 + 决策卡片 + 记忆」,但取向不同:
Noop
任务工厂- 围着软件工作流转:PR、CI、issue、release
- 自带 GitHub 礼节和发布闸门
- 自建 Cloudflare 后端,绑定单个 owner
- 目标是「你什么都不用做」
- 更像给写代码的人定制的流水线
OpenClaw
通用助手- 多通道入口:聊天、文件、日程、搜索、自动化
- 能力按工具插件扩展,不绑定某种工作流
- 面向日常协作与信息处理
- 目标是「随时能问、能办」
- 更像一个常驻的助理,而不是工厂
真要借鉴,Noop 的「任务状态机 + 决策卡 + 硬闸门」适合直接搬;它的 Cloudflare 后端和 NSH 客户端则不必—— 那是作者为了「自己的机器、自己的账号」做的取舍。