# 🧠 MasterBrainAgent — 系統大腦/總調度

**駐地專案**:PMS_API_Manager(cellbedell-api)
**狀態**:🟢 部分落地(規則式 + LLM 常駐分析)

## 規劃職能(拓撲圖)
自然語言指令解析(LLM Function Calling)、跨 Firebase 專案 UID/Token 查詢與同步、API Partner 存取額度與權限審核、全系統調度路由與任務鏈分發。

## 目前真實執行項目
- 系統健康監測:每 5 分鐘 `collectSystemStatus`(記憶體/Swap/磁碟/負載/運行時間),danger 門檻觸發告警(server.js)
- OOM 事故偵測:開機 30 秒查 kernel 日誌,近 15 分鐘有 OOM 強殺才告警(排除人工部署誤報)
- **LLM 根因分析(masterBrainAgent.js,2026-08-07 上線)**:danger/OOM 告警觸發時,彙整系統狀態快照 + 錯誤日誌尾段交給 Gemini(gemini-2.5-flash,沿用參數管理全域金鑰),生成「根因判讀 + 建議動作」附在 LINE 告警中;20 秒逾時、每小時上限 4 次、分析失敗告警照發
- AWS 費用分析:每日抓 Cost Explorer(上月實績/本月至今/月底預估/服務別 Top)並快取(awsCostMonitor.js)
- 跨專案同步調度:一鍵同步五分項(Cellbedell/Vistor/Meeting/Member/PMS)的 UID 解析與 Token 寫入(規則式)

## 尚未落地
- 自然語言指令解析與任務鏈自動分發
- 深度事故調查仍由 Claude Code 支援(常駐分析負責第一線判讀)

## 工作日誌
- 2026-08-07:健康監測、OOM 偵測、費用快取三項職能上線;OOM 事故根因分析由 Claude Code 代理完成(見後台「主機記憶體/磁碟事故」)
- 2026-08-07(晚):LLM 根因分析常駐上線——告警推播從「原始數據」升級為「數據 + 🧠 MasterBrain 分析」
- 2026-08-08:「Agent in LINE」上線——人機審核執行迴圈(提案卡+身分綁定+一次性 token+PIN 六格輸入頁+白名單執行器+稽核)、自然語言交辦查詢軌(六個唯讀工具)與變更軌 v1(設備額度/到期日,LLM 抽參數→帶參數提案卡→核准後執行)