发现 URL (Discovery URL) 配置规范

toc

源的「发现 URL」字段支持通过 JSON 数组定义多个发现页入口，每个入口包含标题、URL 和可选的布局样式。这使得一个源可以提供多个分类或榜单的快捷入口。

1. 字段位置

在源编辑器的发现选项卡中：

发现 → 发现 URL

2. 数据结构

发现 URL 是一个包含多个入口对象的 JSON 数组。

入口字段

字段	类型	必须	说明
`title`	`String`	是	入口标题，显示在发现页列表中
`url`	`String`	是	目标 URL，支持 `{{page}}` 分页变量
`style`	`Object`	否	Flexbox 布局配置

style 布局属性

属性	类型	说明
`layout_flexGrow`	`Int`	弹性增长比例
`layout_flexShrink`	`Int`	弹性收缩比例
`layout_alignSelf`	`String`	交叉轴对齐方式
`layout_flexBasisPercent`	`Int`	基础尺寸百分比，-1 为自动
`layout_wrapBefore`	`Boolean`	是否强制换行

3. 完整 JSON 示例

[
  {
    "title": "热门榜",
    "url": "https://example.com/rank/hot?page={{page}}"
  },
  {
    "title": "新书榜",
    "url": "https://example.com/rank/new?page={{page}}"
  },
  {
    "title": "完本榜",
    "url": "https://example.com/rank/finish?page={{page}}"
  }
]

4. 两种格式

发现 URL 支持两种填写格式：

格式	说明	适用场景
字符串	直接填写 URL，如 `https://example.com/explore`	单个发现页
JSON 数组	定义多个入口	多个分类/榜单入口

5. 分页变量

URL 中可使用 {{page}} 变量实现分页，Legado 会自动递增页码：

https://example.com/rank?page={{page}}

6. 与首页模块的关系

发现 URL 定义的入口可被首页模块的 kindTitle 字段引用。当首页模块的 kindTitle 与某个发现入口的 title 完全匹配时，模块会自动使用该入口的 URL 和规则。

2.4 KiB Raw Blame History