← 返回 Tony's Lab 网页由小虾生成 🦐
档案号NOOP / 0.3.6
拆解对象huacnlee/noop
许可MIT · TypeScript
日期2026-11-09
Source read-through · 8,300 lines

NOOP 一个靠 Markdown 文件跑起来的 AI 团队

它没有自研 agent 框架。本质是一个每分钟醒一次的守护进程,把 tasks/ 里的文件当工单往前推; Claude Code 和 Codex 只是被当成无状态进程反复调用。下面按源码走一遍它到底怎么跑。

NO-OP SOURCE REVIEWED
2026.11.09
摘要
所有共享状态都是 Markdown 文件,每台机器一份本地镜像;同步用逐路径的 compare-and-swap, 分布式锁就是「谁先提交成功谁赢」。危险动作不在提示词里求模型自觉,而是在命令行参数里把工具拿掉。
STARS191 AGE8 天 AGENTS11 角色 TICK60 秒
FILES112 源文件 LINES8,300 TS COMMITS88 / 100 本人 FRAMEWORK0
工位 01

结论先行

Noop 是胡诚(Jason Lee,huacnlee)做的「个人 AI 团队」: 把 Claude Code 和 Codex 组成一个小队,跑在你自己的电脑上。你给目标、回决策, 中间的拆解、并行、验证、收尾它自己做。

作者底子够硬——Longbridge 技术 VP、Ruby China 联合创始人、Native Shell(NSH)和 GPUI Kit 的作者。 所以这不是外行蹭热点,是他按自己每天的工作流做出来、自己真在用的东西。

一句话架构

所有共享状态都是一堆 Markdown 文件;每台机器存一份本地镜像;同步用逐路径的 CAS;分布式锁就是「谁先提交成功谁赢」。

工位 02

整体架构

没有中心服务器,也没有数据库集群。一台常开的 Linux 当 primary,其余机器(macOS / Windows)装上就加入, 只做出站连接,上线就认领任务。云端是用户自己的 Cloudflare Worker + Durable Object。

Client
Noop App
NSH 构建:Web / macOS / Linux / Windows / Android / iOS。也可直接用浏览器打开。
HTTPS
Your Cloudflare
Worker + Durable Object
文件与历史 · 聊天流 · 决策收件箱 · 状态 · 媒体 · 邮箱验证码登录 · Web Push
OUTBOUND
Primary · always-on Linux
routines / judge / agents
定时任务、决策路由、任务执行、长轮询收件箱。
Workers · macOS / Windows
claim tasks when online
不等人,也不接受入站连接。空闲就抢活。
所有机器只主动外连 Worker。没有端口映射,没有 VPN,没有常驻中心服务。

共享状态就是文件

每台机器在本地维护一份 DATA 镜像,agent 直接读写普通 Markdown; src/sync.ts 负责跟 Worker 同步,提交带 base_version,撞了就返回 409。 每个文件版本留 90 天,随时能回滚——包括 agent 给自己改的规则。

这是整套系统能「自我进化」还不出事的前提:改错了能看见、能退回去。

工位 03

一分钟主循环

守护进程 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 三道闸门压。

工位 04

例一:定时任务自己发现活

配置里的一条 routine,每 30 分钟检查一次自己仓库里有没有该 review 的 PR:

