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、运行时日志、worker 标志和卡住的 CLI 运行。
• 仅通过浏览器的 Playground 网站工作流：阅读 references/website.md，了解 Query API 和 Blueprint URL 设置、分享链接及浏览器限制。该文档会将现有网站操作路由到独立的 WebMCP、Playground MCP 和 Sites API 参考资料；仅加载所选方法对应的资料。除非用户指定连接方法，否则对于受支持的浏览器操作，优先使用可用的 WebMCP 工具。

所需输入

• 预期工作流：编写 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、日志、worker 标志和卡住的 CLI 运行。

升级处理

• 如果任务需要 Playground 无法提供的 PHP 扩展、原生数据库访问、持久化或类生产环境基础设施，请使用完整的 WordPress 技术栈，例如 wp-env、Docker 或项目提供的环境。