元数据字段 (BookSourceMeta)
书源 .js 文件头部注释中的元数据，由 Rust parse_meta 从前 60 行解析。
字段列表
| 注释标记 | 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
@name | name | string | ✅ | 书源名称 |
@url | url / urls | string / string[] | ✅ | 主 URL / 所有镜像 URL |
@version | version | string | 推荐 | 版本号（必须在前 1KB 内） |
@author | author | string? | 推荐 | 书源作者 |
@logo | logo | string? | 否 | 图标 URL |
@group | group | string? | 否 | 分组 |
@type | — | string | 否 | 类型：novel（默认）/ comic / video / music |
@enabled | enabled | boolean | 否 | 启用状态，默认 true |
@minDelay | minDelayMs | number | 否 | 最小请求间隔（毫秒） |
@tags | — | string | 否 | 标签（逗号分隔），第一个值作 UI 分组 |
@description | description | string? | 否 | 多行简介 |
@updateUrl | updateUrl | string? | 否 | 自动更新地址，指向远程 .js 文件 |
@require | requireUrls | string[] | 否 | 依赖 JS URL 列表（按声明顺序） |
| — | fileName | string | 自动 | 磁盘文件名 |
多行字段
@url 和 @description 支持多行，每行写一个：
js
// @url https://www.example.com
// @url https://mirror.example.com
// @description 这是第一行描述
// @description 这是第二行描述@url：第一个为主 URL（url字段），全部存入urls数组@description：多行以\n拼接为一个字符串@require：多行叠加，所有 URL 收集到requireUrls数组，按声明顺序加载
@updateUrl 说明
指向远程 .js 文件地址。版本检查时只拉取前 1KB（Range: bytes=0-1023），并自动在 URL 后附加 ?action=check 或 ?action=download；若 URL 已有参数，则使用 & 连接。
版本号位置要求
@version 必须出现在文件前 1KB 以内，否则检查请求无法正确读取远程版本号。
@require 说明
每行一个依赖 URL，书源加载时按顺序 eval，晚于宿主 API 注入、早于主脚本执行。进程级内存缓存，同一 URL 不重复下载。仅支持 http:// 或 https:// 绝对地址。
示例
js
// @name 22笔趣阁
// @version 1.2.0
// @author 开发者
// @url https://www.22biqu.com
// @url https://m.22biqu.net
// @updateUrl https://cdn.example.com/booksources/22biqu.js
// @require https://cdn.example.com/libs/manga-decoder.js
// @logo https://www.22biqu.com/favicon.ico
// @type comic
// @enabled true
// @minDelay 300
// @tags 免费,漫画,热门
// @description 22笔趣阁漫画站
// @description 支持搜索、分类浏览