📋 BibleAI v281.36.1401 수정 보고서

🔧 주요 수정 사항 - 올라마에이전트 설치하고 모델 다운 받은 후 실행.

1. 일반 파일 검색 기능 구현 ✅

문제: search_files() 함수가 빈 리스트만 반환
해결: search_files_advanced() 함수로 완전 재구현
- 텍스트 기반 파일 전체 검색 (.txt, .rtf, .docx, .pdf, .epub, .html, .htm)
- 재귀적 폴더 탐색 지원
- 선택된 폴더 범위 내 검색

2. 조건 검색 기능 추가 ✅

새로운 검색 문법 지원:

+단어: 필수 포함 단어 (AND 조건)
-단어: 제외 단어 (NOT 조건)
일반 단어: 하나라도 포함 (OR 조건)

사용 예시:

+사랑 +믿음           → "사랑"과 "믿음" 모두 포함된 파일만
+은혜 -율법           → "은혜"는 포함하되 "율법"은 제외
사랑 소망 믿음        → "사랑", "소망", "믿음" 중 하나라도 포함

3. 주제어 검색 개선 ✅

이전: 파일의 첫 부분만 추출 (의미 없는 결과)
현재:
- 검색어 주변 앞뒤 200자 컨텍스트 스니펫 제공
- 검색어 매칭 개수 표시
- 전체 내용도 함께 제공하여 확인 가능
- 더 의미 있는 검색 결과!

예시 출력:

[검색어 '사랑' - 15건 발견]

...고 사랑은 모든 것을 믿으며 모든 것을 바라며 모든 것을 견디느니라...

--- 전체 내용 ---
[파일 전문]

4. 다크모드 전체보기 버튼 수정 ✅

문제: JavaScript 템플릿 문법 오류로 버튼 미작동
해결:
- HTML 이스케이프 처리 개선
- JavaScript 변수 안전 처리
- 새 브라우저 창에서 다크모드 뷰어 정상 작동

5. "담아줘" / "생성" 명령어 개선 ✅

담아줘: 검색 결과 전체를 바구니에 일괄 담기
생성: 바구니 내용으로 설교 프롬프트 자동 조립 및 클립보드 복사
두 명령어 모두 대화형 입력창에서 정상 작동

🖥️ 크로스 플랫폼 호환성 검토

✅ Windows

파일 시스템: os.path 모듈 사용으로 경로 자동 처리
PDF 뷰어: SumatraPDF 자동 감지 및 실행
- PATH 환경변수 검색
- 기본 설치 경로 확인
- 대체: os.startfile() 사용
브라우저: webbrowser.open() 사용 (기본 브라우저 자동 실행)
클립보드: pyperclip 모듈 사용 (Windows 완전 지원)

✅ macOS

파일 시스템: Unix 기반 경로 자동 처리
PDF 뷰어: subprocess.Popen(["open", path]) 사용
- 시스템 기본 PDF 뷰어 자동 실행 (Preview.app 등)
브라우저: Safari/Chrome 등 기본 브라우저 자동 실행
클립보드: pyperclip 모듈 완전 지원 (pbcopy 사용)

✅ Linux

파일 시스템: Unix 기반 경로 자동 처리
PDF 뷰어: subprocess.Popen(["xdg-open", path]) 사용
- 시스템 기본 PDF 뷰어 자동 실행 (Evince, Okular 등)
브라우저: Firefox/Chrome 등 기본 브라우저 자동 실행
클립보드: pyperclip 모듈 지원 (xclip/xsel 필요)
- 설치 필요: sudo apt-get install xclip (Ubuntu/Debian)

📦 필수 패키지 설치

Python 패키지

pip install streamlit ollama pymupdf python-docx beautifulsoup4 ebooklib pyperclip

Linux 추가 패키지 (클립보드용)

# Ubuntu/Debian
sudo apt-get install xclip

# Fedora/RHEL
sudo dnf install xclip

# Arch Linux
sudo pacman -S xclip

🚀 실행 방법

1. 기본 실행

streamlit run agape1401ai5_fixed.py

