<?xml version="1.0" encoding="utf-8" standalone="yes"?><rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>介绍 on tgs</title><link>https://garenal1v3.github.io/tgs-cli/zh/</link><description>Recent content in 介绍 on tgs</description><generator>Hugo</generator><language>zh</language><atom:link href="https://garenal1v3.github.io/tgs-cli/zh/index.xml" rel="self" type="application/rss+xml"/><item><title>安装</title><link>https://garenal1v3.github.io/tgs-cli/zh/getting-started/installation/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/getting-started/installation/</guid><description>&lt;h1 id="安装"&gt;安装&lt;a class="anchor" href="#%e5%ae%89%e8%a3%85"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;&lt;code&gt;tgs&lt;/code&gt; 以单个静态二进制文件分发，无任何运行时依赖。选择适合你平台的方式即可——安装后的命令始终是 &lt;code&gt;tgs&lt;/code&gt;。&lt;/p&gt;
&lt;h2 id="homebrewmacos-和-linux"&gt;Homebrew（macOS 和 Linux）&lt;a class="anchor" href="#homebrewmacos-%e5%92%8c-linux"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;在 macOS 和 Linux 上最快的方式：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;brew install garenal1v3/tap/tgs-cli&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;该命令会安装 &lt;code&gt;tgs&lt;/code&gt; 二进制文件，并可通过 &lt;code&gt;brew upgrade&lt;/code&gt; 保持更新。&lt;/p&gt;
&lt;h2 id="预编译二进制文件"&gt;预编译二进制文件&lt;a class="anchor" href="#%e9%a2%84%e7%bc%96%e8%af%91%e4%ba%8c%e8%bf%9b%e5%88%b6%e6%96%87%e4%bb%b6"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;从&lt;a href="https://github.com/garenal1v3/tgs-cli/releases"&gt;发布页面&lt;/a&gt;下载对应平台的归档文件。归档命名为 &lt;code&gt;tgs-cli_&amp;lt;os&amp;gt;_&amp;lt;arch&amp;gt;&lt;/code&gt;：&lt;/p&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;平台&lt;/th&gt;
 &lt;th&gt;OS&lt;/th&gt;
 &lt;th&gt;Arch&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;macOS（Apple 芯片）&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;darwin&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;arm64&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;macOS（Intel）&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;darwin&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;amd64&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;Linux&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;linux&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;amd64&lt;/code&gt; / &lt;code&gt;arm64&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;Windows&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;windows&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;amd64&lt;/code&gt; / &lt;code&gt;arm64&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;h3 id="macos-和-linux"&gt;macOS 和 Linux&lt;a class="anchor" href="#macos-%e5%92%8c-linux"&gt;#&lt;/a&gt;&lt;/h3&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# Choose your platform: OS = darwin (macOS) or linux; ARCH = arm64 or amd64&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e06c75"&gt;OS&lt;/span&gt;&lt;span style="color:#56b6c2"&gt;=&lt;/span&gt;darwin
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e06c75"&gt;ARCH&lt;/span&gt;&lt;span style="color:#56b6c2"&gt;=&lt;/span&gt;arm64
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;curl -L -o tgs.tar.gz &lt;span style="color:#98c379"&gt;\
&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#98c379"&gt;&amp;#34;https://github.com/garenal1v3/tgs-cli/releases/latest/download/tgs-cli_&lt;/span&gt;&lt;span style="color:#98c379"&gt;${&lt;/span&gt;&lt;span style="color:#e06c75"&gt;OS&lt;/span&gt;&lt;span style="color:#98c379"&gt;}&lt;/span&gt;&lt;span style="color:#98c379"&gt;_&lt;/span&gt;&lt;span style="color:#98c379"&gt;${&lt;/span&gt;&lt;span style="color:#e06c75"&gt;ARCH&lt;/span&gt;&lt;span style="color:#98c379"&gt;}&lt;/span&gt;&lt;span style="color:#98c379"&gt;.tar.gz&amp;#34;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tar -xzf tgs.tar.gz tgs
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;sudo mv tgs /usr/local/bin/
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs version&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;h3 id="windows"&gt;Windows&lt;a class="anchor" href="#windows"&gt;#&lt;/a&gt;&lt;/h3&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-powershell" data-lang="powershell"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# PowerShell — ARCH = amd64 or arm64&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e06c75"&gt;$Arch&lt;/span&gt; = &lt;span style="color:#98c379"&gt;&amp;#34;amd64&amp;#34;&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e5c07b"&gt;Invoke-WebRequest&lt;/span&gt; `
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;-Uri&lt;/span&gt; &lt;span style="color:#98c379"&gt;&amp;#34;https://github.com/garenal1v3/tgs-cli/releases/latest/download/tgs-cli_windows_&lt;/span&gt;&lt;span style="color:#e06c75"&gt;$Arch&lt;/span&gt;&lt;span style="color:#98c379"&gt;.zip&amp;#34;&lt;/span&gt; `
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;-OutFile&lt;/span&gt; &lt;span style="color:#e06c75"&gt;tgs&lt;/span&gt;.&lt;span style="color:#e06c75"&gt;zip&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e5c07b"&gt;Expand-Archive&lt;/span&gt; &lt;span style="color:#e06c75"&gt;tgs&lt;/span&gt;.&lt;span style="color:#e06c75"&gt;zip&lt;/span&gt; &lt;span style="color:#e06c75"&gt;-DestinationPath&lt;/span&gt; .
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# Move tgs.exe into a directory on your PATH, then:&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;.\&lt;span style="color:#e06c75"&gt;tgs&lt;/span&gt;.&lt;span style="color:#e06c75"&gt;exe&lt;/span&gt; &lt;span style="color:#e06c75"&gt;version&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;h2 id="从源码构建"&gt;从源码构建&lt;a class="anchor" href="#%e4%bb%8e%e6%ba%90%e7%a0%81%e6%9e%84%e5%bb%ba"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;需要 Go 1.26 或更高版本：&lt;/p&gt;</description></item><item><title>快速开始</title><link>https://garenal1v3.github.io/tgs-cli/zh/getting-started/quick-start/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/getting-started/quick-start/</guid><description>&lt;h1 id="快速开始"&gt;快速开始&lt;a class="anchor" href="#%e5%bf%ab%e9%80%9f%e5%bc%80%e5%a7%8b"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;五条命令，从零到第一次搜索。本节假设你已安装 tgs——如果还没有，请参阅&lt;a href="https://garenal1v3.github.io/tgs-cli/zh/getting-started/installation/"&gt;安装&lt;/a&gt;。&lt;/p&gt;
&lt;h2 id="1-身份验证"&gt;1. 身份验证&lt;a class="anchor" href="#1-%e8%ba%ab%e4%bb%bd%e9%aa%8c%e8%af%81"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;默认登录方式会从 Telegram Desktop 导入现有会话——无需手机号或验证码：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs login&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;其他方式（手机号 + 验证码、二维码、面向 AI 代理的非交互流程）详见&lt;a href="https://garenal1v3.github.io/tgs-cli/zh/getting-started/authentication/"&gt;身份验证&lt;/a&gt;。&lt;/p&gt;
&lt;h2 id="2-确认当前账户"&gt;2. 确认当前账户&lt;a class="anchor" href="#2-%e7%a1%ae%e8%ae%a4%e5%bd%93%e5%89%8d%e8%b4%a6%e6%88%b7"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs whoami&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;以 JSON 返回当前活跃账户——你的 ID、名称和用户名。&lt;/p&gt;
&lt;h2 id="3-列出你的聊天"&gt;3. 列出你的聊天&lt;a class="anchor" href="#3-%e5%88%97%e5%87%ba%e4%bd%a0%e7%9a%84%e8%81%8a%e5%a4%a9"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;查看账户中的所有对话——频道、群组、用户、机器人：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs sources list&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;加上 &lt;code&gt;--type channel&lt;/code&gt; 可按类型过滤，或用 &lt;code&gt;--with-stats&lt;/code&gt; 获取消息统计。详见&lt;a href="https://garenal1v3.github.io/tgs-cli/zh/guide/sources/"&gt;来源&lt;/a&gt;。&lt;/p&gt;
&lt;h2 id="4-在某个聊天中搜索"&gt;4. 在某个聊天中搜索&lt;a class="anchor" href="#4-%e5%9c%a8%e6%9f%90%e4%b8%aa%e8%81%8a%e5%a4%a9%e4%b8%ad%e6%90%9c%e7%b4%a2"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs search messages &lt;span style="color:#98c379"&gt;&amp;#34;release&amp;#34;&lt;/span&gt; -c @durov&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;&lt;code&gt;-c&lt;/code&gt; 接受用户名、&lt;code&gt;t.me&lt;/code&gt; 链接、手机号或数字 ID。用 &lt;code&gt;--from&lt;/code&gt;、&lt;code&gt;--filter&lt;/code&gt; 以及 &lt;code&gt;--after&lt;/code&gt; / &lt;code&gt;--before&lt;/code&gt; 缩小结果范围。&lt;/p&gt;
&lt;h2 id="5-全局搜索"&gt;5. 全局搜索&lt;a class="anchor" href="#5-%e5%85%a8%e5%b1%80%e6%90%9c%e7%b4%a2"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;不确定在哪个聊天里？一次搜索全部：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs search global &lt;span style="color:#98c379"&gt;&amp;#34;meeting notes&amp;#34;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;这就是核心流程。每条命令都输出 JSON——可以管道传给 &lt;code&gt;jq&lt;/code&gt; 或交给 AI 代理。深入了解请看&lt;a href="https://garenal1v3.github.io/tgs-cli/zh/guide/search/"&gt;搜索指南&lt;/a&gt;。&lt;/p&gt;</description></item><item><title>tgs login</title><link>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/auth/login/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/auth/login/</guid><description>&lt;h1 id="tgs-login"&gt;tgs login&lt;a class="anchor" href="#tgs-login"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;对 Telegram 进行身份验证。会话保存在本地，后续所有命令自动复用。&lt;/p&gt;
&lt;h2 id="用法"&gt;用法&lt;a class="anchor" href="#%e7%94%a8%e6%b3%95"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;tgs login [flags]&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id="参数"&gt;参数&lt;a class="anchor" href="#%e5%8f%82%e6%95%b0"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;Flag&lt;/th&gt;
 &lt;th&gt;Short&lt;/th&gt;
 &lt;th&gt;Default&lt;/th&gt;
 &lt;th&gt;Description&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--type&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-T&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;desktop&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Auth method: &lt;code&gt;desktop&lt;/code&gt;, &lt;code&gt;code&lt;/code&gt;, or &lt;code&gt;qr&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--desktop-dir&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-d&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;(auto-detect)&lt;/td&gt;
 &lt;td&gt;Path to Telegram Desktop tdata directory&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--passcode&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;Telegram Desktop local passcode&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--phone&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;Phone number for &lt;code&gt;code&lt;/code&gt; method&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--code&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;Verification code (for non-interactive login)&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--password&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;2FA cloud password&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--profile&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-p&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;(resolved)&lt;/td&gt;
 &lt;td&gt;Profile name to authenticate into&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;

