Files

T

Harold 536f8041da feat: add shandian spider and aggregate support

2026-04-20 15:12:21 +08:00

29 KiB

Raw Blame History

闪电 Spider 与聚合接入 Implementation Plan

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (- [ ]) syntax for tracking.

Goal: 在当前 Python 仓库中新增独立单站 闪电 蜘蛛，并将其接入 玩偶聚合，支持分类、搜索、详情网盘线路整理和网盘透传。

Architecture: 单站实现采用与 至臻 相同的单文件 Spider 模式，在 py/闪电.py 中完成 URL 拼装、列表解析、详情字段提取和网盘线路组装。聚合层只补 shandian 站点配置和对应测试，复用现有 玩偶聚合.py 的搜索聚合、详情合并和网盘透传逻辑，不引入公共基类重构。

Tech Stack: Python 3, unittest, unittest.mock, re, sys, urllib.parse, base.spider.Spider

File Structure

Create: py/闪电.py
- 实现 Spider 类和站点全部逻辑
- 暴露 init、getName、homeContent、homeVideoContent、categoryContent、searchContent、detailContent、playerContent
Create: py/tests/test_闪电.py
- 使用 SourceFileLoader 加载 py/闪电.py
- 通过内联 HTML 与 mock 覆盖分类、搜索、详情、线路排序和透传
Modify: py/玩偶聚合.py
- 新增 shandian 站点配置
- 复用聚合层现有 URL 构建和详情合并逻辑
Modify: py/tests/test_玩偶聚合.py
- 新增 闪电 首页、分类 URL、搜索 URL 和详情合并测试

Task 1: Add Failing Tests For 闪电 Single Spider

Files:

Create: py/tests/test_闪电.py
Create: py/闪电.py
Step 1: Write the failing test

import unittest
from importlib.machinery import SourceFileLoader
from pathlib import Path
from unittest.mock import patch


ROOT = Path(__file__).resolve().parents[1]
MODULE = SourceFileLoader("shandian_spider", str(ROOT / "闪电.py")).load_module()
Spider = MODULE.Spider


class TestShanDianSpider(unittest.TestCase):
    def setUp(self):
        Spider._instance = None
        self.spider = Spider()
        self.spider.init()

    def test_home_content_exposes_all_categories(self):
        content = self.spider.homeContent(False)
        self.assertEqual(
            [(item["type_id"], item["type_name"]) for item in content["class"]],
            [
                ("1", "闪电电影"),
                ("2", "闪电剧集"),
                ("3", "闪电综艺"),
                ("4", "闪电动漫"),
                ("30", "闪电短剧"),
            ],
        )

    def test_home_video_content_returns_empty_list(self):
        self.assertEqual(self.spider.homeVideoContent(), {"list": []})

    def test_build_url_and_detect_pan_type(self):
        self.assertEqual(
            self.spider._build_url("/index.php/vod/detail/id/1.html"),
            "https://sd.sduc.site/index.php/vod/detail/id/1.html",
        )
        self.assertEqual(self.spider._detect_pan_type("https://pan.baidu.com/s/demo"), ("baidu", "百度资源"))
        self.assertEqual(self.spider._detect_pan_type("https://pan.quark.cn/s/demo"), ("quark", "夸克资源"))
        self.assertEqual(self.spider._detect_pan_type("https://example.com/video"), ("", ""))

Step 2: Run test to verify it fails

Run from py/: python -m unittest tests.test_闪电.TestShanDianSpider -v Expected: FAIL with FileNotFoundError for 闪电.py or missing Spider attributes.

Step 3: Write minimal implementation

# coding=utf-8
import re
import sys
from urllib.parse import urljoin

from base.spider import Spider as BaseSpider

sys.path.append("..")


