SearchGram

서치그램

SearchGram은 중국어, 일본어, 한국어(CJK) 언어에 대한 검색 경험을 개선하고 메시지 백업 기능을 제공하는 텔레그램 봇입니다.

소개

텔레그램의 검색 기능은 단어를 구분할 공백이 없기 때문에 CJK 언어에 대한 지원이 부족합니다.

이와 관련된 문제는 수년 전에 보고되었지만 아직 해결되지 않았습니다.

• tdlib/td#1004
• https://bugs.telegram.org/c/724

특징

• 문자 메시지 검색 지원
• CJK 언어에 대한 오타 허용 및 퍼지 검색 제공
• GROUP, CHANNEL, PRIVATE, SUPERGROUP 및 BOT에 대한 필터 지원
• 사용자 이름/ID 필터링 지원
• 사진 및 문서에 대한 캡션 검색 지원
• 백그라운드에서 원활한 채팅 기록 동기화 지원
• 페이지 매김 제공
• 검색을 위해 WebUI를 사용합니다.

검색 구문

1. 전역 검색: 봇에 메시지 보내기
2. 채팅 유형 검색: -t=GROUP keyword , 지원 유형은 ["BOT", "CHANNEL", "GROUP", "PRIVATE", "SUPERGROUP"]입니다.
3. 채팅 사용자 검색: -u=user_id|username keyword
4. 완전 일치: -m=e keyword 또는 직접 "keyword"
5. 위 내용을 결합하세요: -t=GROUP -u=user_id|username keyword
6. /private [username] keyword : 사용자 이름으로 비공개 채팅에서 검색하며, 사용자 이름이 생략되면 모든 비공개 채팅에서 검색됩니다. 이는 위의 모든 검색 유형에도 적용됩니다.n

명령

/start - Start the bot
/ping - Check if the bot is alive
/help - Show help message and search syntax
/delete - Delete all messages from specific chat
/bot - Search messages from bots
/channel - Search messages from channels
/group - Search messages from groups
/private - Search messages from private chats
/supergroup - Search messages from supergroups

이론

SearchGram은 다음과 같이 작동합니다.

1. 최대 10명의 클라이언트와 함께 여러 세션을 허용합니다.
2. MeiliSearch에 들어오고 나가는 모든 문자 메시지를 저장하기 위해 숨겨진 세션을 만듭니다.
3. MeiliSearch를 쿼리하기 위한 다른 봇을 생성합니다.
4. 버그가 있는 것으로 알려진 텔레그램 내장 검색 기능을 사용하기 위해 전체 문장을 반환합니다.

봇 실행 전 채팅 기록이 걱정된다면,

SearchGram은 구성 파일을 사용하여 채팅 기록을 동기화하는 솔루션을 제공하므로 안심할 수 있습니다.

스크린샷

시스템 요구사항

Python 3.8+ 및 MeiliSearch를 실행할 수 있는 모든 시스템은 SearchGram을 실행할 수 있어야 합니다.

MeiliSearch가 더 빠르게 실행될 수 있도록 더 큰 RAM을 갖는 것이 좋습니다.

RAM이 제한되어 있는 경우 환경 변수 MEILI_MAX_INDEXING_MEMORY=800M 설정하여 MeiliSearch에서 RAM 사용을 제한할 수 있습니다.

자세한 내용은 최대 인덱싱 메모리를 참조하세요.

설치

참고: 채팅 기록은 비공개로 유지되어야 하기 때문에 공개 봇을 제공하지 않습니다.

자신의 서버에 SearchGram을 설치하려면 아래 단계를 따르십시오.

이 가이드는 기본 검색 엔진인 MeiliSearch와 함께 SearchGram을 설치하는 방법을 보여줍니다.

다양한 검색 엔진을 사용하여 Docker에서 SearchGram을 사용하는 방법을 알아보려면 Docker.md를 참조하세요.

1. 준비

• 이 저장소를 다운로드하거나 복제하세요.
• 여기에서 Python을 설치하세요: https://www.python.org/downloads/
• 여기에서 MeiliSearch를 설치하세요: https://github.com/meilisearch/meilisearch
• 여기에서 APP_ID 및 APP_HASH를 신청하세요: https://my.telegram.org/
• https://t.me/BotFather에 문의하여 봇 토큰을 받으세요.
• https://t.me/blog_update_bot에 문의하여 사용자 ID를 얻으세요.

2. 환경 파일 수정

선호하는 편집기를 사용하여 config.py 수정하세요. 예:

 APP_ID = 176552
APP_HASH = "667276jkajhw"
TOKEN = "123456:8hjhad"
MEILI_HOST = "localhost"
OWNER_ID = "2311231"

중국과 같이 네트워크 액세스가 제한된 경우 프록시를 설정해야 합니다.

 PROXY = { "scheme" : "socks5" , "hostname" : "localhost" , "port" : 1080 }

3. 클라이언트에 로그인

터미널(예: cmd 또는 iTerm)을 열고 코드를 저장한 디렉터리로 이동한 후 다음을 수행합니다.

python client.py

전화번호를 입력하고 클라이언트에 로그인하세요. Ctrl + C 눌러 종료할 수 있습니다.

4. (선택)동기화 ID 설정

여기를 참조하세요

5. 달려라!

두 개의 터미널을 열고 각 터미널에서 다음 명령을 실행합니다.

python client.py
python bot.py

6. (선택사항) 마이그레이션

• 더 나은 정렬을 위해 모든 데이터에 타임스탬프를 추가하세요. python add_timestamp.py

스폰서

• 나에게 커피를 사다
• 아프디안
• GitHub 스폰서

줄무늬

Stripe를 사용하여 프로젝트에 기부하고 싶다면 아래 버튼을 클릭하세요.

귀하에게 가장 적합한 통화와 결제 방법을 선택할 수 있습니다.

USD(카드, 애플페이, 구글페이)	SEK(카드, Apple Pay 및 Google Pay)	위안화(카드, 애플페이, 구글페이, 알리페이)
USD	SEK	위안화

특허

이 프로젝트는 GNU GENERAL PUBLIC LICENSE 버전 3에 따라 라이센스가 부여됩니다.