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

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

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

打开素材库网页

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

http://127.0.0.1:31937/library

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

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

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

把内容交给正在用的 AI

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

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

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

本机只读接口

外部程序和 Agent 可以读取：

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

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

• 本机程序访问不需要 token。
• 只接受本机地址访问，其他网站在浏览器中发起的跨站请求会被拒绝。
• 接口只监听回环地址，局域网中的其他设备无法访问。需要从其他设备使用 Beav，请看网页访问。