難以監控 AI 代理團隊？Refmade 讓你一目瞭然

我的 AI 代理團隊首批檔案於 2026 年 9 月 20 日晚間 10 點 47 分寫成。隔天，我就有了一個網頁儀表板來監看它們的運作。儀表板的內容豐富度取決於代理的勤奮程度：當某個代理跳過狀態報告時，辦公室的該部分就會空無一人。這是關於開發 Refmade 的 16 篇文章中的第一篇，每兩天發布一篇。

Refmade 是一款桌面應用程式，它會讀取 Claude Code 和 Codex 在你的機器上寫入的會話日誌，並將其繪製成一個小型的像素藝術辦公室，讓你清楚看到每個代理正在做什麼。這是一個獨立應用程式，不隸屬於 Anthropic 或 OpenAI。

我是一名駐韓國的獨立開發者，首先要說明一下工作分配：大部分程式碼是在我的指導下由 Claude Code 和 Codex 代理撰寫的。我負責規劃、決策和審查。這些文章將探討我的決策、推翻的方案以及遇到的錯誤，整個系列將按照實際事件的順序展開。

接下來的幾篇文章將涵蓋一個失控的產品計畫、轉向讀取日誌的過程，以及 Claude Code 和 Codex 如何寫入這些日誌的映射。後續文章則會講述如何在沒有公證的情況下發布 Mac 應用程式、一個遲到很久的首次 Git 提交，以及一個阻止錯誤發布的關卡。

失敗的經驗與成功發布一樣重要。目前應用程式的使用者介面是韓文，這將在本系列後續文章中改變，因此每個截圖都附有英文說明。

「Refmade」這個名字比應用程式本身還要早。從 2026 年 3 月 20 日到 7 月 2 日，Refmade 曾是另一個產品：一個帶有圖庫前端的網頁設計參考目錄。它是一個 Next.js 應用程式，包含約 83 個參考資料、131 次提交以及整合了支付功能。

其中一次 4 月 1 日的提交修復了圖庫中行動裝置記憶體不足的崩潰問題。之後我便停止了這個專案。8 月 7 日，我清理了我的託管帳戶，將 29 個專案削減到 12 個。舊的 Refmade 專案之所以倖存，是因為它綁定了一個自訂網域，所以我沒有將其刪除。

大約六週後，即 9 月 21 日，該網域被指向了新的辦公室儀表板。圖庫的程式碼沒有任何部分被沿用，新的應用程式於 9 月 20 日全新啟動。傳承下來的，只有一個偶然被保留下來的名稱和網域。

9 月 20 日的檔案並非一個產品，而是為 Codex 設計的個人操作設定：包含十一個子代理定義（專案經理、產品、業務、行銷、設計、Figma、工程、實作、研究、數據分析與審查，其中團隊負責人為主要對話），以及一個簡短的 README 檔案，說明這是應我的要求而建立的個人操作設定。

我組建了一個團隊，卻無法得知它正在做什麼。當多個代理在不同的終端機中運行時，「誰在做什麼，誰又在等我？」這個問題根本沒有好的答案。因此在 9 月 21 日，我請 Codex 建立一個「辦公室」：一個網頁儀表板，每個任務佔一層樓，顯示每個代理目前的工作、下一步、正在等待什麼、會議和記錄。Codex 建立了它，我審查了畫面並送回了修改意見。

第一版辦公室（9 月 21 日）在我的 Mac 上運行於 127.0.0.1:4318，透過快速通道提供密碼保護的遠端檢視頁面，僅在 Mac 和橋接器運行時才有效。它每 5 秒刷新一次，在隱藏分頁中會暫停。藝術風格採用像素藝術的地板、書架和 12 個坐著的角色，這些都是用 GPT Image 繪製的。

它通過了 25 個 Python 測試和 16 個 Node 身份驗證/部署測試。遠端檢視並非託管服務，快速通道僅以唯讀方式公開我的 Mac 狀態，因此當 Mac 關閉時，辦公室就無法訪問。這對於一個只供我使用的工具來說沒問題，但也意味著「隨時隨地查看我的代理」的第一個版本實際上是「在我的筆記型電腦開機時查看我的代理」。像素藝術的呈現符合預期，但資料模型卻是失敗之處。

問題出在哪裡？第一個版本要求每個代理記錄自己的狀態。一個小型記錄器腳本將這些報告寫入檔案，然後儀表板將其繪製出來。一個獨立的觀察器可以判斷會話視窗是否開啟，但它只在自己的層級列出這些資訊，沒有附帶角色、下一步或會議。代理會寫入狀態報告，然後透過檔案傳輸到儀表板，最終呈現為「辦公室」；但如果代理跳過報告，則沒有內容可繪製，導致樓層空無一人。

一個正在執行長時間任務的代理，沒有特別的理由停下來寫狀態筆記。當它沒有這麼做時，該代理的樓層上就沒有任何東西，而一個空無一人的樓層看起來就像一個閒置的團隊。儀表板無法區分「沒有人在工作」和「沒有人報告」。9 月 21 日，儀表板看起來沒問題，測試也通過了，畫面與設計相符。

但到了 9 月 25 日，我決定這種方法本身就是錯誤的。我如何用讀取日誌取代自我報告，將是第三篇文章的主題。我得到的教訓很明確：一個依賴被監測系統自我描述的儀表板，在最需要它正確的時候，反而會出錯。任何我無需代理配合就能讀取的資訊，都比代理選擇告訴我的任何資訊更值得信賴。

同一個儀表板還有一個小問題：標誌的白色背景在招牌上顯得格格不入。我保留了原始標誌檔案未動，只調整了它在招牌內的位置和混合模式。這是一張由 Codex（gpt-image-2）為早期產品網站生成的插圖：五個角色、辦公桌和一個貼滿便利貼的白板。這是 AI 生成的藝術作品，而非應用程式截圖。

今天的辦公室是什麼樣子？目前的應用程式是從本地日誌而非報告中，為每個會話繪製一個團隊。以下是 0.3.9 版本的截圖，顯示了三個團隊。Refmade 0.3.9，公開演示數據，使用者介面為韓文。左側：「鄰里工作室」區域（Claude，1 個團隊），任務是「改進首頁預訂畫面」，有 2 名藝術團隊成員正在工作。

中間和右側：「春光咖啡館」區域（Codex）的兩個團隊。中間：任務是「準備新菜單促銷」，有 3 名行銷團隊成員正在工作。右側：任務是「整理客戶詢問回覆」，標記為「我需要你的答案」。工作室和咖啡館的名稱都是虛構的範例數據。

目前狀況如何？Refmade 目前可在 Mac（Apple Silicon）和 Windows 上運行，它是免費的，並且需要在你的機器上安裝並登入 Claude Code 或 Codex。0.3.9 版本是目前 Mac 的建置版本。後續文章將涵蓋這些部分是如何實現的，包括出錯的地方。

應用程式的連結將在系列文章的最後一篇中提供。接下來將介紹我的代理團隊在 9 月 21 日撰寫的產品計畫，以及它如何發展出留言簿和轉蛋功能的那些日子。如果你的代理在不同的終端機或會話中運行，你目前是如何知道哪個代理卡住並正在等你回應的呢？