Skip to content

Commit eae6fb2

Browse files
authored
Create README.md
0 parents  commit eae6fb2

1 file changed

Lines changed: 202 additions & 0 deletions

File tree

README.md

Lines changed: 202 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,202 @@
1+
# FastWinLog - 轻量级Windows 事件日志分析工具
2+
3+
<div align="center">
4+
5+
![Version](https://img.shields.io/badge/version-1.0.0-blue.svg )
6+
![Python](https://img.shields.io/badge/python-3.12+-green.svg )
7+
![React](https://img.shields.io/badge/react-18.2-61dafb.svg )
8+
![Platform](https://img.shields.io/badge/platform-Windows-lightgrey.svg )
9+
10+
**Windows 事件日志分析平台 · 智能解析 · AI 辅助分析 · 安全告警分析 · 深度统计**
11+
12+
[功能特性](#功能特性)[快速开始](#快速开始)[AI 功能](#ai-功能)[技术架构](#技术架构)[使用文档](#使用文档)
13+
14+
</div>
15+
16+
---
17+
18+
## 功能特性
19+
<img width="1613" height="1008" alt="image" src="https://github.com/user-attachments/assets/3cb39203-838f-4415-9a4d-3f5113477d26" />
20+
21+
22+
### 软件架构
23+
<img width="1510" height="822" alt="image" src="https://github.com/user-attachments/assets/c44d416e-902e-4587-a73e-694890a3a97e" />
24+
25+
### 运行逻辑
26+
27+
<img width="1683" height="550" alt="image" src="https://github.com/user-attachments/assets/f4811ac5-4afe-40f6-b3f1-2800c3eb3933" />
28+
29+
30+
### 核心功能
31+
32+
#### 1. 智能日志解析
33+
- **全格式支持**: Security、System、Application、PowerShell 等日志,后续版本将支持logs目录下的所有 Windows 事件日志
34+
- **自动识别**: 基于 Channel 字段智能识别日志类型
35+
- **深度解析**: 提取 100+ 字段,包括嵌套字段和键值对格式
36+
- **高性能缓存**: SQLite 缓存机制,支持百万级事件加载
37+
- **增量更新**: 智能缓存管理,避免重复解析
38+
<img width="1613" height="1008" alt="image" src="https://github.com/user-attachments/assets/f8ecad15-f468-4f62-80ed-347103f8b343" />
39+
40+
#### 2. 全文搜索引擎
41+
- **关键词搜索**: 支持全字段模糊匹配
42+
- **高级搜索**: 多条件组合过滤(EventID、Level、Computer、时间范围等)
43+
- **实时搜索**: 基于 SQLite FTS5 全文索引,毫秒级响应
44+
- **搜索历史**: 自动保存搜索记录
45+
- **结果高亮**: 关键词高亮显示
46+
47+
#### 3. 智能告警系统
48+
- **内置规则库**:
49+
- 57+ 条 Security 安全规则
50+
- 31+ 条 PowerShell 脚本规则
51+
- 31+ 条 System 系统规则
52+
- 15+ 条 Application 应用规则
53+
- **自定义规则**:
54+
- 匹配规则(单条件/多条件/逻辑组合)
55+
- 阈值规则(时间窗口 + 分组聚合)
56+
- 严重级别(Critical/High/Medium/Low/Info)
57+
- **规则管理**:
58+
- JSON 格式导入导出
59+
- 规则启用/禁用
60+
- 规则编辑和删除
61+
- 批量操作
62+
- **实时扫描**:
63+
- 智能过滤,只返回匹配事件
64+
- 进度跟踪
65+
- 扫描历史记录
66+
67+
#### 4. AI 智能分析
68+
<img width="1683" height="527" alt="image" src="https://github.com/user-attachments/assets/dabf4248-53d6-494e-b339-e70758ef2ac2" />
69+
70+
- **AI 对话助手**:
71+
- 浮动 AI 面板,随时咨询
72+
- 流式输出,实时响应
73+
- 支持 OpenAI、Azure OpenAI、自定义 API
74+
- 支持一条或多条日志聚合分析
75+
76+
- **智能日志分析**:
77+
- 自动分析选中的日志事件
78+
- 识别安全威胁和异常行为
79+
- 提供修复建议和最佳实践
80+
- **上下文工程**:
81+
- 知识库管理(添加/编辑/删除)
82+
- 自动从日志创建知识条目
83+
- 知识库启用/禁用控制
84+
- 上下文长度限制(避免 token 超限)
85+
- **AI 配置**:
86+
- 支持多种 AI 模型(GPT-4、GPT-3.5、Claude 等)
87+
- 自定义 API 端点
88+
- Temperature 和 Max Tokens 调节
89+
- API Key 安全存储
90+
91+
#### 5. 可视化统计分析
92+
- **登录分析**:
93+
- 成功/失败登录趋势图
94+
- Top IP 地址排行
95+
- Top 用户排行
96+
- 登录类型分布
97+
- 时间线分析(按小时/天/周)
98+
- **进程监控**:
99+
- 进程创建趋势
100+
- 可疑进程检测
101+
- 进程命令行分析
102+
- 父子进程关系
103+
- **账户管理**:
104+
- 用户创建/删除/修改统计
105+
- 组成员变更追踪
106+
- 权限提升检测
107+
- **应用分析**:
108+
- 应用崩溃统计
109+
- 错误类型分布
110+
- 崩溃趋势分析
111+
- **系统健康**:
112+
- 服务状态监控
113+
- 系统事件统计
114+
- 错误/警告分布
115+
116+
#### 6. 数据导出功能
117+
- **CSV 导出**:
118+
- 导出全部数据
119+
- 导出搜索结果
120+
- 导出高级搜索结果
121+
- 自定义字段选择
122+
- **JSON 导出**: 完整事件数据导出
123+
- **告警规则导出**: JSON 格式,方便团队共享
124+
125+
#### 7. 高级特性
126+
- **字段元数据**: 100+ 字段的中文描述和说明
127+
- **事件描述库**: 1000+ 事件 ID 的详细说明
128+
- **内存管理**: 智能内存释放,支持大文件分析
129+
- **进度追踪**: 实时显示解析/扫描进度
130+
- **错误处理**: 完善的错误提示和恢复机制
131+
- **列设置**: 自定义显示列,保存用户偏好
132+
133+
### 未来规划
134+
135+
136+
#### 扩展支持(规划中)
137+
- **所有 Windows 日志**: 支持所有 Windows 事件日志类型
138+
- **Sysmon 日志**: 深度集成 Sysmon 高级监控
139+
140+
---
141+
142+
## AI 功能
143+
144+
### AI 对话助手
145+
146+
#### 1. 启用 AI 功能
147+
```
148+
设置 → AI 设置 → 配置 API
149+
```
150+
151+
支持的 AI 服务:
152+
- OpenAI (GPT-4, GPT-3.5-turbo)
153+
- Azure OpenAI
154+
- 自定义 API 端点(兼容 OpenAI 格式)
155+
156+
#### 2. 使用 AI 分析日志
157+
```
158+
选中日志事件 → 点击 AI 按钮 → 自动分析
159+
```
160+
161+
AI 会自动:
162+
- 识别事件类型和严重性
163+
- 分析潜在的安全威胁
164+
- 提供修复建议
165+
- 关联相关事件
166+
167+
#### 3. 知识库管理
168+
```
169+
AI 面板 → 知识库图标 → 管理知识条目
170+
```
171+
172+
功能:
173+
- 添加自定义知识条目
174+
- 从日志创建知识
175+
- 启用/禁用知识库
176+
- 控制上下文长度
177+
178+
### AI 配置示例
179+
180+
```json
181+
{
182+
"provider": "openai",
183+
"apiKey": "sk-...",
184+
"model": "gpt-4",
185+
"temperature": 0.7,
186+
"maxTokens": 2000
187+
}
188+
```
189+
190+
191+
192+
---
193+
194+
195+
196+
<div align="center">
197+
198+
**如果这个项目对你有帮助,请给个 Star!**
199+
200+
Made with ❤️ by FastWinLog Team
201+
202+
</div>

0 commit comments

Comments
 (0)