用途:帮助在 WordPress 中构建或调试 Interactivity API 交互功能,包括 data-wp-interactive、data-wp-on--、data-wp-bind--、data-wp-context 等指令,@wordpress/interactivity 的 store/state/actions,以及基于模块的区块 viewScriptModule;也用于排查水合问题或“指令不触发”。
主要能力:先检测现有用法与集成方式(区块、主题或插件层),识别 store 定义、state、actions 与事件回调;推荐服务端渲染,通过 block.json 的 supports.interactivity 或 wp_interactivity_process_directives() 启用服务端指令处理,用 wp_interactivity_state() 与 wp_interactivity_data_wp_context() 初始化状态和上下文,并在 PHP 中复制派生状态逻辑以保证首次渲染正确;提供指令、构建工具与调试的参考文档。
使用方式:需要仓库根目录与 triage 结果、受影响的区块/主题/插件面以及 WP 版本等约束,按检测、识别 store、服务端渲染、安全修改指令、对齐构建、调试的流程执行。新交互区块建议使用 @wordpress/create-block-interactive-template。
限制与注意事项:WordPress 6.9 中 data-wp-ignore 已弃用并将在未来移除;同一元素可用 --- 分隔符添加同类型多个指令;需确认 viewScriptModule 加载、data-wp-interactive 存在、命名空间匹配且水合前无 JS 错误;构建需支持模块输出。其余如具体收费或价格信息暂未提供。