groupultra/telegram-searchView GitHub Homepage for Latest Official Releases
Telegram Search:一个功能强大的Telegram聊天记录搜索工具,支持向量搜索和语义匹配
AGPL-3.0TypeScripttelegram-searchgroupultra 2.8k Last Updated: August 14, 2025
Telegram Search - 智能聊天记录搜索工具
🔍 项目概述
Telegram Search 是一个功能强大的 Telegram 聊天记录搜索工具,支持向量搜索和语义匹配。基于 OpenAI 的语义向量技术,让你的 Telegram 消息检索更智能、更精准。
✨ 主要特性
- 智能语义搜索: 基于 OpenAI 的向量技术,理解消息的语义含义
- 向量搜索: 利用高级搜索算法提供高效的搜索结果
- 聊天记录备份: 轻松备份您的聊天历史记录
- 用户友好界面: 设计简洁,易于使用
- 跨平台支持: 支持多种操作系统
- 开源免费: MIT 许可证,完全开源
🚀 快速开始
环境要求
- Node.js
- pnpm
- Docker 和 Docker Compose
安装步骤
- 克隆仓库
git clone https://github.com/GramSearch/telegram-search.git
cd telegram-search
- 安装依赖
pnpm install
- 配置环境
cp config/config.example.yaml config/config.yaml
- 启动数据库容器
docker compose up -d
- 同步数据库表结构
pnpm run db:migrate
- 启动服务
# 启动后端服务
pnpm run dev:server
# 启动前端界面
pnpm run dev:frontend
- 访问应用
打开浏览器访问
http://localhost:3333
即可使用搜索界面。
🔧 技术架构
核心技术
- 前端: 现代化的Web界面
- 后端: Node.js 服务器
- 数据库: 支持向量存储的数据库系统
- AI集成: OpenAI API 用于语义向量生成
- 容器化: Docker 支持,便于部署
搜索机制
- 向量嵌入: 将文本转换为高维向量表示
- 语义匹配: 基于语义相似度进行搜索
- 智能过滤: 支持多种消息过滤条件
📊 功能详解
1. 智能搜索
- 不仅支持关键词匹配,还能理解语义含义
- 即使用不同的词汇表达相同意思,也能准确找到相关消息
2. 聊天备份
- 自动备份 Telegram 聊天记录
- 支持多种聊天类型(私聊、群聊、频道)
3. 高级过滤
- 按时间范围搜索
- 按消息类型过滤
- 按发送者筛选
🔗 相关链接
- GitHub 仓库: https://github.com/groupultra/telegram-search
- 问题反馈: https://github.com/groupultra/telegram-search/issues
- 讨论区: https://github.com/groupultra/telegram-search/discussions
📈 应用场景
- 个人用户: 快速查找历史消息和文件
- 团队协作: 高效检索团队讨论内容
- 内容管理: 整理和归档重要对话
- 研究分析: 分析聊天数据和趋势