Question 1

LM Studio를 RSSMonster와 함께 사용할 때 'Inference embeddings response contains an invalid vector' 오류를 해결하는 방법

Accepted Answer

LM Studio에서 `EMBEDDING_PROVIDER=openai-compatible`를 사용할 때, `openai` npm SDK(v7.10.0)는 기본적으로 `encoding_format: 'base64'`를 요청합니다. LM Studio는 이 파라미터를 무시하고 항상 일반 JSON float 배열을 반환하는데, SDK는 이를 손상되거나 잘린 벡터로 잘못 디코딩합니다(예: 768개여야 할 값이 192개만 들어 있고 앞부분이 0으로 채워짐). 그러면 서버는 `Inference embeddings response contains an invalid vector` 오류와 함께 이를 거부합니다. 해결 방법(작동 확인됨): `inference/src/embeddings/providers/openaiEmbeddingProvider.js`에서 float 형식을 명시적으로 강제합니다:

```js
const response = await client.embeddings.create({
  model: config.modelId,
  input: texts,
  encoding_format: 'float'
});
```

또는 RSSMonster를 최신 버전으로 업데이트하세요. 메인테이너가 이 문제를 해결하는 패치를 커밋했으며, 리포터가 해결되었음을 확인했습니다.

Question 2

OIDC 로그인이 계정 연결을 완료하지 않고 아무 안내 없이 로그인 페이지로 다시 리디렉션되는 이유는 무엇인가요?

Accepted Answer

PWA 서비스 워커가 OIDC 콜백을 가로채고 있습니다. `/api/auth/oidc/callback`로의 IdP 리디렉션은 내비게이션 요청이므로, Workbox의 NavigationRoute가 요청을 서버로 전달하는 대신 캐시된 `index.html`을 제공합니다. 그 결과 콜백이 서버 로그에 전혀 기록되지 않고 계정 연결이 아무 알림 없이 실패합니다. 해결 방법: API 라우트가 내비게이션 폴백을 우회하도록 `client/pwa-policy.js`의 `NAVIGATION_FALLBACK_DENYLIST`에 `/^\/api\//`를 추가하세요. 이 문제는 업스트림에서 이미 수정되었으므로, 더 최신 이미지로 업데이트해도 해결됩니다. 패치하기 전에 진단을 확인하려면 Chrome DevTools(Application > Service Workers)에서 'Bypass for network'를 활성화하세요. 그 후 로그인이 완료되면 서비스 워커가 원인인 것입니다.

Question 3

RSSMonster에서 reasoning/thinking 모델(LM Studio, Ollama, Qwen3, DeepSeek-R1, Gemma) 사용 시 SEMANTIC_LABEL_INVALID_RESULT 오류와 빈 AI 응답을 해결하는 방법

Accepted Answer

원인: 추론 기능이 있는 모델이 전체 max_tokens 예산을 내부 `reasoning_content` chain-of-thought에 모두 소비하고 `finish_reason: "length"`와 함께 빈 `content`를 반환하기 때문에, RSSMonster의 구조화 출력 작업(semantic labels, article scoring/classification, smart-folder recommendations, feed rediscovery)이 `SEMANTIC_LABEL_INVALID_RESULT` 또는 `CompletionBudgetError` / `INFERENCE_COMPLETION_BUDGET_EXHAUSTED` 같은 오류와 함께 조용히 실패합니다. 해결 방법(요청별 적용, LM Studio/Ollama의 모델 수준 설정을 변경할 필요 없음): `inference/.env`에 다음 변수를 추가하고 추론 서비스를 재시작하세요:

GENERATION_REASONING_EFFORT=none
CLASSIFICATION_REASONING_EFFORT=none

이렇게 하면 각 chat completion 요청에 `reasoning_effort: 'none'`이 함께 전송되어 RSSMonster의 호출에 대해서만 thinking이 비활성화되고, 다른 앱에서는 모델의 전역 추론 동작이 그대로 유지됩니다. 참고: `enable_thinking: false`는 백엔드/템플릿에 따라 작동하지 않을 수 있습니다 — `reasoning_effort: 'none'`이 신뢰할 수 있는 옵션입니다. 결과가 여전히 지나치게 크거나 형식이 잘못된 경우에는 speculative decoding(draft model)도 비활성화하세요.

Question 4

Cloudflare Tunnel과 같은 리버스 프록시 뒤에서 실행할 때 로그인 시 발생하는 'Network Error' (ERR_CONNECTION_REFUSED)를 해결하는 방법

Accepted Answer

원인: 이미지 업그레이드 후 프론트엔드 JavaScript 번들이 로그인 요청을 공용 FQDN이 아닌 `http://localhost:3000/api/auth/login`으로 전송하여, 리버스 프록시(cloudflared, nginx 등)를 통해 접속할 때 브라우저가 `POST http://localhost:3000/api/auth/login net::ERR_CONNECTION_REFUSED` 오류로 요청을 차단했습니다. 해결 방법: 1) 패치가 포함된 최신 이미지로 업데이트하세요: `docker compose pull && docker compose up -d`. 2) 브라우저 캐시를 삭제하거나 로그인 페이지를 강력 새로고침(Ctrl+Shift+R / Cmd+Shift+R)하여 이전에 캐시된 JS 번들이 교체되도록 하세요 — 이 단계를 수행하지 않으면 업그레이드 후에도 오류가 계속 발생합니다. 참고: `PUBLIC_APP_URL`은 SMTP 링크에만 사용되며 로그인 API URL에는 영향을 미치지 않습니다.

Question 5

기사가 존재함에도 불구하고 RSSMonster 사이드바의 기사/읽지 않은 개수가 왜 0으로 고정되어 있나요?

Accepted Answer

이것은 데이터 손실이 아닌 표시 문제이며, 기사는 데이터베이스에 그대로 보존되어 있습니다. 클라이언트는 사이드바를 두 단계로 로드합니다. 먼저 0 자리 표시자로 구조를 로드하고(`fetchOverviewLite`), 그다음 `fetchOverviewCounts`를 통해 실제 숫자를 로드합니다. 카운트 요청이 느리거나 실패하면(예: SQLite Docker 프로필에서 `SQLITE_BUSY: database is locked` 경합으로 인해) UI는 `overviewCountsStatus = 'error'`로 설정하고 중단됩니다. 자동 재시도가 없으므로 수동으로 새로 고칠 때까지 모든 카운터가 0으로 유지됩니다. 해결 방법: 1) 사이드바에 표시되는 'Counts could not refresh / Retry' 배너를 클릭하거나, 2) 페이지를 새로 고치기만 하면 됩니다. 올바른 카운트가 다시 표시됩니다. 필터링 문제가 아닌 이 버그인지 확인하려면 SQLite DB를 직접 확인하세요. 영향을 받는 기사는 `aiAnalysisStatus='complete'`, `filteredInd=0`이어야 하며, 계정의 `minAdvertisementScore`/`minSentimentScore`/`minQualityScore` 임계값이 0이어야 합니다. 발생 빈도를 줄이려면 `server/config/databaseRuntime.js`에 WAL 모드와 `busy_timeout=5000`이 포함된 최신 master를 사용 중인지 확인하세요(저용량 RAM NAS 환경에서 SQLite 잠금을 완화하지만 완전히 제거하지는 못합니다). `fetchOverviewCounts`에 대한 자동 제한 재시도/백오프 기능이 요청되었지만 아직 구현되지 않았습니다.

RSSMonster

주요 기능

할 수 없는 것

사용 사례

태그

시작하기

유사한 프로젝트