JavSP项目文件整理功能使用注意事项与数据恢复方案

项目背景与功能概述

JavSP是一个开源的日本影视(JAV)元数据整理工具，主要功能包括影片信息刮削、文件重命名和分类整理。该项目采用Python开发，遵循GPLv3开源协议，完全免费且不涉及任何商业用途。

核心功能机制解析

该工具的文件整理功能采用以下工作流程：

1. 扫描阶段：遍历指定目录下的视频文件
2. 元数据获取：通过在线API获取影片的详细信息
3. 文件重组：根据配置将文件移动到新的目录结构中
4. 日志记录：所有文件移动操作都会记录到FileMove.log文件中

典型问题场景分析

近期有用户反馈，在未充分了解功能机制的情况下直接运行程序，导致大量视频文件被自动重组，原有目录结构被改变。这主要源于以下几个关键因素：

1. 默认配置行为：早期版本(1.7.x)的config.ini文件中，文件移动功能默认开启
2. 文件关联问题：主程序仅移动视频文件，未同步处理配套的字幕文件
3. 目录结构变更：程序会按照自己的命名规则创建新的目录层级

数据恢复解决方案

对于已经发生文件移动的情况，可通过以下方法恢复：

基于日志文件的恢复

程序生成的FileMove.log包含完整的原始路径和新路径映射关系。可通过编写简单脚本实现批量恢复，示例逻辑：

import shutil
import os

with open('FileMove.log', 'r') as f:
    for line in f:
        # 解析日志行获取原始路径和新路径
        new_path, original_path = line.strip().split(' -> ')
        # 将文件移回原位置
        shutil.move(new_path, original_path)
        # 删除空目录
        os.removedirs(os.path.dirname(new_path))

手动配置调整建议

为避免未来出现类似问题，建议在使用前进行以下配置：

1. 版本1.7.x用户：修改config.ini中的相关参数
2. 新版用户：在config.yml中设置summarizer.move_files: false

最佳实践建议

1. 测试环境验证：首次使用应在小规模测试数据集上验证效果
2. 备份策略：执行批量操作前确保有完整备份
3. 渐进式处理：对于大型媒体库，建议分批次处理
4. 配套文件处理：注意检查字幕、封面等关联文件是否被正确处理

技术实现改进方向

从技术架构角度看，未来版本可考虑：

1. 更安全的默认配置：将移动功能设为默认关闭
2. 操作预览模式：提供"dry run"选项只显示将要执行的操作
3. 关联文件处理：增强对字幕、NFO等配套文件的同步处理
4. 回滚功能：内置一键恢复机制

用户责任与注意事项

作为开源软件用户，应当注意：

1. 阅读文档：使用前仔细阅读README和配置文件说明
2. 理解风险：GPLv3协议明确声明不提供任何担保
3. 技术准备：批量操作重要数据前应具备基本的问题处理能力

通过以上分析和建议，希望用户能够更安全有效地使用JavSP项目，避免数据管理风险，充分发挥工具的价值。