"最近在搭 agent 工作流，最头疼的是长任务没人盯，人一走开，进程挂着烧 token，事情还断在半路。这个三天拿下三千星的新仓库，正面回答了这件事。

本周 Top5：t3code（+16,235）、claude-mem（+9,318）、impeccable（+9,303）、hallmark（+6,994）、DeepTutor（+6,229）。

（本期主角 agent-autoloop 不在前五，它走的是新仓组，三天 +3,344。全站周榜前五被近期主角和同主题仓占满，表格照实填，主角放在正文讲。）

数字生命卡兹克 11 月 3 日开源了 agent-autoloop，一个给命令行 Agent 用的自动化中台。三天 3,344 星、616 fork、七个 release、二十位贡献者。作者此前的 khazix-skills 有 22,002 星，human-writing 有 4,426 星。本文把它怎么工作、三天凭什么涨这么快、坑还剩哪些讲清楚。

它是什么

命令行 Agent 的问题出在「人守着」。你给 Claude Code 或 Codex 扔一个活，得开着终端等它，它问一句你答一句，窗口一关任务就断。agent-autoloop 把这个模式倒了过来。定时任务、GitHub 新 issue、HTTP 事件、线上报错，都变成标准事件送进内核，内核按你写的 rules.json 决定派给哪个 Agent、在哪个目录干。Agent 干完一轮把结论写在最后一条回复里，进程直接退出。碰到删数据、花钱、对外发消息这类事，它把问题做成卡片推到飞书、钉钉、Slack 或桌面通知，你回一句，它接上原来的会话把活干完。等你拍板的这几小时甚至几天里，后台没有 Agent 进程，也不花 token。

图：官方架构图，内核居中，事件、Agent、通道、交付全是插件

图：agent-autoloop try 试跑一轮，提问、退出、回答、续跑

内核约 1650 行，运行时依赖为 0。事件来源、Agent、通知通道、交付流水线四个方向全是插件。内置 Claude Code、Codex、ACP、DeepSeek Harness 四种 Agent 接法，任何能接收提示词并打印最后一条回复的命令行工具，都能用 command 方式一行接入。它还带一条交付流水线，给 PR 打上 deliver 标签，就自动走完审查、等 CI、合并、等部署、核对线上版本五步。

为什么有意思

四个内核机制各有明确的针对性。挂起零消耗解决等人烧钱的问题，等待状态存进数据库，进程退出，三天不回就三天零消耗。事件溯源解决崩了说不清的问题，所有状态从一条只追加的日志算出来，日志和索引在同一个事务里落盘，官方做过强杀测试，杀进程 1000 次已确认的记录一条不丢，任何一轮为什么跑、结果是什么，agent-autoloop why 一条命令查清。指令数据分离把 SQL 参数化的思路搬进了提示词安全，issue 的标题和正文只作为资料放进文件，提示词里只有校验过字符的类型、编号和链接，事件想自带目录、权限或指定 Agent，直接拒收。跳数熔断照搬了网络包 TTL 的思路，Agent 交回的事件再派给 Agent，层数一路累加，人工回答也不清零，超过 8 层就停，防的是两个 Agent 互相触发打空转。

比机制更能说明问题的是工程纪律。内核不读系统时钟、不取随机数、不向外发请求，有专门的 purity 测试守着这几条。内核行数有上限，也由测试守着。三天七版里有一版 v1.4.0 专门做减法，删掉约 500 行防护代码，理由写在 PR #125 里，这些防护来自审计查出的假设问题，没有真实用户碰到过，有的还带来过回归。仓库的 AGENTS.md 写着一条规矩，加锁、重试、兜底，要有真实事故或接口文档作依据。性能数字也实打实公布，Apple M5 Pro 上冷启动 88.78 毫秒，持久化写入每秒 2394 条，派活 p99 1.82 毫秒，110 万条历史事实时启动 99.8 毫秒。

图：官方 benchmark 与 20 万步模拟、强杀 1000 次的验证口径

三天涨三千星还有社区动力学的原因。用户 chenjie1129 连发五条带精确行号的审计 issue，指出失败重试没有上限会每小时烧一次真 token，rules.json 被删会让中台崩进重启循环，作者当天全修进 v1.1.0，连续失败十次就停手，发卡片交给人。用户 xiaojian94xiaojian 在 WSL2 上做了完整实测，踩出的三个坑被写进安装文档。最有戏剧性的是 Windows 需求，作者起初回复没有计划，接单程序依赖 /bin/sh、ps 和 launchd，后来社区拿出两版完整移植 PR 和原生 Windows 实测记录，作者在 issue #17 改了口，这个周末回家开发 Windows 版，还要保留移植者的署名。仓库自己的 AGENTS.md 还规定，改内核的 PR 合并前要找一个没写过这段代码的 Agent 来审，只给代码，不给结论。

写这篇稿子时还碰到一个巧合。我日常查稿子 AI 味的 check_prose 脚本，就出自这位作者的 human-writing 仓库。加上找热点的 AIHOT 和这个 agent-autoloop，作者三个仓库正好拼出一条内容生产线的三块，找选题、管文字、跑代理。

边界与局限

诚实是这个仓库的一个显眼特征，README 直接列出了没验证过的部分。四种 Webhook 通道模板只在本地模拟服务上跑过，GitLab Webhook 按官方文档格式测试、没连过真实 GitLab，pi、Cursor、Hermes 等五家命令行 Agent 的接入命令整理自各家文档、没有逐个实测，场景模板的数据全是虚构的。整机断电恢复也注明没有单独测过。

风险清单值得逐条过。#46 指出未认证请求可以让中台读最大 8MB 的请求体，master.key 空值的处理要加固，这两处属于低风险加固项。安全边界文档写得很细，卡片链接持有即授权、7 天有效，指令数据分离也自曝挡不住所有提示注入，Agent 还是会读到别人写的话。合规上要留神，README 引用 Anthropic 和 OpenAI 的官方说明提醒，个人订阅额度主要为日常人工交互设计，高频自动化建议换 API Key，对外提供服务必须用 API Key。

平台支持上，目前只有 macOS 和 Linux。Windows 原生版作者拍板本周末开发，WSL2 已经有完整实测记录，但有用户反馈 WSL 的内存常驻进程吃掉 1.1GB，16GB 内存的本子要掂量。历史数据变大后状态汇总会变慢，110 万条事实的全量重建要 43.1 秒。

三天七版的节奏说明它还在快速变化期。我的判断是设计文档和内核代码现在就值得读，接活先从小规模、丢了也不心疼的任务试起，关键业务等版本节奏慢下来再说。

对谁有价值

手里有 Claude Code 或 Codex 订阅、想让 issue 跟进、告警排查、每日早报这类活自动跑的人，现在就可以深读，仓库自带七套场景模板，规则写起来是纯 JSON。Windows 原生用户建议等这个周末的版本。没有命令行 Agent 使用经验的人收益有限，它刻意不做界面，#104 里想要可视化入口的用户就是被这一条劝退的。

我的用法很明确，issue 跟进和网站巡检两套模板先进测试目录跑一周，交付流水线等它满月再托付。Windows 版周末见分晓。

数据截至 2026-11-06，来源：GitHub 公开仓库、issues 与 releases

GitHub 仓库 https://github.com/KKKKhazix/agent-autoloop"