class Spider(BaseSpider):
    def __init__(self):
        self.name = "闪电"
        self.host = "https://sd.sduc.site"
        self.headers = {
            "User-Agent": (
                "Mozilla/5.0 (Windows NT 10.0; Win64; x64) "
                "AppleWebKit/537.36 (KHTML, like Gecko) "
                "Chrome/136.0.0.0 Safari/537.36"
            ),
            "Referer": self.host + "/",
        }
        self.categories = [
            {"type_id": "1", "type_name": "闪电电影"},
            {"type_id": "2", "type_name": "闪电剧集"},
            {"type_id": "3", "type_name": "闪电综艺"},
            {"type_id": "4", "type_name": "闪电动漫"},
            {"type_id": "30", "type_name": "闪电短剧"},
        ]
        self.pan_patterns = [
            ("baidu", "百度资源", r"pan\.baidu\.com|yun\.baidu\.com"),
            ("a139", "139资源", r"yun\.139\.com"),
            ("a189", "天翼资源", r"cloud\.189\.cn"),
            ("a123", "123资源", r"123684\.com|123865\.com|123912\.com|123pan\.com"),
            ("a115", "115资源", r"115\.com"),
            ("quark", "夸克资源", r"pan\.quark\.cn"),
            ("xunlei", "迅雷资源", r"pan\.xunlei\.com"),
            ("aliyun", "阿里资源", r"aliyundrive\.com|alipan\.com"),
            ("uc", "UC资源", r"drive\.uc\.cn"),
        ]

    def init(self, extend=""):
        return None

    def getName(self):
        return self.name

    def homeContent(self, filter):
        return {"class": self.categories}

    def homeVideoContent(self):
        return {"list": []}

    def _build_url(self, path):
        return urljoin(self.host + "/", str(path or "").strip())

    def _detect_pan_type(self, url):
        raw = str(url or "").strip()
        for pan_type, title, pattern in self.pan_patterns:
            if re.search(pattern, raw, re.I):
                return pan_type, title
        return "", ""

Step 4: Run test to verify it passes

Run from py/: python -m unittest tests.test_闪电.TestShanDianSpider -v Expected: PASS for the scaffold tests.

Step 5: Commit

git add py/闪电.py py/tests/test_闪电.py
git commit -m "feat: scaffold shandian spider"

Task 2: Add 闪电 List, Search, Detail, And Player Coverage

Files:

Modify: py/tests/test_闪电.py
Modify: py/闪电.py
Step 1: Write the failing test

    def test_parse_cards_extracts_short_path_ids(self):
        html = """
        <div id="main">
          <div class="module-item">
            <div class="module-item-pic">
              <a href="/index.php/vod/detail/id/123.html"></a>
              <img data-src="/poster.jpg" alt="示例影片" />
            </div>
            <div class="module-item-text">HD</div>
            <div class="module-item-caption"><span>2025</span></div>
          </div>
        </div>
        """
        self.assertEqual(
            self.spider._parse_cards(html),
            [
                {
                    "vod_id": "/index.php/vod/detail/id/123.html",
                    "vod_name": "示例影片",
                    "vod_pic": "https://sd.sduc.site/poster.jpg",
                    "vod_remarks": "HD",
                    "vod_year": "2025",
                }
            ],
        )

    @patch.object(Spider, "_request_html")
    def test_category_content_builds_reference_url_and_returns_page_payload(self, mock_request_html):
        mock_request_html.return_value = """
        <div id="main">
          <div class="module-item">
            <div class="module-item-pic">
              <a href="/index.php/vod/detail/id/456.html"></a>
              <img data-src="/cate.jpg" alt="分类影片" />
            </div>
            <div class="module-item-text">更新至10集</div>
            <div class="module-item-caption"><span>2024</span></div>
          </div>
        </div>
        """
        result = self.spider.categoryContent("2", "3", False, {})
        self.assertEqual(
            mock_request_html.call_args.args[0],
            "https://sd.sduc.site/index.php/vod/show/id/2/page/3.html",
        )
        self.assertEqual(result["page"], 3)
        self.assertEqual(result["limit"], 1)
        self.assertEqual(result["list"][0]["vod_name"], "分类影片")

    @patch.object(Spider, "_request_html")
    def test_search_content_builds_reference_search_url_and_parses_results(self, mock_request_html):
        mock_request_html.return_value = """
        <div class="module-search-item">
          <a class="video-serial" href="/index.php/vod/detail/id/789.html" title="搜索影片">抢先版</a>
          <div class="module-item-pic">
            <img data-src="/search.jpg" alt="搜索影片" />
          </div>
        </div>
        """
        result = self.spider.searchContent("繁花", False, "2")
        self.assertEqual(
            mock_request_html.call_args.args[0],
            "https://sd.sduc.site/index.php/vod/search/page/2/wd/%E7%B9%81%E8%8A%B1.html",
        )
        self.assertEqual(result["list"][0]["vod_id"], "/index.php/vod/detail/id/789.html")

    def test_build_pan_lines_deduplicates_and_sorts_supported_links(self):
        detail = {"pan_urls": ["https://pan.quark.cn/s/q1", "https://pan.baidu.com/s/b1", "https://pan.baidu.com/s/b1"]}
        self.assertEqual(
            self.spider._build_pan_lines(detail),
            [
                ("baidu#闪电", "百度资源$https://pan.baidu.com/s/b1"),
                ("quark#闪电", "夸克资源$https://pan.quark.cn/s/q1"),
            ],
        )

