抽象插画:叠放的漫画分镜页、四层存储条和一枚带锁孔的朱砂印

私人书库

MangaPrivate

跑在 Cloudflare 边缘上的私人漫画与小说库

只供自用,进入需要登录。

项目介绍

一个只给自己用的书库:多来源搜索与入库、阅读进度同步、收藏与永久保存,登录后还有一个 AI 工作区。整套系统跑在 Cloudflare Workers 上,没有一台常驻服务器。

这是一个只给自己用的项目,进入需要登录。放在这里,是因为它是我们在 Cloudflare 上走得最远的一次:Workers、D1、R2、Queues、Cache API 和定时任务全都用上了,再接上 Google Drive 做永久存储。

阅读器在手机和电脑上共用一套界面,图片在浏览器里用 Canvas 渲染,阅读进度和书架实时同步。项目附带移动端界面的自动化测试、存储审计脚本,以及一份完整的恢复指南。

私人书库

亮点

  1. 01

    四级存储

    Google Drive 做永久主存储,R2 存收藏的热副本,Cache API 做临时缓存,D1 记录元数据和副本索引;读取时按 R2 → 边缘缓存 → Drive → 来源逐级回退。

  2. 02

    验收过才算保存

    「已保存」要求永久副本通过完整性校验,缓存命中不能代替验收。云端删除失败会被记录下来,数据库记录保留,方便重试。

  3. 03

    队列驱动的后台任务

    预取、复制、迁移和清理都走 Cloudflare Queues,带重试和死信队列;定时任务负责清理过期元数据。

  4. 04

    带上下文的 AI 工作区

    流式对话、模型切换、对当前页做视觉理解、文生图。上游的流式输出在 Worker 里统一成一套事件格式,只开放只读工具,浏览器永远接触不到任何 key。

  5. 05

    为恢复而设计

    一条命令完成生产环境配置;固定版本的稳定版恢复包加上跨平台恢复指南,换一台电脑也能把整套服务重建起来。