自动提及

本页面详细介绍如何使用自动提及功能。

功能概述

自动提及功能可以根据你预先编写的配置，自动在编辑框中查找关键词，然后通过@提及的方式替换为对应的素材文件。

使用步骤

1. 准备配置

在剧梦短剧编辑框中，按照配置说明中的格式编写配置：

【配置信息开始】
老总=二楼楼道
副总=会议室
【配置信息结束】

2. 开始提及

点击侧边栏中的「开始提及」按钮，或点击左侧悬浮按钮（需开启）。

3. 等待完成

执行期间请保持当前标签页处于前台可见状态。插件会自动执行以下操作：

1. 解析配置信息
2. 查找编辑框中的关键词
3. 逐个替换为@提及
4. 根据配置决定是否删除配置区域
5. 完成后发送通知（如开启）

智能特性

自动适配

插件会自动适应页面变化，避免因页面更新导致的操作错误。

重试机制

操作失败时会自动重试，提高成功率。

自动跳过

如果多次重试后仍无法完成，插件会跳过当前项继续处理下一个。

前台执行

自动提及仅在页面可见时运行。切换标签页或最小化浏览器后，任务会暂停；切回该标签页后会继续执行。

自动删除配置区域

开启此功能后，提及完成后会自动删除配置区域（【配置信息开始】 和 【配置信息结束】 之间的内容），但保留其他内容如「场次」、「基础参数」、「场景」等。

常见问题

为什么切换标签页后执行暂停了？

自动提及仅在前台（当前标签页可见）时运行。切换标签页或最小化浏览器后，任务会暂停；切回该标签页后会继续执行。请尽量在执行期间保持页面处于可见状态。

为什么有些提及没有被替换？

可能的原因：

1. 提及列表中没有对应的素材
2. 素材名称匹配不正确
3. 页面元素发生了变化

如何加快执行速度？

可以在配置中调小「等待时间」，但建议不低于100毫秒，否则可能导致操作失败。

执行失败怎么办？

1. 开启「调试模式」查看详细日志
2. 确认配置格式正确
3. 尝试手动执行一次，确认素材存在

最佳实践

1. 确认素材存在 - 执行前先确认提及列表中有对应的素材
2. 合理设置等待时间 - 根据网络情况和页面响应速度调整
3. 定期保存 - 在执行前保存编辑内容，避免意外丢失
4. 使用调试模式 - 遇到问题时开启调试模式查看详细信息

了解自动提及后，请查看更新日志了解版本更新信息。