Tampermonkey脚本删除后API仍返回已安装状态的Bug分析

Tampermonkey作为一款流行的用户脚本管理器，提供了丰富的API供网页开发者调用。其中window.external.Tampermonkey.isInstalled接口用于检测特定脚本是否已安装。然而，近期发现该接口存在一个值得注意的Bug：即使脚本已被删除，API仍会返回该脚本为已安装状态。

问题现象

当用户执行以下操作序列时会出现异常现象：

1. 从Greasy Fork等脚本托管平台安装一个脚本
2. 在Tampermonkey中删除该脚本
3. 刷新托管平台页面

按照预期，页面上的安装按钮应恢复为"安装此脚本"的初始状态。但实际上，按钮仍显示为"重新安装版本x.y.z"，表明系统错误地认为脚本仍存在于用户环境中。

技术分析

深入分析发现，问题根源在于Tampermonkey的API实现逻辑存在缺陷。isInstalled接口不仅检查了当前活跃的脚本列表，还错误地包含了已删除但仍在回收站中的脚本记录。这导致即使脚本已被用户删除，只要未从回收站彻底清除，API仍会返回该脚本为已安装状态。

影响范围

该Bug主要影响以下场景：

• 脚本托管平台的用户界面显示
• 依赖此API进行脚本状态检测的第三方应用
• 需要精确判断脚本安装状态的自动化流程

值得注意的是，该问题在浏览器重启后仍然存在，说明不是简单的缓存问题，而是持久化的数据查询逻辑错误。

解决方案

Tampermonkey开发团队已在5.3.6221 Beta版本中修复此问题。修复方案主要包括：

1. 修改API查询逻辑，排除回收站中的脚本
2. 确保状态检测与实际安装情况严格一致

对于遇到此问题的用户，建议升级到最新版本。如需临时解决方案，可以尝试彻底清空Tampermonkey的回收站，或手动导出/导入脚本和设置。

开发者启示

此案例为浏览器扩展开发提供了重要启示：

1. 状态查询API的设计需要考虑所有可能的数据源
2. 删除操作应有明确的层级划分（软删除/硬删除）
3. 用户界面状态应与底层数据保持严格同步

Tampermonkey团队对此问题的快速响应也展示了成熟开源项目的问题处理流程，从问题报告到修复发布仅用了不到一周时间。