快捷键宏录制与分享(Macro)
宏录制器把你在工具页内的按键 + 点击序列记录下来,保存为可重放的动作序列。对于需要重复执行的复杂操作(比如「批量给 20 份 PDF 加同一水印」),录制一次,以后一键回放。
适用场景
- 批量重复:对多份文件应用同一套精细操作
- 标准化流程:把团队约定的操作步骤固化成可分享的宏
- 自动化演示:录制教学用的操作序列,学员回放即可复现
- 跨工具联动:从一个工具跳到另一个工具的连续操作
操作步骤
1. 打开宏录制器
按 G T 进工具总览,点击「宏录制」。界面分三部分:
- 顶部:录制控制(开始 / 停止 / 暂停)
- 中间:已录制的宏列表
- 底部:事件流(实时显示当前录制的事件)
2. 开始录制
点击「开始录制」按钮(或按快捷键 Ctrl+Shift+R)。录制器会:
- 监听全局
keydown/keyup事件 - 监听
click事件,记录目标元素的 CSS selector - 给每个事件打上相对时间戳(毫秒)
录制期间,顶部会出现红色闪烁的「REC」指示器。
3. 执行操作
切换到任意工具页(比如 PDF 合并),正常操作:
- 拖入文件
- 调整顺序
- 点击「处理」
- 下载结果
所有按键和点击都会被记录。录制器会智能过滤:
- 系统快捷键(Ctrl+W 关闭标签等不录制)
- 输入框内的文字输入(避免泄露隐私)
- 浏览器原生交互(滚动 / 选中文本)
4. 停止并命名
点击「停止录制」,输入宏名称(如「批量加水印流程」),保存到列表。
5. 回放宏
在宏列表中点击「播放」按钮。回放器会:
- 自动切换到录制时的起始工具页
- 按时间戳顺序重放事件
- 用
querySelector找到对应元素并 click - 模拟按键触发
回放速度可调:0.5x / 1x / 2x / 4x。
6. 分享宏(Phase 4+)
点击宏旁边的「分享」按钮:
- 宏会上传到 Workers(存 D1 + KV 缓存)
- 生成分享链接
/share/<id> - 他人打开链接即可导入到自己的宏列表
进阶技巧
编辑事件流
录制的宏可在「编辑」模式下手动调整:
- 删除多余事件(如误点击)
- 调整时间间隔(加快回放)
- 修改 selector(适配不同页面结构)
条件回放
高级用法:在事件流中插入「等待元素出现」节点。回放器会阻塞直到目标 selector 出现在 DOM 中,适配异步加载的页面。
宏组合
把多个宏串联:宏 A 结束后自动触发宏 B。适合超长流程拆分管理。
跨设备同步
宏默认存 localStorage,仅本机可用。要跨设备:
- 导出 JSON 文件手动同步
- 或使用分享功能上传到 Workers(需 🟡 AI 增强模式)
注意事项
- selector 脆弱性:页面 UI 改版后,基于 selector 的点击可能失效;优先用快捷键录制
- 隐私安全:录制器默认不记录输入框内容,但拖入的文件路径会被记录(仅文件名,不含内容)
- 回放兼容性:回放时页面状态需与录制时一致(如文件已上传),否则点击会失败
- 宏大小:单个宏最大 100 个事件,超出会被截断
- 免费额度:上传分享的宏受 Workers 免费额度限制(100k 请求/天)