groupultra/telegram-search

About

是否曾因 Telegram 无法搜索中文聊天记录而困扰？ > 或者想查找一条重要消息，却被海量消息淹没，难以定位？ > 有了 Telegram Search，您可以便捷地备份并检索自己的 Telegram 消息。无论任何语言，强大的本地分词能力都能准确命中。 > 支持向量搜索，实现句子智能模糊匹配，查找信息更快速精准。 > 更多 AI 驱动场景，支持未读消息智能摘要、AI 助手对话等丰富功能体验。

我们提供了一个在线体验版，无需自行部署，即可体验 Telegram Search 的全部功能。

本项目未发行任何虚拟货币，请警惕相关诈骗风险。 > 本软件仅供您导出和检索个人聊天记录使用，切勿将其用于任何违法用途。

仓库现在提供本地优先的 TypeScript CLI。用户只需为命名 profile 完成本地登录，Agent 即可自行组合命令决定是否拉取、拉取哪些会话，以及何时显式同步。

chats list 和 messages list 只做有界的远端读取，不持久化消息。批量同步必须先征得用户同意，并由 Agent 在 sync 命令中显式加入 --takeout；未授权、用户拒绝或 Takeout 初始化失败都会停止，不会退回普通 GetHistory。文本同步只申请所选会话类别，不申请联系人或文件导出权限。同步结果写入 profile 独立的 PGlite。CLI 的 stdout 只输出 JSON 结果，Telegram 日志、提示与进度写入 stderr。导出包含按月 JSONL 和校验清单，不包含媒体二进制、登录 session、向量或密钥，也不会替用户执行…

Excerpted from github.com/groupultra/telegram-search