&lt;p&gt;未设置 &lt;code&gt;--profile&lt;/code&gt; 时的配置文件解析顺序：&lt;code&gt;TGS_PROFILE&lt;/code&gt; 环境变量 → &lt;code&gt;.tgs.yaml&lt;/code&gt; 文件 → &lt;code&gt;&amp;quot;default&amp;quot;&lt;/code&gt;。&lt;/p&gt;</description></item><item><title>tgs profile</title><link>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/account/profile/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/account/profile/</guid><description>&lt;h1 id="tgs-profile"&gt;tgs profile&lt;a class="anchor" href="#tgs-profile"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;管理账户配置文件。&lt;/p&gt;
&lt;h2 id="用法"&gt;用法&lt;a class="anchor" href="#%e7%94%a8%e6%b3%95"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;tgs profile &amp;lt;subcommand&amp;gt; [flags]&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id="子命令"&gt;子命令&lt;a class="anchor" href="#%e5%ad%90%e5%91%bd%e4%bb%a4"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;h3 id="tgs-profile-list"&gt;tgs profile list&lt;a class="anchor" href="#tgs-profile-list"&gt;#&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;列出所有配置文件及其关联的账户信息。&lt;/p&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;tgs profile list [flags]&lt;/code&gt;&lt;/pre&gt;&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;Flag&lt;/th&gt;
 &lt;th&gt;Short&lt;/th&gt;
 &lt;th&gt;Default&lt;/th&gt;
 &lt;th&gt;Description&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--output&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-o&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;json&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Output format: &lt;code&gt;json&lt;/code&gt;, &lt;code&gt;text&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs profile list
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs profile list --output text&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;pre tabindex="0"&gt;&lt;code&gt;* default (@myuser)
 work (@workuser)&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;JSON（默认）：&lt;/strong&gt;&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-json" data-lang="json"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;[
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&lt;span style="color:#e06c75"&gt;&amp;#34;name&amp;#34;&lt;/span&gt;:&lt;span style="color:#98c379"&gt;&amp;#34;default&amp;#34;&lt;/span&gt;,&lt;span style="color:#e06c75"&gt;&amp;#34;phone&amp;#34;&lt;/span&gt;:&lt;span style="color:#98c379"&gt;&amp;#34;+79001234567&amp;#34;&lt;/span&gt;,&lt;span style="color:#e06c75"&gt;&amp;#34;username&amp;#34;&lt;/span&gt;:&lt;span style="color:#98c379"&gt;&amp;#34;alice&amp;#34;&lt;/span&gt;,&lt;span style="color:#e06c75"&gt;&amp;#34;id&amp;#34;&lt;/span&gt;:&lt;span style="color:#d19a66"&gt;261054642&lt;/span&gt;,&lt;span style="color:#e06c75"&gt;&amp;#34;active&amp;#34;&lt;/span&gt;:&lt;span style="color:#e5c07b"&gt;true&lt;/span&gt;},
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {&lt;span style="color:#e06c75"&gt;&amp;#34;name&amp;#34;&lt;/span&gt;:&lt;span style="color:#98c379"&gt;&amp;#34;work&amp;#34;&lt;/span&gt;,&lt;span style="color:#e06c75"&gt;&amp;#34;phone&amp;#34;&lt;/span&gt;:&lt;span style="color:#98c379"&gt;&amp;#34;+79001230000&amp;#34;&lt;/span&gt;,&lt;span style="color:#e06c75"&gt;&amp;#34;username&amp;#34;&lt;/span&gt;:&lt;span style="color:#98c379"&gt;&amp;#34;alice_work&amp;#34;&lt;/span&gt;,&lt;span style="color:#e06c75"&gt;&amp;#34;id&amp;#34;&lt;/span&gt;:&lt;span style="color:#d19a66"&gt;342178890&lt;/span&gt;,&lt;span style="color:#e06c75"&gt;&amp;#34;active&amp;#34;&lt;/span&gt;:&lt;span style="color:#e5c07b"&gt;false&lt;/span&gt;}
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;]&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;strong&gt;文本（&lt;code&gt;--output text&lt;/code&gt;）：&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;* default (@alice)
 work (@alice_work)&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;文本输出中用 &lt;code&gt;*&lt;/code&gt; 标记当前活跃的配置文件，JSON 中标记为 &lt;code&gt;&amp;quot;active&amp;quot;: true&lt;/code&gt;。若未缓存 username 和 phone，则只显示配置文件名。&lt;/p&gt;
