astrbot_plugin_group_log_archive/_conf_schema.json at main · Fangnai-byte/astrbot_plugin_group_log_archive · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
{
  "poll_interval": {
    "description": "轮询导出间隔（秒）",
    "hint": "间隔模式下的轮询秒数，最小 5 秒。设置了 cron_expression 后此项忽略。",
    "type": "int",
    "default": 60
  },
  "cron_expression": {
    "description": "定时导出时间",
    "hint": "支持简单格式 12:00（每天12点），或完整 cron 如 0 3 * * *（每天凌晨3点）、*/5 * * * *（每5分钟）。留空则使用间隔模式。",
    "type": "text",
    "default": ""
  },
  "log_dir": {
    "description": "源日志目录",
    "hint": "AstrBot 日志所在目录，留空自动使用 data/logs。需在 AstrBot 配置中开启文件日志并设为 DEBUG 级别，才会记录群消息原文。",
    "type": "text",
    "default": ""
  },
  "log_prefix": {
    "description": "源日志文件名前缀",
    "hint": "例如 astrbot.log，会同时处理 astrbot.log.1/.2 等轮转文件。",
    "type": "text",
    "default": "astrbot.log"
  },
  "log_source": {
    "description": "聊天记录日志源",
    "hint": "auto=自动检测（GC→RawMessage→event_bus）；group_chat_context=需开DEBUG且消息进管线；rawmessage=开DEBUG即可（含群号，绕过管线过滤）；event_bus=INFO即可（无群号）。",
    "type": "text",
    "default": "auto"
  },
  "group_whitelist": {
    "description": "群白名单（仅归档这些群）",
    "hint": "填群号，如 748791823。留空=归档所有群；填写后只归档列表中的群，其他群的消息与图片一律不记录。",
    "type": "list",
    "default": []
  },
  "auto_enable_debug": {
    "description": "自动开启 DEBUG 日志",
    "hint": "开启后，检测到未开启 DEBUG 时自动修改 AstrBot 配置（log_level=DEBUG + 文件日志），提示重启后生效。",
    "type": "bool",
    "default": false
  },
  "log_cleanup": {
    "description": "日志自动清理",
    "hint": "格式：<天数>day/<时>:<分>[:<秒>]，如 3day/00:00:00:000（保留3天，每天零点清理）、7day/04:30。留空不清理。",
    "type": "text",
    "default": ""
  },
  "output_dir": {
    "description": "归档输出目录",
    "hint": "按天归档文件保存位置，留空自动使用 data/workspaces/group_logs。",
    "type": "text",
    "default": ""
  },
  "only_chat": {
    "description": "只保留聊天记录",
    "hint": "开启后只导出群聊记录行（含群号/昵称/时间/内容），过滤掉系统调试与 LLM 请求日志。",
    "type": "bool",
    "default": true
  },
  "clean_source": {
    "description": "导出后清空源日志",
    "hint": "开启后每次导出完成即清空活跃源日志（truncate，保留文件），并删除轮转文件，避免双份增长。",
    "type": "bool",
    "default": true
  },
  "mask_group_id": {
    "description": "群号脱敏",
    "hint": "开启后群号用哈希替代（文件名和内容中均生效），保护群隐私。",
    "type": "bool",
    "default": false
  },
  "mask_qq_id": {
    "description": "QQ号脱敏",
    "hint": "开启后日志中的 QQ 号打码显示（如 123****456），保护个人隐私。",
    "type": "bool",
    "default": false
  },
  "track_images": {
    "description": "图片追踪",
    "hint": "开启后图片消息会自动匹配并复制图片到归档目录的 tu/ 子文件夹，日志行追加 [图:tu/xxx.png] 标注。",
    "type": "bool",
    "default": false
  },
  "cleanup_images": {
    "description": "自动清理图片",
    "hint": "开启后按 image_retention_days 自动清理 tu/ 目录下过期的图片。",
    "type": "bool",
    "default": false
  },
  "image_retention_days": {
    "description": "图片保留天数",
    "hint": "cleanup_images 开启时，图片保留多少天，超过自动删除。",
    "type": "int",
    "default": 7
  },
  "image_caption": {
    "description": "AI 图片命名",
    "hint": "开启后用识图模型为保存的图片生成 5-6 字简短名称（会消耗 API token）。",
    "type": "bool",
    "default": false
  },
  "image_caption_provider": {
    "description": "命名用模型 Provider ID",
    "hint": "留空自动使用默认模型。需支持图片识别（如 xiaomi/mimo-v2.5）。",
    "type": "text",
    "default": ""
  },
  "record_bot_messages": {
    "description": "记录 bot 自己的发言",
    "hint": "开启后 bot 发送的群消息也会记入归档（昵称显示为 bot），方便统计发言量。",
    "type": "bool",
    "default": false
  }
}