首页 / AI Trending / groupultra/telegram-search

groupultra/telegram-search

⭐ 3,849 Stars 🍴 244 Forks TypeScript AGPL-3.0

这是一个用于导出和模糊搜索 Telegram 聊天记录的开源工具，旨在帮助用户高效检索和备份聊天数据。

来源：据 README 描述 查看 GitHub 仓库 →

为什么值得关注

该项目因解决了 Telegram 本身搜索功能的不足，提供了强大的本地分词和模糊匹配能力，以及丰富的 AI 驱动功能，受到关注。它填补了 Telegram 在中文搜索和智能处理方面的空白，并采用了 TypeScript 语言，使其在性能和可维护性方面具有优势。

来源：综合 README 描述和项目特征

核心功能

导出与备份

支持多种数据库导出聊天记录，自动备份媒体资源，并完成向量嵌入与分词处理，便于后续检索。

来源：据 README 描述
聊天记录搜索

支持自动智能分词，多语言精准检索，融合模糊匹配与向量语义搜索，以及图片语义搜索，提高查找效率。

来源：据 README 描述
Telegram Bot

通过 Bot 搜索和导出消息，支持消息 deep link 跳转，方便用户定位原始对话。

来源：据 README 描述
高级功能

包括未读消息智能摘要、日期范围筛选、右键菜单跳转 Telegram 原消息等，提升用户体验。

来源：据 README 描述

技术架构

项目采用模块化设计，代码目录结构清晰，依赖文件表明使用了 TypeScript 和 Node.js。技术架构上，可能采用了前后端分离的模式，后端负责数据处理和存储，前端负责用户界面展示。

来源：代码目录结构 + 依赖文件

技术栈

infra: Docker  |  key_deps: @dotenvx/dotenvx, @guiiai/logg, drizzle-kit  |  language: TypeScript  |  framework: Node.js

来源：依赖文件 + 代码目录结构

快速上手

使用 Docker Compose： 1. 新建目录并下载配置文件。 2. 启动服务：`docker compose -f docker-compose.yml up -d` 3. 访问 `http://localhost:3333`。
来源：README Installation/Quick Start

使用场景

1. 个人用户备份和检索 Telegram 聊天记录。 2. 企业用户管理团队沟通记录。 3. 开发者测试 Telegram API。 4. 研究人员分析聊天数据。

来源：据 README 描述

优势与局限

优势

  • 功能全面，支持多种搜索和备份方式
  • 采用 TypeScript 和 Node.js，技术栈成熟
  • 提供 Docker 部署，易于使用

局限

  • 可能需要一定的技术背景才能完全理解和使用
  • 开源版本可能缺少一些高级功能
来源：综合 README、代码结构和依赖分析

最新版本

v1.2.5 (2026-04-10): 添加聊天类型过滤器。 v1.2.4 (2026-04-07): 修复搜索结果滚动位置问题。 v1.2.3 (2026-04-04): 保留聊天搜索输入状态。 v1.2.2 (2026-04-01): 精简同步状态面板布局。 v1.2.1 (2026-03-28): 移除不必要的日志。

来源：GitHub Releases

总结评价

Telegram Search 是一个功能强大的 Telegram 聊天记录管理工具，适合需要高效检索和备份聊天记录的个人和企业使用。它适合对技术有一定了解的用户，特别是那些需要处理大量聊天数据的场景。

来源：综合分析
透明度声明
本页内容由 AI（大语言模型）基于以下公开材料自动生成：GitHub README、代码目录结构、依赖文件、Release 信息。 分析时间：2026-04-11 12:33。质量评分：85/100。 所有结论均标注了数据来源。如发现不准确之处，欢迎反馈。

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