&lt;hr&gt;
&lt;h3 id="tgs-profile-switch"&gt;tgs profile switch&lt;a class="anchor" href="#tgs-profile-switch"&gt;#&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;通过写入 &lt;code&gt;.tgs.yaml&lt;/code&gt; 文件来设置当前目录的活跃配置文件。&lt;/p&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;tgs profile switch &amp;lt;name&amp;gt;&lt;/code&gt;&lt;/pre&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs profile switch work
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs profile switch default&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e06c75"&gt;profile&lt;/span&gt;: &amp;lt;name&amp;gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;&lt;strong&gt;JSON（默认）：&lt;/strong&gt;&lt;/p&gt;</description></item><item><title>tgs search messages</title><link>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/search/messages/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/search/messages/</guid><description>&lt;h1 id="tgs-search-messages"&gt;tgs search messages&lt;a class="anchor" href="#tgs-search-messages"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;在一个或多个聊天、频道或群组中搜索消息。&lt;/p&gt;
&lt;h2 id="用法"&gt;用法&lt;a class="anchor" href="#%e7%94%a8%e6%b3%95"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;tgs search messages [query] [flags]&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;code&gt;query&lt;/code&gt; 参数为必填项，指定要搜索的文本。&lt;/p&gt;
&lt;h2 id="参数"&gt;参数&lt;a class="anchor" href="#%e5%8f%82%e6%95%b0"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;参数&lt;/th&gt;
 &lt;th&gt;缩写&lt;/th&gt;
 &lt;th&gt;类型&lt;/th&gt;
 &lt;th&gt;默认值&lt;/th&gt;
 &lt;th&gt;说明&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--chat&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-c&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;string[]&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;要搜索的聊天（用户名、电话、ID；可重复使用，支持逗号分隔）。未设置 &lt;code&gt;--folder&lt;/code&gt; 时必填。&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--folder&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;&amp;quot;&amp;quot;&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;搜索此文件夹内的所有聊天（id 或名称）；文件夹中的对等体与 &lt;code&gt;--chat&lt;/code&gt; 累加&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--from&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-f&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;按发送者筛选（用户名、电话或 ID）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--filter&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;消息类型过滤器（参见&lt;a href="#%e8%bf%87%e6%bb%a4%e5%99%a8%e5%80%bc"&gt;过滤器值&lt;/a&gt;）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--after&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;仅返回此日期之后的消息（YYYY-MM-DD 或 unix 时间戳）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--before&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;仅返回此日期之前的消息（YYYY-MM-DD 或 unix 时间戳）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--topic&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;int&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;0&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;论坛主题 ID&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--limit&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-l&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;int&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;50&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;最大返回消息数（1-100）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--cursor&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;上次响应中的分页游标&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--max-wait&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;int&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;60&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;FLOOD_WAIT 最大等待秒数&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--no-cache&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;bool&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;禁用对等体解析缓存&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--include-comments&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;bool&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;同时搜索每个频道关联的讨论组&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--profile&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-p&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;账户配置文件名称&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;未设置 &lt;code&gt;--profile&lt;/code&gt; 时的配置文件解析顺序：&lt;code&gt;TGS_PROFILE&lt;/code&gt; 环境变量 -&amp;gt; &lt;code&gt;.tgs.yaml&lt;/code&gt; 文件 -&amp;gt; &lt;code&gt;&amp;quot;default&amp;quot;&lt;/code&gt;。&lt;/p&gt;</description></item><item><title>tgs sources list</title><link>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/sources/list/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/sources/list/</guid><description>&lt;h1 id="tgs-sources-list"&gt;tgs sources list&lt;a class="anchor" href="#tgs-sources-list"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;枚举您账户中的所有 Telegram 对话——频道、超级群组、普通群组、用户和机器人。&lt;/p&gt;
&lt;h2 id="用法"&gt;用法&lt;a class="anchor" href="#%e7%94%a8%e6%b3%95"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;tgs sources list [flags]&lt;/code&gt;&lt;/pre&gt;&lt;h2 id="参数"&gt;参数&lt;a class="anchor" href="#%e5%8f%82%e6%95%b0"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;参数&lt;/th&gt;
 &lt;th&gt;缩写&lt;/th&gt;
 &lt;th&gt;类型&lt;/th&gt;
 &lt;th&gt;默认值&lt;/th&gt;
 &lt;th&gt;说明&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--type&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string[]&lt;/td&gt;
 &lt;td&gt;（全部）&lt;/td&gt;
 &lt;td&gt;按类型筛选：&lt;code&gt;channel&lt;/code&gt;、&lt;code&gt;supergroup&lt;/code&gt;、&lt;code&gt;group&lt;/code&gt;、&lt;code&gt;user&lt;/code&gt;、&lt;code&gt;bot&lt;/code&gt;（可重复使用，支持逗号分隔）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--with-stats&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;bool&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;为每个来源获取扩展统计信息（总消息数/24h/首条消息 + 完整信息）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--limit&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-l&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;int&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;0&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;最大返回记录数（1-500，0=全部）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--cursor&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;上次响应中的分页游标&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--folder&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;&amp;quot;&amp;quot;&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;仅返回此文件夹内的聊天（id 或名称），包含已归档的聊天；与 &lt;code&gt;--cursor&lt;/code&gt; 不兼容&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--archived&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;bool&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;包含已归档的对话（设置 &lt;code&gt;--folder&lt;/code&gt; 时忽略——文件夹本身已包含其归档聊天）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--max-wait&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;int&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;60&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;FLOOD_WAIT 最大等待秒数&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--no-cache&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;bool&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;禁用对等体和统计缓存&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--profile&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-p&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;账户配置文件名称&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;未设置 &lt;code&gt;--profile&lt;/code&gt; 时的配置文件解析顺序：&lt;code&gt;TGS_PROFILE&lt;/code&gt; 环境变量 -&amp;gt; &lt;code&gt;.tgs.yaml&lt;/code&gt; 文件 -&amp;gt; &lt;code&gt;&amp;quot;default&amp;quot;&lt;/code&gt;。&lt;/p&gt;</description></item><item><title>身份验证</title><link>https://garenal1v3.github.io/tgs-cli/zh/getting-started/authentication/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/getting-started/authentication/</guid><description>&lt;h1 id="身份验证"&gt;身份验证&lt;a class="anchor" href="#%e8%ba%ab%e4%bb%bd%e9%aa%8c%e8%af%81"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;tgs 通过 MTProto 协议使用您的真实用户账户连接到 Telegram。每个配置文件只需认证一次——会话保存在本地，后续命令自动复用。&lt;/p&gt;
&lt;h2 id="快速开始"&gt;快速开始&lt;a class="anchor" href="#%e5%bf%ab%e9%80%9f%e5%bc%80%e5%a7%8b"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;默认方式是从已有的 Telegram Desktop 客户端导入会话：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs login&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;或选择其他登录方式：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs login --type code &lt;span style="color:#7f848e"&gt;# Phone number + SMS/Telegram code&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs login --type qr &lt;span style="color:#7f848e"&gt;# Scan QR code from another device&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;h2 id="登录方式"&gt;登录方式&lt;a class="anchor" href="#%e7%99%bb%e5%bd%95%e6%96%b9%e5%bc%8f"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;h3 id="desktop-导入默认"&gt;Desktop 导入（默认）&lt;a class="anchor" href="#desktop-%e5%af%bc%e5%85%a5%e9%bb%98%e8%ae%a4"&gt;#&lt;/a&gt;&lt;/h3&gt;
&lt;p&gt;从 Telegram Desktop 导入现有会话。tgs 会自动检测 macOS、Linux 和 Windows 上的 tdata 目录。&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# Auto-detect Telegram Desktop data&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs login
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# Custom tdata path&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs login --desktop-dir /path/to/tdata
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# Passcode-protected Telegram Desktop client&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs login --passcode SECRET&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;无需输入手机号或验证码——会话直接传输。&lt;/p&gt;</description></item><item><title>tgs logout</title><link>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/auth/logout/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/auth/logout/</guid><description>&lt;h1 id="tgs-logout"&gt;tgs logout&lt;a class="anchor" href="#tgs-logout"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;在 Telegram 服务器上撤销当前会话，并清除本地会话数据。&lt;/p&gt;
&lt;h2 id="用法"&gt;用法&lt;a class="anchor" href="#%e7%94%a8%e6%b3%95"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;tgs logout [flags]&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id="参数"&gt;参数&lt;a class="anchor" href="#%e5%8f%82%e6%95%b0"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;Flag&lt;/th&gt;
 &lt;th&gt;Short&lt;/th&gt;
 &lt;th&gt;Default&lt;/th&gt;
 &lt;th&gt;Description&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--profile&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-p&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;(resolved)&lt;/td&gt;
 &lt;td&gt;Profile to log out from&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;

