快速开始 on tgs

安装

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

安装#

tgs 以单个静态二进制文件分发，无任何运行时依赖。选择适合你平台的方式即可——安装后的命令始终是 tgs。

Homebrew（macOS 和 Linux）#

在 macOS 和 Linux 上最快的方式：

brew install garenal1v3/tap/tgs-cli

该命令会安装 tgs 二进制文件，并可通过 brew upgrade 保持更新。

预编译二进制文件#

从发布页面下载对应平台的归档文件。归档命名为 tgs-cli_<os>_<arch>：

平台	OS	Arch
macOS（Apple 芯片）	`darwin`	`arm64`
macOS（Intel）	`darwin`	`amd64`
Linux	`linux`	`amd64` / `arm64`
Windows	`windows`	`amd64` / `arm64`

macOS 和 Linux#

# Choose your platform: OS = darwin (macOS) or linux; ARCH = arm64 or amd64
OS=darwin
ARCH=arm64

curl -L -o tgs.tar.gz \
 "https://github.com/garenal1v3/tgs-cli/releases/latest/download/tgs-cli_${OS}_${ARCH}.tar.gz"
tar -xzf tgs.tar.gz tgs
sudo mv tgs /usr/local/bin/
tgs version

Windows#

# PowerShell — ARCH = amd64 or arm64
$Arch = "amd64"
Invoke-WebRequest `
 -Uri "https://github.com/garenal1v3/tgs-cli/releases/latest/download/tgs-cli_windows_$Arch.zip" `
 -OutFile tgs.zip
Expand-Archive tgs.zip -DestinationPath .
# Move tgs.exe into a directory on your PATH, then:
.\tgs.exe version

从源码构建#

需要 Go 1.26 或更高版本：

快速开始

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

快速开始#

五条命令，从零到第一次搜索。本节假设你已安装 tgs——如果还没有，请参阅安装。

1. 身份验证#

默认登录方式会从 Telegram Desktop 导入现有会话——无需手机号或验证码：

tgs login

其他方式（手机号 + 验证码、二维码、面向 AI 代理的非交互流程）详见身份验证。

2. 确认当前账户#

tgs whoami

以 JSON 返回当前活跃账户——你的 ID、名称和用户名。

3. 列出你的聊天#

查看账户中的所有对话——频道、群组、用户、机器人：

tgs sources list

加上 --type channel 可按类型过滤，或用 --with-stats 获取消息统计。详见来源。

4. 在某个聊天中搜索#

tgs search messages "release" -c @durov

-c 接受用户名、t.me 链接、手机号或数字 ID。用 --from、--filter 以及 --after / --before 缩小结果范围。

5. 全局搜索#

不确定在哪个聊天里？一次搜索全部：

tgs search global "meeting notes"

这就是核心流程。每条命令都输出 JSON——可以管道传给 jq 或交给 AI 代理。深入了解请看搜索指南。

身份验证

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

身份验证#

tgs 通过 MTProto 协议使用您的真实用户账户连接到 Telegram。每个配置文件只需认证一次——会话保存在本地，后续命令自动复用。

快速开始#

默认方式是从已有的 Telegram Desktop 客户端导入会话：

tgs login

或选择其他登录方式：

tgs login --type code # Phone number + SMS/Telegram code
tgs login --type qr # Scan QR code from another device

登录方式#

Desktop 导入（默认）#

从 Telegram Desktop 导入现有会话。tgs 会自动检测 macOS、Linux 和 Windows 上的 tdata 目录。

# Auto-detect Telegram Desktop data
tgs login

# Custom tdata path
tgs login --desktop-dir /path/to/tdata

# Passcode-protected Telegram Desktop client
tgs login --passcode SECRET

无需输入手机号或验证码——会话直接传输。