# 本机素材库网页与开放接口

> 在浏览器或 AI 工具侧栏打开 127.0.0.1:31937/library 只读浏览知识库和素材库，把内容加到其他 AI 的对话，或通过本机接口读取。

- 原文: https://beav.pro/docs/agent/local-library

核对日期：2026-10-08。此功能随 Beav 桌面端 2.8.14 提供；本机页面与外部 Agent 连接已完成源码核对，实际客户端组合仍应按下文前提验证。

Beav 运行时，会在本机提供一个只读的素材库网页和接口，方便你在 Claude、ChatGPT、WorkBuddy 等其他 AI 工具里使用 Beav 中的资料。

## 打开素材库网页

在浏览器或 AI 工具的侧栏打开：

```text
http://127.0.0.1:31937/library
```

页面显示当前空间的知识库和素材库：

* 顶部搜索，切换“知识库 / 素材库”。
* 素材库可以按图片、视频、音频、文案筛选，点击文件夹进入。
* 点击卡片打开详情，查看正文、转写、图片和文件夹内容。

这个页面只能浏览，不能修改、删除或导入内容；新增内容仍走 Beav 原有的入口。Beav 没有运行时页面会提示“连不上 Beav”。

![浏览器中的 Beav 素材库网页，知识库标签下显示多张内容卡片，每张都有加到对话和复制引用按钮](https://beav.pro/screenshots/local-library-web-zh-2026-10-07.webp)

*在浏览器中打开本机素材库网页，只读浏览知识库，并把内容加到其他 AI 的对话。*

![本机素材库网页的素材库标签，显示类型筛选、两个文件夹和多张图片](https://beav.pro/screenshots/local-library-web-assets-zh-2026-10-07.webp)

*素材库可按图片、视频、音频、文案筛选，点击文件夹进入。*

## 把内容交给正在用的 AI

* **加到对话**：图片素材会复制为图片；知识条目和其他素材会复制为一段 Markdown（标题、出处、原文链接、Beav 引用、正文、转写和图片地址），到聊天框粘贴即可。视频和音频只复制说明和地址，文件本身需要另外上传。
* **复制引用**：只复制标题、`knowledge://` 或 `assets://` 引用和本机读取地址，适合已接入 [Beav Creator 插件](https://beav.pro/docs/agent/connect)、能自己读取 Beav 的 Agent。
* **拖入聊天框**：也可以把卡片拖进 AI 的聊天框，能否接收取决于各工具。

网页版 Claude、ChatGPT 等云端工具访问不到你电脑上的 `127.0.0.1`，请使用“加到对话”。

已安装 Beav Creator 插件的 Agent 知道这个网页。2026-10-08 更新的 [Codex 安装指引](https://beav.pro/docs/agent/connect)会让新聊天在连接验证后读取当前空间的档案，并在 Codex 右侧浏览器打开知识库；原安装回复也会说明当前空间、档案读取与网页打开结果。该流程使用 2.8.14 既有接口，需更新后的官网指引或插件 Skill，修改后的完整安装流程尚待实机验收。其他时候也可以直接让 Agent 打开网页挑素材；宿主没有侧边浏览器工具时改用系统浏览器，失败时提供链接。

## 本机只读接口

外部程序和 Agent 可以读取：

```text
http://127.0.0.1:31937/api/v1/library
```

了解可用的只读接口：知识库列表与搜索、素材库列表与搜索、读取单条内容（可以直接返回 Markdown）以及读取媒体文件。

* 本机程序访问不需要 token。
* 只接受本机地址访问，其他网站在浏览器中发起的跨站请求会被拒绝。
* 接口只监听回环地址，局域网中的其他设备无法访问。需要从其他设备使用 Beav，请看[网页访问](https://beav.pro/docs/remote-access)。