# logagent

**Repository Path**: openkylin/logagent

## Basic Information

- **Project Name**: logagent
- **Description**: AI 驱动的 Linux 日志智能分析桌面客户端，基于大语言模型实现本机日志和 sosreport 离线归档的智能诊断。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2026-06-11
- **Last Updated**: 2026-06-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: KylinOS

## README

# LogAgent 日志智能分析系统

AI 驱动的 Linux 日志智能分析桌面客户端，基于大语言模型实现本机日志和 sosreport 离线归档的智能诊断。

## 功能特性

- **本机日志分析**：扫描 /var/log、journalctl 等系统日志，智能定位问题根因
- **sosreport 离线诊断**：上传 sosreport 归档，两阶段预扫描 + 动态探索，高效分析海量日志
- **并行工具调用**：同一轮多个工具调用并行执行，分析效率显著提升
- **多模型支持**：兼容智谱 GLM、阿里通义、DeepSeek 等 OpenAI API 格式的大模型
- **模型自动切换**：API 调用失败时自动切换备用模型，前端无感知过渡
- **流式输出**：实时显示分析过程，工具执行结果即时反馈
- **证据交叉验证**：诊断结论需至少 2 个独立来源支撑，降低幻觉风险

## 运行环境

- **操作系统**：Linux（Ubuntu 20.04+ / 银河麒麟 V10 / CentOS 8+ / Fedora / 银河麒麟 V11 磐石）
- **Python**：>= 3.8
- **依赖**：PyQt5、httpx、pydantic

## 安装

提供三种打包格式，按目标系统选其一：

### DEB 包（Ubuntu / 银河麒麟 V10）

适用于 Ubuntu、Debian、银河麒麟 V10 等 Debian 系发行版。

```bash
sudo dpkg -i logagent_1.0.3_all.deb
sudo apt-get install -f
```

### RPM 包（CentOS / Fedora）

适用于 CentOS、Fedora、openSUSE 等 RPM 系发行版。

```bash
sudo rpm -ivh logagent-1.0.3.noarch.rpm
```

### 开明包（银河麒麟 V11 磐石）

适用于银河麒麟桌面操作系统 V11 磐石不可变架构。开明包与 deb/rpm 完全独立，可共存。详见 [`packaging/kaiming/README.md`](packaging/kaiming/README.md)。

```bash
sudo kaiming install top.kylin.logagent-arm64-1.0.3.1-stable-binary-squashfs.ok
```

**卸载**（必须用此脚本，对标 deb prerm 清理用户数据）：

```bash
bash uninstall_kaiming.sh
```

## 使用

安装后从应用菜单启动 LogAgent，或在终端运行：

```bash
# deb / rpm 包
logagent

# 开明包
kaiming run top.kylin.logagent
```

首次使用需在设置中配置大模型 API 地址和密钥。

## 项目结构

```
src/
├── main.py              # 程序入口
├── app.py               # 主窗口，会话管理
├── chat_panel.py        # 聊天 UI 组件
├── chat_worker.py       # 后台工作线程
├── settings_dialog.py   # 设置界面
├── widgets.py           # 通用 UI 控件
├── styles.py            # 全局样式表
├── markdown.py          # Markdown 渲染
├── conversation.py      # 会话持久化
├── debug_log.py         # 调试日志
├── welcome_widget.py    # 欢迎页面
├── platform_utils.py    # 平台适配
├── qt_compat.py         # Qt 兼容性封装
├── resources/           # 图标、用户手册
└── backend/
    ├── agent.py         # AI Agent 引擎（核心）
    ├── config.py        # 配置管理
    ├── cli.py           # CLI 交互接口
    ├── tools/
    │   └── log_tools.py # 日志分析工具集
    └── vendor/          # 内置依赖（httpx、anyio 等）
packaging/
├── deb/                 # DEB 打包配置
├── rpm/                 # RPM 打包配置
└── kaiming/             # V11 开明包打包配置
vendor_bundled/          # PyQt5 预编译库
```

## 构建

```bash
# DEB 包
bash build.sh

# RPM 包
python3 build_rpm.py

# V11 开明包（需先 sudo apt install kaiming）
bash build_kaiming.sh
```

三种构建互相独立，互不影响。

## 许可证

Copyright (c) 2026 openKylin