&lt;p&gt;未设置 &lt;code&gt;--profile&lt;/code&gt; 时的配置文件解析顺序：&lt;code&gt;TGS_PROFILE&lt;/code&gt; 环境变量 → &lt;code&gt;.tgs.yaml&lt;/code&gt; 文件 → &lt;code&gt;&amp;quot;default&amp;quot;&lt;/code&gt;。&lt;/p&gt;
&lt;h2 id="示例"&gt;示例&lt;a class="anchor" href="#%e7%a4%ba%e4%be%8b"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# Logout the current profile&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs &lt;span style="color:#e5c07b"&gt;logout&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# Logout a specific profile&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs &lt;span style="color:#e5c07b"&gt;logout&lt;/span&gt; --profile work&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;h2 id="输出"&gt;输出&lt;a class="anchor" href="#%e8%be%93%e5%87%ba"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;JSON（默认）：&lt;/strong&gt;&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-json" data-lang="json"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{&lt;span style="color:#e06c75"&gt;&amp;#34;profile&amp;#34;&lt;/span&gt;:&lt;span style="color:#98c379"&gt;&amp;#34;default&amp;#34;&lt;/span&gt;,&lt;span style="color:#e06c75"&gt;&amp;#34;status&amp;#34;&lt;/span&gt;:&lt;span style="color:#98c379"&gt;&amp;#34;logged_out&amp;#34;&lt;/span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;strong&gt;文本（&lt;code&gt;--output text&lt;/code&gt;）：&lt;/strong&gt;&lt;/p&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;Logged out (profile: default)&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;若配置文件未登录，命令以非零退出码结束并将错误写入 stderr。&lt;/p&gt;
&lt;h2 id="说明"&gt;说明&lt;a class="anchor" href="#%e8%af%b4%e6%98%8e"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;退出登录执行两个步骤：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;调用 Telegram API 撤销会话令牌（会话在 Telegram 服务器端失效）&lt;/li&gt;
&lt;li&gt;清除该配置文件的本地会话数据库&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;退出后，必须重新运行 &lt;code&gt;tgs login&lt;/code&gt; 才能继续使用该配置文件。&lt;/p&gt;
&lt;h2 id="另请参阅"&gt;另请参阅&lt;a class="anchor" href="#%e5%8f%a6%e8%af%b7%e5%8f%82%e9%98%85"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href="https://garenal1v3.github.io/tgs-cli/zh/reference/commands/auth/login/"&gt;tgs login&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;&lt;a href="https://garenal1v3.github.io/tgs-cli/zh/getting-started/authentication/"&gt;身份验证指南&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;</description></item><item><title>tgs search global</title><link>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/search/global/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/search/global/</guid><description>&lt;h1 id="tgs-search-global"&gt;tgs search global&lt;a class="anchor" href="#tgs-search-global"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;在所有聊天、频道和群组中全局搜索消息。&lt;/p&gt;
&lt;h2 id="用法"&gt;用法&lt;a class="anchor" href="#%e7%94%a8%e6%b3%95"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;tgs search global [query] [flags]&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;code&gt;query&lt;/code&gt; 参数为必填项，指定要搜索的文本。&lt;/p&gt;
&lt;h2 id="参数"&gt;参数&lt;a class="anchor" href="#%e5%8f%82%e6%95%b0"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;参数&lt;/th&gt;
 &lt;th&gt;缩写&lt;/th&gt;
 &lt;th&gt;类型&lt;/th&gt;
 &lt;th&gt;默认值&lt;/th&gt;
 &lt;th&gt;说明&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--channels-only&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;bool&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;仅在频道中搜索；与 &lt;code&gt;--folder&lt;/code&gt; 不兼容&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--groups-only&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;bool&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;仅在群组中搜索；与 &lt;code&gt;--folder&lt;/code&gt; 不兼容&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--users-only&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;bool&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;仅在私聊中搜索；与 &lt;code&gt;--folder&lt;/code&gt; 不兼容&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--archived&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;bool&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;在归档中搜索（文件夹 ID 1）；设置 &lt;code&gt;--folder&lt;/code&gt; 时忽略&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--folder&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;&amp;quot;&amp;quot;&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;仅在此文件夹中搜索（id 或名称），包含已归档的聊天；与 &lt;code&gt;--channels-only&lt;/code&gt;、&lt;code&gt;--groups-only&lt;/code&gt;、&lt;code&gt;--users-only&lt;/code&gt; 不兼容&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--filter&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;消息类型过滤器（参见&lt;a href="https://garenal1v3.github.io/tgs-cli/zh/reference/commands/search/messages/#%e8%bf%87%e6%bb%a4%e5%99%a8%e5%80%bc"&gt;过滤器值&lt;/a&gt;）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--after&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;仅返回此日期之后的消息（YYYY-MM-DD 或 unix 时间戳）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--before&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;仅返回此日期之前的消息（YYYY-MM-DD 或 unix 时间戳）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--limit&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-l&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;int&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;50&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;最大返回消息数（1-100）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--cursor&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;上次响应中的分页游标&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--max-wait&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;int&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;60&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;FLOOD_WAIT 最大等待秒数&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--profile&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-p&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;账户配置文件名称&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;未设置 &lt;code&gt;--profile&lt;/code&gt; 时的配置文件解析顺序：&lt;code&gt;TGS_PROFILE&lt;/code&gt; 环境变量 -&amp;gt; &lt;code&gt;.tgs.yaml&lt;/code&gt; 文件 -&amp;gt; &lt;code&gt;&amp;quot;default&amp;quot;&lt;/code&gt;。&lt;/p&gt;</description></item><item><title>tgs sources inspect</title><link>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/sources/inspect/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/sources/inspect/</guid><description>&lt;h1 id="tgs-sources-inspect"&gt;tgs sources inspect&lt;a class="anchor" href="#tgs-sources-inspect"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;获取单个 Telegram 来源的详细信息。适用于您已订阅的来源，也适用于您未加入的公开频道。&lt;/p&gt;
&lt;h2 id="用法"&gt;用法&lt;a class="anchor" href="#%e7%94%a8%e6%b3%95"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;tgs sources inspect &amp;lt;ref&amp;gt; [flags]&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;&lt;code&gt;ref&lt;/code&gt; 参数用于标识目标来源，支持以下格式：&lt;/p&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;格式&lt;/th&gt;
 &lt;th&gt;示例&lt;/th&gt;
 &lt;th&gt;说明&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;@username&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;@durov&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;带 &lt;code&gt;@&lt;/code&gt; 前缀的公开用户名&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;username&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;durov&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;不带前缀的公开用户名&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;id:&amp;lt;n&amp;gt;&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;id:-1001234567890&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Telegram 对等体 ID（推荐用于负数 ID——pflag 会把裸 &lt;code&gt;-N&lt;/code&gt; 当作旗标）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;数字 ID&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;12345&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;正数对等体 ID。对于负数请使用上面的 &lt;code&gt;id:&lt;/code&gt; 形式，或插入 &lt;code&gt;--&lt;/code&gt;（例如 &lt;code&gt;inspect -- -1001234567890&lt;/code&gt;）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;电话号码&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;+79001234567&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;用于联系人或您自己的账户&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;-&lt;/code&gt; 或 &lt;code&gt;@me&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;收藏夹（&amp;ldquo;Saved Messages&amp;rdquo;）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;h2 id="参数"&gt;参数&lt;a class="anchor" href="#%e5%8f%82%e6%95%b0"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;参数&lt;/th&gt;
 &lt;th&gt;缩写&lt;/th&gt;
 &lt;th&gt;类型&lt;/th&gt;
 &lt;th&gt;默认值&lt;/th&gt;
 &lt;th&gt;说明&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--no-stats&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;bool&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;跳过扩展统计（总消息数/24h/首条消息）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--no-cache&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;bool&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;禁用对等体和统计缓存&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--max-wait&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;int&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;60&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;FLOOD_WAIT 最大等待秒数&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--profile&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-p&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;账户配置文件名称&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;未设置 &lt;code&gt;--profile&lt;/code&gt; 时的配置文件解析顺序：&lt;code&gt;TGS_PROFILE&lt;/code&gt; 环境变量 -&amp;gt; &lt;code&gt;.tgs.yaml&lt;/code&gt; 文件 -&amp;gt; &lt;code&gt;&amp;quot;default&amp;quot;&lt;/code&gt;。&lt;/p&gt;</description></item><item><title>tgs whoami</title><link>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/account/whoami/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/account/whoami/</guid><description>&lt;h1 id="tgs-whoami"&gt;tgs whoami&lt;a class="anchor" href="#tgs-whoami"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;显示当前配置文件名称和账户信息。从本地存储读取——无需连接 Telegram。&lt;/p&gt;
