注释属性
脚本注释属性用于在爬虫脚本前 50 行内声明元数据,仅下列属性会被后端解析并实际使用。属性名与值之间可用冒号或空格;JavaScript 使用行首 //,Python 使用行首 #。
@version
版本号,用于管理后台「检查更新」与「从远端更新」时的版本对比。建议使用语义化版本(如 1.0.0)。与 @downloadURL 配合使用时,可从远端拉取脚本并比较版本以提示或执行更新。
js
// @version: 1.0.0
// @version 1.0.0python
# @version: 1.0.0
# @version 1.0.0@downloadURL
远程脚本地址,用于管理后台「检查更新」与「从远端更新」。配置后,系统会请求该 URL 获取远端脚本内容,并解析其中的 @version 与当前脚本版本比较;若远端版本更高,可执行「从远端更新」覆盖本地脚本。未配置时无法使用检查更新与从远端更新功能。
js
// @downloadURL: https://github.com/xxx/releases/download/v1.0.0/script.js
// @downloadURL https://example.com/script.jspython
# @downloadURL: https://example.com/script.py
# @downloadURL https://example.com/script.py@indexs
是否参与聚合搜索。取值为 0 或 1(属性名与数字之间需有空格)。1 表示该爬虫源参与站内聚合搜索,0 表示不参与。未声明时视为不参与。
js
// @indexs 1
// @indexs 0python
# @indexs 1
# @indexs 0@push
是否为推送型爬虫。取值为 0 或 1(属性名与数字之间需有空格)。1 表示推送型爬虫(通常只需实现 detail 与 play),0 表示常规爬虫。未声明时视为常规爬虫。推送源在后台展示与筛选逻辑上会与普通源区分。
js
// @push 1
// @push 0python
# @push 1
# @push 0@dependencies
声明脚本运行所需的外部依赖(npm 或 pip 包名)。保存脚本时,若这些依赖未安装,系统会自动尝试安装。
取值:单行、逗号分隔的包名,支持 @dependencies: pkg1,pkg2 或 @dependencies pkg1,pkg2。仅脚本前 50 行内生效。
js
// @dependencies: axios,cheerio
// @dependencies axios,cheeriopython
# @dependencies: requests,beautifulsoup4
# @dependencies requests,beautifulsoup4