Step 2: Run test to verify it fails

Run from py/: python -m unittest tests.test_闪电.TestShanDianSpider -v Expected: FAIL with missing _parse_cards, categoryContent, searchContent, or _build_pan_lines.

Step 3: Write minimal implementation

from urllib.parse import quote


        self.pan_priority = {
            "baidu": 1,
            "a139": 2,
            "a189": 3,
            "a123": 4,
            "a115": 5,
            "quark": 6,
            "xunlei": 7,
            "aliyun": 8,
            "uc": 9,
        }

    def _clean_text(self, text):
        return re.sub(r"\s+", " ", str(text or "").replace("\xa0", " ")).strip()

    def _request_html(self, path_or_url):
        target = path_or_url if str(path_or_url).startswith("http") else self._build_url(path_or_url)
        response = self.fetch(target, headers=dict(self.headers), timeout=10)
        if response.status_code != 200:
            return ""
        return response.text or ""

    def _page_result(self, items, pg):
        page = int(pg)
        return {"page": page, "limit": len(items), "total": page * 20 + len(items), "list": items}

    def _parse_cards(self, html):
        root = self.html(html)
        if root is None:
            return []
        items = []
        seen = set()
        for node in root.xpath("//*[@id='main']//*[contains(@class,'module-item')]"):
            href = "".join(node.xpath(".//*[contains(@class,'module-item-pic')]//a[1]/@href")).strip()
            title = "".join(node.xpath(".//*[contains(@class,'module-item-pic')]//img[1]/@alt")).strip()
            pic = (
                "".join(node.xpath(".//*[contains(@class,'module-item-pic')]//img[1]/@data-src")).strip()
                or "".join(node.xpath(".//*[contains(@class,'module-item-pic')]//img[1]/@src")).strip()
            )
            remarks = self._clean_text("".join(node.xpath(".//*[contains(@class,'module-item-text')][1]//text()")))
            year = self._clean_text("".join(node.xpath(".//*[contains(@class,'module-item-caption')][1]//span[1]//text()")))
            if not href or not title or href in seen:
                continue
            seen.add(href)
            items.append(
                {
                    "vod_id": href,
                    "vod_name": title,
                    "vod_pic": self._build_url(pic),
                    "vod_remarks": remarks,
                    "vod_year": year,
                }
            )
        return items

    def categoryContent(self, tid, pg, filter, extend):
        url = self._build_url(f"/index.php/vod/show/id/{tid}/page/{int(pg)}.html")
        return self._page_result(self._parse_cards(self._request_html(url)), pg)

    def searchContent(self, key, quick, pg="1"):
        keyword = self._clean_text(key)
        page = int(pg)
        if not keyword:
            return {"page": page, "total": 0, "list": []}
        url = self._build_url(f"/index.php/vod/search/page/{page}/wd/{quote(keyword)}.html")
        root = self.html(self._request_html(url))
        if root is None:
            return {"page": page, "total": 0, "list": []}
        items = []
        for node in root.xpath("//*[contains(@class,'module-search-item')]"):
            href = "".join(node.xpath(".//*[contains(@class,'video-serial')][1]/@href")).strip()
            title = "".join(node.xpath(".//*[contains(@class,'video-serial')][1]/@title")).strip()
            pic = (
                "".join(node.xpath(".//*[contains(@class,'module-item-pic')]//img[1]/@data-src")).strip()
                or "".join(node.xpath(".//*[contains(@class,'module-item-pic')]//img[1]/@src")).strip()
            )
            remarks = self._clean_text(
                "".join(node.xpath(".//*[contains(@class,'video-serial')][1]//text()"))
                or "".join(node.xpath(".//*[contains(@class,'module-item-text')][1]//text()"))
            )
            if not href or not title:
                continue
            items.append({"vod_id": href, "vod_name": title, "vod_pic": self._build_url(pic), "vod_remarks": remarks})
        return {"page": page, "total": len(items), "list": items}

    def _build_pan_lines(self, detail):
        lines = []
        seen = set()
        for url in detail.get("pan_urls", []):
            pan_type, title = self._detect_pan_type(url)
            if not pan_type or url in seen:
                continue
            seen.add(url)
            lines.append((self.pan_priority.get(pan_type, 999), f"{pan_type}#闪电", f"{title}${url}"))
        lines.sort(key=lambda item: item[0])
        return [(item[1], item[2]) for item in lines]