&lt;h2 id="用法"&gt;用法&lt;a class="anchor" href="#%e7%94%a8%e6%b3%95"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;tgs whoami [flags]&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id="参数"&gt;参数&lt;a class="anchor" href="#%e5%8f%82%e6%95%b0"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;Flag&lt;/th&gt;
 &lt;th&gt;Short&lt;/th&gt;
 &lt;th&gt;Default&lt;/th&gt;
 &lt;th&gt;Description&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--profile&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-p&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;(resolved)&lt;/td&gt;
 &lt;td&gt;Profile to inspect&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--output&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-o&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;json&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Output format: &lt;code&gt;json&lt;/code&gt;, &lt;code&gt;text&lt;/code&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;

&lt;p&gt;未设置 &lt;code&gt;--profile&lt;/code&gt; 时的配置文件解析顺序：&lt;code&gt;TGS_PROFILE&lt;/code&gt; 环境变量 → &lt;code&gt;.tgs.yaml&lt;/code&gt; 文件 → &lt;code&gt;&amp;quot;default&amp;quot;&lt;/code&gt;。&lt;/p&gt;
&lt;h2 id="示例"&gt;示例&lt;a class="anchor" href="#%e7%a4%ba%e4%be%8b"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# Show current profile (JSON output)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs whoami
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# Human-readable output&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs whoami --output text
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# Inspect a specific profile&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs whoami --profile work
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# Inspect a profile with text output&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs whoami --profile work --output text&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;h2 id="输出"&gt;输出&lt;a class="anchor" href="#%e8%be%93%e5%87%ba"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;文本输出 (&lt;code&gt;--output text&lt;/code&gt;)：&lt;/strong&gt;&lt;/p&gt;</description></item><item><title>配置文件</title><link>https://garenal1v3.github.io/tgs-cli/zh/guide/profiles/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/guide/profiles/</guid><description>&lt;h1 id="配置文件"&gt;配置文件&lt;a class="anchor" href="#%e9%85%8d%e7%bd%ae%e6%96%87%e4%bb%b6"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;tgs 通过配置文件支持多个 Telegram 账户——类似于 AWS CLI 管理凭证的方式。每个配置文件拥有独立的会话，存储在单独的数据库文件中。&lt;/p&gt;
&lt;h2 id="配置文件解析顺序"&gt;配置文件解析顺序&lt;a class="anchor" href="#%e9%85%8d%e7%bd%ae%e6%96%87%e4%bb%b6%e8%a7%a3%e6%9e%90%e9%a1%ba%e5%ba%8f"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;运行任何 tgs 命令时，活跃配置文件按以下优先级确定（从高到低）：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;传递给命令的 &lt;code&gt;--profile&lt;/code&gt; 参数&lt;/li&gt;
&lt;li&gt;&lt;code&gt;TGS_PROFILE&lt;/code&gt; 环境变量&lt;/li&gt;
&lt;li&gt;当前目录或父目录中的 &lt;code&gt;.tgs.yaml&lt;/code&gt; 文件&lt;/li&gt;
&lt;li&gt;&lt;code&gt;&amp;quot;default&amp;quot;&lt;/code&gt;（默认值）&lt;/li&gt;
&lt;/ol&gt;
&lt;h2 id="按目录绑定配置文件"&gt;按目录绑定配置文件&lt;a class="anchor" href="#%e6%8c%89%e7%9b%ae%e5%bd%95%e7%bb%91%e5%ae%9a%e9%85%8d%e7%bd%ae%e6%96%87%e4%bb%b6"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;您可以通过创建 &lt;code&gt;.tgs.yaml&lt;/code&gt; 文件将配置文件绑定到特定目录。使用 &lt;code&gt;tgs profile switch&lt;/code&gt; 可自动完成此操作：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e5c07b"&gt;cd&lt;/span&gt; ~/projects/work-project
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs profile switch work&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-yaml" data-lang="yaml"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e06c75"&gt;profile&lt;/span&gt;: work&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;tgs 会沿目录树向上查找 &lt;code&gt;.tgs.yaml&lt;/code&gt;，因此它在所有子目录中同样生效。这是为不同项目使用不同账户的推荐方式。&lt;/p&gt;
&lt;h2 id="管理配置文件"&gt;管理配置文件&lt;a class="anchor" href="#%e7%ae%a1%e7%90%86%e9%85%8d%e7%bd%ae%e6%96%87%e4%bb%b6"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;h3 id="列出配置文件"&gt;列出配置文件&lt;a class="anchor" href="#%e5%88%97%e5%87%ba%e9%85%8d%e7%bd%ae%e6%96%87%e4%bb%b6"&gt;#&lt;/a&gt;&lt;/h3&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs profile list&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;pre tabindex="0"&gt;&lt;code&gt;* default (@myuser)
 work (@workuser)&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;code&gt;*&lt;/code&gt; 标记当前活跃的配置文件。默认使用 JSON 格式输出，包含 &lt;code&gt;active&lt;/code&gt; 字段。&lt;/p&gt;
&lt;h3 id="切换当前目录的配置文件"&gt;切换当前目录的配置文件&lt;a class="anchor" href="#%e5%88%87%e6%8d%a2%e5%bd%93%e5%89%8d%e7%9b%ae%e5%bd%95%e7%9a%84%e9%85%8d%e7%bd%ae%e6%96%87%e4%bb%b6"&gt;#&lt;/a&gt;&lt;/h3&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs profile switch work&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;在当前目录创建或覆盖 &lt;code&gt;.tgs.yaml&lt;/code&gt; 文件。&lt;/p&gt;
&lt;h3 id="删除配置文件"&gt;删除配置文件&lt;a class="anchor" href="#%e5%88%a0%e9%99%a4%e9%85%8d%e7%bd%ae%e6%96%87%e4%bb%b6"&gt;#&lt;/a&gt;&lt;/h3&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs profile delete old-account&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs profile switch default
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs profile delete work&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;删除配置文件目录及其会话数据库。无法删除当前活跃的配置文件——请先切换到其他配置文件。&lt;/p&gt;</description></item><item><title>tgs search counters</title><link>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/search/counters/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/search/counters/</guid><description>&lt;h1 id="tgs-search-counters"&gt;tgs search counters&lt;a class="anchor" href="#tgs-search-counters"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;获取一个或多个聊天中按类型分组的消息计数（照片、视频、文档等）。&lt;/p&gt;
&lt;h2 id="用法"&gt;用法&lt;a class="anchor" href="#%e7%94%a8%e6%b3%95"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;tgs search counters [flags]&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;此命令不接受位置参数。&lt;/p&gt;
&lt;h2 id="参数"&gt;参数&lt;a class="anchor" href="#%e5%8f%82%e6%95%b0"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;参数&lt;/th&gt;
 &lt;th&gt;缩写&lt;/th&gt;
 &lt;th&gt;类型&lt;/th&gt;
 &lt;th&gt;默认值&lt;/th&gt;
 &lt;th&gt;说明&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--chat&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-c&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;要查询的聊天（用户名、电话或 ID）。未设置 &lt;code&gt;--folder&lt;/code&gt; 时必填。&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--folder&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;&amp;quot;&amp;quot;&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;查询此文件夹内的所有聊天（id 或名称）；输出包含按聊天分组的明细及汇总数据&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--topic&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;int&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;0&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;论坛主题 ID&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--filters&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string[]&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;要统计的过滤器类型（逗号分隔；默认：全部）。参见&lt;a href="https://garenal1v3.github.io/tgs-cli/zh/reference/commands/search/messages/#%e8%bf%87%e6%bb%a4%e5%99%a8%e5%80%bc"&gt;过滤器值&lt;/a&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--max-wait&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;int&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;60&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;FLOOD_WAIT 最大等待秒数&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--no-cache&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;bool&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;禁用对等体解析缓存&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--profile&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-p&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;账户配置文件名称&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;未设置 &lt;code&gt;--profile&lt;/code&gt; 时的配置文件解析顺序：&lt;code&gt;TGS_PROFILE&lt;/code&gt; 环境变量 -&amp;gt; &lt;code&gt;.tgs.yaml&lt;/code&gt; 文件 -&amp;gt; &lt;code&gt;&amp;quot;default&amp;quot;&lt;/code&gt;。&lt;/p&gt;
