脚本实装

SOURCE_SCRIPT.md

@@ -0,0 +1,199 @@
+# 视频源脚本编写教程
+
+## 最小模板
+
+```js
+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: '默认源',
+          lineId: 'default',
+          lineName: '默认线路',
+          episodes: [],
+          episodes_titles: []
+        }
+      ]
+    };
+  },
+
+  async resolvePlayUrl(ctx, { playUrl, sourceId, lineId, 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, lineId, 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` 返回格式
+
+```js
+{
+  list: [
+    {
+      id: '123',
+      title: '凡人修仙传',
+      poster: 'https://...',
+      year: '2025',
+      desc: '简介',
+      type_name: '动漫',
+      douban_id: 0,
+      vod_remarks: '更新至10集'
+    }
+  ],
+  page: 1,
+  pageCount: 1,
+  total: 1
+}
+```
+
+## `detail` 返回格式
+
+```js
+{
+  id: '123',
+  title: '凡人修仙传',
+  poster: 'https://...',
+  year: '2025',
+  desc: '简介',
+  playbacks: [
+    {
+      sourceId: 'default',
+      sourceName: '默认源',
+      lineId: 'line1',
+      lineName: '线路1',
+      episodes: [
+        'https://example.com/play/1',
+        'https://example.com/play/2'
+      ],
+      episodes_titles: ['第1集', '第2集']
+    }
+  ]
+}
+```
+
+## `resolvePlayUrl` 返回格式
+
+```js
+{
+  url: 'https://real-url.m3u8',
+  type: 'auto',
+  headers: {}
+}
+```
+
+## 最简单的搜索例子
+
+```js
+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
+  };
+}
+```
+
+## 最简单的播放解析例子
+
+```js
+async resolvePlayUrl(ctx, { playUrl }) {
+  return {
+    url: playUrl,
+    type: 'auto',
+    headers: {}
+  };
+}
+```
+
+## 导入格式
+
+```json
+{
+  "key": "demo",
+  "name": "演示脚本",
+  "description": "test",
+  "enabled": true,
+  "code": "return { ... }"
+}
+```
+