🐭 鼠标点击录制助手 - 比例坐标版 (Violent Monkey/Tampermonkey) ✨

📖 简介

这是一个功能强大的浏览器鼠标点击录制与回放助手用户脚本，专为 Violent Monkey 或 Tampermonkey 等浏览器扩展设计。它能够精确记录你在网页上的鼠标点击动作，并以比例坐标的形式存储，从而在不同分辨率或缩放比例的屏幕上也能准确回放。

核心亮点包括：

• 多目标区域支持: 可以设定多个矩形区域，只记录在这些区域内的点击，过滤无关操作。
• 优化回放机制: 模拟真实的鼠标点击事件，提供调试信息和可选的点击元素高亮。
• 直观的用户界面 (UI): 提供一个可拖动的浮动面板，方便进行录制、回放、设置等操作。
• 自定义快捷键: 支持配置键盘快捷键来快速控制脚本功能。
• 数据导入/导出: 轻松保存和加载录制数据（JSON 格式）。
• 录制时阻止页面点击: 可选功能，避免在录制过程中意外触发页面交互。

无论是自动化重复点击任务、测试网页交互流程，还是进行教学演示，此脚本都能大大提升你的效率。

##效果图

🚀 主要功能

• 鼠标点击录制:
  • 精确记录鼠标点击事件的相对坐标 (X/Y 比例) 和点击间隔时间。
  • 支持在录制时阻止页面默认点击事件，避免干扰。
  • 多目标区域过滤: 只记录预设的特定区域内的点击，忽略区域外的操作。
• 鼠标点击回放:
  • 以录制时的点击顺序和时间间隔，精确模拟鼠标点击事件。
  • 回放时会自动高亮当前点击的元素，视觉上更直观。
  • 回放进度和状态实时更新。
• 浮动操作面板:
  • 提供一个可拖动的面板，集中管理所有功能（录制、回放、设置、数据管理）。
  • 面板位置和入口按钮位置会自动记忆。
• 自定义快捷键:
  • 可配置开始/暂停/继续/停止录制及开始/停止回放的快捷键组合。
  • 支持 Ctrl, Alt, Shift 修饰键，并区分按键大小写。
• 数据管理:
  • 将录制的数据（JSON 格式）保存到本地文件。
  • 从本地文件导入录制数据。
• 调试模式:
  • 内置详细的调试日志输出，帮助用户理解脚本运行情况和排查问题。

⚙️ 安装

请确保你已经安装了支持用户脚本的浏览器扩展，例如：

• 暴力猴 (Violent Monkey) (推荐):
  • Chrome 商店链接
  • Firefox 插件链接
• 油猴 (Tampermonkey):
  • Chrome 商店链接
  • Firefox 插件链接

安装步骤:

1. 点击以下链接 直接安装脚本： [🐭 点击此处安装 鼠标点击录制助手 - 比例坐标版 ✨]

[https://raw.githubusercontent.com/ccluyan/Automated-dot-connector/main/liandian.user.js)

3. 点击链接后，你的用户脚本管理器会弹出一个安装确认页面。请仔细阅读脚本信息并点击 “安装” 或 “确认”。

💡 使用方法

脚本安装并启用后，会在你访问的任何网页右侧显示一个浮动的“寻到大千脚本”按钮。

1. 打开控制面板:

   • 点击页面右侧的 “寻到大千脚本” 按钮，会弹出功能面板。
   • 面板和入口按钮都可以拖动到你喜欢的位置，位置会自动记忆。

2. 设置目标区域 (可选，但强烈推荐):

   • 点击 “添加目标区域” 按钮。
   • 页面会变为半透明覆盖层，鼠标变成十字光标。
   • 按住鼠标左键拖拽，框选你希望脚本只在此区域内录制或回放点击的范围。
   • 松开鼠标后，该区域会被添加到面板的“目标区域列表”中。你可以添加多个区域，也可以随时删除。
   • 作用: 当设置了目标区域后，脚本将只记录和回放在这些区域内的点击事件。这对于限制脚本操作范围、避免误触非常有用。

3. 录制点击:

   • 点击 “开始录制” 按钮（或按默认快捷键 Ctrl+W）。
   • 现在你可以在页面上进行鼠标点击操作了。脚本会记录每次点击的位置（相对坐标）和时间间隔。
   • 你可以勾选 “录制时阻止页面点击事件” 以防止点击触发网页自身的交互。
   • 点击 “暂停录制” (Ctrl+E) 暂停，点击 “继续录制” (Ctrl+R) 继续。
   • 完成录制后，点击 “停止录制” (Ctrl+Q)。录制的数据会显示在下方的文本域中。

4. 回放点击:

   • 在停止录制后，点击 “开始回放” 按钮（或按默认快捷键 Ctrl+P）。
   • 脚本会按照录制时的顺序和速度模拟鼠标点击。
   • 回放过程中，被点击的元素周围会有一个临时的黄色阴影高亮。
   • 点击 “停止回放” (Ctrl+O) 随时终止回放。

5. 数据管理:

   • 保存录制数据: 点击 “保存录制数据” 按钮，可以将当前的录制内容下载为 .json 文件。
   • 导入录制数据: 点击 “导入录制数据” 按钮，然后选择一个之前保存的 .json 文件，即可加载数据。

6. 自定义快捷键:

   • 点击 “自定义快捷键设置” 按钮，打开快捷键设置面板。
   • 点击对应的功能输入框，然后按下你想要的快捷键组合 (例如 Ctrl+Shift+F)。
   • 点击 “保存快捷键” 生效，或 “取消” 放弃更改。
   • 支持: Ctrl, Alt, Shift 修饰键，以及任意非修饰键（字母、数字、符号键），区分大小写。

7. 调试模式 (高级):

   • 要开启调试模式，需要修改脚本代码。在脚本顶部找到 const DEBUG_MODE = false;，将其改为 true。
   • 保存并更新脚本后，打开浏览器的开发者工具 (F12)，切换到 Console (控制台) 面板，即可看到详细的 [录制调试] 信息输出。

⚠️ 注意事项

• 页面动态加载: 对于通过 AJAX 动态加载内容的页面，脚本会尝试通过 MutationObserver 监听变化并重新处理，但可能无法完美应对所有复杂场景。
• 坐标系: 脚本使用比例坐标进行录制和回放，可以适应不同的窗口大小，但在页面布局发生重大变化时，回放可能不准确。
• 安全: 请仅从信任的来源安装用户脚本。此脚本模拟用户操作，请谨慎使用，并避免在敏感或重要操作中使用未经测试的录制回放。

🤝 贡献与反馈

欢迎提交 issues 报告 Bug 或提出功能建议，也欢迎提交 Pull Request 贡献代码。

• 提交 Bug 或建议 (Issues)
• 贡献代码 (Pull Requests)

---

📜 许可证

本项目采用 MIT License 许可。

---

© 2023 [ccluyan]