# 常见问题

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

- 原文: https://beav.pro/docs/troubleshooting

## 桌面端无法打开

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

## 浏览器插件无法连接

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

## 保存后找不到内容

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

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

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

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

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

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

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

## Agent 每次都创建新会话

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

## 媒体任务长时间运行

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

## 生成结果出现，但找不到文件

先确认当前空间是不是发起任务时的空间；切换空间后，任务结果仍保存在原空间。再打开原对话，在右侧“稿件 → 本次会话”查看这次对话的附件、生成结果和素材包。聊天里出现的链接或文字不代表已经保存为素材或稿件，需要时让 AI 明确保存。

## 文件移动、分类或来源跳转失败

这些操作适用于 Beav 桌面端 2.8.13 及更新版本。先确认空间与来源是否可写；分类冲突先刷新，文件同名先处理名称。批量部分成功后只重试失败选区。移除关联目录入口不删除原文件，但目录内部回收会作用于电脑原件。旧素材没有来源关系时不会自动生成；原知识删除后素材仍保留。详细范围见[文件管理教程](https://beav.pro/docs/workflows/file-management)。

## 登录、积分或模型配置问题

兑换码、充值订单、第三方或本地模型的配置与保存失败，见[账号、积分与模型设置](https://beav.pro/docs/troubleshooting/account-and-models)。

## 本地小工具或剪辑器的问题

小工具窗口右上角“更多”和剪辑器标题栏都有“反馈问题”，提交时可附带脱敏日志。小工具用法见[内置小工具](https://beav.pro/docs/workflows/mini-tools)，剪辑见[视频剪辑与智能剪口播](https://beav.pro/docs/workflows/video-editing)。