请求精准描述Gmail Add-on脚本的触发条件

我之前做Gmail Add-on开发时也踩过这个坑，完全懂你的困惑！官方文档里说的“无条件触发”其实很容易被误解，实际触发逻辑和我们直觉里的“每次切换对话都调用”有不小的差距，具体细节如下：

• 缓存是核心限制：Gmail会对已经加载过的Add-on卡片内容做缓存。如果用户切换到的是之前已经打开过的对话，且缓存还没失效，Gmail会直接复用缓存的内容，根本不会重新调用你的触发器脚本。这就是为什么你测试时发现触发器不是每次都触发的关键原因。
• 真正的触发时机：只有两种情况会触发脚本：一是用户打开从未加载过该Add-on的对话；二是缓存的内容已经过期（比如超过了Gmail默认的缓存时长，或者你的Add-on配置/代码有更新）。
• 官方文档表述的局限：文档里说的“对所有邮件均触发”，意思是没有基于邮件内容的过滤规则（比如不会只触发带附件或特定关键词的邮件），但绝对不是指每一次对话导航都会执行脚本，缓存机制是绕不开的。

如果你的需求是每次切换对话都要执行某些逻辑，目前没有原生的触发器能实现，但可以试试这些变通方案：

• 利用Add-on客户端的事件监听：在前端卡片代码里监听对话切换事件（比如onSelectionChanged相关的客户端方法），触发后再调用后端脚本处理。
• 主动控制缓存有效期：在脚本返回的Card对象中设置较短的expiration时间，让Gmail更快地重新加载内容，变相提高触发频率。

补充一句：这个缓存机制是Gmail为了性能优化设计的，但确实和文档表述有偏差，很多新手开发者都会被坑到。

内容的提问来源于stack exchange，提问作者user3754273