&lt;h2 id="示例"&gt;示例&lt;a class="anchor" href="#%e7%a4%ba%e4%be%8b"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;获取频道中所有消息类型的计数：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs search counters -c @golang&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;获取特定类型的计数：&lt;/p&gt;</description></item><item><title>tgs sources folders</title><link>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/sources/folders/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/sources/folders/</guid><description>&lt;h1 id="tgs-sources-folders"&gt;tgs sources folders&lt;a class="anchor" href="#tgs-sources-folders"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;枚举用户的 Telegram &lt;strong&gt;文件夹&lt;/strong&gt;（UI 中的对话筛选器），并按 Telegram 客户端的方式
解析每个文件夹的内容——将置顶/包含/排除的对等体及自动规则（联系人、群组等）
应用到完整的对话列表。&lt;/p&gt;
&lt;p&gt;默认的&amp;quot;所有聊天&amp;quot;文件夹不会出现在输出中；只有用户自定义的文件夹和共享聊天列表才会显示。&lt;/p&gt;
&lt;h2 id="用法"&gt;用法&lt;a class="anchor" href="#%e7%94%a8%e6%b3%95"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;tgs sources folders [flags]&lt;/code&gt;&lt;/pre&gt;
&lt;h2 id="参数"&gt;参数&lt;a class="anchor" href="#%e5%8f%82%e6%95%b0"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;Flag&lt;/th&gt;
 &lt;th&gt;Short&lt;/th&gt;
 &lt;th&gt;Type&lt;/th&gt;
 &lt;th&gt;Default&lt;/th&gt;
 &lt;th&gt;Description&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--max-wait&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;int&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;60&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Max seconds to wait on FLOOD_WAIT&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--no-cache&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;bool&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Disable peer cache&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--profile&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-p&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;Account profile name&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;

&lt;p&gt;未设置 &lt;code&gt;--profile&lt;/code&gt; 时的配置文件解析顺序：&lt;code&gt;TGS_PROFILE&lt;/code&gt; 环境变量 -&amp;gt; &lt;code&gt;.tgs.yaml&lt;/code&gt; 文件 -&amp;gt; &lt;code&gt;&amp;quot;default&amp;quot;&lt;/code&gt;。&lt;/p&gt;
&lt;h2 id="示例"&gt;示例&lt;a class="anchor" href="#%e7%a4%ba%e4%be%8b"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# List all user-defined folders and their contents&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs sources folders
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# Disable peer cache (force fresh data)&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs sources folders --no-cache
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# Use a specific profile&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs sources folders --profile secondary&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;h2 id="输出"&gt;输出&lt;a class="anchor" href="#%e8%be%93%e5%87%ba"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-json" data-lang="json"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;folders&amp;#34;&lt;/span&gt;: [
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;id&amp;#34;&lt;/span&gt;: &lt;span style="color:#d19a66"&gt;2&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;kind&amp;#34;&lt;/span&gt;: &lt;span style="color:#98c379"&gt;&amp;#34;custom&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;title&amp;#34;&lt;/span&gt;: &lt;span style="color:#98c379"&gt;&amp;#34;Crypto&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;emoticon&amp;#34;&lt;/span&gt;: &lt;span style="color:#98c379"&gt;&amp;#34;💰&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;chats_count&amp;#34;&lt;/span&gt;: &lt;span style="color:#d19a66"&gt;12&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;chats&amp;#34;&lt;/span&gt;: [
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;id&amp;#34;&lt;/span&gt;: &lt;span style="color:#d19a66"&gt;-1001234567890&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;type&amp;#34;&lt;/span&gt;: &lt;span style="color:#98c379"&gt;&amp;#34;channel&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;title&amp;#34;&lt;/span&gt;: &lt;span style="color:#98c379"&gt;&amp;#34;BTC News&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;username&amp;#34;&lt;/span&gt;: &lt;span style="color:#98c379"&gt;&amp;#34;btcnews&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;unread_count&amp;#34;&lt;/span&gt;: &lt;span style="color:#d19a66"&gt;3&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;pinned&amp;#34;&lt;/span&gt;: &lt;span style="color:#e5c07b"&gt;true&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;last_message&amp;#34;&lt;/span&gt;: {&lt;span style="color:#e06c75"&gt;&amp;#34;id&amp;#34;&lt;/span&gt;: &lt;span style="color:#d19a66"&gt;9876&lt;/span&gt;, &lt;span style="color:#e06c75"&gt;&amp;#34;date&amp;#34;&lt;/span&gt;: &lt;span style="color:#98c379"&gt;&amp;#34;2026-05-27T10:00:00Z&amp;#34;&lt;/span&gt;}
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; ]
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; },
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;id&amp;#34;&lt;/span&gt;: &lt;span style="color:#d19a66"&gt;5&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;kind&amp;#34;&lt;/span&gt;: &lt;span style="color:#98c379"&gt;&amp;#34;chatlist&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;title&amp;#34;&lt;/span&gt;: &lt;span style="color:#98c379"&gt;&amp;#34;Go Community&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;chats_count&amp;#34;&lt;/span&gt;: &lt;span style="color:#d19a66"&gt;8&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;chats&amp;#34;&lt;/span&gt;: []
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; ],
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;total&amp;#34;&lt;/span&gt;: &lt;span style="color:#d19a66"&gt;2&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;h3 id="文件夹字段"&gt;文件夹字段&lt;a class="anchor" href="#%e6%96%87%e4%bb%b6%e5%a4%b9%e5%ad%97%e6%ae%b5"&gt;#&lt;/a&gt;&lt;/h3&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;字段&lt;/th&gt;
 &lt;th&gt;类型&lt;/th&gt;
 &lt;th&gt;说明&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;id&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;int&lt;/td&gt;
 &lt;td&gt;Telegram 对话筛选器 ID&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;kind&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;custom&lt;/code&gt; 表示用户自定义文件夹；&lt;code&gt;chatlist&lt;/code&gt; 表示共享聊天列表&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;title&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;文件夹显示名称&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;emoticon&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;文件夹表情符号；未设置时省略&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;has_my_invites&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;bool&lt;/td&gt;
 &lt;td&gt;聊天列表包含您创建的邀请链接；仅在为 &lt;code&gt;true&lt;/code&gt; 时出现&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;chats_count&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;int&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;chats&lt;/code&gt; 数组中的聊天数量&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;chats&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;array&lt;/td&gt;
 &lt;td&gt;已解析的聊天条目（字段结构与 &lt;code&gt;sources list&lt;/code&gt; 来源相同）&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;total&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;int&lt;/td&gt;
 &lt;td&gt;返回的文件夹总数&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;code&gt;chats&lt;/code&gt; 内的聊天条目字段结构与