2. 특정 포트 지정

streamlit run agape1401ai5_fixed.py --server.port 8501

3. 외부 접속 허용

streamlit run agape1401ai5_fixed.py --server.address 0.0.0.0

📚 사용 가이드

검색 기능 사용법

1. 성경 구절 검색 (보화 찾기 탭)

성경: 요한복음 (또는 요, Joh, John 등)
장: 3
절: 16 (범위: 16-18, 복수: 16/18)

2. 주제어 검색 (대화형 입력창)

사랑                 → "사랑" 포함된 모든 파일
+사랑 +믿음          → "사랑"과 "믿음" 모두 포함
+은혜 -율법          → "은혜" 포함, "율법" 제외
십자가 구원 희생      → 셋 중 하나라도 포함

3. 로컬 AI 질문 (대화형 입력창)

? 요한복음 3:16의 신학적 의미는?
? 사랑과 율법의 관계를 설명해줘

4. 바구니 명령어 (대화형 입력창)

담아줘               → 검색 결과 전체를 바구니에 담기
생성                 → 바구니 내용으로 설교 프롬프트 조립

워크플로우 예시

검색: 주제어 "사랑" 검색
담기: 원하는 결과들을 바구니에 담기 (🧺 버튼 클릭)
조립: "생성" 명령어로 설교 프롬프트 자동 조립
복사: 클립보드에 자동 복사됨
활용: Ollama나 ChatGPT에 붙여넣기

🛠️ 설정 파일 구조

프로젝트 폴더/
├── agape1401ai5_fixed.py      # 메인 프로그램
├── bible_database.db           # 성경 데이터베이스 (선택)
├── bible.dct.twm               # 원어 사전 (선택)
├── docs/                       # 문서 폴더 (기본 검색 범위)
│   ├── 주석/
│   ├── 설교/
│   └── 신학자료/
├── *.cmt.mybible               # MyBible 주석 파일
├── *.cmt.twm                   # TheWord 주석 파일
└── *.sqlite3                   # 기타 주석 데이터베이스

⚠️ 알려진 제한사항

성경 데이터베이스: bible_database.db 파일이 없으면 성경 본문 검색 불가
- 해결: 테이블 구조(book, chapter, verse, content)에 맞는 DB 파일 준비
Ollama 연동: Ollama가 로컬에 설치 및 실행 중이어야 함
- 설치: https://ollama.ai
- 모델: gemma3:4b (또는 다른 모델로 변경 가능)
파일 읽기: 손상되거나 암호화된 파일은 읽기 실패 가능
- 로그: "파일 읽기 오류" 메시지 표시

🎯 주요 개선점 요약

기능	이전	현재
일반 검색	❌ 미구현	✅ 전체 파일 검색
조건 검색	❌ 없음	✅ +/- 연산자 지원
주제어 검색	⚠️ 첫 부분만	✅ 컨텍스트 스니펫
다크모드 뷰어	❌ 작동 안 함	✅ 정상 작동
담아줘 명령어	⚠️ 불완전	✅ 완전 작동
생성 명령어	⚠️ 불완전	✅ 완전 작동
크로스 플랫폼	⚠️ 부분 지원	✅ 완전 지원

💡 추가 개선 제안

단기 (구현 용이)

검색 결과 정렬: 관련도 점수 기반 정렬
검색 히스토리: 최근 검색어 저장 및 재사용
바구니 그룹화: 주제별/파일별 그룹 관리

중기 (구현 복잡)

AI 요약: 검색 결과를 AI로 자동 요약
전문 편집기: 바구니 내용을 직접 편집
협업 기능: 여러 사용자가 바구니 공유

장기 (대규모 개선)

벡터 검색: 의미 기반 검색 (임베딩 활용)
음성 입력: 검색어 음성 인식
모바일 최적화: 태블릿/스마트폰 UI

📞 문의 및 지원

버그 리포트: 상세한 오류 메시지와 함께 제보
기능 제안: 구체적인 사용 시나리오 설명
사용 문의: 설정 환경 및 운영체제 정보 포함

