SuperAPI AI 工具集

pulsar-haptics

前端与建站

查看项目

更新于 10-15 21:06

技能介绍

用途:围绕 Software Mansion Pulsar 触觉反馈进行实现、迁移、设计、审查与排障,覆盖 React Native、Expo、iOS/Swift、Android/Kotlin、Kotlin Multiplatform、Flutter 与 Web。核心原则是依据项目实际解析出的 Pulsar 包与匹配版本的官方来源,而非记忆中的 API。

主要能力:先检查目标组件及相邻状态、成功失败、手势、导航与清理路径,推断平台、框架、已解析包版本及事件语义;再按已安装声明、生成接口、包源码、匹配发布标签、注册表元数据与锁文件的顺序确认可调用契约。选择反馈时优先匹配事件语义的命名或系统预设,仅在完整自定义时间线已知且无预设适用时使用 PatternComposer,实时反馈使用 RealtimeComposer。

使用方式:安装仅在用户明确要求时进行;未要求且 Pulsar 缺失时应先询问。不得未经授权升级、替换或删除依赖。声明版本与解析版本不一致时以解析版本为准并报告差异。实时反馈需映射并钳制输入范围、复用 composer、在正常结束、取消、失败、中断、导航离开、卸载与销毁时停止,并防止过期回调重启输出。需按平台检查原生链接、清单权限、插件注册、特性检测与音频回退等前置条件,尊重用户与系统触觉设置,保证无触觉时流程仍可用。

适用场景:跨平台触觉反馈实现与迁移(如从 expo-haptics 迁移)、Figma 设计中的绑定预设读取、预设与自定义时间线选择、实时手势反馈生命周期管理。

限制:模拟器或仿真器音频只能验证调用、时序与大致形态,不能验证触感,最终需在支持的物理硬件上完成。Figma MCP 的 get_design_context 与 get_metadata 不返回触觉绑定,需另行读取。若缺少已安装证据且无匹配官方来源,只能提供明确标注的伪代码,不得声称可编译。硬件、浏览器、权限、生命周期或用户设置阻止播放时,应先诊断该边界。