漫画源脚本 API 速览:一个源要实现哪些块
以官方开发文档为底的速查表。每个块都是可选的,不用的删掉即可;应用按块是否存在决定界面上给不给入口。
基本信息(必填)
| 字段 | 职责 |
|---|---|
| name | 源显示名称 |
| key | 全局唯一标识 |
| version | 脚本版本号 |
| minAppVersion | 最低兼容的应用版本,低于则拒绝加载 |
| url | 脚本更新地址 |
| init() | 初始化函数,可选 |
功能块一览
| 块 | 职责 | 关键点 |
|---|---|---|
| account | 账号登录 | 三种登录方式与登出,见源脚本的三种登录方式怎么写 |
| explore | 探索页 | 三种类型:分区拼装、翻页列表、混合 |
| category | 分类页 | 静态分类目录,可声明开启排行页;一个源只有一个 |
| categoryComics | 分类取数 | 分类列表加载与排序选项,排行数据单独一块 |
| search | 搜索 | 支持分页加载;筛选控件有单选、多选、可空下拉三种;可开标签联想 |
| favorites | 网络收藏 | 是否支持多文件夹由脚本声明;登录过期抛特定错误可触发自动重登重试 |
| comic | 漫画详情 | 加载信息、章节图片、缩略图列表;可选实现评分与图片加载配置 |
comic 块的常用函数
- loadInfo:加载漫画信息(详情页数据源)
- loadEp:加载某章节的图片列表
- loadThumbnails:可选,章节缩略图,支持用坐标语法只截取长图的一小块当缩略图
- starRating:可选,评分(应用侧五星制,换算为 0-10 数值)
- onImageLoad:可选,为单张图片提供加载配置(请求头等)
提效细节
- 搜索与列表加载都支持「下一页令牌」式分页(loadNext),比算页码更适合游标式接口
- 筛选选项的值与文案用连字符写在同一字符串里,左边值右边文案
- 标签联想可自定义点击后填入搜索框的格式(如「命名空间:标签」)
完整字段与示例以官方源开发文档与模板注释为准,模板会随生态更新。