主页插件相关问题说明

本章整理主页插件使用过程中较常见的问题。遇到异常时，可以先按对应条目检查运行环境和设置。

1. 浏览器组件为什么无法显示网页

浏览器组件在思源笔记客户端中使用 Electron 的 WebView 元素实现网页浏览和操作。

在 Docker、局域网和移动端环境中，思源笔记实际运行在普通浏览器内，无法使用 WebView。插件从 v1.1.4 开始会在这些环境中改用 Iframe。

2. 远程图片为什么加载失败

从 v2.0.0 开始，插件会在移动端、Docker 和局域网环境中通过代理获取远程图片。代理加载速度可能较慢，也可能因网络或图片源限制而失败。

如果图片需要长期稳定展示，优先使用本地图片。

3. 切换明亮或暗黑模式后，颜色没有更新

插件从 v1.4.0 开始适配暗黑模式。热力图、最近日记的日历视图和番茄钟圆环等组件，在切换主题后可能需要手动刷新一次，才能更新标签和标题颜色。

4. 如何完全卸载插件

卸载插件后，相关配置数据仍会保留在笔记工作空间中。如果确认不再使用，可以进入下图所示路径手动删除：

其他插件的数据也保存在相同位置。删除前请确认目录对应的插件名称，避免误删仍在使用的数据。

5. 悬浮预览窗口为什么会卡顿

如果被预览的文档引用了大量其他文档，思源笔记的默认预览模式可能会加载全部引用内容，导致预览缓慢甚至界面卡死。

解决方法：

1. 打开 设置 → 导出 → 引用；
2. 如果当前模式是“脚注 + 锚点哈希”，改用其他锚文本模式；
3. 重新打开悬浮预览进行确认。