FrontierAgent完整概览一条命令搞定深度研究与文件工作的开源终端Agent框架【免费下载链接】FrontierAgent FrontierAgent, our agent framework, open-sourced alongside it — native command-line TUI, ReAct and Agent Team modes, one command on macOS and Linux, no preinstall, no hard Docker dependency.项目地址: https://gitcode.com/gh_mirrors/fr/FrontierAgentFrontierAgent是一个开源的终端Agent框架它把 Agent 运行时、原生命令行 TUI终端界面和评测套件合为一体让你在 macOS 或 Linux 上一条命令就能启动深度研究与文件工作——无需预装复杂环境也没有对 Docker 的硬性依赖。ReAct 单智能体负责专注研究与文件读写Agent Team 模式则让协调者拆任务、派发给并行子智能体再汇总成最终报告。一、FrontierAgent 是什么为什么值得关注对新手来说市面上很多 Agent 工具要么只能聊天要么依赖庞大的 Web 控制台。FrontierAgent 的定位很清晰把 Agent 直接装进你的终端专门处理两类长周期任务深度研究联网搜索、交叉验证证据、撰写带引用的报告文件工作读取代码仓库与文档、执行命令、产出可交付文件。它由五个边界清晰的模块组成可独立复用模块职责frontier_agent/通用推理循环、调度、注册表、AgentBus、观察者plugins/tools/网页、Shell、文件、沙箱与团队协作工具实现workflows/ReAct 与 Agent Team 流水线、配置档、提示词apodex/终端 CLI/TUI、审批、会话、追踪与 Docker 路径benchmarks/公开评测框架及内置基准数据集二、两种工作流模式ReAct 单兵与 Agent Team 军团FrontierAgent 内置两条原生工作流用--mode参数一键切换模式适合场景执行模型react聚焦研究、仓库分析、文档/文件处理一个有状态的智能体持续推理、读文件、跑命令并迭代agent_team适合拆解、需要多线并行的宽泛问题协调者 持久任务板 有界并行子智能体 报告收集与综合ReAct 模式像一位专注的研究员它在任务沙箱里循环思考 → 调用工具 → 观察结果直到给出最终答案。Agent Team 模式则像一个小型研究团队主智能体把请求分解为任务写入实时显示在 TUI 侧边栏的任务板Task Board将独立工作分派给并行子智能体收集结构化报告后综合成最终结果需要时还可调用快速报告员做证据复核。整个协作流程如下图所示任务板上的每个任务都会以 pending / active / completed / blocked / cancelled 五种状态实时呈现你可以随时用/revert、--resume等命令掌控进程。两种工作流的详细说明分别在 workflows/stateful_react_agent/README.md 和 workflows/agent_team/README.md。三、一条命令启动FrontierAgent安装与快速上手FrontierAgent 的最大卖点就是低门槛只需要 Git、Python 3.12 和一个 OpenAI 兼容的模型端点Docker 完全可选。第一步克隆并初始化git clone https://gitcode.com/gh_mirrors/fr/FrontierAgent cd FrontierAgent uv sync --python 3.12 --extra dev cp .env.example .env第二步在.env中填入模型端点只需三项必填OPENAI_API_KEYyour-key OPENAI_BASE_URLhttps://your-openai-compatible-endpoint/v1 OPENAI_MODELyour-model-name第三步启动 TUI# 单智能体模式 uv run frontier-agent --mode react --cwd /path/to/project # 多智能体团队模式 uv run frontier-agent --mode agent_team --cwd /path/to/project 完事。不想手敲命令官方提供了开箱即用的启动脚本 scripts/run-macos.sh 与 scripts/run-linux.sh会自动完成依赖安装、.env校验并打开全屏 TUI。更多部署方式Docker、WSL2、本地 GPU 模型可参考 docs/install/README.md 的安装选择器。几个实用小贴士用-p 任务描述可一次性执行并退出适合脚本化用--input 文件路径可在启动前挂载只读文档PDF、图片均可运行中直接输入文字指令会排队注入到下一个安全轮次不会打断当前运行--resume可在 Ctrl-C 中断后恢复上次会话。四、任务沙箱文件系统Agent 的安全工位这是新手最关心的安全问题之一。文件与 Shell 工具共享同一个任务级沙箱三个目录各司其职路径策略用途/inputs只读提供的文档与基准输入/workspace读写源码检出、提取数据、临时工作/outputs受控读写最终持久化交付物在 macOS/Docker 环境下/outputs会映射到主机的.apodex/runs/session-id/outputs同一运行目录还包含检查点、追踪日志与轨迹文件——所有交付物透明可查。授权与沙箱失败均为 fail-closed宁可报错也不降级为无隔离执行详见 docs/framework.md 的沙箱章节。而文件工作到底长什么样下图是一个典型的文件落地任务输入原始电化学电压序列图Agent 需要读取、分析并产出结论——这正是 FrontierAgent 评测中的 file-grounded 基准任务五、安全机制审批、diff预览与一键回滚FrontierAgent 把防误操作做成了默认行为✅审批闸门只读操作读取、搜索、git status直接放行写文件、删除、安装、危险 Shell 命令必须确认--yes可跳过但硬拒绝的命令即使加了也拒绝执行统一 diff 预览任何写操作前先展示统一 diff 并等待批准⏪/revert一键回滚每次写/删都会先快照可恢复整个会话的文件变更本地 JSONL 追踪每个 LLM 与工具动作包括被拒绝的都写入cwd/.apodex/runs/id/trace.jsonl全程可审计。TUI 侧边栏还有四个标签页Plan / Activity / Files / Diff文件标签页支持预览 Markdown、PDF、Office 文档、Notebook 甚至 3D 结构文件。完整键位与命令参考见 apodex/README.md 和 docs/tui-user-guide.md中文使用教程。六、评测能力用同一套引擎跑深度研究基准FrontierAgent 不止是产品它的同一套工作流引擎还驱动着官方基准评测框架——每个基准问题运行在隔离子进程中支持可续跑的多轮实验、确定性或模型裁判评分、并发控制与单题重跑。内置支持 BrowseComp、HLEHumanitys Last Exam、SuperChem、GDPval、APEX、FrontierSearchBench、WideSearch 等十余项研究类基准。下图是驱动模型 Apodex-1.1 在六大专业工作/研究基准上的表现Agent Team 模式全面领先想自己动手跑一轮冒烟测试最小命令形如uv run python -m benchmarks.public.runner.run_subprocess \ --benchmark browsecomp --pipeline stateful-react-agent \ --limit 1 --concurrency 1 --out ./results/smoke数据集下载、裁判配置与结果解读的完整操作手册见 docs/eval.md基准数据集注册表见 benchmarks/README.md。七、新手快速选择指南不知道从哪套环境开始一张表帮你决策你的环境推荐运行方式起步文档macOS已有一个 OpenAI 兼容端点原生或 Docker Desktop托管端点docs/install/macos.zh-CN.mdLinux 主机/虚拟机原生模式默认也可选 bubblewrap 或 Dockerdocs/install/linux.mdWindowsWSL2按 Linux 处理docs/install/linux.md不想装任何 Python 环境Docker Compose 一键运行docs/install/docker.md有 NVIDIA 显卡、想本地跑模型Docker SGLang 或原生 SGLangdocs/install/gpu-compatibility.md选型口诀任务聚焦、步骤线性 →react问题宽泛、可拆子题并行 →agent_team需要严格隔离 → 加--bwrapLinux或--docker。八、小结FrontierAgent 用一条命令把终端里的 Agent 团队变成现实开箱即用——macOS/Linux 一条命令启动无需硬性依赖 Docker双工作流——ReAct 专注单兵作战Agent Team 支持任务板 并行子智能体协作安全透明——任务沙箱、审批 diff、/revert回滚、本地追踪一应俱全评测内建——同一引擎驱动十余项深度研究基准产品与科研互相验证。如果你是想要一个能干活、可审计、可回滚的终端 Agent 的开发者或研究者FrontierAgent 值得放进你的工具箱。下一步建议从 docs/install/tui-endpoint-quickstart.zh-CN.md 开始十分钟跑通你的第一个任务。【免费下载链接】FrontierAgent FrontierAgent, our agent framework, open-sourced alongside it — native command-line TUI, ReAct and Agent Team modes, one command on macOS and Linux, no preinstall, no hard Docker dependency.项目地址: https://gitcode.com/gh_mirrors/fr/FrontierAgent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考