发现页 (explore)

explore() 是可选函数，用于提供分类浏览入口。不实现此函数时，发现页自动跳过该书源。

函数签名

function explore(page, category) → string[] | BookItem[] | { type: 'html', html: string }

参数	类型	说明
page	number	页码，从 1 开始
category	string	分类名，或 'GETALL' 表示获取所有分类

返回值

调用场景	返回类型	说明
category === 'GETALL'	string[]	分类名数组
指定分类名	BookItem[]	该分类下的书籍列表
特殊分类（如"设置"）	{ type: 'html', html: '...' }	HTML 交互页面

基本示例

function explore(page, category) {
  // 返回分类列表
  if (category === 'GETALL') {
    return ['玄幻', '仙侠', '都市', '历史', '科幻'];
  }

  // 返回指定分类下的书籍
  legado.log('[explore] category=' + category + ' page=' + page);
  var html = legado.http.get(BASE + '/category/' + encodeURIComponent(category) + '?page=' + page);
  var doc = legado.dom.parse(html);
  var items = legado.dom.selectAll(doc, '.book-item');
  var books = [];

  for (var i = 0; i < items.length; i++) {
    books.push({
      name: legado.dom.selectText(items[i], '.title'),
      author: legado.dom.selectText(items[i], '.author'),
      bookUrl: legado.dom.selectAttr(items[i], 'a', 'href'),
      coverUrl: legado.dom.selectAttr(items[i], 'img', 'src'),
      kind: category
    });
  }

  legado.dom.free(doc);
  return books;
}

JSON API 发现页

var CATEGORIES = {
  '玄幻': 1, '仙侠': 2, '都市': 3, '历史': 4
};

function explore(page, category) {
  if (category === 'GETALL') {
    return Object.keys(CATEGORIES);
  }

  var catId = CATEGORIES[category];
  var resp = legado.http.get(BASE + '/api/list?cid=' + catId + '&page=' + page);
  var json = JSON.parse(resp);

  return json.data.list.map(function(book) {
    return {
      name: book.title,
      bookUrl: BASE + '/book/' + book.id,
      author: book.author,
      coverUrl: book.cover,
      kind: category
    };
  });
}

排行榜 + 分类混合

function explore(page, category) {
  if (category === 'GETALL') {
    return ['总人气排行', '月排行榜', '周排行榜', '玄幻', '仙侠', '都市'];
  }

  var url;
  switch (category) {
    case '总人气排行': url = BASE + '/top/allvisit/' + page + '.htm'; break;
    case '月排行榜':   url = BASE + '/top/monthvisit/' + page + '.htm'; break;
    case '周排行榜':   url = BASE + '/top/weekvisit/' + page + '.htm'; break;
    default:          url = BASE + '/sort/' + category + '/' + page + '.htm'; break;
  }

  var html = legado.http.get(url);
  // ... 解析逻辑
}

HTML 交互发现页

explore() 还支持返回 HTML 交互页面，用于实现高级的用户交互（如设置面板、筛选器）。详见 进阶 → HTML 交互发现页。