Skip to main content

订阅模式

文件开头必须使用UserSubscribe而不是UserScript,安装时的链接推荐使用user.sub.js后缀,必须使用https链接。

订阅脚本仅会在安装时弹出安装界面由用户确认订阅,但后续的更新采用静默更新的方式,除非connect权限发生改变,否则不会弹出更新界面由用户确认。

一个订阅脚本可以描述所需要的多个脚本的安装链接,通过订阅模式安装的脚本使用静默安装,不会弹出确认安装页面,所安装的脚本也会展示在脚本列表中,但是connect权限会使用订阅中所声明的connect,而不会使用脚本自身的connect权限。

// ==UserSubscribe==
// @name xxx
// @description 订阅xxx系列脚本
// @version 0.1.0
// @author You
// @connect www.baidu.com
// @scriptUrl https://script.tampermonkey.net.cn/48.user.js
// @scriptUrl https://script.tampermonkey.net.cn/49.user.js
// ==/UserSubscribe==

订阅更新与脚本更新

根据用户设置的更新间隔,定时通过订阅的链接去进行检查更新,必须配置version才能生效。

订阅每次更新和变化会使用脚本链接与已安装的脚本进行比对,新的订阅中没有的脚本会进行删除,新增的脚本会进行静默安装。脚本的更新通过脚本自身的version去更新,与用户正常安装脚本的更新逻辑一致。

静默安装

订阅的脚本使用静默的方式进行安装,订阅新增/删除脚本时仅会弹出一个通知,不会再次由用户进行确认,脚本的更新机制不发生变化需要由用户确认,若用户勾选了设置->非重要变更静默更新脚本的选项,则按照改规则进行更新。由于静默更新的机制,请选择安全且值得信任的订阅方。

metadata

订阅脚本中的某些metadata含义也将发生改变

name

订阅名称(在订阅列表中也可以自行进行修改)

description

订阅描述,用于描述本订阅所作用途

version

订阅版本,如果忽略则将使用订阅脚本的内容是否发生改变去更新

connect

获取网站的访问权限,请看GM_cookieGM_xmlhttpRequest,通过订阅模式所安装的脚本中的connect会被订阅的connect所覆盖

scriptUrl

订阅所需要安装的脚本链接