
项目定位与架构
该源码是一套面向 NAS 媒体库的自动化管理工具,后端基于 FastAPI,前端采用 Vue3,采用前后端分离架构,分别负责 API 服务与 Web 界面。
项目在保留关键功能的同时尽量简化配置,许多配置项可直接使用默认值,降低了上手门槛。
- 后端:FastAPI,提供 API 服务
- 前端:Vue3,负责 Web 界面与交互
- 配套资源库与插件仓库,便于扩展功能
核心特性与扩展方式
项目聚焦核心自动化整理需求,重新设计了用户界面,更加美观、清爽且易于上手。
支持插件扩展,可在后端的 plugins 目录中按照插件开发指引编写扩展代码,实现第三方集成。
- 插件项目:扩展功能与第三方集成能力
- 资源项目:提供各平台所需的库文件
- Wiki 项目:集中存放使用与开发文档
部署与开发环境
本地开发需要 Python 3.12 和 Node.js v20.12.1。部署时需克隆主项目仓库,安装后端依赖并运行主程序启动后端服务(默认监听 3001 端口);克隆前端项目,安装前端依赖并以开发模式运行后即可在浏览器访问界面。
克隆资源项目后,需将对应平台与版本的动态库文件复制到后端指定目录。项目提供官方 Wiki 文档,包含安装部署、基础配置与进阶使用说明。
- 后端默认端口:3001
- 开发环境:Python 3.12、Node.js v20.12.1