telegram-search 是什么?

Telegram Search 是一个导出并「模糊/语义搜索」自己 Telegram 聊天记录的工具,解决 Telegram 原生搜索对中文等语言不友好、海量消息难定位的痛点。它把你的消息备份到本地数据库,自动分词与向量嵌入,支持模糊匹配 + 向量语义搜索、以文搜图、RAG 智能问答、未读消息智能摘要等 AI 功能,并提供 Telegram Bot 与 deep link 跳转。许可为 AGPL-3.0,TypeScript,约 3,903 stars。需中立提示:它备份的聊天记录通常也包含他人发给你的消息,导出/存储/嵌入这些数据涉及隐私,应妥善保管、仅作个人用途并遵守 Telegram 条款与他人隐私。

⭐ 3,849 Stars 🍴 244 Forks TypeScript AGPL-3.0 作者: groupultra
来源:README.md(TIP 段落、功能亮点);GitHub 仓库元数据(stars=3903、license=AGPL-3.0、language=TypeScript);隐私判断 查看 GitHub 仓库 →

为什么值得关注

Telegram 用户常苦于「找不到那条重要消息」,尤其中文/多语言搜索不佳。Telegram Search 用本地分词 + 向量语义搜索 + RAG 问答 + AI 摘要,让备份与检索自己的消息变得便捷精准,还能以文搜图、智能汇总未读,AI 能力丰富,因而受关注。截至数据采集约 3,903 stars。需提示:备份涉及他人消息的隐私,热度不代表可随意导出/共享聊天数据。

来源:README.md(TIP、功能亮点);GitHub 仓库元数据(stars=3903);隐私判断

核心功能

导出与备份聊天记录

把 Telegram 消息备份到 PGlite/PostgreSQL,媒体自动存 MinIO,导出时自动向量嵌入与分词,并实时同步最新对话。

来源:README.md(功能亮点 → 导出与备份)
模糊 + 向量语义搜索

自动多语言分词,融合模糊匹配与向量语义搜索;支持图片 embedding 的以文搜图与无限滚动浏览。

来源:README.md(功能亮点 → 聊天记录搜索)
RAG 问答与 AI 摘要

基于历史上下文与 AI 对话做 RAG 问答;一键汇总全部未读消息生成精炼摘要。

来源:README.md(功能亮点 → RAG 智能问答、未读消息智能摘要)
Telegram Bot 与跳转

通过 Bot 搜索/导出消息,deep link 一键定位原始对话,右键跳转原消息(支持移动端)。

来源:README.md(功能亮点 → Telegram Bot、高级功能)

技术架构

Telegram Search 是 TypeScript 项目。导出与备份:兼容 PGlite 与 PostgreSQL 存聊天记录,媒体可自动备份到 MinIO 对象存储,导出时自动完成向量嵌入与分词,并实时同步拉取最新对话。搜索:自动智能分词支持多语言,融合模糊匹配与向量语义搜索,支持图片 embedding 的以文搜图、无限滚动浏览,以及 RAG 智能问答(基于历史上下文与 AI 对话)。还提供 Telegram Bot(用 Bot 搜索/导出、deep link 一键跳回原消息)、未读消息智能摘要、日期范围筛选、右键跳转原消息等。仓库 topics 含 mcp、embedding,路线图规划会话总结、知识图谱等。

来源:README.md(功能亮点的导出/搜索/Bot/高级功能、路线展望);GitHub 仓库 topics(mcp、embedding)

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) PGlite / PostgreSQL(存储)PGlite / Postg… MinIO(媒体对象存储)MinIO(媒体对象… 向量嵌入模型、分词 Telegram API/Bot;MCPTelegram API/B… 导出与备份聊天记录 模糊 + 向量语义搜索 RAG 问答与 AI 摘要 Telegram Bot 与跳转 telegram-search 项目本体 核心功能 关键依赖

中心为项目本体,内环 = 核心功能模块,外环 = 关键技术依赖;按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成

技术栈

语言TypeScript框架导出/索引/搜索服务 + Telegram Bot
PGlite / PostgreSQL(存储)MinIO(媒体对象存储)向量嵌入模型、分词Telegram API/Bot;MCP
本地部署(数据存本地 DB);提供在线体验站
来源:README.md(功能亮点的存储/嵌入、topics);GitHub 仓库元数据(language=TypeScript、homepage)

快速上手

按仓库文档部署(TypeScript 项目,需配置 PGlite/PostgreSQL 存储,媒体可选 MinIO),用你自己的 Telegram 账号导出聊天记录并自动完成嵌入/分词,即可做模糊+语义搜索、以文搜图、RAG 问答与未读摘要,也可用 Telegram Bot 操作。也可先用官方在线体验站。重要提示:导出的聊天记录通常包含他人发给你的私密消息,请确保数据存于你掌控的环境、妥善保管、仅作个人检索用途,遵守 Telegram 服务条款并尊重他人隐私,不要外传或滥用。
来源:README.md(功能亮点、立即体验);隐私/合规判断

使用场景

适合 Telegram 重度用户检索与管理自己的消息:找回被海量消息淹没的重要内容、跨语言精准搜索、以文搜图、用 RAG 与 AI 问答基于历史快速获取答案、一键汇总未读。它面向个人备份与检索场景。需强调:聊天记录涉及他人隐私,应仅作个人用途、数据自托管妥善保管、遵守平台条款与他人隐私,不得用于监视或外传。

来源:README.md(TIP、功能亮点);隐私判断

优势与局限

优势

  • 解决 Telegram 中文/多语言搜索与定位痛点,备份+检索一体
  • 模糊 + 向量语义搜索、以文搜图、RAG 问答、未读摘要等 AI 能力丰富
  • 数据存本地 DB(PGlite/PostgreSQL)+ MinIO,自托管可控
  • 提供 Bot 与 deep link 跳转,AGPL-3.0 开源

局限

  • 备份涉及他人消息隐私,需仅作个人用途、妥善保管、勿外传
  • 导出/使用需遵守 Telegram 服务条款
  • 部署涉及数据库/对象存储/嵌入模型,配置有一定门槛
  • AGPL-3.0 许可,二次开发/分发需守 copyleft
来源:README.md(功能亮点);License;隐私/合规判断

最新版本

本页未列出具体版本号;项目持续迭代,路线图规划自动会话总结、基于历史消息构建人物/事件知识图谱(「超级大脑」)、智能整理收藏等。更新以增强 AI 检索/问答与导出能力为主。

来源:README.md(路线展望、功能亮点)

总结评价

Telegram Search 很好地解决了「Telegram 消息找不到」的痛点:备份到本地 DB、多语言分词、模糊+向量语义搜索、以文搜图、RAG 问答与未读摘要,自托管可控、AI 能力丰富。对 Telegram 重度用户检索自己的消息很实用。要中立看待隐私:它备份的聊天通常包含他人私密消息,应仅作个人用途、数据自托管妥善保管、遵守平台条款与他人隐私、不外传。作为个人 Telegram 消息检索工具,它实用、能力强,但隐私与合规应放在前面。

来源:综合 README.md 的功能与隐私/合规考量
透明度声明
本页内容由 AI(大语言模型)基于以下公开材料自动生成:GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间: 2026-05-24 14:18. 质量评分: 100/100.

数据来源:README、GitHub API、依赖文件