Files
aiops/docs
attackerandClaude 92a2247390 feat: 新增 Agent CLI — Web 版 AI 运维 Agent(参考 opsxcli 移植)
后端引擎 backend/pkg/agentcli/(纯引擎库,零业务依赖,剥离 CLI/TUI 外壳):
- llm: OpenAI 兼容客户端,复用 model.LLMConfig
- tools: ssh_execute(复用 pkg/remoteexec)+ analyze_output + 风险评估黑名单
- safety: 三级安全模式 + 五级风险 + WebSocket 异步确认
- prompt: 五层 System Prompt
- core: ReAct 16 轮循环 + 自适应检查点 + 循环检测
- evolver: 四层记忆 + 进化循环,data/agentcli/ 文件存储

集成层:
- controller/agent_cli.go: WebSocket 控制器(事件流推流 + 高危确认 + 会话持久化)
- model/agent_cli.go: agent_cli_sessions/messages 表 + AutoMigrate
- 路由 /ws/agent-cli + /api/v1/aiops/agent-cli/sessions
- seed 权限 aiops:agent-cli / aiops:llm-config

前端:
- AgentCLI.tsx: 对话流 + 工具块 + 高危确认 + 四模块 tips 面板
- LLMConfig.tsx: 大模型设置独立页
- api/agentCli.ts + Sidebar/App 菜单路由

文档:
- docs/agent/ 11 篇(opsxcli 同名文档适配改写 + 00-README 映射总览)

其他:
- CLAUDE.md 补充 agent-cli 模块说明
- 修正 .gitignore 根级二进制规则(前导 /,避免误伤 frontend/src/components/aiops/)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-06-27 09:55:17 +08:00
..

AIOps 开发文档

本目录包含 AIOps 智能运维平台的开发文档。

文档索引

文档 说明
快速开始 环境准备、本地开发、常见问题
部署指南 二进制 / Docker / K8s 部署、版本发版、镜像推送
项目结构 前后端目录结构说明
开发规范 代码规范、Git 工作流
API 接口 后端 API 接口文档
数据库设计 数据模型和表结构
开发日志 详细开发日志(按日期记录)
Redis 缓存策略 Redis 缓存使用现状与优化方案

设计文档

文档 说明
PDD 计划 产品驱动开发计划
项目摘要 项目整体概述
后端摘要 后端架构概述

根目录文档

文档 说明
README.md 项目主说明
CLAUDE.md AI 助手指引(完整命令与规范)
ROADMAP.md K8s 管理功能演进路线图

部署速查

场景 命令
本地开发 ./run.sh dev
编译二进制 ./run.sh build tag v1.5.0 → ./aiops
Docker Compose ./run.sh docker up → http://localhost:8080
K8s 部署 ./run.sh kubernetes deploy
发版推送 ./run.sh release v1.5.0 → lghost/aiops:v1.5.0
查看版本 ./aiops version / curl /version

部署架构(当前)

开发:     ./run.sh dev          → 5173 + 8080 热重载
二进制:   ./run.sh build        → ./aiops (embed, 项目根目录)
Compose:  ./run.sh docker up    → mysql + redis + aiops (embed, :8080)
K8s:      ./run.sh kubernetes   → lghost/aiops:<tag> embed 单 Pod

前后端分离的 Nginx 容器已废弃,统一使用 Dockerfile.embed 单容器方案。