Banana Loop
以使用者書寫的語言回覆。
使用者入口為 快速入門。不要讓初次使用者閱讀所有內部文件;請遵循以下的引導原則和 代理工作流程指南,僅引導當前所需的步驟。
如果使用者詢問要在聊天中輸入什麼,或需要一個現成的範例,請從 複製貼上請求範例 中選取與情況相符的項目。請勿在一次回覆中列出所有範例。
引導初次使用者
- 當你收到技能、圖片或劇情概要時,首先閱讀你能存取的所有資料,然後給出 3-5 句話:資料摘要 -> 推薦的生成方式 -> 下一步。在你閱讀某些內容之前,請說你會檢查它;切勿說你檢查了你無法閱讀的資料。不要在第一次回覆中傾瀉安裝說明、完整的診斷表或長篇程式碼。具體範例請遵循 首次回覆範本。
- 在引導中,將生成方式稱為 ① 純文字 ② 單一參考圖片 ③ 參考資料夾(按順序)。當使用者描述結果時,代理會選擇匹配的方式。如果有多張圖片但使用者只提到一張,則為方式 ②;不要僅僅因為附加了圖片就強行將參考圖片套用到文字請求上。
- 如果僅移交了資料且目標不明確,請簡短建議一個可能的任務,並詢問他們想要的結果。不要自動開始生成劇情概要中的每個場景。如果任務已請求且資訊足夠,給出簡短說明後繼續;不要停下來要求批准同一件事。
- 首先釐清使用者想要的結果和提供的資料。不要將內部術語(如 mode、slot、stride 或 JSON)強加給使用者作為選擇。
- 如果缺少資訊,僅詢問決定結果所需的問題,並將其歸納在一起。跳過已在「什麼任務」、「資料在哪裡」、「需要多少」等問題中回答過的內容。根據請求上下文決定簡單的構圖或風格選擇,並簡要提及。
- 判斷目前階段:僅排序、首次運行、修改結果、或停止/恢復。如果僅請求排序,則在此停止。如果是首次運行,先提供完成的檔案,並解釋如何用小量進行檢查。對於修改請求,重複使用現有資料、計畫和共享引擎。
- 區分使用者的工作和代理的工作。閱讀資料、連結名稱、編寫提示、構建和檢查是代理的工作。僅引導使用者執行工具無法執行的操作(登入、粘貼到控制台、選擇資料夾),具體而言。不要將瀏覽器連接作為建立檔案的前提條件。
- 首次交接以最新的運行檔案連結結束,其中必須包含參考圖片的位置、現在要做什麼,以及驗證的真實範圍。如果發生錯誤,請檢查進度位置和症狀並繼續提供幫助。使用者偏好簡短回覆優先於回答格式。
- 在開始準備工作前,告知使用者不支援的工作。不要將未實現的功能宣傳為可用範例,或讓使用者嘗試會失敗的程式碼。
閱讀任務描述和提供的資料,並建立一個包含提示、引擎和面板的 paste_into_console.js。不要將其綁定到特定專案、帳戶、資料夾或代理。將其與能夠讀取檔案和執行 Python 的代理一起使用。這是一個 alpha 版本。
核心工作原則
根據請求選擇三種方式中的一種。文字生成僅交換提示;單一參考圖片生成保留原始圖片。使用多張參考圖片的序列生成是 一個參考圖片 -> 為該原始圖片運行所有準備好的提示 -> 刪除現有參考圖片 -> 上傳下一個參考圖片 -> 運行下一個提示組。代理準備每個圖片的提示和運行順序,使用者連接資料夾並在需要時啟動。在同一組內始終保持相同的原始圖片,切勿使用生成的結果作為下一個原始圖片。
每個圖片的提示數量可以根據請求而變化。不要固定為 6 個提示,也不要在每個圖片上應用相同的句子。不要要求使用者匹配角色和背景進行合成,也不要將多參考圖片功能擴展到預設任務中。也支援無參考圖片生成和保留單一原始圖片。
當前引擎 0.3.2-alpha.6 的資料夾模式實現了這種順序交換結構。實際接受的請求驗證範圍記錄在 references/release-checks.md 中。當一個組的請求處理完畢後,它會移動到下一個圖片;不要將其描述為等待圖片渲染完成。它在最後一張圖片後結束,並且僅在使用者要求完全重複時才開啟無限重複。序列任務使用 Shuffle OFF。
理解任務並選擇模式
首次使用時,請閱讀 環境檢查與代理回應指南。按以下順序進行:環境檢查 -> 每個切片的資料和提示 -> 完成的運行檔案和簡短啟動指南 -> 基於證據的錯誤處理。分別檢查檔案存取、程式碼執行和瀏覽器控制是否可能,並且不要重新詢問已確認的內容。清楚說明實際工作位置和驗證範圍。根據實際情況調整回應範例,不要將未經驗證的功能複製為已完成的狀態。
從請求中,確定要保留的內容、要更改的內容以及所需的切片數、重複次數和順序。不要重新詢問你已擁有的資訊。當資料和目的足夠時,代理會在下方選擇一種模式;不要將技術模式的選擇留給使用者。
| 任務 | 建構選項 | 行為 |
|---|---|---|
| ① 純文字 | --reference none | 僅交換提示。網站上現有的參考圖片保持空白。 |
| ② 單一參考圖片 | --reference manual | 保留使用者上傳到網站的原始圖片,僅交換提示。 |
| ③ 參考資料夾(按順序) | --reference folder | 處理一個原始圖片的提示組,刪除它,然後上傳下一個編號的原始圖片。 |
生成的結果不會自動連結為下一個原始圖片。上表是目前引擎支援的範圍。僅在單獨請求時才解釋不支援多參考圖片合成;不要將其作為預設序列運行的前提條件。
資料夾排序
當被要求時,自行查看圖片和場景,並設定適合目的的順序。保留原始圖片並將其複製到一個單獨的資料夾中,例如 sorted_refs,命名為 01_name.png、02_name.jpg。保留副檔名,並簡短展示原始名稱 -> 新名稱 -> 排序原因。在僅請求排序的階段,不要超前進行提示生成或運行。
相對於使用者指定的實際工作資料夾進行讀取和編輯。資料名稱和切片順序是不同的事情。重新命名或複製時,也更新切片清單中的檔案連結並驗證它們是否存在。如果你進行了複製,請說明確切路徑。不要將編輯不同資料夾的結果報告為編輯原始資料夾。
編號是唯一的,範圍 1-999;支援的格式為 PNG、JPG、JPEG 和 WebP。將圖片直接放在要連接的資料夾下。詳細規則請參閱 naming.md。
編寫提示
根據使用者的要求撰寫任意數量的英文提示。根據目的編寫主體、場景、景框、光線和風格,並在變體中區分要保留的內容和要更改的內容。不要隨意將更改標誌、文字、插圖或頭髮的請求轉變為將其移除、使其逼真或固定頭髮的指令。對於單人單鏡頭,也要說明不需要多視圖或重複頁面。
如果請求角色設定圖且未指定其他版面,則使用 左側臉部特寫 -> 中央正面全身 -> 右側背面全身 作為預設。三個視圖保持相同角色的服裝、頭髮、藝術風格和共同背景。不要強制版面比例或長寬比;使用者對版面、視圖數量或保留現有角色設定圖版面的請求具有優先權。將此標準應用於角色設定圖變體請求,但不要自動將普通的服裝/頭髮變更或場景工作轉變為角色設定圖工作。不要將單視圖或非角色設定圖指令放入角色設定圖提示中。例如文字,請參閱 prompt-styles.md 中的角色設定圖條目。
如果沒有請求特定的長寬比,請使用 aspect: "site"。模型、長寬比和輸出數量使用網站當前的設定。預設為 Loop OFF 和 Shuffle OFF;根據請求更改它們。順序交換使用 Shuffle OFF。解釋如何用小量進行檢查,但不要強制一個讓你必須等待結果才能提供完整請求程式碼的程序。
風格參考: prompt-styles.md。僅在需要預設拍攝計劃預設時,才使用 axes.md 搭配 scripts/scan_refs.py 和 scripts/build_prompts.py。不要將自由形式的請求限制為四個預設。
設定變化的軸向以符合每個切片的目的。轉換會保留臉部和身體,並更改服裝和道具。角色-背景合成會保留兩者的身份,並匹配接地、透視和陰影。相機比較會保留姿勢、地點和光線,僅更改景框;光線比較會保留姿勢、地點和景框,僅更改光線。如果請求組合,請為每個切片構建組合;不要對所有資料應用相同的固定句子。
資料格式
{
"schema_version": 1,
"mode": "WITH_REF",
"project": "使用者專案名稱",
"aspect": "site",
"stride": 10,
"prompts": {
"1": "使用原始參考圖片。保留主體設計。僅將背景更改為淺色工作室背景。",
"11": "使用相同的原始參考圖片。保留主體設計。僅將背景更改為深色工作室背景。"
},
"labels": {"1": "淺色背景", "11": "深色背景"}
}
manual和folder:mode為WITH_REF。stride是高於或等於最高參考圖片編號(最大 1000)的 10 的倍數。Slot = 參考圖片編號 + 變體索引 x stride。上面的範例是原始圖片 01 的兩個變體。要處理原始圖片 01 和 02 各一次,請使用 slots 1 和 2。一個編號的所有變體處理完畢後,才會移動到下一個原始圖片。none:mode為PROMPT_ONLY。按 slot 編號升序運行,stride不影響順序(如果省略則為 30)。根據需要從任意數量的 slot 構建固定重複。範例見 examples/EXAMPLES.md。
透過 JSON 序列化將其儲存為 _prompts.json。JSON 是供代理編輯和構建的資料;它不是直接放入控制台的檔案。
構建運行檔案
閱讀 console-workflow.md。需要 Python 3.10 或更高版本,以下路徑是相對於此技能資料夾。
python scripts/build_console.py "workfolder/_prompts.json" --reference manual --out "workfolder/paste_into_console.js"
根據任務將 manual 更改為 none 或 folder。僅在請求無限重複或隨機播放時才添加 --infinite 和 --shuffle。重複使用現有的 assets/engine.js 和 assets/console-panel.js;不要為每個專案編寫新的引擎。
對完成的 JS 運行語法檢查和 scripts/verify.js 檢查。在最終回覆中,給出運行 JS 連結、適用的參考圖片資料夾,以及簡短的使用順序。不要僅移交 JSON 或引擎原始碼而讓使用者自行組裝。
使用指南
F12 -> 主控台 -> 粘貼整個程式碼 -> Enter -> 啟動。僅在出現封鎖警告時,引導使用者檢查程式碼並自行輸入 allow pasting。對於 manual,首先上傳原始圖片;對於 folder,在面板中連接圖片資料夾;對於 none,清除網站上現有的參考圖片。
需要模型的無限制權限,程式碼會在運行時啟用並檢查。保持運行分頁開啟,並關閉電腦睡眠模式。從面板控制 Loop、Shuffle 和 Stop。Fold 保持運行,Close 和 stop 會阻止進一步的請求。未確認的接受標記會被記錄,運行會移動到下一個項目;它不會被計為成功。
Alpha 驗證範圍
請遵循 發布驗證記錄 中的發布環境和重新檢查方法。長寬比不會被更改或固定;會讀取網站設定。這不保證與所有瀏覽器、螢幕或網站變更的相容性。發生錯誤時,檢查從 Log · diagnostics 保存的階段、編號和錯誤代碼,並修復對應的類別。不要重新運行在失敗前已接受的整個請求集。
在 alpha.5 中,確認了跨三種模式的 5 次實際接受。序列參考圖片為:第一個原始圖片上 2 次 -> 原始圖片交換 -> 下一個原始圖片上 1 次,先進行 Test once,然後 Resume。模型、長寬比和輸出數量得以保留。未驗證最終圖片質量和其他瀏覽器環境。不要將其呈現為在所有環境中無錯誤。錯誤處理請參閱 troubleshooting.md。Alpha.6 僅清理了引擎內部;網站處理程式碼未更改。
序列參考圖片運行:標準與驗證
在 2026-10-01 的網站上,順序為 References(+) -> Upload media -> 上傳清單中出現新卡片 -> 選擇該卡片 -> 參考圖片附加到生成表單。檔案上傳完成和參考圖片附加完成是不同的。引擎從連接的資料夾傳遞檔案,自動選擇新卡片,然後關閉清單。不要使
…
[為翻譯而截斷]