# 素材库模式

> 把 Beav 切换成带 AI 素材理解的素材库，并让 Claude Code、Codex、WorkBuddy 等 Agent 接入使用。

- 原文: https://beav.pro/docs/workspace/library-mode

核对日期：2026-10-13。适用于 Beav 桌面端 2.9.0；源码已核对，真实桌面的动画与连接状态仍待验收。

Beav 有两种使用模式，全 App 统一，不跟随空间：

* **Agent 模式**：完整的 Beav，包括新对话、主页、AI 创作和工具&技能。
* **素材库模式**：只保留素材库、热点和日历，收起对话和 AI 创作入口，界面换成访达风格的灰白配色。素材入库后的 AI 处理照常工作，包括拆解、转写、视觉索引，照常消耗积分；定时任务也照常运行。

如果你主要在 Claude Code、Codex 等 Agent 里工作，只想让 Beav 管理素材，适合使用素材库模式。

## 切换模式

1. 点击左下角头像，打开账号菜单。
2. 在“外观”下方的“使用模式”里选择 **Agent** 或 **素材库**。

也可以按 `⌘⇧M`（Windows / Linux 为 `Ctrl+Shift+M`）。视频剪辑器的时间轴获得焦点时，这个快捷键仍然用于跳到上一个标记。

切到素材库模式时，左侧主侧栏会收走，热点、日历和头像飞进素材库的侧栏。切到素材库模式后会打开素材库页面；切回 Agent 模式会回到切换前所在的页面。系统开启“减少动态效果”时，不播放切换动画，直接切换。

## 素材库模式里有什么

* 没有左侧主侧栏，只剩素材库的侧栏：顶部是**热点**和**日历**，下面是素材库、知识库、订阅、账号档案、稿件和标签，底部是**接入 Agent**和你的头像。点热点或日历时右侧显示对应页面，再点侧栏里素材库的任意一项就回到素材库。
* 热点列表中的“AI 讨论”变为**存为选题**：点击后，热点标题和来源链接会存进选题。
* 从通知或链接打开对话等 Agent 模式的功能时，Beav 不会自动切换模式，而是在顶部提示该功能在 Agent 模式里，并提供“切换到 Agent 模式”按钮。

## 接入你的 Agent

点击侧栏左下角的**接入 Agent**（账号菜单里也有同名入口），打开接入弹窗：

1. 选择你的 Agent：Claude Code、Codex、WorkBuddy、Claude 桌面版或其他。
2. 按弹窗里的三步操作。Claude Code、Codex 和 WorkBuddy 复制一段话发给 Agent，Agent 会自己安装 Beav Creator 插件；Claude 桌面版需要在终端运行一条命令，然后打开生成的 `beav-creator.mcpb`；其他 Agent（例如 Cursor、Cherry Studio）添加一个 stdio MCP 服务器，命令和参数在弹窗里给出。
3. 回到弹窗，等待右侧状态变为**已连接**。

只要 Agent 在 Beav 本次启动以后调用过 Beav，弹窗右侧就会显示“已连接”和最近一次调用的时间；左下角“接入 Agent”旁的数字是已连接的 Agent 数量。这个状态不会保存，重启 Beav 后要等 Agent 再调用一次才会重新显示。弹窗下方还会显示本机端口的运行状态，端口未运行时可以直接点“启动”。

不要把凭据文件或令牌粘贴到任何对话里。Codex 与 WorkBuddy 的详细安装过程见[连接 Codex Desktop 与 WorkBuddy](https://beav.pro/docs/agent/connect)，Claude 见[连接 Claude](https://beav.pro/docs/agent/claude)。

## 当前限制

以下功能还在开发中，本版本没有：

* 右侧检查器和底部路径栏。
* 素材库模式下收窄外部 Agent 可以使用的工具。
* 素材库模式专属的外部 Agent 写入权限设置；现有 MCP 授权连接仍可按工具权限写入素材。
* 色彩拆分，以及按颜色筛选。