常见问题

桌面端无法打开

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

浏览器插件无法连接

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

保存后找不到内容

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

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

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

资产拖入或手机领取失败

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

Agent 读取官网后没有连接 Beav

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

Agent 每次都创建新会话

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

媒体任务长时间运行

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

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

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

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

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

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

兑换码、充值订单、第三方或本地模型的配置与保存失败，见账号、积分与模型设置。

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

小工具窗口右上角“更多”和剪辑器标题栏都有“反馈问题”，提交时可附带脱敏日志。小工具用法见内置小工具，剪辑见视频剪辑与智能剪口播。