tgs search calendar#
获取一个或多个聊天按日期分组的消息搜索结果。
用法#
tgs search calendar [flags]此命令不接受位置参数。
参数#
| 参数 | 缩写 | 类型 | 默认值 | 说明 |
|---|---|---|---|---|
--chat | -c | string | 要查询的聊天（用户名、电话或 ID）。未设置 --folder 时必填。 | |
--folder | string | "" | 查询此文件夹内的所有聊天（id 或名称）；输出包含按聊天分组的数组及汇总数据 | |
--filter | string | 消息类型过滤器（参见过滤器值）。必填。 | ||
--max-wait | int | 60 | FLOOD_WAIT 最大等待秒数 | |
--no-cache | bool | false | 禁用对等体解析缓存 | |
--profile | -p | string | 账户配置文件名称 |
未设置 --profile 时的配置文件解析顺序：TGS_PROFILE 环境变量 -> .tgs.yaml 文件 -> "default"。
示例#
获取频道中照片消息的日历：
tgs search calendar -c @travel_photos --filter photo获取群组中共享文档的日历：
tgs search calendar -c @dev_team --filter document获取文件夹内所有聊天的照片日历：
tgs search calendar --folder Work --filter photo输出#
返回 JSON，包含日期条目数组和总数 total。
JSON（默认，单个聊天）：
{
"periods": [
{"date": "2026-05-12", "count": 2, "min_msg_id": 510, "max_msg_id": 511},
{"date": "2026-05-10", "count": 1, "min_msg_id": 508, "max_msg_id": 508},
{"date": "2025-12-23", "count": 1, "min_msg_id": 466, "max_msg_id": 466}
],
"total": 98
}JSON（使用 --folder，多个聊天）：
使用 --folder 时，输出包含按聊天分组的数组及汇总数据：
{
"chats": [
{
"chat": {"id": -1001006503122, "type": "channel", "title": "Dev News"},
"periods": [
{"date": "2026-05-12", "count": 1, "min_msg_id": 510, "max_msg_id": 510}
],
"total": 1
},
{
"chat": {"id": -1001009876543, "type": "supergroup", "title": "Team"},
"periods": [
{"date": "2026-05-12", "count": 1, "min_msg_id": 200, "max_msg_id": 200},
{"date": "2026-05-10", "count": 1, "min_msg_id": 198, "max_msg_id": 198}
],
"total": 2
}
],
"totals": [
{"date": "2026-05-12", "count": 2},
{"date": "2026-05-10", "count": 1}
],
"total": 3
}文本（--output text）：
2026-05-12 2
2026-05-10 1
2025-12-23 1
total: 98每个条目覆盖指定日期（UTC）的消息。min_msg_id 和 max_msg_id 可用于通过 tgs search messages --cursor 或任何接受消息 ID 范围的第三方工具获取具体消息。