&lt;a href="https://garenal1v3.github.io/tgs-cli/zh/reference/commands/sources/list/"&gt;tgs sources list&lt;/a&gt; 中的来源相同。&lt;/p&gt;</description></item><item><title>搜索</title><link>https://garenal1v3.github.io/tgs-cli/zh/guide/search/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/guide/search/</guid><description>&lt;h1 id="搜索"&gt;搜索&lt;a class="anchor" href="#%e6%90%9c%e7%b4%a2"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;tgs 提供四个搜索子命令，它们直接对应 Telegram 的 MTProto 搜索方法。所有输出均为 JSON，便于通过管道传入 &lt;code&gt;jq&lt;/code&gt;、交给 AI 智能体或以编程方式处理。&lt;/p&gt;
&lt;h2 id="在聊天中搜索"&gt;在聊天中搜索&lt;a class="anchor" href="#%e5%9c%a8%e8%81%8a%e5%a4%a9%e4%b8%ad%e6%90%9c%e7%b4%a2"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;最常见的操作：在指定聊天中搜索消息。&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs search messages &lt;span style="color:#98c379"&gt;&amp;#34;docker compose&amp;#34;&lt;/span&gt; -c @devops_notes&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;查询参数为必填项。&lt;code&gt;-c&lt;/code&gt; / &lt;code&gt;--chat&lt;/code&gt; 标志指定在哪个聊天中搜索。所有支持的格式请参见下方的&lt;a href="#%e8%81%8a%e5%a4%a9%e8%a7%a3%e6%9e%90"&gt;聊天解析&lt;/a&gt;。&lt;/p&gt;
&lt;h2 id="多个聊天"&gt;多个聊天&lt;a class="anchor" href="#%e5%a4%9a%e4%b8%aa%e8%81%8a%e5%a4%a9"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;通过重复该标志或使用逗号分隔的值传入多个聊天：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# 重复标志&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs search messages &lt;span style="color:#98c379"&gt;&amp;#34;release&amp;#34;&lt;/span&gt; -c @frontend -c @backend
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# 逗号分隔&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs search messages &lt;span style="color:#98c379"&gt;&amp;#34;release&amp;#34;&lt;/span&gt; -c @frontend,@backend&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;tgs 会依次对每个聊天执行搜索，并将结果合并为一个 JSON 响应。&lt;/p&gt;
&lt;h2 id="按作者筛选"&gt;按作者筛选&lt;a class="anchor" href="#%e6%8c%89%e4%bd%9c%e8%80%85%e7%ad%9b%e9%80%89"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;使用 &lt;code&gt;--from&lt;/code&gt; / &lt;code&gt;-f&lt;/code&gt; 只显示来自特定发送者的消息：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs search messages &lt;span style="color:#98c379"&gt;&amp;#34;bug&amp;#34;&lt;/span&gt; -c @dev_chat --from @alice&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;&lt;code&gt;--from&lt;/code&gt; 的值接受与 &lt;code&gt;--chat&lt;/code&gt; 相同的格式（用户名、数字 ID、手机号或 &lt;code&gt;t.me&lt;/code&gt; 链接）。&lt;/p&gt;
&lt;h2 id="按内容类型筛选"&gt;按内容类型筛选&lt;a class="anchor" href="#%e6%8c%89%e5%86%85%e5%ae%b9%e7%b1%bb%e5%9e%8b%e7%ad%9b%e9%80%89"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;&lt;code&gt;--filter&lt;/code&gt; 标志将结果限定为特定的消息类型。共有 15 种可用过滤器：&lt;/p&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;过滤器&lt;/th&gt;
 &lt;th&gt;说明&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;photo&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;图片&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;video&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;视频&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;photo-video&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;图片和视频&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;document&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;文件和文档&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;url&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;包含链接的消息&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;gif&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;GIF 动图&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;voice&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;语音消息&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;music&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;音频文件 / 音乐&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;round-video&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;圆形视频消息&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;geo&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;位置和实时位置&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;contact&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;共享的联系人&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;pinned&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;置顶消息&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;mention&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;提及当前用户的消息&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;phone-call&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;通话记录&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;chat-photo&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;聊天头像变更&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;示例 —— 查找频道中的所有文档：&lt;/p&gt;</description></item><item><title>tgs search calendar</title><link>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/search/calendar/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/search/calendar/</guid><description>&lt;h1 id="tgs-search-calendar"&gt;tgs search calendar&lt;a class="anchor" href="#tgs-search-calendar"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;获取一个或多个聊天按日期分组的消息搜索结果。&lt;/p&gt;
&lt;h2 id="用法"&gt;用法&lt;a class="anchor" href="#%e7%94%a8%e6%b3%95"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;pre tabindex="0"&gt;&lt;code&gt;tgs search calendar [flags]&lt;/code&gt;&lt;/pre&gt;&lt;p&gt;此命令不接受位置参数。&lt;/p&gt;
&lt;h2 id="参数"&gt;参数&lt;a class="anchor" href="#%e5%8f%82%e6%95%b0"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;参数&lt;/th&gt;
 &lt;th&gt;缩写&lt;/th&gt;
 &lt;th&gt;类型&lt;/th&gt;
 &lt;th&gt;默认值&lt;/th&gt;
 &lt;th&gt;说明&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--chat&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-c&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;要查询的聊天（用户名、电话或 ID）。未设置 &lt;code&gt;--folder&lt;/code&gt; 时必填。&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--folder&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;&amp;quot;&amp;quot;&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;查询此文件夹内的所有聊天（id 或名称）；输出包含按聊天分组的数组及汇总数据&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--filter&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;消息类型过滤器（参见&lt;a href="https://garenal1v3.github.io/tgs-cli/zh/reference/commands/search/messages/#%e8%bf%87%e6%bb%a4%e5%99%a8%e5%80%bc"&gt;过滤器值&lt;/a&gt;）。&lt;strong&gt;必填。&lt;/strong&gt;&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--max-wait&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;int&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;60&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;FLOOD_WAIT 最大等待秒数&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--no-cache&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;bool&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;false&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;禁用对等体解析缓存&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;--profile&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;&lt;code&gt;-p&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;string&lt;/td&gt;
 &lt;td&gt;&lt;/td&gt;
 &lt;td&gt;账户配置文件名称&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;未设置 &lt;code&gt;--profile&lt;/code&gt; 时的配置文件解析顺序：&lt;code&gt;TGS_PROFILE&lt;/code&gt; 环境变量 -&amp;gt; &lt;code&gt;.tgs.yaml&lt;/code&gt; 文件 -&amp;gt; &lt;code&gt;&amp;quot;default&amp;quot;&lt;/code&gt;。&lt;/p&gt;
