用途 Mouse Swarm Reveal 用于为网站创建完整的、可用的顺序揭示演示：一组模拟光标按编排顺序依次展示页面元素，形成类似“协作构建”的视觉效果。它也可用于添加一个本地 Ruflo 智能体状态视图（观察模式），或将两者结合。所有模式需显式选择：Reveal（仅视觉揭示）、Ruflo 观察、或 Both（视觉揭示与观察状态保持清晰标注并相互分离）。只有在可信来源确实提供坐标时，才显示实时标记。
主要能力
- 通过 data-swarm-item 按文档顺序标记有意义的元素，通过 data-swarm-type 标记纯文本叶子元素以进行打字动画。
- 可配置光标数量、颜色、标签、尺寸、移动速度、机器人频率、选中描边、打字节奏和可选滚动；提供 onStep、onError 回调与 getState() 状态读取。
- 提供 replay()、pause()、resume()、skip() 控制方法，以及 destroy() 清理方法。
- 内置 assets/demo.html 作为可交互配置参考；浏览器模块自包含，无运行时依赖。
- Ruflo 观察模式通过本地 CLI 读取智能体注册与状态，不启动智能体、不控制计算机、不报告光标位置。
使用方式 静态站点：将 assets/mouse-swarm.js 复制到公开资源目录，以浏览器 ES 模块方式导入；需通过 HTTP 提供站点。打包应用：执行 npm install github:ruvnet/mouse-swarm，从 @ruvector/mouse-swarm 导入。初始化需在目标 DOM 存在后进行；素材目标列表发生重大变化后需重建实例；组件卸载时调用 destroy()。目标元素不能被同一模块的多个同时实例共享。动画或回调出错时会恢复内容并通过 onError 报告。观察模式可运行 npx --yes --package=github:ruvnet/mouse-swarm mouse-swarm observe，并在目标 Ruflo 项目中打开打印出的本地 URL；不要将该服务器公开暴露。
适用场景 适用于展示由群体构建的落地页、顺序呈现的页面内容、光标动画演示，以及在本地开发环境中观察 Ruflo 智能体注册与状态。
限制 模拟光标不是真实智能体或遥测，除非有已验证的实时智能体事件支持。目标不应嵌套标记，否则可能意外隐藏内容。不要覆盖交互元素、劫持滚动或强制用户滚动位置。需尊重减少动态效果设置，并保留无 JavaScript 时的可读内容与页面语义。观察适配器不进行网络调用、不执行任务，不应用于存放机密、原始任务描述或私有智能体数据；不得从注册推断执行状态。该模块不生成 MP4 文件。未经许可不得复制第三方网站或素材。其他未在资料中说明的功能、收费、价格、平台或效果暂未提供。