追星物料资料库
将“我收藏了一堆物料，想按艺人或活动找回来”变成离线目录。只用 Python 3.9+ 标准库，有文件与执行工具的 AI 均可调用；没有执行工具就先整理标签表，不能宣称扫描了目录。
用法
用户明确指定要整理的文件夹后，运行：
python {baseDir}/scripts/fan_library.py 用户文件夹 --out 新的输出目录
--metadata 标签.json 可关联用户提供的标签；--hash 才读取文件内容计算完全重复。标签模板见 示例，键为相对文件名，值可填 artist、event、date、source_url、rights。不从文件名猜测真实人物、活动或版权；没有标签就留空。
输出 library.html（可搜索文件名与标签的离线目录）、catalog.json（元信息与重复组）、summary.txt。输出目录必须是输入目录之外的新目录，不覆盖现有结果。原文件保持原位；报告本身包含文件名和标签，默认只留本机，不公开上传。
解释结果
- 显示相对文件名、扩展名、大小、最后修改时间和人工标签；修改时间不是拍摄日期，不能据此断定现场时间。
--hash只把内容指纹完全相同且读取期间未变化的文件列为重复，不代表视觉相似或应删除的文件。超过单文件 512 MB 的内容默认不读，标记未比对；可由用户调整--hash-max-mb。- 默认最多枚举 20000 个候选文件，达到上限明确报告截断。跳过隐藏路径、符号链接及重解析点，避免扫到目录外。文件打不开就列为异常，不声称完整。
- 只按扩展名分类，不校验格式，不读取 EXIF/定位，不做 OCR、人脸识别或版权鉴定。网页没有自动打开原文件的功能，只提供原相对路径，用户自行查看。
- 不抓取付费物料、不去水印、不整理非公开位置或私人信息。若以后需要改名、移动、删除，应作为独立任务先提供可审阅清单，不在本技能中执行。
首次可使用 示例文件夹 和示例标签生成目录；其中只有虚构文本演示文件，不代表真实艺人物料。
