Gurashish73/sentinel

# 🛡️ Sentinel OS **一个自主事件响应 Agent 平台，受人工审批门控。** [](https://nextjs.org/) [](https://prisma.io/) [](https://neon.tech/) [](https://tailwindcss.com/) 当生产环境出现故障时，人类工程师不应是凌晨 3 点第一批盯着日志的人。Sentinel 是一个自主事件引擎，它能接收 webhook（来自 GitHub、Sentry、Datadog），触发 AI agent pipeline 进行调查，并提出修复方案。 没有任何操作会自动执行。每一个建议的操作都受到严格的人工审批门控。 ## 🚀 架构：超越“RAG 套壳” 与调用一次 API 来总结日志的基础 LLM 工具不同，Sentinel 采用了真正的 **agentic reasoning loop（代理推理循环）**：`推理 → 调用工具 → 观察结果 → 再次推理`。 它运行在严格的 **7 层 Tier-1 架构**上： 1. **核心 SaaS：** Next.js App Router，Auth.js Edge RBAC（Commander、Engineer、Observer 角色），多租户组织隔离，以及用于存储集成 token 的加密保险库。 2. **事件引擎：** 不可变的事件存储（`ALERT_RECEIVED`、`AGENT_ACTION_PROPOSED`、`ACTION_APPROVED`）作为唯一事实来源。在 `ACTION_APPROVED` 事件存在之前，操作根本无法执行。 3. **持久化 Agent 编排：** 由 Upstash QStash 提供支持。Agent 作为幂等且可重试的步骤运行。崩溃的 worker 或重复的 webhook 永远不会被执行两次。 4. **实时推理流：** Agent 的思考和工具调用通过 SSE 实时流式传输到实时 UI War Room。 5. **AI 智能：** 每个租户独立的 `pgvector` 存储，用于存放 runbook 和过往的 postmortem。Diagnosis Agent 将其推理建立在检索到的内部文档之上，并明确引用它们。 6. **Human-in-the-Loop 安全：** Redis 滑动窗口速率限制，严格的爆炸半径控制，以及针对所有修复操作的显式授权门控。 7. **Edge DevOps：** Vercel Edge runtime 摄取，CI/CD GitHub Action 部署拦截，以及严格的 schema 验证。 ## 🧠 Agent Pipeline * **Triage Agent：** 根据传入的 webhook payload 对严重程度和影响进行分类。 * **Diagnosis Agent：** 对组织的 runbook 执行 RAG，调用工具拉取实时指标/日志，并查明根本原因。 * **Remediation Agent：** 提出明确的修复方案（例如，配置回滚、服务重启、代码补丁草案），并等待人工审批。 ## 🛠️ 技术栈 * **框架：** Next.js 16（App Router、Server Actions、Edge Proxy） * **数据库：** PostgreSQL（Neon serverless） * **ORM：** Prisma 7（带 Edge Driver Adapters） * **认证：** Auth.js v5（GitHub OAuth App 集成） * **样式：** Tailwind CSS v4 * **状态与流式传输：** React Suspense、`useOptimistic`、SSE（Server-Sent Events） * **队列与缓存：** Upstash Redis 与 QStash ## 🗺️ 开发路线图与状态 Sentinel 正以严格且可演示的里程碑进行开发，以确保稳定性和持续部署。 * [ ] **阶段 0：** 基础架构（核心 SaaS、Edge RBAC、基线架构） * [ ] **阶段 1：** 核心 CRUD * [ ] **阶段 2：** 摄取与事件存储 * [ ] **阶段 3：** 持久化 Agent 编排（核心） * [ ] **阶段 4：** 实时 UI * [ ] **阶段 5：** AI 智能（RAG） * [ ] **阶段 6：** 强化与优化 ## 💻 快速入门 ``` # Clone the repository git clone [https://github.com/YOUR_USERNAME/sentinel.git](https://github.com/YOUR_USERNAME/sentinel.git) # Navigate to the project directory cd sentinel # Install dependencies npm install ```

标签：AI智能体, PostgreSQL, Prisma, 开发运维, 自动化事件响应, 运维平台