ufy2024/AuC

解決的問題

AuC (Agents-ufy-Core) 是一個基於 Python 的單智能體框架，旨在構建具有高度工程紀律的自主智能體。它解決了對安全、可觀測且可進化的 AI 智能體的需求，這些智能體可以在與本地檔案、Shell 和外部 API 互動的同時，保持對高風險操作的嚴格控制。

工作原理

該框架基於 asyncio 構建，並實現了用於串流推理和並行工具調用的 ReAct (Reasoning and Acting) 迴圈。它提供了一個分層工具權限系統（L1 唯讀、L2 沙箱寫入、L3 二次授權）以確保安全性。高風險指令會自動升級到 L3，需要透過集成的平台（如 Telegram、QQ 或 Web UI）進行手動批准。

關鍵技術組件包括：

• Au-Context Slicer: 透過語義切片管理上下文窗口效率。
• Au-Rules Matrix: 透過 .aurules 檔案實現特定專案的規則。
• Checkpointing: 允許使用者撤銷檔案變更或指令執行。
• Evolution Memory: 使用 .auc/evolution.yaml 來回溯經驗並鞏固知識「金塊」。
• Sandbox: 為檔案 I/O、Shell 執行和帶有 SSRF 保護的 URL 獲取提供隔離環境。

適用對象

想要構建能夠以安全優先方式自主管理程式碼庫或執行系統任務的智能體的開發人員和 AI 工程師，以及希望透過受控的智能體工作流與 LLM 進行互動的即用型 CLI 或 Web UI 的使用者。

亮點

• 分層權限: L1/L2/L3 授權層級，防止意外或惡意的系統變更。
• 多模型支援: 與 OpenAI、Anthropic 和 DeepSeek 原生整合。
• 多渠道審批: 二次授權請求發送到 Telegram、QQ 或 Web UI。
• 可進化記憶: 一種讓智能體從自身執行中學習並隨時間推移改進其行為的機制。
• 全面的 UI: 包括專業的終端 REPL 和基於 FastAPI 的具有工作區管理功能的 Web UI。
• 安全優先設計: 內建 SSRF 保護、路徑沙箱化和 Docker 隔離支援。