文章摘要
各位站友好，我是站长。这段时间 Claude Code、Codex、DeepSeek 的 dsh 这些命令行 Agent 大家都用上了吧？好用是真好用，但有个毛病我一直觉得别扭：它得你守着。你输一句话，盯着它跑，等它问你下一步；人一走开、窗口一关，事情就断了。想让它半夜帮你把 GitHub Issue 处理了、早上 9 点准时把早报写好？没门。这两天 GitHub 上冒出来一个国产项目，3 天就拿了 3400 多个 star，专门解决这件事——它叫 Agent Autoloop，一句话概括：让你的命令行 Agent 在后台自己接活、自己跟进到底；平时不烦你，遇到拿不准的事才发卡片找你拍板。
它能做什么
Agent Autoloop 是国人作者 KKKKhazix 开源的一个极轻量自动化中台，TypeScript 写的，MIT 协议，完全免费。它的思路很有意思：把任务调度做成一个零外部依赖的内核（约 1650 行代码），把事件来源、Agent、通知通道、代码上线流水线全部拆成可以随时插拔的插件。内核在中间，其他都是插件，这就是上面那张架构图想说的事。
一件事在它手里是这么转起来的，一共五步：
第一步：新事件进来。早上 9 点的定时任务、GitHub 上新提的 Issue、业务系统报的错，都变成一条标准事件送进内核。
第二步：按规则派活。内核照你写的规则，决定交给哪个 Agent、去哪个目录干。同一件事排队时又来了新消息，会合并成一轮处理，不会重复开工。
第三步：干完一轮就退出。Agent 把结果写在最后一条回复里，进程直接退出，不挂在后台空转。
第四步：拿不准才问你。碰到删数据、重启服务、花钱、对外发消息这类事，内核通过飞书、钉钉、企微、Slack、Discord 或者桌面通知发一张卡片给你。等你回复期间，它不占后台进程，也不消耗 Token——你三天没回，这三天就没有 Agent 进程在跑。
第五步：点一下，接着干。你选完，它接上原来的对话，把剩下的活干完。能自己搞定的事走自动闭环：直接办完，或者约个时间（比如半小时后）再醒来复查，全程不打扰你。
说白了，它把 Agent 从「你守着的聊天框」变成了「你手下的值班员」：有活自己干，拿不准再找你，你只管拍板。
能接哪些 Agent、哪些场景
Agent 这边，内置支持 Claude Code、Codex、ACP、DeepSeek Harness（dsh），另外留了个通用命令接口——一行配置就能接新 Agent，不需要 SDK，也不用改 Agent 源码，只要是能接收提示词、并把结果打印在最后一条回复里的命令行工具都能接。作者还整理了 pi、OpenClaw、Cursor、CodeBuddy 这些的接入命令，不过按他自己的说法，这些是按各家官方文档整理的，还没逐个真机跑过。
通知通道默认开桌面通知，飞书、钉钉、企微、Slack、Discord 都能配。事件来源除了定时规则，还有 GitHub Webhook、GitLab Webhook、HTTP 接口和 Issue 轮询脚本。
最实在的是它自带的一批拿来即用的场景模板，每套都带规则、任务 Skill 和启用说明：每日早报（默认每天 8 点整理本地笔记和 Git 提交写进 briefs 文件夹）、跟进 GitHub Issue（每 5 分钟查新 Issue，在本地改代码并通知你查看；不提交、不推送、不回复 Issue）、线上告警排查（接收报错、对照代码查原因，需要重启时发卡片问你）、用户反馈处理、网站巡检（每 5 分钟检查状态和关键内容，异常只通知一次，恢复后更新原卡片）、飞书周报与业务摘要，还有 PR 自动交付——给 PR 打上 deliver 标签后，它自己跟进到上线：审代码、等 CI、合并 PR、等部署、核对线上版本，全程不用你盯。
内核的四个机制，挺见功底
作者在 README 里专门讲了内核的四个机制，我觉得这是这个项目最值得看的地方：
挂起零消耗：等你拍板时进程直接退出，等待状态存在数据库里。没有 Agent 在后台空转，也就没有 Token 在烧。
事件溯源：所有状态都从一条只追加的日志算出来，日志和索引在同一个事务里写进磁盘，写完才应答。作者实测强杀进程 1000 次，已确认的记录一条不丢；任何一轮为什么跑、结果是什么，一条 agent-autoloop why 命令就能查清。
指令数据分离：思路和 SQL 参数化一样。Issue 的标题正文这些外部文字只作为资料放进文件，不拼进提示词；用哪个 Agent、在哪个目录、什么权限，只由你本机的规则决定，事件里带相关字段会被直接拒收。这一步是防提示词注入的，玩自动化的朋友应该懂它的分量。
跳数熔断：思路和网络包的 TTL 一样。Agent 交回的事件会再派给 Agent，层数一路累加，经过人工提问和定时复查也不清零，Agent 自己改不了；超过 8 层就只记录、不再派活，并发一张卡片告诉你。防止 Agent 自己跟自己聊出无限循环，这个设计很老道。
性能数据作者也贴出来了（Apple M5 Pro、24GB、Node 24.21.0 实测）：冷启动 88.78 毫秒，空闲内存不到 60MB，派活 p99 只要 1.82 毫秒，持久化写入 2394 条/秒。轻是真的轻。
使用方法（分步）
1. 准备一台 Mac 或 Linux 电脑，装好 Node 24、Git、curl，再装好并登录任意一个命令行 Agent（Claude Code、Codex、dsh 都行），不需要 GitHub 账号。
2. 一条命令安装：curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh，装的是通过了全部检查的最新 Release 版。
3. 先跑一遍试跑验证：agent-autoloop try，它会用你本机的 Agent 真实走一遍「提问 → 退出等回复 → 拍板 → 接着干完」的完整流程。
4. 试跑里它会问你选蓝色还是绿色，交互终端直接输数字回车，非交互终端跑 agent-autoloop answer 1 2，再跑 agent-autoloop status 就能看到它接上刚才的会话、把活干完，还能看到今天和最近 7 天的轮数、Token 和费用。
5. 打开 ~/.agent-autoloop/rules.json 写规则：什么事、交给谁、在哪个目录干。比如每天早上 9 点写早报，一条 cron 规则就行，保存后几秒内自动生效；agent-autoloop check 检查规则有没有写错，agent-autoloop rules explain 看生效的规则和下次定时。
6. 想用现成的场景模板，去仓库 examples/recipes 里挑一个，把任务 Skill 放进所用 Agent 的 skills 目录，把示例规则合入 rules.json，替换电脑名和路径，跑 agent-autoloop check 就行。
注意事项
1. 目前只支持 macOS 和 Linux，Windows 版还没出。作者在 README 里说了，自己在外面出差，手边没有 Windows 电脑没法真机测试，计划 11 月 7、8 日回家后开发并做兼容性测试再正式推出。等不及的 Windows 用户可以先用 WSL2，注意事项见仓库里的 INSTALL.md。
2. 它调用的是你本机已经安装并登录好的命令行工具，不会读取或转存你的账号凭据，模型调用的消耗算在你自己的账号名下。作者也提醒：高频自动化场景下，各家厂商通常更建议用 API Key，个人订阅额度主要是为日常人工交互设计的；如果你用它对外提供服务，请用 API Key。
3. 规则写错了也不怕：改错了或者文件被删、读不到，系统会继续按旧规则跑，并发卡片提醒你。
4. 反馈处理、网站巡检和飞书摘要这几个模板默认使用北京时间，只发给本人的飞书私聊；样例数据都是虚构的，脚本和回执只用本地 HTTP 与假飞书 CLI 验证过，没有在真实账号上跑过完整业务——真要上生产，先在自己的环境里跑通再说。
5. 现在还是早期版本，功能在快速迭代，遇到 bug 去仓库提 issue 就行，作者响应挺积极的。
下载地址
GitHub 仓库：https://github.com/KKKKhazix/agent-autoloop
安装包在仓库的 Releases 页面拿最新版，安装脚本见上面使用方法第 2 步；README 有中文版，英文不好的朋友也能看明白。
站长点评
说实话，今年 AI 编程工具卷的是「生成」，Agent Autoloop 卷的是「值班」——这个切入点我挺认可。Claude Code 们再强，也解决不了「人不在就停摆」的问题，而这个项目用一个 1650 行、零依赖的内核就把这事补上了：定时、Issue、告警这些活自己接，拿不准的发卡片问你，等你回复时一分钱 Token 不烧。3 天 3400 星，说明戳中这痛点的人不止我一个。当然也要泼点冷水：现在还是早期版本，Windows 还没出，真机验证过的 Agent 和通道也就 README 里列的那几家，想当生产力的话，先从每日早报、网站巡检这种低风险模板玩起，等它再稳一点再把重要流程交过去。白嫖党注意：软件本身开源免费，但干活烧的是你自己的 Agent 账号额度，这个成本得自己掂量。
