企业官网建设流程全解析

AuC（Agents-ufy-Core）是一款基于 asyncio 的 Python 智能体核心框架，其 Web UI 是面向新手最友好的入口：通过auc web一条命令即可启动，提供Code + Chat 双模式工作区、基于SSE 的流式 AI 对话，以及项目沙盒运行（HTML / Node / Python 一键预览），让普通用户无需配置复杂环境，就能在浏览器里让 AI 读写文件、执行任务并实时看到结果。

为什么值得了解 AuC Web UI？

相比纯终端工具，AuC 的网页界面把"配置模型 → 对话 → 操作项目 → 审批高危操作"的完整闭环搬进了浏览器：

💡 简单说：Chat 模式像和 AI 客服聊天，Code 模式像把 AI 装进 IDE，两种模式共享同一个沙盒工作区，可随时切换。

快速启动 AuC Web：三步上手

第一步：安装

pip install "ufy-auc[web]" # 网页 UI 版本 pip install "ufy-auc[chat,web]" # 终端对话 + 网页 UI（推荐）

也可从源码安装（clone 后执行pip install -e ".[web]"），仓库地址：https://gitcode.com/gh_mirrors/auc/AuC。

第二步：配置大模型

auc config init # 生成 ~/.Au/AuC/settings.json auc config init --provider deepseek # 使用 DeepSeek 模板 export DEEPSEEK_API_KEY=sk-... # 或 OPENAI_API_KEY / ANTHROPIC_API_KEY

配置格式为 JSON（Claude Code 风格），支持 OpenAI、Anthropic、DeepSeek 三大厂商，并内置模型自动发现与auto智能路由（按成本 / 均衡 / 质量 / 低延迟四种策略）。详见 docs/model-config.md。

第三步：启动 Web UI

auc web --sandbox ./my-project # 打开 http://127.0.0.1:8765

常用启动参数一览（见 auc/web/server.py）：

🔒安全提示：Web 服务默认只绑定本机。若需对外暴露（如--host 0.0.0.0），必须通过--token或环境变量AUC_WEB_TOKEN提供访问令牌，否则启动会直接报错。鉴权逻辑见 auc/web/auth.py。

Code + Chat 双模式工作区详解

界面顶部的两个标签页（见 auc/web/static/index.html）就是模式开关：

<button class="mode-btn active">@app.post("/api/chat/stream") async def api_chat_stream(request: Request) -> StreamingResponse: def _sse(obj: dict) -> str: return f"data: {json.dumps(obj, ensure_ascii=False)}\n\n" ... return StreamingResponse(_gen(), media_type="text/event-stream")

几个对新手友好的设计细节：

• 互斥保护：若已有对话在生成中，立即返回run_in_progress错误提示"请等待完成或取消"，避免并发写冲突；
• 状态真实：v0.4.1 修复了done状态与真实结果不一致的问题，前端看到"完成"就一定是完成；
• 输入校验友好：空消息、非法 JSON、图片字段类型错误等都会以中文错误事件回传，方便排查。

L3 高危操作二次授权

AuC 把工具分为L1 只读 / L2 沙盒写 / L3 高危三级（详见 docs/tool-privilege.md）。当智能体要执行 L3 操作（如危险 Shell 命令）时，后端会挂起等待前端批复：

• 前端弹出授权卡片（同一步骤并行产生的多个 L3 请求会逐个弹卡，避免覆盖丢单）；
• 用户点击"批准 / 拒绝"后调用/api/chat/approve接口回传决定；
• 审批模式可在设置面板中切换"每次都询问 / 危险时询问 / 全部通过"，逻辑见 auc/web/approval_settings.py。

⚠️ 这是 AuC 吸收 Claude Code 工程纪律的核心体现：AI 可以干活，但高危动作必须人来拍板。

项目沙盒运行：一键预览你的项目

在 Code 模式侧栏，AuC 会自动发现沙盒内的项目并支持一键运行（auc/web/projects.py、auc/web/runner.py）：

运行器ProjectRunner的实现细节很扎实：

• 自动端口：随机分配空闲端口，仅绑定127.0.0.1；
• 防死锁：持续 drain 子进程 stdout/stderr，防止 PIPE 缓冲区写满导致项目卡死（v0.4.1 修复项）；
• 就绪探测：轮询端口开放状态，超时 20 秒给出"服务启动超时，请检查项目依赖与日志"提示；
• API 转发：运行中的 Python/Node 后端服务可被沙盒前端页面直接代理访问。

此外还内置PTY 终端（WebSocket + FIFO 单 writer 队列，auc/web/pty_terminal.py），可以在浏览器里对沙盒目录执行命令，输出实时刷新。

典型使用场景

1. 学习调试：把一个小项目丢进--sandbox，用 Chat 模式问"这段代码为什么报错"，AI 直接读写沙盒内文件给出修改；
2. 原型演示：写一个index.html，侧栏点击运行，立刻在预览窗口看到效果，无需另开服务器；
3. 安全探索：担心 AI 乱执行命令？默认授权模式下所有高危操作都会弹窗确认，新手也能放心用；
4. 多角色协作：先用"产品经理"角色梳理需求，再切"后端工程师"角色实现接口，角色与技能在界面上一键切换。

小结

AuC Web UI 用一条命令（auc web --sandbox ./my-project）就交付了一个完整的 AI 编程工作台：Code + Chat 双模式覆盖"深度开发"与"轻量问答"两类需求，SSE 流式对话保证 Token 级实时反馈，项目沙盒运行让 HTML / Node / Python 项目一键起服务，L3 二次授权则给所有高危操作加上了"人工刹车"。对于想低门槛体验 AI Agent 能力的新手来说，这是目前 Python 生态里少见的"开箱即用 + 安全可控"组合。

想深入了解整体架构，可阅读 docs/architecture.md 与 docs/loops.md；想扩展审批渠道（Telegram / QQ），参考 docs/aurules.md 与 auc/integration/ 目录。