AI 상담 + 사이트 검색 패키지 v2.2.0을 배포합니다.
- 그누보드 5.4+, PHP 7.4+
- DB 변경 없음
- API 키는 패키지에 포함되지 않습니다.
- 배포 파일: ai_assistant-2.2.0.zip

■ 주요 기능
- 우측 하단 AI 상담 위젯
- 공개 게시판·내용관리·FAQ·테마 페이지 검색
- 첨부파일·PDF·이미지 내용은 검색하지 않습니다.
- 답변에 출처([1], [2]) 표시
- 비밀글·회원전용·그룹 제한 제외
- 게시판 글 개인정보 마스킹

■ 설치
1. extend, bbs, adm 파일 복사
2. data/ 쓰기 권한 확인
3. 관리자 > 환경설정 > AI 상담 설정
4. 설치 환경 점검 확인
5. API 키 저장
6. 검색 테스트

■ 다른 모델도 쓸 수 있나요?
네. OpenAI 호환 chat/completions + Bearer 인증을 지원하는 모델이면 교체할 수 있습니다.
- 예: Gemini(기본), OpenAI, OpenRouter, Groq, Together, Mistral, Ollama/LM Studio
- 관리자 > 환경설정 > AI 상담 설정에서 API 키·모델·API 주소를 변경합니다.

예시
- OpenAI: https://api.openai.com/v1/chat/completions / gpt-4o-mini
- OpenRouter: https://openrouter.ai/api/v1/chat/completions / openai/gpt-4o-mini
- Ollama: http://localhost:11434/v1/chat/completions / qwen2.5:7b

모델 변경 시 주의
- 제공자별 API 키가 필요합니다. 기존 Gemini 키로 다른 제공자를 호출할 수 없습니다.
- reasoning_effort, temperature, max_tokens를 지원하지 않는 모델은 오류가 날 수 있습니다. 현재 reasoning_effort 기본값 low가 전송됩니다.
- Anthropic 네이티브, Azure OpenAI, Gemini 네이티브 generateContent는 직접 지원하지 않습니다. OpenRouter나 프록시를 사용하세요.
- 한국어 이해도·지시 준수·컨텍스트 창은 모델마다 다릅니다. 8k 이상 컨텍스트를 권장합니다.

자세한 설치·설정은 패키지의 INSTALL.md와 docs/ai-assistant.md를 참고하세요.

---

관리자/방문자 모드 구분
- 관리자 : 키 없으면 설정 안내 표시 · 관리자 환영 문구/배지 · 초안 작성 칩 · 글쓰기 도우미 · 사이트 검색/출처 없음 · 요청 제한 3배 · API 오류 상세 표시
- 방문자 : 키 없으면 위젯 숨김 · 일반 환영 문구 · 자동/지정 추천 질문 · 사이트 검색 기반 Q\&A + 출처 · 요청 제한 1배
- 핵심 차이 : 위젯 관리자 모드는 `group`/`board` 관리자도 포함하지만, 설정 화면·메뉴는 최고관리자(`super`)만 접근 가능
- 주의 : 관리자 위젯은 사이트 검색을 하지 않음 → 사이트 내용 Q\&A는 방문자 모드 또는 관리자 화면의 검색 테스트 이용

---