FolioSpace Library

NAS / Docker / 自部署

给自己的电子书、漫画、PDF、ROM 和视频一个本地入口。

FolioSpace Library 运行在你的 NAS、Docker 主机或本地服务器上。 它不托管内容，也不是云盘，而是把你已经拥有的个人数字资产整理成一个统一索引， 再提供 Web 界面、客户端 API 和 MCP 工具给 Reader、GameEMU 或 Agent 使用。

Docker 安装 了解 Reader
FolioSpace Library 0.88
本地书库
扫描任务
游戏目录
客户端接口 GET /api/client/home GET /api/client/videos

为什么需要它

文件夹能存东西，但很难被不同设备舒服地使用。

很多人已经把漫画、电子书、PDF 手册、游戏 ROM、视频文件放在 NAS 或移动硬盘里。 问题不在于“有没有文件”，而在于缺少一个轻量、清楚、可被客户端读取的本地服务层。

电子书和 EPUB

记录阅读进度、封面、章节和私有状态，让 Reader 不必直接处理真实文件路径。

漫画和 ZIP / CBZ

按需读取归档里的页面，适合本地漫画库，也避免一开始就把大文件全部解开。

PDF 和说明书

扫描 PDF，生成首页预览，并通过服务 URL 提供单页或双页阅读。

本地 ROM 目录

只管理用户自己已有的本地 ROM 文件，不提供下载源，也不内置任何资源。

本地视频目录

浏览器能播的文件直接 Range streaming；不兼容编码可按需转成缓存 HLS。

扫描任务可见

扫描进度、耗时、暂停、取消、恢复和错误列表都能看到，出问题不用猜。

产品边界

它不是另一个大而全的媒体中心。

FolioSpace Library 的定位更接近“个人资产索引层 + 客户端服务层”。 它应该轻、透明、容易部署，而不是替代所有媒体服务器。

不是云服务

服务端由用户自己部署。FolioSpace 不上传、不托管、不同步你的内容。

不是 Plex / Jellyfin 替代品

视频能力目前偏轻量：本地索引、缩略图、直接播放和按需 HLS 转码。

不是 ROM 资源站

ROM 功能只索引本地已有文件，不提供下载、分发或版权资源。

不是只给网页用

它的核心价值是给 Vision Pro Reader、iPad、GameEMU、MCP Agent 等客户端提供统一入口。

快速开始

先用 Docker 跑起来，再把 NAS 目录挂进去。

当前版本：0.88。镜像支持 linux/amd64 和 linux/arm64。 /config 必须是可写持久化目录，用来保存 SQLite、封面、缩略图和缓存。 

docker pull funland/foliospace-library:0.88
docker run -d \
  --name foliospace-library \
  --restart unless-stopped \
  -p 8080:8080 \
  -v /volume1/docker/foliospace-library/config:/config \
  -v /volume2/ComicCenter:/library:ro \
  -v /volume2/Books:/books:ro \
  -v /volume2/GameROMS:/games:ro \
  -v /volume2/MovieCollection/Movies:/videos:ro \
  -e FOLIOSPACE_DIRECTORY_ROOTS=/library,/books,/games,/videos \
  funland/foliospace-library:0.88

打开 http://你的NAS地址:8080。首次进入会创建访问密钥， 然后选择容器内可见的目录，例如 /library、/books、 /games 或 /videos。

Reader

Vision Pro 阅读器会成为这个资产库的一个客户端。

Folio Space Reader 仍然保留自己的阅读体验：EPUB、PDF、ZIP 漫画、Mini Book 模式、 白噪音、插图查看和本地书库。后续它可以接入 FolioSpace Library， 从你的 NAS 读取同一套资源。

查看 Reader 联系支持

本地阅读优先

不是在空间里摆一个书架，而是让你更安静地读完一本书。

远程书库作为补充

Reader 可以继续支持本地导入，也可以逐步接入 NAS 上的 FolioSpace Library。

API / MCP

给客户端和 Agent 一个安全的服务入口。

Client API 返回的是服务 URL 和 manifest，不暴露 NAS 真实路径。 MCP 则让 Codex、Claude Desktop 或 Hermes 这类工具查询版本、健康状态、扫描任务、 视频转码状态和资源 manifest。 

curl -fsSL https://foliospace.app/install-mcp.sh | sh

foliospace.client_info
foliospace.list_videos
foliospace.open_video_manifest
foliospace.get_video_transcode_queue