Photoview多用户共享媒体库配置问题解析

问题背景

在Photoview项目中，当管理员创建第二个用户并设置相同的媒体库根路径时，新用户界面中出现了与管理员不同的媒体展示结构。管理员看到的是标准时间线视图，而新用户却看到的是嵌套的"photos"相册结构，这显然不符合用户预期。

技术原理

Photoview采用基于用户的媒体库索引机制。每个用户首次访问系统时，都需要执行完整的媒体库扫描来建立自己的索引数据库。即使多个用户配置了相同的根路径，系统仍会为每个用户维护独立的索引。

解决方案

要实现多用户共享同一媒体库的正确显示，需要执行以下步骤：

1. 统一根路径配置：确保所有用户在设置页面都配置了相同的媒体库根路径（如/photos）

2. 执行全量扫描：

   • 管理员在"Scanner"区域点击"Scan all users"按钮
   • 或针对特定用户在用户管理表格中点击"Scan"按钮

3. 等待扫描完成：首次扫描可能需要较长时间（取决于媒体库大小），但后续增量扫描会快很多

技术细节

• 扫描过程会解析媒体文件元数据并建立优化后的数据库索引
• 每个用户的视图结构（时间线/相册）由索引数据决定
• 系统采用差异扫描算法，后续扫描只处理新增或修改的文件

最佳实践建议

1. 对于大型媒体库，建议在系统空闲时段执行首次扫描
2. 确保所有用户对媒体库路径具有相同的读写权限
3. 定期检查扫描任务状态，确保索引完整性

常见误区

• 认为配置相同路径后内容会自动同步（实际上需要手动触发扫描）
• 低估首次扫描所需时间（应提前规划好扫描时段）
• 忽略系统权限配置（可能导致扫描不完整）

通过正确理解Photoview的索引机制和遵循上述操作流程，可以确保多用户环境下媒体库的一致展示体验。