来源 on tgs

tgs sources list

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

tgs sources list#

枚举您账户中的所有 Telegram 对话——频道、超级群组、普通群组、用户和机器人。

用法#

tgs sources list [flags]

参数#

参数	缩写	类型	默认值	说明
`--type`		string[]	（全部）	按类型筛选：`channel`、`supergroup`、`group`、`user`、`bot`（可重复使用，支持逗号分隔）
`--with-stats`		bool	`false`	为每个来源获取扩展统计信息（总消息数/24h/首条消息 + 完整信息）
`--limit`	`-l`	int	`0`	最大返回记录数（1-500，0=全部）
`--cursor`		string		上次响应中的分页游标
`--folder`		string	`""`	仅返回此文件夹内的聊天（id 或名称），包含已归档的聊天；与 `--cursor` 不兼容
`--archived`		bool	`false`	包含已归档的对话（设置 `--folder` 时忽略——文件夹本身已包含其归档聊天）
`--max-wait`		int	`60`	FLOOD_WAIT 最大等待秒数
`--no-cache`		bool	`false`	禁用对等体和统计缓存
`--profile`	`-p`	string		账户配置文件名称

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

tgs sources inspect

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

tgs sources inspect#

获取单个 Telegram 来源的详细信息。适用于您已订阅的来源，也适用于您未加入的公开频道。

用法#

tgs sources inspect <ref> [flags]

ref 参数用于标识目标来源，支持以下格式：

格式	示例	说明
`@username`	`@durov`	带 `@` 前缀的公开用户名
`username`	`durov`	不带前缀的公开用户名
`id:<n>`	`id:-1001234567890`	Telegram 对等体 ID（推荐用于负数 ID——pflag 会把裸 `-N` 当作旗标）
数字 ID	`12345`	正数对等体 ID。对于负数请使用上面的 `id:` 形式，或插入 `--`（例如 `inspect -- -1001234567890`）
电话号码	`+79001234567`	用于联系人或您自己的账户
`-` 或 `@me`	`-`	收藏夹（“Saved Messages”）

参数#

参数	缩写	类型	默认值	说明
`--no-stats`		bool	`false`	跳过扩展统计（总消息数/24h/首条消息）
`--no-cache`		bool	`false`	禁用对等体和统计缓存
`--max-wait`		int	`60`	FLOOD_WAIT 最大等待秒数
`--profile`	`-p`	string		账户配置文件名称

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

tgs sources folders

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

tgs sources folders#

枚举用户的 Telegram 文件夹（UI 中的对话筛选器），并按 Telegram 客户端的方式解析每个文件夹的内容——将置顶/包含/排除的对等体及自动规则（联系人、群组等）应用到完整的对话列表。

默认的"所有聊天"文件夹不会出现在输出中；只有用户自定义的文件夹和共享聊天列表才会显示。

用法#

tgs sources folders [flags]

参数#

Flag	Short	Type	Default	Description
`--max-wait`		int	`60`	Max seconds to wait on FLOOD_WAIT
`--no-cache`		bool	`false`	Disable peer cache
`--profile`	`-p`	string		Account profile name

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

示例#

# List all user-defined folders and their contents
tgs sources folders

# Disable peer cache (force fresh data)
tgs sources folders --no-cache

# Use a specific profile
tgs sources folders --profile secondary

输出#

{
 "folders": [
 {
 "id": 2,
 "kind": "custom",
 "title": "Crypto",
 "emoticon": "💰",
 "chats_count": 12,
 "chats": [
 {
 "id": -1001234567890,
 "type": "channel",
 "title": "BTC News",
 "username": "btcnews",
 "unread_count": 3,
 "pinned": true,
 "last_message": {"id": 9876, "date": "2026-05-27T10:00:00Z"}
 }
 ]
 },
 {
 "id": 5,
 "kind": "chatlist",
 "title": "Go Community",
 "chats_count": 8,
 "chats": []
 }
 ],
 "total": 2
}

文件夹字段#

字段	类型	说明
`id`	int	Telegram 对话筛选器 ID
`kind`	string	`custom` 表示用户自定义文件夹；`chatlist` 表示共享聊天列表
`title`	string	文件夹显示名称
`emoticon`	string	文件夹表情符号；未设置时省略
`has_my_invites`	bool	聊天列表包含您创建的邀请链接；仅在为 `true` 时出现
`chats_count`	int	`chats` 数组中的聊天数量
`chats`	array	已解析的聊天条目（字段结构与 `sources list` 来源相同）
`total`	int	返回的文件夹总数

chats 内的聊天条目字段结构与 tgs sources list 中的来源相同。