wp-playground

WordPress Playground

這是一個輕量的路由包裝器。使用它來選擇正確的 Playground 工作流程，然後僅載入任務所需的聚焦參考或技能。

程序

1. 識別使用者意圖：Blueprint 編寫/審查、本地 CLI 執行、僅瀏覽器的網站/分享連結工作流程、Xdebug/卡住的 CLI 執行，或混合的 Playground 請求。
2. 路由到下方聚焦的來源，僅在請求包含多個不同部分時載入多個來源。
3. 對於混合請求，將 Blueprint JSON 工作委派給 blueprint，然後返回此處獲取執行時期、CLI、除錯或分享指引。

• Blueprint JSON、結構、步驟、資源、套件或 Blueprint 審查：直接使用 blueprint 技能。請勿在此處重複 Blueprint 結構細節。
• 本地 CLI 執行：閱讀 references/cli.md 以了解 @wp-playground/cli 伺服器、run-blueprint、build-snapshot、掛載、版本切換和本地驗證。
• Xdebug 或卡住的 CLI 執行：閱讀 references/debugging.md 以了解 Xdebug、執行時期日誌、工作者旗標和卡住的 CLI 執行。
• 僅瀏覽器的 Playground 網站工作流程：閱讀 references/website.md 以了解 playground.wordpress.net、分享 URL、Blueprint 編輯器、託管套件和瀏覽器限制。

必要輸入

• 預期的工作流程：Blueprint 編寫、本地 CLI 執行、網站/分享連結、快照或除錯。
• 如果需要掛載或打包本地程式碼，則提供專案或套件路徑。
• 如果相容性重要，則提供所需的 WordPress/PHP 版本。
• 如果需要本地伺服器，則提供連接埠偏好。
• 是否需要僅瀏覽器分享或本地檔案系統存取。

護欄

• Playground 實例是可拋棄的、基於 SQLite 的環境；切勿將其指向生產資料。
• 將 Blueprint JSON 指引保留在 blueprint 中，以便結構和範例有單一事實來源。
• 對於本地 CLI 工作，在執行指令前確認 Node.js 20.18+ 和 npm/npx。
• 僅瀏覽器的 Playground 無法讀取本地檔案系統路徑；請使用公開 URL、託管的 ZIP 套件或內嵌的 Blueprint JSON。

驗證

• 對於 Blueprint 內容，根據已發布的結構進行驗證，並遵循 blueprint 技能的驗證方式。
• 對於本地 CLI 執行，在 Playground 實例中驗證掛載的外掛/主題或 Blueprint 副作用。
• 對於分享連結，開啟產生的 URL 並確認預期的登陸頁面和已安裝的資源載入正常。

失敗模式

• Blueprint 工作被路由至此：停止並使用 blueprint 技能處理結構鍵、步驟、資源、套件、驗證或 Blueprint 審查。
• 在僅瀏覽器的工作流程中需要本地檔案系統：使用 references/cli.md；playground.wordpress.net 無法讀取本地檔案系統路徑。
• 從本地 CLI 工作流程請求可分享的瀏覽器連結：使用 references/website.md；本地伺服器 URL 不是可攜帶的分享連結。
• 將除錯視為第二跳參考：直接閱讀 references/debugging.md 以了解 Xdebug、日誌、工作者旗標和卡住的 CLI 執行。

升級處理

• 如果任務需要 Playground 無法提供的 PHP 擴充功能、原生資料庫存取、持久化或類似生產的基礎設施，請使用完整的 WordPress 堆疊，例如 wp-env、Docker 或專案提供的環境。