InvokeAI 如何用 image_subfolder_strategy 重新归档既有图片并执行存储维护任务【免费下载链接】InvokeAIInvoke is a leading creative engine for Stable Diffusion models, empowering professionals, artists, and enthusiasts to generate and create visual media using the latest AI-driven technologies. The solution offers an industry leading WebUI, and serves as the foundation for multiple commercial products.项目地址: https://gitcode.com/GitHub_Trending/in/InvokeAI当 InvokeAI 的图片库已经积累在outputs/images/下的单层目录里而你希望改用按日期或按类型分层的目录结构时会遇到一个具体问题修改image_subfolder_strategy只影响新创建的图片既有图片会留在原地。完成本任务的目标是把策略改成date、type或hash之一然后通过设置面板中的 Image Storage Maintenance 把既有图片和缩略图迁移到新布局并在过程中确认迁移状态、处理中断恢复。适用前提你是当前实例的管理员multi-user 模式下的 admin或者单用户本地安装未开启 multi-user 时唯一本地用户拥有相同权限。multi-user 模式下的非管理员无法启动迁移也无法查看迁移状态。这项操作会改什么、不会改什么Image Storage Maintenance 改变的是图片和缩略图在磁盘上的存放位置。它不会改变图片名称、boards画板、生成元数据或画廊记录。也就是说迁移后画廊里的板子结构和记录保持不变只有文件路径变了。Image Storage Maintenance 文档将其明确描述为与 board 组织相互独立的操作。第一步配置 image_subfolder_strategyimage_subfolder_strategy决定新创建图片的存放布局。有两种等价的修改方式编辑 InvokeAI 根目录下的invokeai.yaml以管理员身份在应用内的 Settings 面板中修改。根目录是包含models/、outputs/、databases/、invokeai.yaml等内容的目录启动时按--root参数、INVOKEAI_ROOT环境变量、当前虚拟环境所在目录、用户主目录下invokeai目录的顺序查找见 YAML 配置文档。在invokeai.yaml的用户设置区写入image_subfolder_strategy: date四个可选取值及其在文档中的示例路径如下路径为文档示例说明各策略产生的布局策略示例路径说明flatoutputs/images/abc123.png默认值图片直接存放在 images 目录dateoutputs/images/2026/03/17/abc123.png按创建日期分层typeoutputs/images/general/abc123.png按图片类别分层hashoutputs/images/ab/abc123.png用图片 UUID 前两个字符分桶适合大型图库的文件系统性能也可以不设 yaml 而用环境变量INVOKEAI_IMAGE_SUBFOLDER_STRATEGY传递。注意 InvokeAI 的读取优先级是CLI 参数 环境变量 invokeai.yaml 默认值环境变量会覆盖配置文件中的值。这一步完成后新生成的图片会进入新布局既有图片仍留在原位置需要下一步的维护任务来迁移。第二步执行图片迁移任务在应用内 Settings 面板中打开 Image Storage Maintenance 区域。管理员可以执行三类操作启动迁移Start Move、强制恢复force recovery、查看当前迁移状态。点击Start Move前InvokeAI 会先检查当前没有活跃的队列任务迁移才允许开始。迁移以维护操作的方式运行在移动进行期间InvokeAI 会阻止图片读取、上传、删除、生成任务和画廊变更与文件系统移动发生竞争。UI 会一直显示迁移或恢复状态直到任务完成或需要人工处理维护期间画廊图片和缩略图可能不可用。验证迁移结果文档给出的判断方式Settings 面板会报告还剩多少张图片待迁移。这是最直接的进度信号数字归零说明当前批次已覆盖完毕。UI 显示迁移或恢复状态直到 job 完成complete或需要人工处理requires manual attention。迁移成功后图片文件位于所选策略的布局下例如date策略下位于outputs/images/YYYY/MM/DD/路径数据库字段images.image_subfolder只在文件系统移动成功后才更新。成功迁移后留下的空源目录在安全的前提下会被自动删除。对于date策略既有图片按数据库中保存的原始创建时间戳归位而不是按维护任务运行的时间——迁移后旧图片会分散在历史日期目录下这是预期行为。中断后的崩溃恢复迁移过程是崩溃可恢复的每个移动 job 在动文件之前先写入数据库记录如果 InvokeAI 在迁移途中停止恢复流程会续跑未完成的 job。若恢复发现文件系统状态有歧义例如新旧路径的全尺寸图片同时存在或两个都不存在它会暂停该项交由人工处理而不是盲目更新数据库同一 job 中的其他项仍会继续完成job 记录为失败后维护锁会被释放。需要注意恢复只会完成已记录的 job还没来得及被规划进 job 的图片不会被恢复本身移动。恢复后 Settings 面板仍会显示剩余待迁移数量此时再次点击Start Move继续即可。失败项的处理路径缺失的中间态图片文件视为已清理不会中断迁移而非中间态文件缺失、图片不可读、文件截断则被记录为失败项。当全尺寸文件仍在原路径时恢复会保留它以便安全地修复或删除。维护锁释放后对失败文件先做备份然后二选一替换为一张有效图片或从画廊中删除其图片记录如果还有待迁移图片再运行一次Start Move。文档同时明确两条红线维护进行期间不要删除活跃的 journal 行也不要手动编辑images.image_subfolder字段。限制与边界权限边界multi-user 模式下非管理员既不能启动迁移也不能查看迁移状态single user 模式不受此限。运行边界迁移期间图片读取、上传、删除、生成、画廊写入全部被阻塞缩略图可能不可用因此应在没有队列工作负载的时段执行。数据边界迁移不改动图片名、boards、生成元数据、画廊记录它只重排磁盘文件并同步images.image_subfolder。如果只需要给未来的图片换布局而不迁移旧图那么只完成第一步的配置即可无需执行维护任务。相关文档Image Subfolder Strategyinvokeai.yaml、Image Storage Maintenance、Gallery。【免费下载链接】InvokeAIInvoke is a leading creative engine for Stable Diffusion models, empowering professionals, artists, and enthusiasts to generate and create visual media using the latest AI-driven technologies. The solution offers an industry leading WebUI, and serves as the foundation for multiple commercial products.项目地址: https://gitcode.com/GitHub_Trending/in/InvokeAI创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考