makerhub

MakerHub 是一个面向 NAS 的 MakerWorld 私有归档与订阅系统。它基于 mw_archive_py 库进行二次重构，将 MakerWorld 模型、图片、附件、评论和打印配置自动保存到本地 NAS 中。系统支持单模型和批量归档模式，允许用户创建收藏夹并订阅关注来源的新模型。MakerHub 提供分页搜索、筛选、收藏、打印标记、软删除和文件管理功能，并通过 CloakBrowser 技术复用真实浏览器登录态，有效解决国内访问问题。

核心特性包括： - 自动抓取 MakerWorld 模型、作者页、收藏夹和合集 - 定时发现并归档新发布的模型 - 支持本地导入 3MF、STL、STEP、OBJ 格式文件及压缩包附件 - 浏览器会话复用机制，避免重复登录 - 任务监控与诊断功能，显示归档进度、刷新状态和缺失 3MF 修复情况 - 自托管更新能力，支持从 GitHub Container Registry (GHCR) 手动拉取镜像进行升级

系统采用微服务架构，包含 API 服务、Worker 进程、PostgreSQL 数据库和 CloakBrowser Manager。数据分离存储：PostgreSQL 负责结构化状态管理（配置、任务状态、业务日志），文件系统用于保存模型本体、图片、附件和导入文件；CloakBrowser profile 则独立管理浏览器会话与 Cookie，实现登录态复用。

默认部署包含四个容器服务：App 提供 FastAPI API 和 Vue 页面、Worker 处理归档队列和后台任务、PostgreSQL 存储配置与索引数据、CloakBrowser Manager 负责浏览器 profile 管理与会话控制。