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 隔离支持。