## 📋 插件简介
SH-Logger 是一款专为 FiveM ESX 服务器设计的高级日志管理系统，提供全方位的游戏行为记录、实时监控和远程管理功能。融合 Resources 日志系统的优点，支持游戏内面板、网页后台和 KOOK 机器人三重管理方式。
## ✨ 核心功能
### 1️⃣ 全面的日志记录
日志类型 记录内容 截图支持 物品日志 拾取、丢弃、给予、存取仓库/车辆/柜子等详细动作 ✅ 金钱日志 转账、存款、取款、交易等资金变动 ✅ 连接日志 玩家进服、退服、掉线等连接事件 ❌ 死亡日志 玩家死亡原因、位置、凶手信息 ✅ 聊天日志 全局聊天、私聊、指令使用记录 ✅ 管理员日志 管理员操作记录，支持与普通日志分离 ✅
特色功能：
- 🏷️ 详细的物品动作追踪 - 自动识别丢弃、拾取、给予、放入柜子/车辆等动作
- 🏦 银行日志细分 - 存款、取款、转账分类记录
- ⚠️ 金钱异常检测 - 单次大额变动自动触发异常警告
- 📝 物品白名单 - 支持通配符，过滤不需要记录的常规物品
### 2️⃣ 三重管理面板 🎮 游戏内面板
- 快捷键支持 - F6 一键开启（可选双重令牌验证）
- 指令开启 - /logs 命令
- 权限控制 - 基于 ESX 权限组
- 现代化 UI - 卡片/表格双视图，支持图片预览
- 实时筛选 - 按类型、玩家、时间快速筛选
- 日志清理 - 自动/手动清理历史日志 🌐 网页管理面板
- 多用户登录 - 支持配置多个管理员账号
- 登录审计 - 记录登录 IP 地址和时间
- 响应式设计 - 完美适配手机和电脑
- 视图切换 - 卡片/表格样式自由切换 🤖 KOOK 机器人
- 实时推送 - 日志实时推送到指定频道
- 精美卡片 - 两列布局的彩色卡片消息
- 截图预览 - 自动上传并嵌入截图
- 分类频道 - 不同类型日志推送到不同频道
### 3️⃣ 智能截图系统
- 📸 自动截图 - 关键事件自动捕获游戏画面
- ☁️ 云端存储 - 使用 imgbb 图床，支持自定义过期时间
- 🖼️ 类型开关 - 独立控制各类型日志是否截图
- 🔗 外链访问 - 截图 URL 可在面板和 KOOK 中直接查看
### 4️⃣ KOOK 控制台（远程管理）
管理员可在 KOOK 频道发送指令，直接管理服务器：
```
/restart [资源名] - 重启资源
/start [资源名] - 启动资源
/stop [资源名] - 停止资源
/kick [ID] [原因] - 踢出玩家
/ban [ID] [小时] [原因] - 封禁玩家
/say [消息] - 发送公告
```
安全特性：
- 仅指定 KOOK 用户可执行命令
- 命令执行结果实时反馈到频道
- 支持自定义轮询间隔
### 5️⃣ KOOK 白名单系统
自动化白名单流程：
1. 新玩家连接 → txAdmin 自动踢出并生成识别码
2. 玩家在 KOOK 频道发送识别码申请
3. 管理员打 ✅ 批准（或自动批准）
4. 玩家重新连接即可进服
功能亮点：
- 支持 auto 自动模式和 reaction 人工审核模式
- 申请消息自动清理
- 批准通知卡片自动删除
- 与 txAdmin 深度集成
### 6️⃣ 扩展集成 🔌 sh-lib 支持（可选）
- UseSHLib = true - 使用 sh-lib 的通知、UI 组件
- UseSHLib = false - 使用 ESX 原生通知，保持独立运行 🔧 txAdmin 集成
- 自动批准白名单
- 玩家踢出/封禁联动
- 服务器状态同步
## 🎯 技术优势
### 1. 高性能架构
- 异步数据库操作 - 使用 MySQL.Async，不阻塞主线程
- 智能缓存 - 统计数据缓存，减少数据库查询
- 分页加载 - 大量日志分页显示，流畅不卡顿
### 2. 安全可靠
- 权限分级 - 多层级权限控制
- 令牌验证 - F6 按键支持双重验证
- 登录审计 - 完整记录管理员登录行为
- SQL 注入防护 - 参数化查询，安全可靠
### 3. 灵活配置
- 模块化开关 - 各功能独立启用/禁用
- 自定义样式 - 支持自定义 KOOK 卡片颜色和图标
- 多语言支持 - 易于本地化扩展
### 4. 易于维护
- 自动清理 - 支持按时间自动清理旧日志
- 日志分类 - 管理员日志与普通日志分离
- 详细注释 - 代码注释清晰，易于二次开发
## 📊 适用场景
场景 功能应用 反作弊 金钱异常检测 + 截图证据 纠纷处理 物品/金钱日志追溯 管理审计 管理员操作全记录 玩家服务 白名单自动化处理 远程管理 KOOK 控制台 + 网页面板 证据留存 截图 + 详细日志卡片
## 🚀 快速对比
功能 SH-Logger 普通日志插件 游戏内面板 ✅ 现代化 UI ❌ 简陋或没有 网页后台 ✅ 完整功能 ❌ 多数没有 KOOK 推送 ✅ 精美卡片 ❌ 纯文本或没有 截图系统 ✅ 自动上传 ❌ 手动或无 白名单系统 ✅ KOOK 集成 ❌ 需单独插件 远程控制台 ✅ KOOK 执行 ❌ 不支持 物品动作细分 ✅ 8+ 种动作 ❌ 简单记录 视图切换 ✅ 卡片/表格 ❌ 单一视图
## 💡 为什么选择 SH-Logger？
1. 一体化解决方案 - 日志记录、管理面板、远程控制、白名单系统全部集成
2. 现代化体验 - 精美的 UI 设计，流畅的交互体验
3. 实时监控 - KOOK 推送让管理无处不在
4. 证据链完整 - 日志 + 截图，处理纠纷有据可依
5. 持续更新 - 融合 Resources 等优秀插件的优点，不断改进
SH-Logger - 让服务器管理更智能、更高效！
