主页插件相关问题说明

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

0. 找不到“添加组件”或“主页设置”

5.0 版把这两个入口放到了主页空白处的右键菜单中。右键具体组件可以打开内容设置、刷新、样式或删除；右键标题、横幅、状态语、快捷按钮和页脚，可以直接进入对应区域设置。

移动端请点击右上角更多菜单，或先点击组件再选择编辑内容、调整样式和刷新。

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

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

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

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

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

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

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

5.0 版增加了主题系统。切换浅色、暗色或内置主题后，如果某个组件的内容没有立即更新，可以右键组件选择“刷新组件”。使用主题控制外观时，右键菜单可能显示“组件大小”，这是正常的。

如果问题只出现在某个数据组件中，再到“主页设置 → 检索管理”检查索引。

4. 如何完全卸载插件

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

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

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

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

解决方法：

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