私有云媒体管理系统产品系统

针对家庭 NAS 场景开发的⾼性能媒体资源管理平台，集成“资源采集-下载调度-多端播放-AI辅助维护”的
全链路流程

本项目是一款针对家庭NAS场景的私有云媒体管理系统，采用全栈独立开发模式，实现了从资源自动化采集、下载调度、元数据治理到多端播放的全链路闭环。核心目标是为家庭用户提供高性能、私密、安全的个人媒体库解决方案，避免依赖第三方云盘的隐私风险和限速问题。
主要功能模块包括：
1、资源采集与搜索：集成Scrapy爬虫自动抓取电影/剧集/动漫等元数据（标题、简介、海报、磁力链接），支持自定义规则和多来源聚合。
2、下载调度与管理：通过FastAPI后端对接qBittorrent，实现App端一键添加磁链/种子、实时进度监控、下载完成自动入库、优先级/限速策略。
3、媒体库管理：支持多类型媒体（电影、剧集、音乐、照片）分类、元数据编辑、封面优化（Pillow处理）、标签/评分/观看进度记录。
4、多端播放：Flutter跨平台客户端（Android/iOS/Windows/macOS/Linux/Web），提供流畅的原生级UI、Dio网络缓存、视频/音频在线播放、投屏支持（DLNA/AirPlay）。
5、用户与权限：多用户支持、访客模式、家庭成员独立观看历史、简单权限控制。
6、AI辅助维护：接入Dify + DeepSeek/Ollama本地大模型，实现RAG知识库问答（基于项目代码自动同步索引），辅助代码修改、问题诊断、元数据补全建议等。

1、跨平台前端（Flutter）
Flutter统一代码库实现Android/iOS/桌面/Web多端一致体验。Provider全局状态管理 + Dio网络封装（自定义缓存、拦截、离线策略），SharedPreferences持久化配置。视频播放集成chewie + video_player，支持硬件加速、字幕、倍速等原生交互，流畅低内存。
2、高性能异步后端（FastAPI）
FastAPI异步API支持高并发；WebSocket实时推送下载进度/通知。API对接qBittorrent，实现App一键磁链/种子下载、实时监控、完成自动入库、任务优先级/限速策略。
3、自动化采集与数据治理（Scrapy + Pillow）
Scrapy爬虫多站点规则配置、反爬处理，自动抓取元数据（标题/简介/磁链/海报）。Pillow图像压缩/裁剪/优化，Pipeline管道清洗、去重、MySQL持久化，确保媒体库高质量。
4、容器化部署与远程访问（Docker + Tailscale）
Dockerfile + docker-compose.yml一键编排全栈（前后端、MySQL、Redis、qBittorrent、Dify），适配NAS私有部署。Tailscale零信任组网实现安全内网穿透与远程访问，无需端口映射或公网IP。
5、AI工程化与RAG应用（Dify + DeepSeek/Ollama）
本地部署Dify平台，接入DeepSeek大模型 + Ollama (mxbai-embed-large)向量模型。容器化Python脚本实现“代码变更 → 自动同步Dify知识库 → 全量解析索引”闭环，构建项目专属RAG Agent，支持自然语言查询代码逻辑、片段推荐、Bug诊断，提升个人维护效率。