主要变更: - RDP 远程桌面:新增 backend/pkg/rdp(RDP 引擎 + credssp/display/rle/trace)、 backend/controller/rdp*(连接/凭证/文件/会话/实时)、frontend RDP 组件与 API - Windows SMB 文件传输:backend/pkg/winsmb - 云账单同步:backend/pkg/billingsync + billing_sync/aliyun_billing,前端账单详情 - Agent CLI Kubernetes 工具:kubernetes_action/get、pod_execute/logs - 服务器导入助手:server_import_helpers、ImportCredentialSettings - 国际化与组件重构(cloud/deploy/monitor/server/system 等多模块) - 清理编译产物二进制:移除 backend/server、backend/agent/bin/aiops-agent-* - .gitignore:新增 backend/agent/ 与 .cache/(避免 334MB go-build 缓存误入库) Co-Authored-By: Claude <noreply@anthropic.com>
71 lines
3.1 KiB
Markdown
71 lines
3.1 KiB
Markdown
# AIOps 开发文档
|
||
|
||
本目录包含 AIOps 智能运维平台的开发文档。
|
||
|
||
## 文档索引
|
||
|
||
| 文档 | 说明 |
|
||
|------|------|
|
||
| [快速开始](./quick-start.md) | 环境准备、本地开发、常见问题 |
|
||
| [部署指南](./deployment.md) | 二进制 / Docker / K8s 部署、版本发版、镜像推送 |
|
||
| [项目结构](./project-structure.md) | 前后端目录结构说明 |
|
||
| [开发规范](./development-guide.md) | 代码规范、Git 工作流、PageShell / i18n |
|
||
| [API 接口](./api-reference.md) | 后端 API 接口文档 |
|
||
| [数据库设计](./database-schema.md) | 数据模型和表结构 |
|
||
| [开发日志](./dev-log.md) | 详细开发日志(按日期记录) |
|
||
| [Web RDP 远程桌面](./rdp.md) | 自研 RDP 协议栈、WebSocket 帧协议(归档:`/opt/rdp/`) |
|
||
| [Redis 缓存策略](./redis-caching-strategy.md) | Redis 缓存使用现状与优化方案 |
|
||
|
||
## 设计文档
|
||
|
||
| 文档 | 说明 |
|
||
|------|------|
|
||
| [Agent CLI 设计集](./agent/00-README.md) | ReAct 引擎、Evolver、安全系统、会话管理(10 篇) |
|
||
| [PDD 计划](./PDD_PLAN.md) | 产品驱动开发计划 |
|
||
| [项目摘要](./PROJECT_SUMMARY.md) | 项目整体概述 |
|
||
| [后端摘要](./BACKEND_SUMMARY.md) | 后端架构概述 |
|
||
|
||
## 根目录文档
|
||
|
||
| 文档 | 说明 |
|
||
|------|------|
|
||
| [README.md](../README.md) | 项目主说明 |
|
||
| [CLAUDE.md](../CLAUDE.md) | AI 助手指引(完整命令与规范) |
|
||
| [AGENTS.md](../AGENTS.md) | AI Agent 工作指南 |
|
||
| [ROADMAP.md](../ROADMAP.md) | K8s 管理功能演进路线图 |
|
||
|
||
## 近期重要变更(2026-06 ~ 2026-07)
|
||
|
||
| 变更 | 说明 |
|
||
|------|------|
|
||
| PageShell 设计系统 | 全站统一页面骨架,`dg-page*` CSS 变量 + 7 套主题 |
|
||
| 前端架构对齐 | `api/` + `pages/` 按菜单域拆分,复杂页面迁入 `pages/` |
|
||
| 国际化 (i18n) | i18next 中/英双语,已覆盖 dashboard / server / alert / approval / audit / deploy / k8s |
|
||
| Agent CLI 优化 | 终端审计回放、ssh-key 连接修复、会话管理增强 |
|
||
| 中间件监控 | Redis / MySQL 后端直连采集引擎 |
|
||
| 日志告警 | AlertEngine 支持 `type=log` 规则,查询 Loki / ES 触发/恢复 |
|
||
| 远程执行 | 新增远程执行页(执行/上传),移除 ansible 命名 |
|
||
| 大模型双协议 | OpenAI 兼容 + Anthropic Messages 协议接入 |
|
||
| Web RDP 自研引擎 | 移除 grdp,SessionEngine 完整图形会话,见 [rdp.md](./rdp.md) |
|
||
|
||
## 部署速查
|
||
|
||
| 场景 | 命令 |
|
||
|------|------|
|
||
| 本地开发 | `./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` 单容器方案。 |