Agents-ufy-Core — ufy 体系中的单智能体 Python 核心框架。
AuC 基于 asyncio，提供可插拔推理循环（默认 ReAct）、LLM 适配、工具权限分级（L1/L2/L3）与可观测事件流。与 AuM 协同时，吸收 Claude Code 式工程纪律：上下文切片、项目军规（.aurules）、高危操作 IM 二次授权。
v0.4.2 — 评测与隔离运营：确定性 eval 扩至 13 用例 + CI/nightly 门禁；Docker 隔离支持 memory/cpus；Actions concurrency 防队列堆积。
v0.4.1 — Web 工作区与终端加固：.auc/ 元数据经符号链接绕过防护（resolve_workspace_safe 双重路径校验）；PTY 输出改为 FIFO 单 writer 队列，移除应用层 JSON ping 刷屏；项目运行器 drain 子进程 stdout/stderr 防 PIPE 死锁；git diff 路径沙盒校验；Chat SSE done 状态与真实结果一致。
v0.4.0 — 安全与质量全面加固（代码审查 P0–P4）+ 技能库：清零 12 项高危（hooks RCE、WebSocket 绕过鉴权、API Key 明文回传、/raw 泄漏 .auc、eval shell 注入、isolation 静默降级、MCP 沙盒绕过、git 路径穿越、retry 重复计费等），并发正确性（subagent 生命周期超时+取消联动、jobs/metrics/索引跨进程锁+原子写，新增 auc/fslock.py），一致性（Anthropic 流式重试、metrics 召回/采纳解耦、回执↔run_id 显式映射、SSRF 连接期 IP 绑定+DNS fail-closed、worktree 冲突安全清理）；新增技能库（skill library）与审批设置面板。全量 701 测试通过。
v0.3.2 — 角色与模型广场：内置 agency-agents 中文角色库（256 角色）、智能选择 auto 路由、角色广场按领域浏览/自定义编辑；模型广场与连接设置分离、本地/网关智能路由；Web UI 树形角色选择、主题与对话框样式统一。
v0.3.1 — 大模型接入与对话体验增强：base_url + SK 配置、模型自动发现（多端点/多鉴权探测）与按系列/类型过滤、智能路由 auto[:策略]（成本/均衡/质量/低延迟）及网关不支持时的本地路由回退、运行时模型实时显示与切换提示、Token 用量按 K 显示；对话支持就地重试与「编辑后重答」（可临时切换模型/工作模式/角色）；Code 与 Chat 双界面均显示智能体状态；富渲染依赖（mermaid/marked）改为多 CDN 镜像懒加载并优雅降级，离线/内网不再白屏。
v0.3.0 — 竞品对标优化计划全面落地（O1–O4 / R1–R28 主干）：符号代码索引（R26，含可选 tree-sitter 多语言与向量语义层）、多轮专项审查（R27）、任务回执/Replay（R28）、MCP 客户端（R16）、生命周期 Hooks（R14）、会话内子智能体工具（R13）、后台作业 + 定时 Routines + 容器隔离（R17）、并行 worktree（R18）、确定性评测基线（R19），以及自进化全闭环「执行→复盘→度量→固化→优化」（R20/R21/R22/R23）。修复 OpenAI/DeepSeek 兼容客户端 400 错误体透传、终端 URL 链接对齐、测试环境变量隔离。v0.2.14 安全与健壮性加固。
| 能力 | 说明 |
|---|---|
| ReAct 循环 | 流式推理、并行工具调用、上下文压缩、检查点回滚 |
| 多模型 | OpenAI Chat Completions、Anthropic Messages、DeepSeek 兼容网关 |
| 工具分级 | L1 只读 / L2 沙盒写 / L3 二次授权；危险命令自动升级 |
| 终端 UI | prompt-toolkit 多行输入、斜杠命令、Plan / 自治模式 |
| Web UI | Code + Chat 双模式、工作区、项目预览/代理运行、SSE 流式对话 |
| IM 授权 | Telegram、QQ（OneBot 11）L3 审批卡片 |
| 进化记忆 | .auc/evolution.yaml 经验召回与金块固化 |
| 沙盒 | 文件读写、Shell、grep/glob、URL 抓取（SSRF 防护） |
pip install ufy-auc # 仅核心（无 HTTP / 无 Web）
pip install "ufy-auc[chat]" # 终端对话（llm + cli，日常推荐）
pip install "ufy-auc[web]" # 网页 UI
pip install "ufy-auc[all]" # 全部可选组件
pip install "ufy-auc[dev]" # 开发/CI（pytest + 全部组件）PyPI 包名为
ufy-auc（import auc不变；CLI 仍为auc/auc-web）。PyPI 上的auc已被其他项目占用。
git clone https://github.com/ufy2024/AuC.git && cd AuC
pip install -e ".[chat]" # 或 .[all] / .[dev]| 模式 | 命令 | 包含 |
|---|---|---|
| 核心 | pip install ufy-auc |
框架 + YAML（无 HTTP / 无 Web） |
| llm | pip install "ufy-auc[llm]" |
httpx，调用 OpenAI / Anthropic / DeepSeek |
| cli | pip install "ufy-auc[cli]" |
prompt-toolkit 终端增强 |
| chat | pip install "ufy-auc[chat]" |
llm + cli（终端对话推荐） |
| web | pip install "ufy-auc[web]" |
FastAPI 网页 UI + 工作区 + 项目运行 |
| telegram | pip install "ufy-auc[telegram]" |
Telegram L3 二次授权 |
pip install "ufy-auc[qq]" |
QQ L3 二次授权（OneBot 11） | |
| all | pip install "ufy-auc[all]" |
上述全部 |
| dev | pip install "ufy-auc[dev]" |
pytest + 全部（CI / 本地开发） |
可组合：pip install "ufy-auc[chat,web]"。openai 为 llm 的兼容别名。运行 auc extras 查看完整列表。
auc config init # ~/.Au/AuC/settings.json
auc config init --provider deepseek # DeepSeek 模板
export DEEPSEEK_API_KEY=sk-... # 或 OPENAI_API_KEY / ANTHROPIC_API_KEY
auc config show配置格式为 JSON（Claude Code 风格），详见仓库内 docs/model-config.md。
auc chat "你好"
auc chat "hi" -p anthropic -m claude-sonnet-4-20250514
auc chat # 进入交互 REPL（/help /plan /autonomy …）
auc undo --list # 检查点回滚auc web --sandbox ./my-project # http://127.0.0.1:8765
# 或
auc-web --sandbox ./my-project侧栏可浏览工作区、运行沙盒内项目（HTML / Node / Python）、在 Chat 模式与智能体对话（含 L3 授权弹窗、图片上传）。
import asyncio
from auc import AgentConfig, DefaultAgent, DefaultToolRegistry, InMemoryModelClient, make_echo_tool
from auc.messages import ToolCall
from auc.model import AssistantMessage
async def main():
reg = DefaultToolRegistry()
t, p = make_echo_tool()
reg.register(t, p)
model = InMemoryModelClient(responses=[
AssistantMessage(content=None, tool_calls=[
ToolCall(id="1", name="echo", arguments={"x": 1}),
]),
AssistantMessage(content="done", tool_calls=None),
])
agent = DefaultAgent(AgentConfig(agent_id="demo", model=model, tools=reg))
print((await agent.run("run echo")).output)
asyncio.run(main())更多示例见 examples/。
| 命令 | 说明 |
|---|---|
auc chat |
终端对话（推荐 [chat]） |
auc web |
启动 Web UI（推荐 [web]） |
auc config init/show/set/migrate |
管理 settings.json |
auc slice |
语义切片（Au-Context Slicer） |
auc undo |
检查点列表与回滚 |
auc run |
脚本化单次运行（--reply 调试） |
auc dispatch |
IM 遥控分发 |
auc extras |
打印可选安装模式 |
| 机制 | 实现要点 |
|---|---|
| Au-Context Slicer | SemanticSlicer → ContextPackage |
| Au-Rules Matrix | FileRulesPort + .aurules |
| L3 二次授权 | TelegramApprovalPort、QQApprovalPort、WebApprovalPort、ConsoleApprovalPort |
| 自治与升级 | AutonomyPolicy、危险 Shell 自动升 L3 |
| 检查点 | write_file / delete_path / run_command 快照与 auc undo |
| 进化记忆 | EvolutionMemoryPort、.auc/evolution.yaml |
pip install -e ".[dev]"
pytest -q # 357 项用例
pytest -q --cov=auc --cov-fail-under=75 # CI 同款（当前约 80%）
ruff check auc testsCI：GitHub Actions，Python 3.11 / 3.12，覆盖率门槛 ≥75%。
设计文档位于仓库 docs/ 目录（本地克隆后可见）：
| 文档 | 说明 |
|---|---|
docs/需求.md |
需求清单（R1–R28）、对标分析与实现状态 |
docs/竞品分析与优化计划.md |
Cursor/Codex/Claude Code 对比、缺陷清单与 O1–O4 优化排程 |
docs/架构设计.md |
目标架构（落地 R1–R28） |
docs/方案设计.md |
关键技术选型与决策（D-Rx） |
docs/详细设计.md |
接口、数据格式、时序与测试计划 |
docs/design-philosophy.md |
设计哲学与生态蓝图 |
docs/architecture.md |
总体架构（现状 As-Is） |
docs/model-config.md |
OpenAI / Anthropic / DeepSeek 配置 |
docs/tool-privilege.md |
L1/L2/L3 工具权限 |
docs/approval-modes.md |
授权模式（每次都询问 / 危险时询问 / 全部通过） |
docs/aum-compatibility.md |
AuM 联调与版本 |
docs/test-reports/ |
测试报告与覆盖率（按日期归档） |
- ReAct 循环、
run_stream、事件总线 - OpenAI / Anthropic / DeepSeek 流式客户端
- 沙盒文件、Shell、搜索、URL 抓取工具
- 检查点回滚、Plan 模式、自治策略、上下文压缩
- 终端 REPL（斜杠命令、prompt-toolkit）
- Web UI（工作区、项目运行、SSE Chat、L3 授权队列）
- Telegram + QQ（OneBot 11）IM 二次授权
- 进化记忆与金块固化
- 267 项 pytest、CI 覆盖率门槛
-
ConversationStore上移共享（M2） - Usage 上报与进化层联动
- 独立 AuM 仓库生产化（持久化、向量索引、Webhook）
- P0 地基纠偏（本仓事项）：见 docs/P0-地基纠偏.md；跨仓完整清单在 AuM
docs/P0-里程碑与Issue清单.md
pip install -U "ufy-auc[chat]"MIT — 见 LICENSE。