agent-autoloop 把「等人」存成資料庫裡的一列

每隔幾週我都能看到同樣的畫面:有人在終端機裡啟動一個 coding agent,起身去倒咖啡,回來發現它卡在一個沒有人看見的問題上。常見的做法是把提示音量調大。agent-autoloop 處理的是底下那層浪費:一個行程、一個上下文視窗就這樣開著,什麼也不做,而人已經離開鍵盤。
它是一個本地 hub,截至 2026 年 11 月 15 日有 5,459 個 GitHub star,MIT 授權。它監聽事件,把事件交給你已經在用的任何命令列 agent,然後自己退到一邊。agent 跑完一輪,寫下回答,結束。當它需要做決定時,hub 把一張卡片推到你桌面,或是推給 Feishu、DingTalk、WeCom、Slack、Discord。你挑一個選項。agent 把這段對話接回來繼續。
沒有雲端主機,沒有開放連接埠,沒有 dashboard。
安裝,以及證明它真的能跑的那一行指令
需求:Node 24 或更新版本、Git,以及一個已經裝好並登入的命令列 agent。在 macOS 和 Linux 上還需要 curl。
irm https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.ps1 | iex
curl -fsSL https://raw.githubusercontent.com/KKKKhazix/agent-autoloop/main/install.sh | sh
接著執行 agent-autoloop try。安裝腳本印出版本號,並不能證明你那個 agent 的參數和登入狀態可用。try 會用你自己的 agent 走一遍真實的「提問、等待、回答、繼續」循環:一個事件送出去,agent 開始做事,停下來,帶著選項問一個問題,結束,然後等待。你回答,hub 恢復工作階段並收尾。如果哪裡設錯了,你兩分鐘內就會知道,而不是凌晨兩點被一條跑偏的 cron 規則叫醒。
一句約定,一個規則檔
hub 和 agent 之間的介面只有一個約定:把結果放在最後一則回覆裡。沒有 SDK,沒有 wrapper,沒有打過補丁的執行檔。任何能接收 prompt 並印出最後一則訊息的東西都能接上,所以通用命令轉接器和 Claude Code、Codex、ACP、DeepSeek Harness、ZCode 並列在一起。
提問就是一次附加。agent 在回覆結尾放一個名為 agent-autoloop 的圍籬程式碼區塊,裡面是 JSON:一個 ask 陣列,含 title、text、options 和一個 key,另外有 notice、resolve、later 和 events 對應其餘動詞。這就是 agent 作者需要學會的全部協定。
規則放在 ~/.agent-autoloop/rules.json。一條規則回答三個問題:發生了什麼事,交給哪個 agent,在哪個目錄裡執行。
{
"when": { "cron": "0 9 * * *" },
"to": "codex",
"cwd": "~/notes"
}
事件規則把時鐘換成一個來源:比對 GitHub 的 issues.opened,加上 parallel: 3 和一個 skill,形狀一樣。設定只有兩個檔案,這一個,加上你的 agent 本來就會讀的那個。我喜歡它可以被人翻看,也容易 diff。
四個向系統工程借來的機制
核心是設計開始有意思的地方。單獨拿出來看,幾乎沒有一樣是新的。
第一個是零成本暫停。等待期間行程結束,狀態搬進資料庫。三天的沉默只花掉三天沒有 token、沒有 agent 在跑。只有 hub 還站著,而留著它跑是件很小的事。
第二個是事件溯源。每一份狀態都從 append-only 日誌推導出來,而日誌在 hub 回覆之前與索引寫在同一個交易裡。殺掉行程,已確認的工作還在。任何一輪事後都能用它的編號解釋清楚。schema 變更從日誌重建,不需要遷移腳本。
第三個是指令與資料分離。外部文字,例如一個 issue 標題,當成素材存進檔案,永遠不拼進 prompt。prompt 裡只帶經過驗證的 type、id 和 link。跑哪個 agent、在哪個目錄、有什麼權限,全部來自你本地的規則。一個自帶 cwd、agent 或 access 的事件會被拒絕。
第四個是 hop fuse,也是我最喜歡的一個。agent 產生的事件再派回給 agent,會累積深度,就像封包累積 TTL。人的提問和排定的複查不會重設計數,agent 自己也改不了它。超過 8 層,hub 停止派送,記錄該事件,改成給你發一張卡片。
那些數字,以及我從哪裡開始不信
它的 benchmark 表來自一台 Apple M5 Pro、24 GB 記憶體、Node 24.21.0,每次寫入單獨提交,交易在回覆之前落地。冷啟動 88.78 ms。閒置記憶體 59.94 MB RSS。一千個同時長輪詢時 170.49 MB。每秒 2,394 次持久寫入。派送 p99 為 1.82 ms,佇列裡壓著 5,000 項時心跳 p99 為 1.66 ms。110 萬筆事實下啟動耗時 99.8 ms。零執行期相依套件。
這些是佇列的數字,不是應用程式的數字,而這正是重點。一個把「等待」存成一列、把「工作」存成事件的 hub,本來就該表現得像一個佇列。
我的懷疑:一台機器,一個操作者,一個熱著的 page cache,還有一份由寫核心的人親手寫的 harness。這個 benchmark 從來沒跑在那台還開著視訊會議、背景在編譯的筆電上,所以把它當下限讀,不要當承諾。110 萬筆事實這個數字在別處也配了一個誠實的代價。README 說格式變更後的第一次啟動會從日誌重建,那一次花了 43.1 秒。對筆電來說還行,如果你以為不是這樣就會有點尷尬。
自治會傷到你的兩個地方,以及你繼承了什麼
安全是作者們最不「聰明」的地方,這是誇他們。指令與資料分離意味著一個惡意的 issue 標題沒辦法把一次執行重導到別的目錄或別的 agent,因為這些欄位在門口就被擋掉了。hop fuse 意味著一組 agent 互相傳工作不會永遠轉下去,因為深度是 hub 加的,不是參與者加的。
兩者都不是證明。fuse 是 8 層的一條策略。如果一條正當的流程需要 9 層,那是你的問題;而如果危險的情況是一個慢的兩層迴圈、每一跳都造成真實損害,fuse 永遠不會觸發。分離保護的是派送決策,不是 agent 在你交給它的那個目錄裡拿到 shell 之後會做什麼。
模擬比大多數專案做得更實。node sim/random.ts 24301 200000 在固定種子下跑 20 萬步的斷線、丟包、崩潰和重複提交,所以一次失敗可以重現。node sim/crash.ts 1000 12648430 把行程殺掉 1,000 次,檢查沒有任何已確認的紀錄消失。然後 README 補了一句:整機斷電沒有測。我尊重這句話,而它讓我去問還有什麼沒測。webhook 範本只在本地 mock server 上跑過。GitLab webhook 只對著它文件裡的格式檢查過,從沒對過真的 GitLab。範例腳本則是對著一個假的 Feishu CLI 驗的。每一處都是「測過了」比讀者以為的要少的地方。
手寫核心加零執行期相依套件,你繼承下來的是維護。一棵小的相依樹,有人盯著就越老越穩,作者走開就越老越糟。這就是 88 ms 冷啟動換來的東西。
有一個計費細節完全在設計之外。hub 驅動的是你機器上已經裝好並登入的 CLI 工具,所以用量落在你自己的帳號或訂閱上。README 提到廠商更希望高頻自動化走 API key,因為個人方案是為人的節奏設計的。在你把一條 cron 規則指到你的 Claude Code 工作階段然後去睡覺之前,把這句話讀兩遍。
還有一個風險能穿過上面所有機制。一個能開 GitHub issue、並且藉著佈署流程合併帶 deliver 標籤的 pull request 的迴圈,就是拿著你憑證的供應鏈參與者。上面的一切讓它可靠,也給它拴了一根短繩。你設定的那個 review 步驟,是它和一次糟糕合併之間唯一的東西,而再多的 event sourcing 也救不了一份你沒讀過的 review。
相關文章
一份社群維護的點擊表,關掉了中國品牌 Android 系統裡的廣告
它不動系統,不解鎖,不刷機,只把廠商本來就留出來的開關一個個撥過去。代價是這份名單得一直有人續寫。
GPT Image 2.6 守住 token 價格,帳單卻變貴了
GPT Image 2.6 沿用 2.5 的全部 token 費率,每張圖卻更貴,因為更多工作現在花在輸出 token 上。上線十一天,定價結構說得比排行榜更多。
有人從外部重寫了 IDM,並寫下自己沒碰過的部分
Mister Download Manager 用 Rust 重寫了 Internet Download Manager 的下載流程,聲稱速度快 5 倍、支援 86 種語言。更值得細讀的,是它解釋如何在不複製任何程式碼的前提下完成重寫的那一段。
Rune 是一個 Rust UI 框架,設計初衷是讓 agent 能檢查自己的工作
Rune 能無頭繪製、匯出元素樹並接受腳本化輸入,這讓編碼 agent 拿到截圖永遠給不了的東西,一個可 diff 的訊號。這個框架仍是預先發布版,不接受 pull request。