Step 4: Run test to verify it passes

Run from py/: python -m unittest tests.test_闪电.TestShanDianSpider -v Expected: PASS for list, search, and line-building tests.

Step 5: Commit

git add py/闪电.py py/tests/test_闪电.py
git commit -m "feat: add shandian list and search parsing"

Task 3: Add 闪电 Detail And Player Behavior

Files:

Modify: py/tests/test_闪电.py
Modify: py/闪电.py
Step 1: Write the failing test

    def test_parse_detail_page_extracts_meta_content_and_pan_urls(self):
        html = """
        <div class="page-title">示例剧</div>
        <div class="mobile-play"><img class="lazyload" data-src="/poster.jpg" /></div>
        <div class="video-info-itemtitle">年代</div><div><a>2024</a></div>
        <div class="video-info-itemtitle">导演</div><div><a>导演甲</a></div>
        <div class="video-info-itemtitle">主演</div><div><a>演员甲</a><a>演员乙</a></div>
        <div class="video-info-itemtitle">剧情</div><div><p>一段剧情简介</p></div>
        <div class="module-row-info">
          <p>https://pan.quark.cn/s/q1</p>
          <p>https://pan.baidu.com/s/b1</p>
        </div>
        """
        detail = self.spider._parse_detail_page("/index.php/vod/detail/id/123.html", html)
        self.assertEqual(detail["vod_name"], "示例剧")
        self.assertEqual(detail["vod_pic"], "https://sd.sduc.site/poster.jpg")
        self.assertEqual(detail["vod_year"], "2024")
        self.assertEqual(detail["vod_director"], "导演甲")
        self.assertEqual(detail["vod_actor"], "演员甲,演员乙")
        self.assertEqual(detail["vod_content"], "一段剧情简介")
        self.assertEqual(detail["pan_urls"], ["https://pan.quark.cn/s/q1", "https://pan.baidu.com/s/b1"])

    @patch.object(Spider, "_request_html")
    def test_detail_content_builds_pan_play_fields(self, mock_request_html):
        mock_request_html.return_value = """
        <div class="page-title">示例剧</div>
        <div class="mobile-play"><img class="lazyload" data-src="/poster.jpg" /></div>
        <div class="video-info-itemtitle">年代</div><div><a>2024</a></div>
        <div class="video-info-itemtitle">导演</div><div><a>导演甲</a></div>
        <div class="video-info-itemtitle">主演</div><div><a>演员甲</a></div>
        <div class="video-info-itemtitle">剧情</div><div><p>一段剧情简介</p></div>
        <div class="module-row-info">
          <p>https://pan.quark.cn/s/q1</p>
          <p>https://pan.baidu.com/s/b1</p>
        </div>
        """
        result = self.spider.detailContent(["/index.php/vod/detail/id/123.html"])
        vod = result["list"][0]
        self.assertEqual(vod["vod_play_from"], "baidu#闪电$$$quark#闪电")
        self.assertEqual(
            vod["vod_play_url"],
            "百度资源$https://pan.baidu.com/s/b1$$$夸克资源$https://pan.quark.cn/s/q1",
        )

    def test_player_content_passthroughs_supported_pan_urls(self):
        self.assertEqual(
            self.spider.playerContent("baidu#闪电", "https://pan.baidu.com/s/demo", {}),
            {"parse": 0, "playUrl": "", "url": "https://pan.baidu.com/s/demo"},
        )

    def test_player_content_rejects_non_pan_url(self):
        self.assertEqual(
            self.spider.playerContent("site", "/index.php/vod/play/id/1.html", {}),
            {"parse": 0, "playUrl": "", "url": ""},
        )

