AlexThunder01/ARGOS-2

# 🛡️ ARGOS-2：个人 AI Linux 代理与工作流中心 **ARGOS-2** 是一个基于 **Unified Core Engine** 构建的先进代理生态系统，它连接了 **可视化工作流编排 (n8n)** 与 **高性能认知推理 (FastAPI + Python)** 之间的鸿沟。 与传统“聊天机器人”不同，ARGOS 采用了 **CoreAgent** 架构：一个由 Linux 终端、Telegram 和 n8n 自动化引擎共享的单一、强健的大脑。 ## ✨ 关键特性 (v2.2) - **🧠 统一 CoreAgent 架构**：单一认知引擎 (`src/core/`) 处理所有推理、规划和记忆。无论您使用 CLI、Telegram 还是 Web Dashboard，您都在与同一个“大脑”对话。 - **🖥️ 指挥中心仪表盘**：高级 React Web 界面 (Vite + Glassmorphism UI)，具备实时 SSE 聊天流、Docker 容器监控和 Rate Limit 追踪功能。 - **💻 高级用户 Linux CLI**：丰富的命令行界面 (`scripts/main.py`) 提供三种记忆模式： - **Stateless (默认)**：每次命令都是从零开始。 - **`--session`**：仅限当前会话的临时 RAM 记忆。 - **`--memory`**：完整的持久化 RAG 记忆（与 Telegram 共享）。 - **⚙️ 高级推理工具**：ARGOS 拥有 23 个内置工具，包括： - **Code Interpreter (REPL)**：在 **Docker 隔离沙箱** 中执行 Python 代码（128MB RAM 限制，无网络）。 - **Document Parser**：原生读取 **PDF**、**CSV** 和 **JSON** 文件。 - **Web Scraper**：将任何 URL 转换为可读文本以供深度分析。 - **OS Control**：文件系统管理、Bash 执行和 GUI 自动化。 - **🛡️ 5 层认知安全**： - **Paranoid Judge**：基于 LLM 的中间件，净化所有输入。 - **Risk Scoring**：实时评估 prompt-injection 威胁。 - **Atomic Rate Limiting**：无需 Redis，基于数据库原生滑动窗口配额（每分钟/每小时）。 - **Docker Sandbox Isolation**：通过 `docker-socket-proxy` 在临时容器中执行代码。 - **Interactive Security Gate**：危险工具（bash、python、delete）在 CLI 上始终请求 `(y/N)` 确认。 - **💬 带 RAG 的 Telegram 代理**：具有长期记忆、仅白名单访问和管理员人在回路 (HITL) 批准的对话助手。 ## 🚀 快速入门：交互模式 ### 1. Linux 终端 (CLI) 在本地机器上直接与 ARGOS 交互。 ``` # 基础无状态交互 python3 scripts/main.py # 持久记忆交互 (记住你！) python3 scripts/main.py --memory # 临时会话记忆 python3 scripts/main.py --session ``` ### 2. 服务器 (Telegram & n8n) 一次性部署完整技术栈： ``` docker compose up -d --build python3 scripts/inject_n8n.py ``` ### 3. Web Dashboard 部署后通过 `http://localhost:8000/` 访问指挥中心。 对于本地开发： ``` cd dashboard && npm install && npm run dev ``` Vite 开发服务器会自动将 API 调用代理到 FastAPI。 ## 🏗️ 架构 ARGOS 将 **神经系统** 与 **大脑** 分离： - **身体 (n8n)**：处理 I/O、Gmail 轮询和 Telegram webhook。 - **大脑 (CoreAgent)**：模块化的 FastAPI/Python 后端，管理状态、记忆和工具执行。 - **盾牌 (基础设施)**： - **PostgreSQL 17 + pgvector**：用于 RAG 记忆的向量相似性搜索。 - **Docker Socket Proxy**：在临时容器中进行安全、隔离的代码执行。 - **Atomic Rate Limiting**：数据库原生滑动窗口配额。 - **OpenTelemetry + Jaeger**：用于全链路可观测性的分布式追踪。 - **GitHub Actions CI/CD**：在 SQLite + PostgreSQL 矩阵上进行自动化测试。 - **[架构深入解析](docs/ARCHITECTURE.md)**：CoreAgent 如何统一体验。 - **[技术规范](docs/TECHNICAL_SPECIFICATION.md)**：详尽的 HLD 和安全协议。 ## 🛠️ 工具库 (23 个工具) | 类别 | 工具 | |:---|:---| | **代码与脚本** | `python_repl` (Docker 沙箱化), `bash_exec` (Docker 沙箱化) | | **文档** | `read_pdf`, `read_csv`, `read_json`, `read_file` | | **网络与搜索** | `web_search`, `web_scrape`, `crypto_price`, `finance_price` | | **文件系统** | `list_files`, `create_file`, `modify_file`, `delete_file`, `rename_file` | | **自动化** | `visual_click`, `keyboard_type`, `launch_app`, `describe_screen` | | **系统** | `system_stats`, `get_weather` | ## 🛡️ 安全配置 ARGOS-2 引入了全局 **Paranoid Mode**。编辑您的 `.env`： ``` # 在所有入口点启用 LLM 安全验证器 ARGOS_PARANOID_MODE=true # Rate Limiting (API & Telegram 防护) RATE_LIMIT_PER_HOUR=50 RATE_LIMIT_PER_MINUTE=10 # Docker Sandbox Isolation DOCKER_HOST=tcp://localhost:2375 WORKSPACE_DIR=./workspace ``` ## 🛠️ 开发者文档 - **[开发指南](docs/DEVELOPMENT.md)**：添加新工具、运行测试和仪表盘开发。 - **[配置指南](docs/CONFIGURATION_GUIDE.md)**：精通 `config.yaml`。 - **[Telegram RAG 规范](docs/TELEGRAM_MODULE_SPEC.md)**：记忆提取的工作原理。 **由 n8n & Python 驱动 ✨**

标签：AI 防护盾, AV绕过, DevOps 工具, Docker 容器, FastAPI, GUI 自动化, Linux 系统管理, LLM 推理引擎, n8n 集成, PE 加载器, Prompt 注入防御, Python, RAG 记忆, React 仪表盘, Telegram 机器人, 个人 AI, 人机交互 (HITL), 代码沙箱, 命令行界面 (CLI), 工作流自动化, 文件解析, 无后门, 智能运维 (AIOps), 测试用例, 用户代理, 私有云助手, 系统控制, 自主智能体, 认知安全, 请求拦截, 逆向工具, 风险评分