nexus-agent

Nexus-Agent 是一个开源、生产级自主 AI 软件工程代理，旨在端到端地解决复杂编码、重构和 DevOps 任务。它不同于盲目串联提示词或产生语法幻觉的脆弱包装脚本，而是围绕自愈、语法安全与可观测性构建。

主要能力：

1. 自愈式 ReAct 循环：自动捕获测试失败与 stderr，定位根因并修补代码。
2. AST 感知代码引擎：在写入或修改文件前验证 Python 语法树，防止产生语法错误的提交。
3. 双引擎用户体验：
   • Rich TUI 终端：彩色实时差异、加载动画、分步思考可视化。
   • 赛博朋克玻璃拟态 Web 仪表盘：通过 WebSocket 实时流式传输代理思考、工具执行遥测，并提供交互控制。
4. 分层 SQLite 记忆：token 高效的工作记忆，加持久化 SQLite 反思日志，从错误中学习。
5. 零 API 密钥确定性模拟引擎：无需花费 API token，1 秒内离线测试整个代理套件。

使用方式：

• 30 秒快速开始：Windows 用户双击 start.bat 即可自动配置环境、启动服务器并弹出浏览器；Mac/Linux 用户运行 chmod +x start.sh && ./start.sh。
• 终端 CLI 模式：可配合实时云端 LLM 运行。
• Web 任务控制仪表盘：执行 nexus-agent web 会自动在默认浏览器打开 http://localhost:8000；若端口被占用，会自动切换到下一个可用端口。
• Docker 部署：Web 仪表盘将立即可用于 http://localhost:8000。
• 测试：在单元、集成和 E2E 自愈测试套件中拥有 100% 通过率。

内置工具库（均带安全防护）：

• read_file：按行范围切片并检查文件内容。
• write_file：写入文件前进行 AST 语法预校验（磁盘写入前拒绝无效 Python 语法）。
• edit_file：执行精准文本替换，并自动生成统一差异预览。
• list_dir：结构化目录树浏览。
• execute_command：带执行超时和破坏性命令黑名单的沙盒 shell 执行。
• grep_search：带行号片段的高速正则代码搜索。
• find_files：基于 glob 的文件定位。
• git_status / git_diff / git_commit：自主版本控制管理。
• web_search / web_fetch：实时文档查询。

扩展与协作：

• 可用 5 行代码编写自定义工具，扩展领域特定能力。
• 支持即时代码脚手架（fastapi、cli、custom-tool）。
• 支持多代理协作 swarm 模式。
• 支持思维树（ToT）分支搜索。
• 支持 browser-use 可视化 DOM 自动化。

其他特性：

• 时间旅行式代码快照与一键回滚。
• 持久化 SQLite 反思日志。

适用场景：适合需要自动化处理编码、重构与 DevOps 流程的开发者或团队，尤其看重语法安全、自愈能力和实时可视化监控的场景。

限制：官方文本未提供具体的系统要求、支持的编程语言范围、LLM 供应商兼容性、性能基准、许可之外的收费信息等，暂未提供。项目采用 MIT 许可证分发，贡献指南见 CONTRIBUTING.md。