Step 2: Run test to verify it fails

Run from py/: python -m unittest tests.test_闪电.TestShanDianSpider -v Expected: FAIL with missing detail parser, detailContent, or playerContent.

Step 3: Write minimal implementation

    def _parse_detail_page(self, vod_id, html):
        root = self.html(html)
        if root is None:
            return {
                "vod_id": vod_id,
                "vod_name": "",
                "vod_pic": "",
                "vod_year": "",
                "vod_director": "",
                "vod_actor": "",
                "vod_content": "",
                "pan_urls": [],
            }
        detail = {
            "vod_id": vod_id,
            "vod_name": self._clean_text("".join(root.xpath("//*[contains(@class,'page-title')][1]//text()"))),
            "vod_pic": self._build_url(
                "".join(
                    root.xpath(
                        "//*[contains(@class,'mobile-play')]//*[contains(@class,'lazyload')][1]/@data-src | "
                        "//*[contains(@class,'mobile-play')]//*[contains(@class,'lazyload')][1]/@src"
                    )
                ).strip()
            ),
            "vod_year": "",
            "vod_director": "",
            "vod_actor": "",
            "vod_content": "",
            "pan_urls": [],
        }
        for label_node in root.xpath("//*[contains(@class,'video-info-itemtitle')]"):
            key = self._clean_text("".join(label_node.xpath(".//text()")))
            sibling = label_node.getnext()
            if sibling is None:
                continue
            values = [self._clean_text(text) for text in sibling.xpath(".//a//text()")]
            joined = ",".join([value for value in values if value])
            text_value = self._clean_text("".join(sibling.xpath(".//text()")))
            if "年代" in key:
                detail["vod_year"] = joined or text_value
            elif "导演" in key:
                detail["vod_director"] = joined or text_value
            elif "主演" in key:
                detail["vod_actor"] = joined or text_value
            elif "剧情" in key:
                detail["vod_content"] = text_value
        for node in root.xpath("//*[contains(@class,'module-row-info')]//p"):
            text = self._clean_text("".join(node.xpath(".//text()")))
            if text:
                detail["pan_urls"].append(text)
        return detail

    def detailContent(self, ids):
        result = {"list": []}
        for raw_id in ids:
            vod_id = str(raw_id or "").strip()
            detail = self._parse_detail_page(vod_id, self._request_html(self._build_url(vod_id)))
            lines = self._build_pan_lines(detail)
            result["list"].append(
                {
                    "vod_id": vod_id,
                    "vod_name": detail["vod_name"],
                    "vod_pic": detail["vod_pic"],
                    "vod_year": detail["vod_year"],
                    "vod_director": detail["vod_director"],
                    "vod_actor": detail["vod_actor"],
                    "vod_content": detail["vod_content"],
                    "vod_play_from": "$$$".join([item[0] for item in lines]),
                    "vod_play_url": "$$$".join([item[1] for item in lines]),
                }
            )
        return result

    def playerContent(self, flag, id, vipFlags):
        pan_type, _ = self._detect_pan_type(id)
        if pan_type:
            return {"parse": 0, "playUrl": "", "url": id}
        return {"parse": 0, "playUrl": "", "url": ""}

Step 4: Run test to verify it passes

Run from py/: python -m unittest tests.test_闪电.TestShanDianSpider -v Expected: PASS for detail and player tests.

Step 5: Commit

git add py/闪电.py py/tests/test_闪电.py
git commit -m "feat: add shandian detail and player support"

Task 4: Add 玩偶聚合 Failing Tests For 闪电

Files:

