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），僅供參考 InvokeAI 如何用 image_subfolder_strategy 重新歸檔既有圖片并執行存儲維護任務
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），僅供參考