[[routine]]
name = "pr-review"
every = "30m"
agent = "reviewer"
requires = "os:linux"
signal = """gh api graphql ... is:pr is:open repo:..."""
  1. 到点先别叫模型

    先跑 signal 那条 shell,把 stdout 做 SHA1 和上次存的值比 cli.ts:59。 这条命令特意用 head SHA + CI 状态,而不是 PR 的 updatedAt——CI 每跳一下 updatedAt 就变, 用它会天天白唤醒。哈希没变就直接跳过,一个 token 都不烧。

  2. 变了才建工单

    newTask() core.ts:202 写一个 tasks/inbox/T-0042.md: YAML front matter 存 id、agent、cli、requires、priority、source,正文就是给 agent 的 prompt。

  3. 派活

    主机的 planNow() cli.ts:658 把一批新任务丢给最快的模型(Haiku), 让它决定「需不需要 macOS」「用 claude 还是 codex」「算不算 hard」。写回 planned 字段。 3 分钟内没规划完,就按默认先跑,不卡住。

  4. 抢任务:CAS 就是分布式锁

    任意在线机器 pickTask() core.ts:316 挑一个能干的,然后 claim() 把文件从 inbox/ 挪到 active/,写入 claimed_by,再 push。 Worker 按 base_version 做逐路径 CAS,撞了返回 409,本地回滚。两台机器同时抢,只有一个能赢。

  5. 拼 prompt

    buildPrompt() runner.ts:38 把 agent 档案、它的记忆、全队 policy、你的偏好、 最近 25 条决策先例、近期 journal、花名册、对外签名规则、资源预算、任务正文,全串成一个大字符串。 结尾附 RESULT_SPEC——要求最后必须输出一个 json 块。

  6. 起进程

    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。

  7. 解析结果:只认最后一个 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" }]
    }
  8. 按 status 分叉

    done → 进 tasks/done,只有你派的活才推送; waiting → 存一条 wait_check 只读命令 + 唤醒时间,daemon 定时跑它,退出码一变就叫醒,不占并发; delegated → 拆子任务,父任务停等; failed → 先分类,额度用完 / 要登录就切账号在本机重跑,真失败才报。

  9. 决策卡过滤

    openDecision() 生成 decisions/open/D-0017.md,任务挪到 blocked。 然后 routeDecision() 让 judge 先看——详见下一节。

  10. 你回一句,闸门开一次

    你回 D-0017 A,正则 ([DLP]-[A-Z]?\d{4}) 抓出来,closeDecision() 把答案追加进任务正文, 任务从 blocked 回 inbox,并带上 gate_override: D-0017。 下一轮重新认领时,claudeDisallowed(cfg, override=true) 返回空数组——那 15 条硬禁只为这一次运行解除,跑完清掉。

工单流转 / 一张任务卡的四个状态
INBOXT-0042 待认领任何在线机器签收
→
ACTIVEclaimed_by: mac-miniClaude Code 运行中开工
→
BLOCKEDD-0017 等你选judge 已过滤会签
→
DONE结果 + 版本可回滚写入 tasks/done归档
工位 05

例二:你直接说一句话

你说「把 nsh #814 合了,CI 应该是绿的」。路径不同,但很快汇合:

  1. 消息进云端

    App / 微信 → Worker → primary 用 GET /api/host/inbox?wait=25 长轮询拿到,不轮询。

  2. 不是纯指令 → 交给 chat brain

    handleOwnerMessage() server.ts:369 判断格式。不是 D-xxxx A, 就交给 brain.ts:一个预热的 Haiku 进程,跑短的 tool loop,单条消息延迟记在 ~/.noop/brain.jsonl。

  3. 工具只有一份定义

    brain 能调的工具有唯一定义 cloud/src/tools.ts,MCP 服务器用的也是这一份: get_task / create_task / answer_decision / remember…… 所以 Claude / ChatGPT 通过 MCP 连上来,能力边界和 Noop 自己是同一套。

  4. 先查再建

    它先 get_task 看有没有现成的,没有就 create_task,来源是 owner → 直接进 inbox,不走 proposed。你派的活不用再批准一次。

  5. 汇入同一条流水线

    agent 跑起来发现要 merge,也知道闸门在,于是返回 needs_decision。后面就是例一的第 8 步往后。 整个过程你只看到两条消息:一条「收到」,一条带 A/B 的决策卡。

工位 06

决策与闸门:不靠模型自觉

这是整套设计里最值得看的部分。危险动作不是「在 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 条历史决策、 以及你纠正过它的记录,让它给三种判决:

DECIDED有先例

直接按先例答,写回记录,任务自动继续。你看不到这张卡。

SENT BACK你自己能查

问题缺信息、或 policy 已写清楚,退回去让它自己解决。

HOLD真需要你

新判断、高风险、不可逆、或者它没把握。这才推到你手机。

