鬼混日记 · 机器人社交统计插件 for AstrBot

作者：柯尔 (Luna-channel)
版本：v1.0.1
仓库：https://github.com/Luna-channel/astrbot_plugin_hangout

查询机器人都和谁去鬼混了 —— 一款为 AstrBot 设计的 消息统计可视化插件，自动记录机器人每天在各个群聊和私聊的回复数量，生成精美的统计报告图片。

🌟 核心特性

• 📊 自动统计：自动记录机器人的每一条回复（只计数，不记录内容），按群聊/私聊分类统计
• 🖼️ 可视化报告：生成精美的图片报告，包含头像、排名、消息数量和占比
• ⏰ 定时推送：每天定时将报告私聊发送给白名单管理员
• 📅 多日统计：支持查询最近1-30天的统计数据
• 🔒 隐私保护：只记录消息数量，不记录任何消息内容

✨ 功能特性

• 群聊统计：显示机器人在各个群聊的回复数量排行
• 私聊统计：显示机器人与各个用户的私聊回复数量排行
• 百分比显示：直观展示每个会话占总回复的比例
• 头像展示：自动获取并显示群聊和用户头像
• 管理员专属：只有白名单中的管理员才能查看报告

📦 安装

1. 从 Release 或本仓库获取插件包，解压到：
   AstrBot/data/plugins/astrbot_plugin_hangout/
2. 启动（或重启）AstrBot。
3. 进入 WebUI → 插件 → 启用 鬼混日记。
4. 在插件配置页完成参数设置（添加管理员白名单）。

目录结构示例：

AstrBot/
└─ data/
   └─ plugins/
      └─ astrbot_plugin_hangout/
         ├─ main.py
         ├─ _conf_schema.json
         ├─ metadata.yaml
         ├─ README.md
         ├─ requirements.txt
         └─ templates/
            ├─ report_template.html
            ├─ group_section.html
            └─ private_section.html

插件会在 AstrBot/data/ 目录下创建自己的数据文件夹：

AstrBot/
└─ data/
   └─ plugin_data/
      └─ astrbot_plugin_hangout/
         └─ message_stats.json

🧩 配置项（_conf_schema.json）

💬 指令全集

🚀 快速上手

1. 配置管理员白名单：

   • 进入 WebUI → 插件配置 → 鬼混日记
   • 在 admin_whitelist 中添加你的QQ号
   • 保存配置

2. 查看统计报告：

   /消息日记
   

3. 查看多日统计：

   /消息日记 7
   

4. 设置每日报告时间（可选）：

   • 在 WebUI 中设置 report_hour 和 report_minute
   • 默认每天 12:00 发送

📊 报告示例

报告将展示：

• 📈 今日/多日总回复数
• 👥 活跃群聊数量
• 💬 活跃私聊数量
• 🏆 群聊回复排行榜（前15名，含头像）
• 🏆 私聊回复排行榜（前15名，含头像）
• 📊 每个会话的消息占比和进度条

🔧 注意事项

• 本插件仅支持 QQ 平台（aiocqhttp）
• 只记录消息数量，不记录任何消息内容，保护用户隐私
• 报告中的群名和昵称实时获取，可能会显示为默认值
• 图片生成需要 AstrBot 的 HTML 渲染服务支持

🗂️ 数据与持久化

• 插件数据目录：AstrBot/data/plugin_data/astrbot_plugin_hangout/
  • message_stats.json：消息统计数据（按日期存储）

数据存储在全局 plugin_data 目录下，遵循 AstrBot 插件开发规范。

🤝 贡献

欢迎 Issue 与 PR！

• Repo：https://github.com/Luna-channel/astrbot_plugin_hangout

📜 许可证

MIT