Modify: py/tests/test_玩偶聚合.py
Modify: py/玩偶聚合.py
Step 1: Write the failing test

    def test_home_content_exposes_shandian_site_and_categories(self):
        content = self.spider.homeContent(False)
        self.assertIn("site_shandian", [item["type_id"] for item in content["class"]])
        self.assertEqual(
            content["filters"]["site_shandian"][0]["value"][1:],
            [
                {"n": "电影", "v": "1"},
                {"n": "剧集", "v": "2"},
                {"n": "综艺", "v": "3"},
                {"n": "动漫", "v": "4"},
                {"n": "短剧", "v": "30"},
            ],
        )

    @patch.object(Spider, "_request_with_failover")
    def test_fetch_site_search_builds_shandian_search_url_and_parses_results(self, mock_request_with_failover):
        mock_request_with_failover.return_value = """
        <div class="module-search-item">
          <a class="video-serial" href="/index.php/vod/detail/id/789.html" title="闪电影片">抢先版</a>
          <div class="module-item-pic"><img data-src="/search.jpg" alt="闪电影片" /></div>
        </div>
        """
        site = self.spider._get_site("shandian")
        results = self.spider._fetch_site_search(site, "繁花", 1)
        self.assertEqual(
            mock_request_with_failover.call_args.args[1],
            "/index.php/vod/search/page/1/wd/%E7%B9%81%E8%8A%B1.html",
        )
        self.assertEqual(results[0]["vod_id"], "site:shandian:/index.php/vod/detail/id/789.html")

    @patch.object(Spider, "_request_with_failover")
    def test_category_content_builds_shandian_category_url(self, mock_request_with_failover):
        mock_request_with_failover.return_value = """
        <div class="module-item">
          <div class="module-item-pic">
            <a href="/index.php/vod/detail/id/456.html"></a>
            <img data-src="/cate.jpg" alt="闪电分类片" />
          </div>
          <div class="module-item-text">HD</div>
        </div>
        """
        result = self.spider.categoryContent("site_shandian", "2", False, {"categoryId": "30"})
        self.assertEqual(
            mock_request_with_failover.call_args.args[1],
            "https://sd.sduc.site/index.php/vod/show/id/30/page/2.html",
        )
        self.assertEqual(result["list"][0]["vod_id"], "site:shandian:/index.php/vod/detail/id/456.html")

Step 2: Run test to verify it fails

Run from py/: python -m unittest tests.test_玩偶聚合.TestWanouAggregateSpider.test_home_content_exposes_shandian_site_and_categories tests.test_玩偶聚合.TestWanouAggregateSpider.test_fetch_site_search_builds_shandian_search_url_and_parses_results tests.test_玩偶聚合.TestWanouAggregateSpider.test_category_content_builds_shandian_category_url -v Expected: FAIL because shandian is not yet present in self.sites.

Step 3: Write minimal implementation

            {
                "id": "shandian",
                "name": "闪电",
                "domains": ["https://sd.sduc.site"],
                "filter_files": [],
                "list_xpath": "//*[contains(@class,'module-item')]",
                "search_xpath": "//*[contains(@class,'module-search-item')]",
                "detail_pan_xpath": "//*[contains(@class,'module-row-info')]//p",
                "category_url": "/index.php/vod/show/id/{categoryId}/page/{page}.html",
                "search_url": "/index.php/vod/search/page/{page}/wd/{keyword}.html",
                "default_categories": [("1", "电影"), ("2", "剧集"), ("3", "综艺"), ("4", "动漫"), ("30", "短剧")],
            },

Step 4: Run test to verify it passes

Run from py/: python -m unittest tests.test_玩偶聚合.TestWanouAggregateSpider.test_home_content_exposes_shandian_site_and_categories tests.test_玩偶聚合.TestWanouAggregateSpider.test_fetch_site_search_builds_shandian_search_url_and_parses_results tests.test_玩偶聚合.TestWanouAggregateSpider.test_category_content_builds_shandian_category_url -v Expected: PASS with site_shandian visible and both URLs using /index.php/vod/....

Step 5: Commit

git add py/玩偶聚合.py py/tests/test_玩偶聚合.py
git commit -m "feat: add shandian aggregate site config"

Task 5: Verify 闪电 Detail Merge In 聚合层

Files:

