Foxel Vibe 项目

项目简介

Foxel 是一个面向个人和团队的可扩展私有云存储方案，源自作者一门专业课的课设项目，近期在秋招准备阶段被重新拾起并补充了大量新功能。它把「文件在线预览 + 多种网盘聚合 + 自动化任务 + AI 语义检索」合到同一个 Web 界面，再通过 WebDAV / S3 映射把整套私有云反向暴露成标准协议，方便其它应用挂载使用。

核心功能

• 多协议在线预览：网页直接打开视频、Office、PDF、图片等常见文件类型，免去下载；点开即看，体验接近主流网盘。
• 存储挂载聚合：本地、S3、WebDAV、SFTP、OneDrive、夸克、115、123 等二十多种协议 / 网盘均可挂载，全部统一在同一个「文件」入口管理。
• 自动化任务：文件写入触发后可按路径、文件名规则匹配，自动派给处理器，例如加水印、做向量索引、归档到影视库等。
• 视频房间：异地协同看片，播放、暂停、进度实时同步，无需各自下载。
• LLM MCP 接入：通过 Model Context Protocol 暴露文件能力给外部 Agent，让 AI 直接管理你私有云里的资料。
• 协议反向映射：整盘私有云可以再次映射为 WebDAV 或 S3 端点，第三方应用（如 Zotero、备份工具）无缝挂载。

技术实现

Foxel 后端基于 Python（3.14+）和 React 19 构建，许可证为 MIT。它把存储抽象为统一的「适配器」，每一种协议 / 网盘对应一个适配器，统一对外提供文件读写接口。自动化任务引擎监听写入事件并按规则触发处理器，向量索引是其中一种内置处理器，输出结果回写到 Foxel 自身的检索端点供 MCP 查询。WebDAV / S3 映射通过在 Foxel 上再搭一层协议网关实现，整盘资源被原样映射出去，对外部应用透明。MCP Server 侧基于标准 MCP 协议暴露「读文件 / 搜索 / 触发自动化」等工具，第三方 Agent 可以直接连接调用。

快速上手

1. 克隆仓库：git clone https://github.com/DrizzleTime/Foxel.git && cd Foxel。
2. 用 Docker Compose 启动依赖，或按 README 安装 Python 3.14+ 与前端依赖。
3. 在「存储挂载」入口接入第一个存储源（推荐先接本地或 WebDAV 验证流程）。
4. 在「自动化任务」新建一条规则，例如「下载/目录下新增 mp4 → 触发处理器 → 加水印 + 写向量」。
5. 打开「LLM MCP」端点，把 Endpoint 填入支持 MCP 的 Agent（如 Claude Desktop），即可让 AI 检索 / 操作文件。
6. 在「WebDAV / S3 映射」页开启对外暴露，把映射端点配到 Zotero 等第三方工具。

适用人群

需要把散落在 OneDrive、115、夸克、S3、本地磁盘等多个云端的资料统一管理的个人用户；想给 AI Agent 配一个真正「私人知识库」的研究者 / 工程师；以及希望用 WebDAV / S3 把私有云反向挂载给现有工具链、不愿意被某个网盘生态绑死的团队。

官方链接

• 仓库：https://github.com/DrizzleTime/Foxel
• 在线体验：https://demo.foxel.cc