&lt;h2 id="示例"&gt;示例&lt;a class="anchor" href="#%e7%a4%ba%e4%be%8b"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;获取频道中照片消息的日历：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs search calendar -c @travel_photos --filter photo&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;获取群组中共享文档的日历：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs search calendar -c @dev_team --filter document&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;获取文件夹内所有聊天的照片日历：&lt;/p&gt;</description></item><item><title>来源</title><link>https://garenal1v3.github.io/tgs-cli/zh/guide/sources/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/guide/sources/</guid><description>&lt;h1 id="来源"&gt;来源&lt;a class="anchor" href="#%e6%9d%a5%e6%ba%90"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;&lt;code&gt;tgs sources&lt;/code&gt; 让您枚举并查看账户中的 Telegram 对话——频道、超级群组、普通群组、用户和机器人。所有输出均为 JSON 格式，可直接通过 &lt;code&gt;jq&lt;/code&gt; 处理或提供给 AI 代理。&lt;/p&gt;
&lt;blockquote class='book-hint '&gt;
&lt;p&gt;&lt;strong&gt;通过 &lt;code&gt;jq&lt;/code&gt; 解析时：&lt;/strong&gt; &lt;code&gt;tgs&lt;/code&gt; 把诊断日志（&lt;code&gt;[tgs] retry: …&lt;/code&gt;、&lt;code&gt;[tgs] FLOOD_WAIT: …&lt;/code&gt;）写入 &lt;strong&gt;stderr&lt;/strong&gt;，JSON 写入 &lt;strong&gt;stdout&lt;/strong&gt;。在管道传给 &lt;code&gt;jq&lt;/code&gt; 时请丢弃 stderr，以免解析失败：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs sources list --with-stats 2&amp;gt;/dev/null | jq &lt;span style="color:#98c379"&gt;&amp;#39;.sources[].title&amp;#39;&lt;/span&gt;&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;避免使用 &lt;code&gt;2&amp;gt;&amp;amp;1 | jq …&lt;/code&gt;——那会把日志混进 stdout 并破坏 JSON 解析。&lt;/p&gt;
&lt;/blockquote&gt;&lt;h2 id="列出所有来源"&gt;列出所有来源&lt;a class="anchor" href="#%e5%88%97%e5%87%ba%e6%89%80%e6%9c%89%e6%9d%a5%e6%ba%90"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;p&gt;最简单的调用方式会返回账户中的所有对话：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;tgs sources list&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;p&gt;响应为包含 &lt;code&gt;sources&lt;/code&gt; 数组、&lt;code&gt;total&lt;/code&gt; 总数和可选 &lt;code&gt;cursor&lt;/code&gt; 的 JSON 对象：&lt;/p&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-json" data-lang="json"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;{
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;sources&amp;#34;&lt;/span&gt;: [
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; {
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;id&amp;#34;&lt;/span&gt;: &lt;span style="color:#d19a66"&gt;-1001234567890&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;type&amp;#34;&lt;/span&gt;: &lt;span style="color:#98c379"&gt;&amp;#34;channel&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;title&amp;#34;&lt;/span&gt;: &lt;span style="color:#98c379"&gt;&amp;#34;Durov&amp;#39;s Channel&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;username&amp;#34;&lt;/span&gt;: &lt;span style="color:#98c379"&gt;&amp;#34;durov&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;access&amp;#34;&lt;/span&gt;: &lt;span style="color:#98c379"&gt;&amp;#34;public&amp;#34;&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;members_count&amp;#34;&lt;/span&gt;: &lt;span style="color:#d19a66"&gt;1234567&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;verified&amp;#34;&lt;/span&gt;: &lt;span style="color:#e5c07b"&gt;true&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;unread_count&amp;#34;&lt;/span&gt;: &lt;span style="color:#d19a66"&gt;0&lt;/span&gt;,
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;last_message&amp;#34;&lt;/span&gt;: {&lt;span style="color:#e06c75"&gt;&amp;#34;id&amp;#34;&lt;/span&gt;: &lt;span style="color:#d19a66"&gt;4321&lt;/span&gt;, &lt;span style="color:#e06c75"&gt;&amp;#34;date&amp;#34;&lt;/span&gt;: &lt;span style="color:#98c379"&gt;&amp;#34;2026-05-28T08:15:00Z&amp;#34;&lt;/span&gt;}
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; }
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; ],
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt; &lt;span style="color:#e06c75"&gt;&amp;#34;total&amp;#34;&lt;/span&gt;: &lt;span style="color:#d19a66"&gt;287&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;}&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;&lt;blockquote class='book-hint '&gt;
&lt;p&gt;&lt;strong&gt;&lt;code&gt;total&lt;/code&gt;&lt;/strong&gt; 是您账户中的对话总数（应用 &lt;code&gt;--type&lt;/code&gt; 筛选&lt;strong&gt;之前&lt;/strong&gt;）。CLI 保证 &lt;code&gt;total &amp;gt;= len(sources)&lt;/code&gt;（Telegram 自身的计数器有时已过期，我们会把 &lt;code&gt;total&lt;/code&gt; 抬升到实际返回的数量）。请勿用 &lt;code&gt;total&lt;/code&gt; 除以数组长度估算页数——请使用 &lt;code&gt;cursor&lt;/code&gt; 分页。&lt;/p&gt;</description></item><item><title>环境变量</title><link>https://garenal1v3.github.io/tgs-cli/zh/reference/environment/</link><pubDate>Mon, 01 Jan 0001 00:00:00 +0000</pubDate><guid>https://garenal1v3.github.io/tgs-cli/zh/reference/environment/</guid><description>&lt;h1 id="环境变量"&gt;环境变量&lt;a class="anchor" href="#%e7%8e%af%e5%a2%83%e5%8f%98%e9%87%8f"&gt;#&lt;/a&gt;&lt;/h1&gt;
&lt;p&gt;所有 tgs 环境变量均为可选。它们会覆盖编译时的默认值或配置文件中的值。&lt;/p&gt;
&lt;h2 id="变量列表"&gt;变量列表&lt;a class="anchor" href="#%e5%8f%98%e9%87%8f%e5%88%97%e8%a1%a8"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;table&gt;
 &lt;thead&gt;
 &lt;tr&gt;
 &lt;th&gt;Variable&lt;/th&gt;
 &lt;th&gt;Description&lt;/th&gt;
 &lt;/tr&gt;
 &lt;/thead&gt;
 &lt;tbody&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;TGS_PROFILE&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Active profile name. Overrides &lt;code&gt;.tgs.yaml&lt;/code&gt; but is overridden by &lt;code&gt;--profile&lt;/code&gt; flag.&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;TGS_API_ID&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Telegram API ID. Overrides the value compiled into the binary.&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;TGS_API_HASH&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Telegram API Hash. Overrides the value compiled into the binary.&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;TGS_CONFIG_DIR&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Config directory. Takes precedence over &lt;code&gt;XDG_CONFIG_HOME&lt;/code&gt;. Default: &lt;code&gt;$XDG_CONFIG_HOME/tgs&lt;/code&gt;, falling back to &lt;code&gt;~/.config/tgs&lt;/code&gt;.&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;TGS_DATA_DIR&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Data directory for session databases. Takes precedence over &lt;code&gt;XDG_DATA_HOME&lt;/code&gt;. Default: &lt;code&gt;$XDG_DATA_HOME/tgs&lt;/code&gt;, falling back to &lt;code&gt;~/.local/share/tgs&lt;/code&gt;.&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;XDG_CONFIG_HOME&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Base config directory (XDG spec). Used as &lt;code&gt;$XDG_CONFIG_HOME/tgs&lt;/code&gt; when &lt;code&gt;TGS_CONFIG_DIR&lt;/code&gt; is unset.&lt;/td&gt;
 &lt;/tr&gt;
 &lt;tr&gt;
 &lt;td&gt;&lt;code&gt;XDG_DATA_HOME&lt;/code&gt;&lt;/td&gt;
 &lt;td&gt;Base data directory (XDG spec). Used as &lt;code&gt;$XDG_DATA_HOME/tgs&lt;/code&gt; when &lt;code&gt;TGS_DATA_DIR&lt;/code&gt; is unset.&lt;/td&gt;
 &lt;/tr&gt;
 &lt;/tbody&gt;
&lt;/table&gt;

&lt;h2 id="配置文件选择"&gt;配置文件选择&lt;a class="anchor" href="#%e9%85%8d%e7%bd%ae%e6%96%87%e4%bb%b6%e9%80%89%e6%8b%a9"&gt;#&lt;/a&gt;&lt;/h2&gt;
&lt;div class="highlight"&gt;&lt;pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"&gt;&lt;code class="language-bash" data-lang="bash"&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# Use the &amp;#34;work&amp;#34; profile for one command&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e06c75"&gt;TGS_PROFILE&lt;/span&gt;&lt;span style="color:#56b6c2"&gt;=&lt;/span&gt;work tgs whoami
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#7f848e"&gt;# Use the &amp;#34;work&amp;#34; profile for the whole shell session&lt;/span&gt;
&lt;/span&gt;&lt;/span&gt;&lt;span style="display:flex;"&gt;&lt;span&gt;&lt;span style="color:#e5c07b"&gt;export&lt;/span&gt; &lt;span style="color:#e06c75"&gt;TGS_PROFILE&lt;/span&gt;&lt;span style="color:#56b6c2"&gt;=&lt;/span&gt;work&lt;/span&gt;&lt;/span&gt;&lt;/code&gt;&lt;/pre&gt;&lt;/div&gt;
&lt;p&gt;完整优先级链详见&lt;a href="https://garenal1v3.github.io/tgs-cli/zh/guide/profiles/#how-profile-resolution-works"&gt;配置文件解析顺序&lt;/a&gt;。&lt;/p&gt;</description></item></channel></rss>