SuperAPI AI 工具集

hwc-realtime-streaming

通用与其它

查看项目

更新于 10-16 00:01

技能介绍

用途:为 Hotwire 应用实现推送驱动的实时与流式交互,使用 Turbo Streams 配合 Stimulus 完成服务端推送更新。

主要能力:支持通过 WebSocket、SSE、内联 stream 标签或服务端响应流进行传输;优先使用默认 Turbo Stream 动作(append、prepend、replace、update、remove、before、after、refresh),仅在默认动作不足时添加自定义动作;支持内联客户端 stream 标签、自定义动作、通过自定义动作做播放列表编排、基于 localStorage 的流状态、View Transitions 列表动画、实时 combobox 更新,以及标签页间通信。

使用方式:先确定传输方式与投递形态,再选择默认动作或自定义动作;流动作应保持小而确定,避免在流载荷中嵌入任意脚本;将流编排与领域 UI(表单、媒体、导航)分离;对实时更新验证顺序、幂等性与多标签页行为;延迟或乱序消息需验证失败模式。跨标签页同步应保持显式(BroadcastChannel/localStorage)并限定在同一设备语义内;View Transitions 仅在动画能明显提升状态变化清晰度时使用。按需加载参考文件,仅打开当前请求所需的文件,如 references/2023-08-01-turbo-streams-inline-stream-tags.md、references/2023-08-15-turbo-streams-custom-stream-actions.md、references/2023-10-10-turbo-streams-custom-stream-actions-video-playlist-management.md、references/2024-01-30-turbo-streams-custom-stream-actions-localstorage.md、references/2025-06-10-turbo-streams-list-animation-view-transitions.md、references/2024-03-12-hotwire-combobox-with-real-time-data.md、references/2023-11-21-stimulus-inter-tab-communication.md,完整目录见 references/INDEX.md。

适用场景:需要服务端推送更新列表、实时数据、跨标签页状态同步或流式 UI 的 Hotwire/Rails 前端。

限制与边界:拉取式导航与历史记录问题改用 hwc-navigation-content;表单验证与提交流程改用 hwc-forms-validation;媒体播放与上传改用 hwc-media-content;通用加载、进度与过渡体验改用 hwc-ux-feedback;基础 Stimulus API 问题(非流式)改用 hwc-stimulus-fundamentals。具体安装命令、收费与版本信息暂未提供。