用途:为混合应用(原生壳 + 内嵌 Web)提供四层分析模型与领域知识库,属于方法论与知识增强,不是独立端到端工作流;由 PDCA 宿主通过 frontmatter 依赖引用(前置检查后调用),运行时检查委托给 browser-debug-toolkit。领域知识(技术陷阱、原生↔H5 契约模板、锚定案例)位于 reference.md。
主要能力:四层模型——L1 Web 运行时(H5 逻辑、CSS、DOM、JS 状态,症状出现处)、L2 原生↔Web 桥接(属性注入/类切换/JS API 调用、注入内容与时序)、L3 原生配置(Activity/主题、WebView 设置如 forceDarkAllowed、Manifest、Info.plist)、L4 平台运行时(Android WebView 的 prefers-color-scheme 跟随 isLightTheme、WKWebView 手势、Electron IPC 序列化限制)。核心纪律:绝不停留在 L1,找到 L1 原因后继续追问“为何 L1 如此”,向 L2→L3/L4 追溯至根因置信度高。平台差异是最强信号,差异几乎总源于 L2/L3/L4,需跨平台对比桥接路径、原生配置与平台运行时。
使用方式:先定位症状层(通常 L1),再向 L2→L3/L4 追溯;对照 reference.md 已知陷阱;用运行时证据锚定根因(CSS 变量解析、规则优先级、平台媒体查询返回值只能运行时观察,工具选择委托 browser-debug-toolkit,可用逐条禁用规则、模拟平台环境、截图像素采样);扫描同根因元素;评估跨层副作用后再选修复;根因置信度不足时不进入执行。
适用场景:WebView/WKWebView/Electron/React Native + H5 的 UI、主题或行为问题;平台差异复现;单端修复后问题复发或遗漏同根因兄弟元素;调用链完整、参数正确、日志有执行但运行时行为错误的静默失败。
限制:非独立工作流,依赖宿主与相关技能;不提供具体代码修复;reference.md 内容未在此展开;未提供安装命令、收费与平台支持信息。