搜索 on tgs

tgs search messages

Mon, 01 Jan 0001 00:00:00 +0000

在一个或多个聊天、频道或群组中搜索消息。

tgs search messages [query] [flags]

query 参数为必填项，指定要搜索的文本。

参数	缩写	类型	默认值	说明
`--chat`	`-c`	string[]		要搜索的聊天（用户名、电话、ID；可重复使用，支持逗号分隔）。未设置 `--folder` 时必填。
`--folder`		string	`""`	搜索此文件夹内的所有聊天（id 或名称）；文件夹中的对等体与 `--chat` 累加
`--from`	`-f`	string		按发送者筛选（用户名、电话或 ID）
`--filter`		string		消息类型过滤器（参见过滤器值）
`--after`		string		仅返回此日期之后的消息（YYYY-MM-DD 或 unix 时间戳）
`--before`		string		仅返回此日期之前的消息（YYYY-MM-DD 或 unix 时间戳）
`--topic`		int	`0`	论坛主题 ID
`--limit`	`-l`	int	`50`	最大返回消息数（1-100）
`--cursor`		string		上次响应中的分页游标
`--max-wait`		int	`60`	FLOOD_WAIT 最大等待秒数
`--no-cache`		bool	`false`	禁用对等体解析缓存
`--include-comments`		bool	`false`	同时搜索每个频道关联的讨论组
`--profile`	`-p`	string		账户配置文件名称

未设置 --profile 时的配置文件解析顺序：TGS_PROFILE 环境变量 -> .tgs.yaml 文件 -> "default"。

Mon, 01 Jan 0001 00:00:00 +0000

在所有聊天、频道和群组中全局搜索消息。

tgs search global [query] [flags]

query 参数为必填项，指定要搜索的文本。

参数	缩写	类型	默认值	说明
`--channels-only`		bool	`false`	仅在频道中搜索；与 `--folder` 不兼容
`--groups-only`		bool	`false`	仅在群组中搜索；与 `--folder` 不兼容
`--users-only`		bool	`false`	仅在私聊中搜索；与 `--folder` 不兼容
`--archived`		bool	`false`	在归档中搜索（文件夹 ID 1）；设置 `--folder` 时忽略
`--folder`		string	`""`	仅在此文件夹中搜索（id 或名称），包含已归档的聊天；与 `--channels-only`、`--groups-only`、`--users-only` 不兼容
`--filter`		string		消息类型过滤器（参见过滤器值）
`--after`		string		仅返回此日期之后的消息（YYYY-MM-DD 或 unix 时间戳）
`--before`		string		仅返回此日期之前的消息（YYYY-MM-DD 或 unix 时间戳）
`--limit`	`-l`	int	`50`	最大返回消息数（1-100）
`--cursor`		string		上次响应中的分页游标
`--max-wait`		int	`60`	FLOOD_WAIT 最大等待秒数
`--profile`	`-p`	string		账户配置文件名称

未设置 --profile 时的配置文件解析顺序：TGS_PROFILE 环境变量 -> .tgs.yaml 文件 -> "default"。

Mon, 01 Jan 0001 00:00:00 +0000

获取一个或多个聊天中按类型分组的消息计数（照片、视频、文档等）。

tgs search counters [flags]

此命令不接受位置参数。

参数	缩写	类型	默认值	说明
`--chat`	`-c`	string		要查询的聊天（用户名、电话或 ID）。未设置 `--folder` 时必填。
`--folder`		string	`""`	查询此文件夹内的所有聊天（id 或名称）；输出包含按聊天分组的明细及汇总数据
`--topic`		int	`0`	论坛主题 ID
`--filters`		string[]		要统计的过滤器类型（逗号分隔；默认：全部）。参见过滤器值
`--max-wait`		int	`60`	FLOOD_WAIT 最大等待秒数
`--no-cache`		bool	`false`	禁用对等体解析缓存
`--profile`	`-p`	string		账户配置文件名称

未设置 --profile 时的配置文件解析顺序：TGS_PROFILE 环境变量 -> .tgs.yaml 文件 -> "default"。

获取频道中所有消息类型的计数：

tgs search counters -c @golang

获取特定类型的计数：

Mon, 01 Jan 0001 00:00:00 +0000

获取一个或多个聊天按日期分组的消息搜索结果。

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

获取文件夹内所有聊天的照片日历：