✨ 변경 이력

v281.36.1401 (2024-02-09)

✅ 일반 파일 검색 기능 완전 구현
✅ 조건 검색 (+/-) 추가
✅ 주제어 검색 컨텍스트 스니펫 개선
✅ 다크모드 뷰어 JavaScript 오류 수정
✅ "담아줘"/"생성" 명령어 정상화
✅ 크로스 플랫폼 호환성 검증
✅ 사용자 가이드 문서 작성

🎉 선한소망교회를 위한 특별 제작 - 은혜와 평강이 함께하시길! 🙏

'BibleAI > 설치 및 활용법' 카테고리의 다른 글

다국어 번역이 가능한 epub 뷰어로 활용하는 법 (0)	2026.02.14
e-Sword 주석 모듈 연동 업데이트 (0)	2026.02.13
바이블AI 코드 작업을 마치며 ... (0)	2026.02.08
히 11:1 - 새벽기도 프리셋 사용 설교 초안 (0)	2026.02.08
바이블AI 최종 사용 설명서 (0)	2026.02.07

agape1401ai5 설치 및 사용법

📋 BibleAI v281.36.1401 수정 보고서

🔧 주요 수정 사항 - 올라마에이전트 설치하고 모델 다운 받은 후 실행.

1. 일반 파일 검색 기능 구현 ✅

2. 조건 검색 기능 추가 ✅

3. 주제어 검색 개선 ✅

4. 다크모드 전체보기 버튼 수정 ✅

5. "담아줘" / "생성" 명령어 개선 ✅

🖥️ 크로스 플랫폼 호환성 검토

✅ Windows

✅ macOS

✅ Linux

📦 필수 패키지 설치

Python 패키지

Linux 추가 패키지 (클립보드용)

🚀 실행 방법

1. 기본 실행

2. 특정 포트 지정

3. 외부 접속 허용

📚 사용 가이드

검색 기능 사용법

1. 성경 구절 검색 (보화 찾기 탭)

2. 주제어 검색 (대화형 입력창)

3. 로컬 AI 질문 (대화형 입력창)

4. 바구니 명령어 (대화형 입력창)

워크플로우 예시

🛠️ 설정 파일 구조

⚠️ 알려진 제한사항

🎯 주요 개선점 요약

💡 추가 개선 제안

단기 (구현 용이)

중기 (구현 복잡)

장기 (대규모 개선)

📞 문의 및 지원

✨ 변경 이력

'BibleAI > 설치 및 활용법' 카테고리의 다른 글

티스토리툴바

agape1401ai5 설치 및 사용법

📋 BibleAI v281.36.1401 수정 보고서

🔧 주요 수정 사항 - 올라마에이전트 설치하고 모델 다운 받은 후 실행.

1. 일반 파일 검색 기능 구현 ✅

2. 조건 검색 기능 추가 ✅

3. 주제어 검색 개선 ✅

4. 다크모드 전체보기 버튼 수정 ✅

5. "담아줘" / "생성" 명령어 개선 ✅

🖥️ 크로스 플랫폼 호환성 검토

✅ Windows

✅ macOS

✅ Linux

📦 필수 패키지 설치

Python 패키지

Linux 추가 패키지 (클립보드용)

🚀 실행 방법

1. 기본 실행

2. 특정 포트 지정

3. 외부 접속 허용

📚 사용 가이드

검색 기능 사용법

1. 성경 구절 검색 (보화 찾기 탭)

2. 주제어 검색 (대화형 입력창)

3. 로컬 AI 질문 (대화형 입력창)

4. 바구니 명령어 (대화형 입력창)

워크플로우 예시

🛠️ 설정 파일 구조

⚠️ 알려진 제한사항

🎯 주요 개선점 요약

💡 추가 개선 제안

단기 (구현 용이)

중기 (구현 복잡)

장기 (대규모 개선)

📞 문의 및 지원

✨ 변경 이력

'BibleAI > 설치 및 활용법' 카테고리의 다른 글

관련글

티스토리툴바