用途:排查 WordPress 代理窗口或独立预览中的预览、认证与编辑器模式问题,覆盖简单 WordPress.com、Jetpack 和 Atomic 站点。
主要能力:定位预览 URL 解析、frame nonce、未映射主机、cookie、读取权限、代理与路由覆盖等行为差异,并区分未登录视图、已认证预览和编辑模式。
使用方式:从当前代码路径入手,检查 Sources/WordPressAgentPreviewURLResolver.swift、Sources/WordPressAgentWindowView.swift、Sources/WPCOMClient.swift 及相关 Sources/AppState.swift 预览方法;可运行 rg -n "preview|frame_nonce|jetpack_frame_nonce|unmapped|Atomic|cookie|requested|effective|private|proxy" Sources 搜索。检查 Sources/NetworkRoutingSettings.swift 和 Sources/WPCOMClient.swift 中的 WordPress.com 认证 cookie 引导。
限制与规则:UI 只展示请求的用户可见 URL,不暴露有效预览 URL、frame nonce、认证引导 URL 或私有预览细节;拒绝 localhost 与私有网络 URL。预览 cookie 引导流程故意使用一次性直连会话,因为代理路由曾产生 wp-login.php 200 响应且认证 cookie 为空;普通 API 流量仍遵循用户网络设置。优先使用应用日志、已有预览加载状态和针对性代码检查,验证加载/准备状态、导航更新、请求 URL 与实际 URL 显示及模式切换行为。输出应先指出失败路由或信任边界,附文件引用与站点/模式假设,并建议针对公共 URL、同站 URL、预览 URL、编辑器 URL、内部导航和被拒私有 URL 的测试。更完整的限制暂未提供。