IncidentCopilot：本地优先的 AI DevOps 调查框架

Project: IncidentCopilot — AI DevOps 事故调查里程碑：1 — 代码仓库与本地开发基础状态：✅ 已完成

🎯 为什么从基础开始？

构建 AI 驱动的 DevOps 系统时，直接跳进 LLM 的诱惑是巨大的。

对于 IncidentCopilot，我刻意选择了不这样做。

证据优先。AI 其次。人工始终在循环中。

AI 应该在经过验证的证据上进行推理，而不是替代解析、规范化、持久化或关联这些确定性系统。

因此里程碑 1 专注于：

本地开发环境

后端和前端基础

文档与可复现性

🖥️ 本地优先决策

IncidentCopilot 有意采用本地优先架构，不依赖：

专有 SaaS 基础设施

取而代之，栈通过 Docker Compose 运行：

📂 代码仓库结构

incidentcopilot/
├── backend/
├── frontend/
├── runbooks/
├── test-data/
├── evaluation/
├── docker-compose.yml
├── .env.example
├── README.md
└── Makefile

后端包已定义但有意留空——确立架构方向的同时避免过早实现。

⚙️ 后端基础

FastAPI 应用包含两个端点：

GET /health → {"status": "ok"}
GET /ready → {"status": "ready"}

通过 pydantic-settings 进行配置管理

使用 Pytest + FastAPI 的 TestClient 进行测试

后端已 Docker 化（最小容器，暂无数据库和 AI）

🎨 前端基础

React + TypeScript + Vite + Tailwind CSS + Lucide icons

IncidentCopilot — AI DevOps 事故调查

清理了未使用的 Vite 启动文件

前端已 Docker 化，使用基于 Node 的构建镜像

🛠️ 实际问题与修复

Node.js 版本不匹配：从 v20 升级到 v24 以支持 Vite

Docker Desktop：CLI 已安装但引擎未运行——通过启动 Docker Desktop 解决

Windows make：使用 mingw32-make 而非 GNU make

Git 卫生问题：修复了无效的 UTF-8 README + 优化了 .gitignore

后端测试 → 1 个通过

前端 lint → 0 个错误

前端构建 → ✓ 构建成功

Docker Compose 配置 → 有效

后端和前端容器 → 本地运行中

🧩 我们没有构建的内容（目前）

里程碑 1 有意排除了：

解析器（Nginx、Kubernetes、Docker、GitHub Actions）

规范化与关联

Qdrant + RAG 集成

结构化 AI 诊断

完整事故仪表板

这些属于未来的里程碑。

🏗️ 架构原则

Reliable evidence
       ↓
Deterministic analysis
       ↓
AI reasoning

LLM 将位于确定性证据管道之后。

基础工作 = 真正的开发

验证 > 假设

起步模板应该被质疑

本地优先改变开发策略

AI 不应该是我们首先构建的东西

里程碑 2 — FastAPI 基础 + PostgreSQL

FastAPI
   ↓
Services
   ↓
PostgreSQL

IncidentCopilot 仍处于起步阶段。尚无 AI 诊断、无 RAG、无摄入管道。

里程碑 1 建立了正确构建这些能力所需的工程环境。

FastAPI + React/TypeScript

经过验证的本地工作流

先构建证据管道。稍后让 AI 在经过验证的证据上进行推理。

🔗 GitHub: https://www.github.com/richardatodo/incidentcopilot ➡️ 下一步：里程碑 2 — FastAPI + PostgreSQL