# 浏览器插件排错

> 处理 Beav 浏览器插件无法连接、保存按钮缺失、采集未入库、批量任务中断和更新未生效。

- 原文: https://www.getbeav.com/docs/browser-extension/troubleshooting

排错时先判断问题发生在浏览器、插件连接还是 Beav 入库，不要连续重复点击同一个任务。

## 侧边栏显示未连接

1. 确认 Beav 桌面端正在运行。
2. 重新打开 Beav 工作空间。
3. 在扩展管理页确认 Beav 已启用。
4. 点击扩展卡片上的“重新加载”。
5. 刷新当前网页，再打开侧边栏。

本机防火墙或安全软件如果拦截 `127.0.0.1`，可能导致插件无法连接桌面端。只允许本机 Beav 需要的连接，不要把本地服务暴露到公网。

## 页面没有 Beav 按钮

* 确认网页已经加载完成。
* 刷新页面，让扩展内容脚本重新注入。
* 某些页面只在侧边栏提供操作，不一定显示页面内按钮。
* 小红书博主主页优先使用侧边栏或资料区入口。
* 浏览器内部页面、扩展商店和受保护页面不允许普通扩展注入。

## 插件显示成功，但知识库没有内容

1. 确认 Beav 当前工作空间正确。
2. 清除知识库筛选条件并重新搜索标题。
3. 检查侧边栏任务历史是否存在部分成功或失败原因。
4. 对长文章等待页面正文加载后重试。
5. 只重试一次，避免重复记录。

## 小红书批量采集中断

站点验证、页面刷新、网络波动或访问限制会中断任务。停止当前任务，完成页面验证，确认列表可以正常滚动后再继续。不要同时从多个页面发起大批量任务。

## 浏览器控制无法开始

确认目标页面由安装了 Beav 插件的真实 Chrome 打开，并且桌面端保持运行。外部 Agent 发起的浏览器控制还需要用户批准；如果任务处于等待审批状态，应先在 Beav 中处理审批。

## 更新后仍显示旧功能

确认新版文件已经覆盖原固定目录，并在扩展管理页点击“重新加载”。随后刷新目标网页，重启侧边栏。完整步骤见[更新浏览器插件](https://www.getbeav.com/docs/browser-extension/update)。

## 重新安装

只有在目录损坏或扩展持续报错时才重新安装：

1. 停止正在运行的任务。
2. 在扩展管理页移除 Beav。
3. 优先从 [Chrome 应用商店](https://chromewebstore.google.com/detail/dhfphfekcjahljnefpdjoidehnhhoeie?utm_source=item-share-cb)重新安装。
4. 无法使用商店时，下载并解压最新 ZIP 到固定目录，重新选择包含 `manifest.json` 的目录。
5. 完成一次保存网页和知识库确认。