Skills
skills/platform-eaglelab.tcl.com/feishu-usage-analytics

feishu-usage-analytics

SKILL.md

Feishu Usage Analytics

飞书使用统计和分析 Skill，帮助用户全面了解自己的飞书使用习惯和沟通模式。

功能特性

📊 消息统计

  • 发送消息数: 统计每日/每周/每月发送的单聊和群聊消息
  • 收到消息数: 统计接收到的消息数量
  • 回复消息数: 统计回复的消息数量
  • 总互动数: 发送 + 收到 + 回复的综合统计

👥 聊天排行

  • 单聊排行: 按互动频率排序的联系人列表
  • 群聊排行: 按活跃度排序的群组列表
  • 详细数据: 每个聊天的发送/收到/回复数量

⏰ 在线时间

  • 首次打开: 每天第一次打开飞书的时间
  • 最后打开: 每天最后一次打开飞书的时间
  • 会话次数: 每天打开飞书的次数

📅 自动周报

  • 定时推送: 每周五晚上9点自动生成并发送周报
  • 周期统计: 汇总本周所有数据
  • 趋势分析: 对比每日活跃度

快速开始

查看统计数据

# 查看今日详细统计
python ~/.openclaw/workspace/skills/feishu-usage-analytics/scripts/cli.py daily

# 查看本周统计
python ~/.openclaw/workspace/skills/feishu-usage-analytics/scripts/cli.py weekly

# 查看本月统计
python ~/.openclaw/workspace/skills/feishu-usage-analytics/scripts/cli.py monthly

# 生成周报文本
python ~/.openclaw/workspace/skills/feishu-usage-analytics/scripts/cli.py report

# 生成日报文本
python ~/.openclaw/workspace/skills/feishu-usage-analytics/scripts/cli.py daily-report

设置自动周报

# 设置每周五晚上9点自动发送周报
python ~/.openclaw/workspace/skills/feishu-usage-analytics/scripts/cron_setup.py setup

# 查看定时任务状态
python ~/.openclaw/workspace/skills/feishu-usage-analytics/scripts/cron_setup.py status

# 移除定时任务
python ~/.openclaw/workspace/skills/feishu-usage-analytics/scripts/cron_setup.py remove

在 OpenClaw 中使用

记录发送的消息

from scripts.analytics_collector import FeishuAnalyticsCollector

collector = FeishuAnalyticsCollector()

# 记录发送的单聊消息
collector.record_message_sent('single', chat_id, chat_name='张三')

# 记录发送的群聊消息
collector.record_message_sent('group', chat_id, chat_name='技术交流群')

记录收到的消息

# 记录收到的单聊消息
collector.record_message_received('single', chat_id, chat_name='张三', sender_id='user_123')

# 记录收到的群聊消息
collector.record_message_received('group', chat_id, chat_name='技术交流群', sender_id='user_456')

记录回复的消息

# 记录回复的单聊消息
collector.record_message_replied('single', chat_id, chat_name='张三', reply_to_msg_id='msg_789')

# 记录回复的群聊消息
collector.record_message_replied('group', chat_id, chat_name='技术交流群', reply_to_msg_id='msg_012')

记录会话开始

# 当用户打开飞书时记录
collector.record_session_start()

获取详细报告

# 获取每日详细报告
daily_report = collector.get_daily_report('2024-01-15')
print(f"发送: {daily_report['total_sent']}")
print(f"收到: {daily_report['total_received']}")
print(f"回复: {daily_report['total_replied']}")

# 获取单聊排行
for chat in daily_report['single_chats_top'][:5]:
    print(f"{chat['name']}: 发{chat['sent_count']} 收{chat['received_count']} 回{chat['replied_count']}")

# 获取每周报告
weekly_report = collector.get_weekly_report('2024-W03')

# 获取每月报告
monthly_report = collector.get_monthly_report('2024-01')

生成并发送周报

from scripts.weekly_report import generate_weekly_briefing, generate_daily_briefing

collector = FeishuAnalyticsCollector()

# 生成周报
weekly_report = generate_weekly_briefing(collector)

# 生成日报
daily_report = generate_daily_briefing(collector)

# 发送到飞书
message.send(target="user_id", message=weekly_report)

数据结构

每日统计数据

{
  "2024-01-15": {
    "single_chats": {
      "user_123": {
        "name": "张三",
        "sent_count": 10,
        "received_count": 15,
        "replied_count": 5,
        "last_activity": "2024-01-15T18:30:00"
      }
    },
    "group_chats": {
      "group_456": {
        "name": "技术交流群",
        "sent_count": 20,
        "received_count": 50,
        "replied_count": 10,
        "last_activity": "2024-01-15T20:00:00"
      }
    },
    "sent_single_count": 10,
    "sent_group_count": 20,
    "received_single_count": 15,
    "received_group_count": 50,
    "replied_single_count": 5,
    "replied_group_count": 10
  }
}

会话记录

{
  "2024-01-15": {
    "first_open": "08:30:00",
    "last_open": "22:15:00",
    "session_count": 8
  }
}

数据存储

数据默认存储在 ~/.openclaw/workspace/feishu-analytics/：

  • daily_stats.json - 每日详细消息统计
  • sessions.json - 每日在线时间记录
  • chat_details.json - 聊天对象详情
  • config.json - 配置文件

可通过环境变量 FEISHU_ANALYTICS_DIR 修改存储路径。

参考文档

定时任务配置

自动周报使用 cron 定时任务，默认配置：

  • 时间: 每周五 21:00
  • 任务: 生成并发送周报简报

修改配置请编辑 ~/.openclaw/workspace/feishu-analytics/config.json。

示例输出

日报示例

📊 飞书使用日报 - 2024-01-15

📈 消息统计
📤 发送: 35 条 (单聊15/群聊20)
📥 收到: 68 条 (单聊28/群聊40)
💬 回复: 12 条 (单聊8/群聊4)
📊 总互动: 115 条

👤 单聊排行 Top 3
  1. 张三
     📤15 📥20 💬5
  2. 李四
     📤8 📥12 💬3
  3. 王五
     📤5 📥8 💬2

👥 群聊排行 Top 3
  1. 技术交流群
     📤20 📥40 💬4
  2. 产品讨论组
     📤10 📥25 💬2

⏰ 在线时间
• 首次打开: 08:30:00
• 最后打开: 22:15:00
• 会话次数: 8

周报示例

📊 飞书使用周报
📅 2024-01-08 至 2024-01-14

📈 消息统计
📤 发送消息: 245 条
   ├─ 单聊: 105 条
   └─ 群聊: 140 条
📥 收到消息: 476 条
   ├─ 单聊: 196 条
   └─ 群聊: 280 条
💬 回复消息: 84 条
   ├─ 单聊: 56 条
   └─ 群聊: 28 条
📊 总互动数: 805 条 (日均 115.0)

👤 单聊排行 Top 5
  1. 张三
     📤45 📥60 💬15 (共120)
  2. 李四
     📤30 📥40 💬10 (共80)
  ...

👥 群聊排行 Top 5
  1. 技术交流群
     📤80 📥160 💬16 (共256)
  ...

⏰ 每日在线时间
• 2024-01-08: 08:30 - 22:00 (115 条)
• ...

🏆 本周之最
• 最活跃的一天: 2024-01-10
  共 145 条互动
  (发55/收75/回15)
Installs
1
Source
platform-eaglel…nalytics
First Seen
Apr 9, 2026