SD-Scripts项目中save_last_n_steps参数失效问题解析

问题背景

在kohya-ss/sd-scripts项目的FLUX分支中，用户报告了一个关于模型检查点保存功能的异常现象。当用户在训练配置中设置了save_last_n_steps = 3参数时，系统并没有按照预期保留最近的3个训练步骤检查点，而是保留了所有生成的检查点文件。

参数功能分析

在模型训练过程中，检查点保存机制对于模型恢复和性能评估至关重要。SD-Scripts项目提供了多个相关参数来控制检查点的保存行为：

1. epoch：设置总训练轮数
2. save_every_n_epochs：每隔多少轮保存一次检查点
3. save_last_n_steps：预期保留最近N个步骤的检查点（但实际存在问题）
4. save_last_n_epochs：正确保留最近N个轮次的检查点

问题根源

经过项目维护者的确认，问题的根本原因在于参数名称的使用错误。在FLUX分支中，save_last_n_steps参数实际上已被弃用或不再有效，正确的参数名称应为save_last_n_epochs。

解决方案

对于希望控制检查点保留数量的用户，应当：

1. 使用save_last_n_epochs替代save_last_n_steps
2. 参数值设置为3时，系统将自动保留最近的3个检查点
3. 结合save_every_n_epochs参数，可以精确控制检查点的生成和保留策略

实际应用建议

在实际训练过程中，合理的检查点保存策略应考虑以下因素：

1. 存储空间限制：过多的检查点会占用大量磁盘空间
2. 训练中断恢复：保留足够检查点以确保能从最近的进度恢复
3. 模型性能评估：需要保留关键训练阶段的模型用于比较

建议的配置示例：

epoch = 50
save_every_n_epochs = 10
save_last_n_epochs = 3

这种配置将在50轮训练中每10轮保存一次检查点，同时自动清理旧检查点，只保留最近的3个，既保证了训练过程的可恢复性，又避免了存储空间的浪费。

总结

在使用SD-Scripts进行模型训练时，开发者应当注意参数名称的准确性。save_last_n_epochs是控制检查点保留数量的正确参数，而save_last_n_steps在当前版本中已不再适用。正确的参数使用可以确保训练过程的稳定性和存储资源的高效利用。