两个额外的保守设计:学习期 judge 只做影子判断,不真答(记录答案,用来算准确率); 合并卡即使 judge 有答案也强制 hold——judge 的答案点不了 merge 按钮。

闭环:它怎么越用越像你

你答完之后,learn() 把你的选择和 judge 的影子答案比,记 shadow_agree。 如果你没采纳 agent 的建议,就往 memory/lessons.md 追加一行。攒到准确率够了,architect 才提议升自主度。

工位 07

自主度三档

默认最保守。升级由 architect 根据指标提议,但只有 owner 能改。

LEVEL 01 · DEFAULT

onboarding

自发的活全部进 tasks/proposed,每 15 分钟或攒够 5 项合成一张提案卡,你一次批。judge 只影子判断。

LEVEL 02

assisted

judge 可以真的按先例答;follow-up 可按配置放行。你只在没有先例时被打扰。

LEVEL 03

autonomous

自发生成的任务不再需要批准。硬闸门依然在——自主不等于能 merge、能发布。

另外还有 per-agent 覆盖,比如只把 reviewer 提到 assisted,其他保持保守。

工位 08

值得抄的三件事

状态即文件

任务、决策、记忆、日志全是 Markdown,带 YAML front matter。可读、可 diff、可手改。 没有黑盒数据库,也没有「迁移」这个概念——换台机器,文件过去就接着跑。

CAS 当锁

提交带 base_version,409 就是「别人赢了」。不用 Redis、不用租约, 分布式抢占只有一种语义;输的那台机器回滚,不会留下半个认领。

闸门在工具层

危险命令从工具列表里删掉,而不是写进提示词。模型没有能力,就没有「不听话」这回事; agent 想绕过,只能开口问你。这是机制设计,不是对齐。

「它的护城河不在模型,在这三个约束。」 —— 比抄 UI 值钱得多

还有一个工程细节值得学:Cloudflare 免费版是硬约束,自己的稳态目标只占免费额度的 1/5。 test/budget.test.ts 模拟一天的真实流量,超了测试就红;规则是「不许放宽标准,改设计」。 所有轮询都被 push 取代,付费的「行读取」有索引约束——这种成本纪律,大多数 agent 项目没有。

工位 09

风险清单

  • 太新。v0.3.x,建仓一周,单人主导。出问题基本只能自己读代码。
  • 权限面很大。curl | bash 安装 + agent 跑 bypassPermissions + 绑你的 Cloudflare 账号。架构上是出站 only + 工具闸门,但没有第三方审计。
  • 真实成本是订阅额度。软件 MIT 免费,烧的是你自己的 Claude / Codex 额度。多账号轮换只是把额度用得更满。
  • 别照抄配置。仓库 templates/config.toml 是作者真实在跑的项目和 routine;AGENTS.md 里甚至有他自己的 iPhone UDID 和签名身份。一人自用的痕迹很重。
  • 「学习你」依赖历史。judge 的先例来自决策记录,冷启动阶段会问得比较多;换工作领域要重新养。
工位 10

与 OpenClaw 的区别

重叠在「多机 agent 编排 + 决策卡片 + 记忆」,但取向不同:

Noop

任务工厂
  • 围着软件工作流转:PR、CI、issue、release
  • 自带 GitHub 礼节和发布闸门
  • 自建 Cloudflare 后端,绑定单个 owner
  • 目标是「你什么都不用做」
  • 更像给写代码的人定制的流水线

OpenClaw

通用助手
  • 多通道入口:聊天、文件、日程、搜索、自动化
  • 能力按工具插件扩展,不绑定某种工作流
  • 面向日常协作与信息处理
  • 目标是「随时能问、能办」
  • 更像一个常驻的助理,而不是工厂

真要借鉴,Noop 的「任务状态机 + 决策卡 + 硬闸门」适合直接搬;它的 Cloudflare 后端和 NSH 客户端则不必—— 那是作者为了「自己的机器、自己的账号」做的取舍。

来源:github.com/huacnlee/noop · huacnlee.github.io/noop · 源码快照 2026-11-09(main,v0.3.6)。 文中行号与函数名对应 src/ 下的 TypeScript 源码;T-0042 / D-0017 为示意编号。