telegram-groups

Telegram Groups 是一个面向 Telegram 群组管理的命令行技能，主要用于对群组执行列表查看、发帖、成员管理、群组重命名和话题创建等操作。

用途该技能适用于需要以命令行方式操作 Telegram 群组的场景，例如查看自己加入的群组、向指定群组发送消息、列出群组成员、批量添加用户、修改群组名称，以及在论坛型群组中创建话题。

主要能力

列出群组：可仅列出群组，也可同时列出群组与频道。
在群组中发帖：支持直接传入文本消息，或从文件读取消息内容；对于论坛型群组，还可指定话题 ID 进行发帖。
列出成员：查看指定群组的成员列表。
添加用户：通过 CSV 文件批量添加用户，CSV 格式为 username,name。
重命名群组：修改群组名称。
创建话题：在论坛型群组中新增话题，并可指定话题颜色。

使用方式该技能通过 Python 脚本 $TG_TOOLS_PATH/tools/tg_groups.py 调用，具体命令如下：

列出群组：

仅群组

python3 $TG_TOOLS_PATH/tools/tg_groups.py list

群组 + 频道

python3 $TG_TOOLS_PATH/tools/tg_groups.py list --all

在群组中发帖：

直接发送文本

python3 $TG_TOOLS_PATH/tools/tg_groups.py post "Group Name" --message "Hello!"

从文件读取消息

python3 $TG_TOOLS_PATH/tools/tg_groups.py post "Group Name" --message-file msg.txt

在指定话题中发帖（论坛群组）

python3 $TG_TOOLS_PATH/tools/tg_groups.py post "Group Name" --message "Hello!" --topic 123

其中 Group Name 支持按子字符串搜索，且不区分大小写。

列出成员： python3 $TG_TOOLS_PATH/tools/tg_groups.py members "Group Name"

添加用户： python3 $TG_TOOLS_PATH/tools/tg_groups.py add-users "Group Name" --input users.csv CSV 格式：username,name

重命名群组： python3 $TG_TOOLS_PATH/tools/tg_groups.py rename "Group Name" --name "New Name"

创建话题（论坛群组）： python3 $TG_TOOLS_PATH/tools/tg_groups.py topics "Group Name" --add "Topic Title" python3 $TG_TOOLS_PATH/tools/tg_groups.py topics "Group Name" --add "Topic" --color 6FB9F0

适用场景

需要快速查看自己管理的 Telegram 群组列表。
需要向特定群组或论坛话题发送通知或消息。
需要导出或查看群组成员。
需要批量邀请或添加用户到群组。
需要调整群组名称或创建新话题。

限制

add-users：需要管理员权限，且要求双方为互相联系人，并受隐私设置影响。
rename：需要管理员权限。
topics：仅适用于论坛型群组。
添加用户时每次操作之间有 2 秒延迟（速率限制）。

技能介绍

仅群组

群组 + 频道

直接发送文本

从文件读取消息

在指定话题中发帖（论坛群组）