获取下载链全程约 1 分钟

打开微信，搜索「软件教程管家」关注，或长按下方二维码关注
回复关键词 telegram-search
公众号自动回复网盘链接，点击即可保存下载

打开微信扫一扫关注
或搜索【软件教程管家】

Telegram 用久了，聊天记录越攒越多，想找一句话却翻不到：Telegram 自带的搜索对中文支持弱，关键词一换说法就搜不出来。Telegram Search 是开源的 Telegram 聊天记录备份与语义检索工具，把记录同步到自己手里，再用分词、模糊匹配和向量语义搜索去找，按意思搜也能命中，还能对着历史记录问答。最新版 v1.6.1，AGPL-3.0 开源免费。

前往 GitHub 下载 Telegram Search

GitHub 国内访问较慢，如打不开可多刷新几次

Telegram Search 软件信息

软件名称	Telegram Search
最新版本	v1.6.1（2026-11-05 发布）
适用平台	macOS / Linux（CLI），网页界面走 Docker，任意系统浏览器访问
软件语言	中文 README 与界面，TypeScript 开源实现
授权协议	AGPL-3.0 开源免费
GitHub 关注	约 4100 Star，2026-11-09 仍在更新
在线体验	官方演示站 search.lingogram.app，可先看效果再部署

版本选择：CLI、网页版还是 Bot

结论先行：只想在自己电脑上搜记录，装 CLI 就够了；想要图形界面、家里多台设备共用，走 Docker 网页版；出门在外手机上随手搜，再配 Bot 入口。三者共用同一份本地数据，不是三个独立产品。

形态	适合谁	说明
CLI（tgs 命令行）	开发者、重度终端用户	Homebrew 安装，本地登录一次就能搜，还能交给 AI Agent 调用
网页界面（Docker Compose）	想点鼠标、不想记命令的人	部署后浏览器打开本机 3333 端口，可视化检索与浏览
Telegram Bot	手机上随时查记录的人	Bot 内搜索并导出消息，点 deep link 跳回原始对话

Telegram Search 安装步骤（CLI 版）

macOS 或 Linux 上先装好 Homebrew，执行官方给出的两条命令：brew tap groupultra/telegram-search，再 brew install groupultra/telegram-search/tg-search，装完得到 tgs 命令（旧命令 tg-search 仍可用）。
运行 tgs auth login 登录。好消息是登录已内置 API ID 和 Hash，不用自己去 my.telegram.org 申请，按提示完成本地账户登录即可。
想让新消息自动进来，启动常驻服务：brew services start groupultra/telegram-search/tg-search。注意以当前用户运行，不要加 sudo。
先看一眼会话列表：tgs chats list，确认要备份的会话都在，再同步历史：tgs sync –takeout –chat 123456 –from 2026-01-01，把会话 ID 和起始日期换成自己的。
同步完成后直接搜：tgs search “项目进展”，看结果是不是你要的那条，再决定要不要全量同步。

聊天记录搜索怎么用：四种找法

Telegram Search 的检索不是只有一种：中文分词解决“按词命中”，不以空格分词的中文也能按词搜到；模糊匹配兜底错字和大概说法；向量语义搜索按意思找，记得大概内容、记不住原词也能命中；图片 embedding 支持以文搜图，描述画面内容就能找到那张图。结果支持按日期范围筛选、无限滚动浏览。

找一句话：直接搜关键词或自然语言问句，语义搜索会把意思相近的消息排上来。
找一张图：用文字描述图里有什么，以文搜图定位到原消息。
补未读：未读消息摘要先帮你过一遍，再决定哪些要细看。
问历史：基于历史上下文的 RAG 问答，对着自己的聊天记录提问，答案来自你自己的消息。

装完先改这 4 个设置

同步范围先小后大：第一次同步先拿一个重要会话验证（单个 –chat），确认内容、速度都没问题再 –all 全量，别一上来就全库同步。
存储后端默认 PGlite：单人自用默认的 PGlite 零配置就能跑；数据量大了、要多人共用再切 PostgreSQL，别一开始就上重型数据库。
媒体备份位置想清楚：不配 MinIO 时，图片视频默认存到本地 data/media 目录。空间紧张、媒体多的用户先接 MinIO，别等硬盘报警才处理。
AI 配置按账户在应用内配：向量搜索、RAG 问答和未读摘要都要配 embedding 与 LLM 服务，不配也能用关键词检索，但语义功能不会生效。

注意事项

本软件仅供导出和检索个人聊天记录，README 明确警示不要用于违法用途，也提醒项目未发行任何虚拟货币，谨防打着项目名义的诈骗。
批量同步历史要用 Takeout 流程：如果返回 TAKEOUT_AUTHORIZATION_REQUIRED，需要在另一台 Telegram 设备上批准导出请求再重试；对方拒绝或失败时不会退回普通历史读取。
首次全量同步的耗时和占用空间取决于消息量，跑之前先看一眼磁盘余量，别在系统盘只剩几 GB 时开全量。
媒体默认落本地 data/media 目录，要自己规划磁盘空间和备份策略；数据库、媒体目录和环境配置建议一起备份。
不要用 sudo 运行 brew services，升级 CLI 会保留 profile 数据，但升级前仍建议先备份本地数据库和媒体；改完 Docker Compose 配置要重启服务才生效。
MCP 接口、AI 服务兼容范围和性能边界在 README 里没有完整说明，想把这套东西接进 Agent 或自动化流程，先核对文档和源码再动手。