# 常见问题

> 快速定位 Beav 安装、浏览器插件、知识库、Agent 接入和媒体任务中的常见问题。

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

## 桌面端无法打开

确认安装包与系统和架构匹配。macOS Apple Silicon 使用 `aarch64`，Intel 使用 `x64`；大多数 Windows 和 Linux 电脑使用 `x64`。Linux 可优先使用 AppImage，Debian、Ubuntu 及其衍生发行版也可使用 DEB。重新下载前先确认原文件是否完整。

## 浏览器插件无法连接

保持 Beav 运行，确认扩展已启用，重新加载扩展并刷新网页。详细步骤见[浏览器插件排错](https://www.getbeav.com/docs/browser-extension/troubleshooting)。

## 保存后找不到内容

确认当前工作空间和知识库筛选条件。使用来源标题或链接搜索，并检查插件任务历史。如果只显示部分成功，按错误原因等待页面加载或重新采集一次。

## 手机上传打不开或提交未确认

确认电脑已启动 Beav、没有休眠，且手机与电脑在互通的同一局域网。换网络、配对到期或清理浏览器数据后，重新从知识库“手机上传”扫码配对。提交未确认时先点“检查结果”，必要时点“重试原提交”；已接收但采集失败时在电脑卡片上处理。详细步骤见[手机上传笔记链接](https://www.getbeav.com/docs/workflows/phone-upload)。

## 资产拖入或手机领取失败

把电脑文件拖到内容资产主区域，关闭已有命名窗口；切换空间或目录后重新拖入。手机领取需同一局域网和运行中的电脑，二维码有效 30 分钟；文档与 ZIP 下载后在手机文件管理器查看。详细步骤见[资产分享到手机与拖入文件](https://www.getbeav.com/docs/workflows/asset-sharing)。

## Agent 读取官网后没有连接 Beav

先确认 Agent 运行在安装 Beav 的同一台电脑上。Web 或云端 Agent 无法读取本机 discovery 文件。然后确认 ACP Gateway 已启用、Beav 正在运行，以及 Token 是否通过环境变量提供。

## Agent 每次都创建新会话

要求 Agent 保存并复用上一次返回的 `sessionId` 或 `acpSessionId`。继续同一创作目标时不要省略会话 ID。

## 媒体任务长时间运行

先查看任务状态和事件，不要重复提交同一生成。遇到 `awaiting_approval` 先处理审批。详细说明见[性能与长任务](https://www.getbeav.com/docs/troubleshooting/long-running-tasks)。

## 生成结果出现，但项目中找不到

检查结果是否已经保存到媒体库，并与对应稿件、主体或项目绑定。临时预览或聊天中的链接不能替代正式资产记录。