Question 1

如何修复将 LM Studio 与 RSSMonster 一起使用时出现的 "Inference embeddings response contains an invalid vector" 错误？

Accepted Answer

当将 `EMBEDDING_PROVIDER=openai-compatible` 与 LM Studio 一起使用时,`openai` npm SDK (v7.10.0) 默认会请求 `encoding_format: 'base64'`。LM Studio 会忽略该参数,始终返回普通的 JSON 浮点数组,而 SDK 会将其错误地解码为损坏/被截断的向量(例如,只有 192 个值而非 768 个,且带有前导零)。随后服务器会拒绝该向量,并报错 `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 service worker 拦截了 OIDC 回调。IdP 对 `/api/auth/oidc/callback` 的重定向是一个导航请求，因此 Workbox 的 NavigationRoute 返回了缓存的 `index.html`，而不是让请求到达服务器——回调从未出现在服务器日志中，账户关联也悄无声息地失败了。修复方法：在 `client/pwa-policy.js` 中将 `/^\/api\//` 添加到 `NAVIGATION_FALLBACK_DENYLIST`，使 API 路由绕过导航回退。此问题已在上游修复，因此更新到更新的镜像也可以解决该问题。要在打补丁之前验证诊断结果，请在 Chrome DevTools（Application > Service Workers）中启用“Bypass for network”——如果登录随后能够完成，则说明 service worker 是问题根源。

Question 3

如何修复在使用推理/思考模型（LM Studio、Ollama、Qwen3、DeepSeek-R1、Gemma）时 RSSMonster 中出现的 SEMANTIC_LABEL_INVALID_RESULT 错误和 AI 空响应问题？

Accepted Answer

原因：具备推理能力的模型会把整个 max_tokens 预算消耗在其内部的 `reasoning_content` 思维链上，返回的 `content` 为空且 `finish_reason: "length"`，因此 RSSMonster 的结构化输出任务（语义标签、文章评分/分类、智能文件夹推荐、订阅源重新发现）会静默失败，并报出 `SEMANTIC_LABEL_INVALID_RESULT` 或 `CompletionBudgetError` / `INFERENCE_COMPLETION_BUDGET_EXHAUSTED` 之类的错误。修复方法（按请求生效，无需更改 LM Studio/Ollama 中的模型级设置）：在 `inference/.env` 中添加以下变量并重启推理服务：

GENERATION_REASONING_EFFORT=none
CLASSIFICATION_REASONING_EFFORT=none

这样会在每次聊天补全请求中发送 `reasoning_effort: 'none'`，仅对 RSSMonster 的调用禁用思考，同时保持模型对其他应用的全局推理行为不变。注意：`enable_thinking: false` 可能因后端/模板不同而不生效——`reasoning_effort: 'none'` 才是可靠的选项。如果结果仍然超长或格式错误，也请禁用推测解码（draft model）。

Question 4

如何修复在 Cloudflare Tunnel 等反向代理后运行时登录出现的“网络错误”（ERR_CONNECTION_REFUSED）？

Accepted Answer

原因：在镜像升级后，前端 JavaScript 包将登录请求发送到了 `http://localhost:3000/api/auth/login` 而不是你的公网 FQDN，因此当通过反向代理（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) 直接重新加载页面——正确的计数就会恢复。要确认这是该 bug 而不是筛选问题,请直接检查 SQLite 数据库:受影响的文章应具有 `aiAnalysisStatus='complete'`、`filteredInd=0`,并且您账户的 `minAdvertisementScore`/`minSentimentScore`/`minQualityScore` 阈值应为 0。为减少出现频率,请确保您使用的是最新的 master 分支,其中包含 WAL 模式和 `server/config/databaseRuntime.js` 中的 `busy_timeout=5000`(可以缓解但不能完全消除低内存 NAS 环境下的 SQLite 锁定)。针对 `fetchOverviewCounts` 的自动有限重试/退避已被提出请求,但尚未实现。

RSSMonster

核心功能

避坑指南

适用场景

标签

快速上手

相似推荐