用途：在 Telegram 中跨全部聊天或指定聊天搜索历史消息，按文本查找旧消息。
主要能力：支持全局搜索、限定某一聊天搜索、按发送者过滤，并可组合使用。可设置返回结果上限（默认 20）和每条正文的预览截断长度。默认输出完整多行缩进文本，格式为时间、聊天名称与 id、发送者及正文。
使用前提：需存在会话文件 ~/.local/share/gramjs/<profile>.session，缺失时先运行 /tlg:setup。使用方式为通过 bash 执行 tg-cli.ts 脚本，命令形式如 bun "$SCRIPT" search "搜索词" -n 20；可加 --chat 指定聊天、--from 指定发送者、--preview N 截断正文。
限制：全局搜索使用常见词可能触发速率限制（约每 10 次请求等待 30 秒）；全局搜索要求查询字符串非空，否则结果为空。参数名称与脚本路径以资料为准，暂未提供更多平台、收费或安装细节。