Modify: py/tests/test_玩偶聚合.py
Modify: py/玩偶聚合.py
Step 1: Write the failing test

    @patch.object(Spider, "_fetch_site_detail")
    def test_detail_content_for_aggregate_id_merges_shandian_pan_lines(self, mock_fetch_site_detail):
        mock_fetch_site_detail.side_effect = [
            {
                "vod_name": "繁花",
                "vod_pic": "https://img.example/w.jpg",
                "vod_year": "2024",
                "vod_director": "导演甲",
                "vod_actor": "演员甲",
                "vod_content": "玩偶简介",
                "pan_urls": ["https://pan.baidu.com/s/b1"],
                "_site_name": "玩偶",
            },
            {
                "vod_name": "繁花",
                "vod_pic": "https://sd.sduc.site/poster.jpg",
                "vod_year": "2024",
                "vod_director": "导演乙",
                "vod_actor": "演员乙",
                "vod_content": "闪电简介",
                "pan_urls": ["https://pan.quark.cn/s/s1", "https://pan.baidu.com/s/b1"],
                "_site_name": "闪电",
            },
        ]
        payload = [
            {"site": "wanou", "path": "/voddetail/1.html", "name": "繁花", "year": "2024"},
            {"site": "shandian", "path": "/index.php/vod/detail/id/2.html", "name": "繁花", "year": "2024"},
        ]
        result = self.spider.detailContent([self.spider._encode_aggregate_vod_id(payload)])
        vod = result["list"][0]
        self.assertEqual(vod["vod_play_from"], "baidu#玩偶$$$quark#闪电")
        self.assertEqual(
            vod["vod_play_url"],
            "百度资源$https://pan.baidu.com/s/b1$$$夸克资源$https://pan.quark.cn/s/s1",
        )

Step 2: Run test to verify it fails

Run from py/: python -m unittest tests.test_玩偶聚合.TestWanouAggregateSpider.test_detail_content_for_aggregate_id_merges_shandian_pan_lines -v Expected: FAIL before shandian config exists because _get_site("shandian") cannot resolve.

Step 3: Write minimal implementation

            {
                "id": "shandian",
                "name": "闪电",
                "domains": ["https://sd.sduc.site"],
                "filter_files": [],
                "list_xpath": "//*[contains(@class,'module-item')]",
                "search_xpath": "//*[contains(@class,'module-search-item')]",
                "detail_pan_xpath": "//*[contains(@class,'module-row-info')]//p",
                "category_url": "/index.php/vod/show/id/{categoryId}/page/{page}.html",
                "search_url": "/index.php/vod/search/page/{page}/wd/{keyword}.html",
                "default_categories": [("1", "电影"), ("2", "剧集"), ("3", "综艺"), ("4", "动漫"), ("30", "短剧")],
            },

这一步不需要改动详情合并逻辑本身，只要保证 shandian 配置可被复用的聚合流程消费。

Step 4: Run test to verify it passes

Run from py/: python -m unittest tests.test_玩偶聚合.TestWanouAggregateSpider.test_detail_content_for_aggregate_id_merges_shandian_pan_lines -v Expected: PASS and重复百度链接被去重，只保留 闪电 的夸克线路增量。

Step 5: Commit

git add py/玩偶聚合.py py/tests/test_玩偶聚合.py
git commit -m "test: cover shandian aggregate detail merge"

Self-Review

Spec coverage: 单站分类、搜索、详情、播放透传，以及聚合层首页、分类 URL、搜索 URL、详情合并都覆盖到了，没有遗漏。
Placeholder scan: 文件路径、测试名、命令、代码片段和期望结果都已具体化，没有保留 TBD 或泛化描述。
Type consistency: 全程使用 闪电 / shandian / site_shandian / site:shandian:<path> 和 https://sd.sduc.site，命名保持一致。

29 KiB Raw Blame History

闪电 Spider 与聚合接入 Implementation Plan

File Structure

Task 1: Add Failing Tests For 闪电 Single Spider

Task 2: Add 闪电 List, Search, Detail, And Player Coverage

Task 3: Add 闪电 Detail And Player Behavior

Task 4: Add 玩偶聚合 Failing Tests For 闪电

Task 5: Verify 闪电 Detail Merge In 聚合层

Self-Review

29 KiB

Raw Blame History