博主在线状态插件 | LiMhy Blog System 专用

插件介绍

博主在线状态插件是专为 LiMhy Blog System 开发的实时状态展示工具，支持多管理员状态监控、在线时长统计、最后活跃时间记录三大核心功能。悬浮卡片设计，支持自定义位置和样式，让访客实时了解博主在线状态，提升博客互动感。

插件轻量化、无侵入、高性能，支持日夜模式自动适配，完美融入博客主题风格。

核心功能

• 实时状态监控：自动检测博主在线/空闲/离线状态，状态圆点一目了然

• 在线时长统计：精准记录博主从首次登录至今的总在线时长

• 最后活跃记录：记录博主最后退出登录的完整时间（年月日时分秒）

• 多管理员支持：支持多管理员账号，可分别显示在线状态

• 悬浮卡片设计：鼠标悬停/点击展示详细信息，支持展开/收起

• 位置自定义：支持固定在屏幕四角（右上/右下/左上/左下），可自定义偏移量

• 日夜模式适配：完美适配博客深色/浅色主题，自动切换样式

• 纯插件机制：不修改系统核心代码，安全稳定，即装即用

核心特性

插件信息

下载地址

安装方法

1、 下载插件并解压，上传至博客 /plugins/ 目录

2、 后台进入「插件管理」，找到「博主在线状态插件」并启用

3、 进入插件设置，选择显示位置、卡片标题等参数

4、 刷新前台页面，即可在角落看到博主状态悬浮按钮

使用说明

状态说明

显示位置

支持四种固定位置：

• 右下角（默认）
• 左下角
• 右上角
• 左上角

可通过后台设置调整位置偏移量（X轴/Y轴）。

卡片信息

点击头像展开卡片，包含：

• 博主头像、昵称
• 当前状态（在线/空闲/离线）
• 总在线时长
• 最后活跃时间

缓存机制

插件自动记录管理员活动，数据存储在 /plugins/blogger-status-plugin/data/admin_activity.json，无数据库负担。

注意事项

1、插件依赖管理员登录状态，需确保系统用户角色正确配置

2、首次启用需等待管理员登录后才会记录活动数据

3、离线状态会显示最后退出登录的准确时间

4、多管理员模式下，卡片显示当前在线的管理员信息

5、 插件纯前端展示，不向任何第三方发送数据

版本信息

API 接口说明（开发者）

插件提供了 RESTful API 接口，可供主题或其他插件调用：

获取状态响应示例

{
  "success": true,
  "blogger": {
    "id": 1,
    "name": "允赫先森",
    "avatar": "https://cravatar.cn/avatar/xxx",
    "role": "admin"
  },
  "status": {
    "status": "online",
    "status_text": "在线",
    "status_color": "#4CAF50",
    "online_duration": 84600,
    "online_duration_formatted": "23小时30分钟",
    "last_active_formatted": "刚刚",
    "is_online": true
  },
  "timestamp": 1744185600
}