========================================================================
            个人媒体中心 (PMS) 自动化脚本套件 - 使用说明书
========================================================================

一、 套件简介
------------------------------------------------------------------------
这套脚本旨在构建一个低成本、无限存储、自动化的个人媒体中心。
核心闭环：JuiceFS (无限存储) -> Aria2 (下载) -> Unzip (解压) -> Web/Stream (展示)

二、 快速部署流程 (按顺序执行)
------------------------------------------------------------------------

[第一步：扩容存储]
1. 运行 juice.sh
   命令: bash juice.sh
   作用: 挂载 S3 对象存储到本地 (通常挂载点为 /mnt/你的名称)。
   注意: 这是所有数据的基础，必须最先运行。

[第二步：配置下载器]
2. 运行 aria2.sh
   命令: bash aria2.sh
   作用: 安装并管理 Aria2 下载器。
   关键配置: 安装后选择 "7. 修改配置" -> "3. 修改下载目录"，
            务必将目录修改为 JuiceFS 的挂载路径 (例如: /mnt/nas/downloads)，
            否则会占满本地硬盘空间。

[第三步：启动展示服务]
3. 运行 chfsma.sh (文件管理)
   命令: bash chfsma.sh
   作用: 提供全功能文件管理界面 (WebDAV/上传/下载)。
   端口: 默认 80 (视配置文件而定)。

5. 运行 phoo.py (沉浸式图库)
   前置要求: pip install flask
   配置修改: 编辑 phoo.py，将 IMAGE_ROOT = '/mnt' 改为你的实际挂载路径。
   启动命令: python3 phoo.py
   端口: 8090

6. 运行 vidd.py (视频流媒体)
   启动命令: python3 vidd.py
   交互输入: 启动后需输入视频所在的绝对路径 (例如: /mnt/nas/videos)。
   端口: 8091
   提示: 配合 VLC 播放器或浏览器直接播放。

三、 辅助工具与维护
------------------------------------------------------------------------

[自动解压]
脚本: unz.sh
命令: cd /你的下载目录 && bash /path/to/unz.sh
作用: 递归扫描当前目录下的 .zip 文件，校验并解压，跳过损坏文件。

[卸载与清理]
脚本: unjuice.sh
命令: bash unjuice.sh
作用: 强制卸载所有 JuiceFS 挂载点。当网络卡死或需要重启服务时使用。

四、 端口速查表
------------------------------------------------------------------------
服务        | 端口   | 说明
-----------|--------|------------------------------
Aria2 RPC  | 6800   | 下载控制 (RPC密钥在 aria2.sh 查看)
CHFS       | 80     | 文件管理 (需检查 chfs.ini)
Gallery    | 8090   | 图片浏览
Video      | 8091   | 视频串流

五、 常见问题 (FAQ)
------------------------------------------------------------------------
Q1: 为什么 phoo.py 报错 "Module not found"?
A1: 需要安装 Flask 库。运行: pip install flask

Q2: 下载速度很快，但本地磁盘满了？
A2: 检查 Aria2 的下载路径是否设置在了系统盘 (/root) 而不是挂载盘 (/mnt/xxx)。

Q3: 如何在后台运行 Python 脚本？
A3: 使用 nohup。例如: nohup python3 phoo.py > phoo.log 2>&1 &

Q4: 无法访问网页？
A4: 1. 检查云服务器防火墙是否放行了对应端口 (80, 8090, 8091, 6800)。
    2. 检查脚本是否正在运行 (使用 ps -ef | grep python 查看)。