dsh-rss-reader

LIMITATIONS

Known limitations

- **BBC 等部分站点**：若网络环境无法直连，会报网络错误（属环境问题，非解析问题）。 - **Markdown 是自带渲染器**：因为客户端 bundle 不允许引入 `marked` 等库，渲染器覆盖的是订阅源真正会用到的语法子集（标题、列表、引用、表格、代码、链接、图片、粗斜体、分隔线）。极冷门的语法（脚注、定义列表、HTML 内联）会退化为纯文本。 - **图片只显示不下载**：图片按远程 URL 直接引用（带 `no-referrer`），插件不会代理或缓存图片，因此需要能直连图床。 - **图片位置靠 Markdown 结构还原，不理解 HTML 版式**：插件把订阅源正文转成 Markdown 再渲染，所以「图在它原来待的段落之间」是准的，但原文里靠 CSS 实现的复杂版式（多图并排、图文环绕、图注在侧）不会被还原——那些信息在转 Markdown 的那一步就没了。连续的图片会合成一组，因此「并排三张」与「上下三张」在插件里长得一样。 - **翻译质量取决于所配置的模型**：插件只负责把 Markdown 结构和 URL 原样交给模型并要求保留；模型仍可能改动人名或术语。 - **RSSHub 覆盖度随实例而异**：路由由社区维护，实例之间版本不同；某条路由在一个实例上 503（限流）不代表不可用，换实例或自建通常更稳。部分路由（如微博、B 站）在公共实例上需要配置 `key` 或 Cookie。 - **「探索」看到的是实例自己的路由表**：分类与路由都来自你配置的那个实例。官方实例不可达时，在 **设置 → RSS 阅读器 → RSSHub 实例** 里换成可达的（公共镜像或自建）即可，不用改配置、不用重启；换完两个功能一起跟着走，旧实例的缓存会被丢掉。 - **首次打开探索要等一次大请求**：整张表约 3.3 MB（压缩后），实测约 1 秒；之后走宿主内存缓存（默认 12 小时）。缓存是**进程内**的，所以重启 `dsh web` 后第一次打开又要拉一次。 - **探索不判断「哪条真的能取到」**：`需配置` / `反爬` / `需浏览器` 是路由自己声明的，插件照实显示。真正失败会像任何订阅源一样记在 `lastError` 里（例如实例对该路由返回 `503`），不会因为来自探索页就特殊对待。 - **参数只支持写在路径里的**：路由表偶尔会给出路径模板里没有的参数键（例如某些路由的 `routeParams`）。插件不猜它们的位置——猜错会拼出一个语义不同的地址。这类路由仍可订阅，但那些参数需要你在「+ 添加订阅源」里手改地址。 - **发现只推荐"可直接订阅"的路由**：需要参数才能生成的路由只作提示列出，不会当成可订阅项。 - **无全文抓取**：只读取订阅源自身提供的内容，不会去抓取原文页面补全正文。 - **无 OPML 导入 / 导出**：目前只能逐条添加（状态文件为 JSON，可直接编辑）。 - **右侧边栏面板依赖该功能存在**：tab 注册在 `dsh-web-app` 自带的右侧边栏（`sidebarRightTabs` / `sidebarRight`）上。若某个 profile 没有它，插件照常加载，只有中间主区域的三栏面板可用。 - **左侧栏入口可以关，中间面板本身不能关**：设置里的开关控制的是「左侧栏那一行」，`main` 面板始终注册着——只是关掉那一行后就只能从右侧边栏或底部按钮打开面板。这与「隐藏入口」的字面意思一致，但值得知道：关掉后中间的三栏面板不会消失，只是少了一个入口。 - **偏好是每个 DSH 实例一份**：存在宿主的状态文件里，不是浏览器本地存储。所以同一个人换浏览器、或用别的机器访问同一个 DSH，看到的是同一个选择；反过来，两个不同的 DSH 实例互不影响。