常见问题

桌面端无法打开

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

浏览器插件无法连接

保持 Beav 运行，确认扩展已启用，重新加载扩展并刷新网页。详细步骤见浏览器插件排错。

保存后找不到内容

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

Agent 读取官网后没有连接 Beav

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

Agent 每次都创建新会话

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

媒体任务长时间运行

先查看任务状态和事件，不要重复提交同一生成。遇到 awaiting_approval 先处理审批。详细说明见性能与长任务。

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

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