SOURCE_SCRIPT.md

视频源脚本编写教程

最小模板

return {
  meta: {
    name: '示例脚本',
    author: 'admin'
  },

  async getSources(ctx) {
    return [{ id: 'default', name: '默认源' }];
  },

  async search(ctx, { keyword, page, sourceId }) {
    return {
      list: [],
      page,
      pageCount: 1,
      total: 0
    };
  },

  async recommend(ctx, { page }) {
    return {
      list: [],
      page: page || 1,
      pageCount: 1,
      total: 0
    };
  },

  async detail(ctx, { id, sourceId }) {
    return {
      id,
      title: '',
      poster: '',
      year: '',
      desc: '',
      playbacks: [
        {
          sourceId,
          sourceName: '默认源',
          episodes: [],
          episodes_titles: []
        }
      ]
    };
  },

  async resolvePlayUrl(ctx, { playUrl, sourceId, episodeIndex }) {
    return {
      url: playUrl,
      type: 'auto',
      headers: {}
    };
  }
};

支持的 hook

1. getSources() 返回脚本管理的子源列表
2. search({ keyword, page, sourceId }) 搜索
3. recommend({ page }) 推荐
4. detail({ id, sourceId }) 详情
5. resolvePlayUrl({ playUrl, sourceId, episodeIndex }) 播放前解析最终地址

ctx 里能用什么

1. ctx.fetch(...) 发请求
2. ctx.request.get/getJson/getHtml/post 快捷请求
3. ctx.html.load(html) cheerio 风格解析
4. ctx.cache.get/set/del 脚本缓存
5. ctx.log.info/warn/error 输出测试日志
6. ctx.utils.buildUrl/joinUrl/randomUA/sleep/base64Encode/base64Decode/now 常用工具
7. ctx.config.get/require/all 读脚本配置
8. ctx.runtime 当前脚本信息

search 返回格式

{
  list: [
    {
      id: '123',
      title: '凡人修仙传',
      poster: 'https://...',
      year: '2025',
      desc: '简介',
      type_name: '动漫',
      douban_id: 0,
      vod_remarks: '更新至10集'
    }
  ],
  page: 1,
  pageCount: 1,
  total: 1
}

detail 返回格式

{
  id: '123',
  title: '凡人修仙传',
  poster: 'https://...',
  year: '2025',
  desc: '简介',
  playbacks: [
    {
      sourceId: 'default',
      sourceName: '默认源',
      episodes: [
        'https://example.com/play/1',
        {
          playUrl: 'https://example.com/play/2',
          needResolve: false
        }
      ],
      episodes_titles: ['第1集', '第2集']
    }
  ]
}

说明：

• episodes 可以是字符串，默认等价于 { playUrl: '...', needResolve: true }
• needResolve 默认为 true
• 显式写 needResolve: false 时，播放页会直接使用该地址，不再调用 resolvePlayUrl

resolvePlayUrl 返回格式

{
  url: 'https://real-url.m3u8',
  type: 'auto',
  headers: {}
}

最简单的搜索例子

async search(ctx, { keyword, page, sourceId }) {
  const data = await ctx.request.getJson('https://example.com/api/search', {
    query: { wd: keyword, pg: page }
  });

  return {
    list: (data.list || []).map((item) => ({
      id: String(item.id),
      title: item.title,
      poster: item.pic || '',
      year: item.year || '',
      desc: item.desc || ''
    })),
    page,
    pageCount: data.pagecount || 1,
    total: data.total || 0
  };
}

最简单的播放解析例子

async resolvePlayUrl(ctx, { playUrl }) {
  return {
    url: playUrl,
    type: 'auto',
    headers: {}
  };
}

导入格式

{
  "key": "demo",
  "name": "演示脚本",
  "description": "test",
  "enabled": true,
  "code": "return { ... }"
}