From 4da4d980a1301f4ec1d2cb217fb39bf51c9717e8 Mon Sep 17 00:00:00 2001
From: Harold <8866033@gmail.com>
Date: Sun, 19 Apr 2026 18:59:57 +0800
Subject: [PATCH] feat: scaffold juquanquan spider

---
 py/tests/test_剧圈圈.py | 46 ++++++++++++++++++++++++
 py/剧圈圈.py            | 79 +++++++++++++++++++++++++++++++++++++++++
 2 files changed, 125 insertions(+)
 create mode 100644 py/tests/test_剧圈圈.py
 create mode 100644 py/剧圈圈.py

diff --git a/py/tests/test_剧圈圈.py b/py/tests/test_剧圈圈.py
new file mode 100644
index 0000000..ed3d9c9
--- /dev/null
+++ b/py/tests/test_剧圈圈.py
@@ -0,0 +1,46 @@
+import unittest
+from importlib.machinery import SourceFileLoader
+from pathlib import Path
+
+
+ROOT = Path(__file__).resolve().parents[1]
+MODULE = SourceFileLoader("juquanquan_spider", str(ROOT / "剧圈圈.py")).load_module()
+Spider = MODULE.Spider
+
+
+class TestJuQuanQuanSpider(unittest.TestCase):
+    def setUp(self):
+        Spider._instance = None
+        self.spider = Spider()
+        self.spider.init()
+
+    def test_home_content_exposes_expected_categories(self):
+        content = self.spider.homeContent(False)
+        self.assertEqual(
+            [item["type_id"] for item in content["class"]],
+            ["dianying", "juji", "dongman", "zongyi", "duanju"],
+        )
+
+    def test_encode_and_decode_detail_and_play_ids(self):
+        self.assertEqual(self.spider._encode_vod_id("/vod/123.html"), "vod/123")
+        self.assertEqual(self.spider._decode_vod_id("vod/123"), "https://www.jqqzx.cc/vod/123.html")
+        self.assertEqual(self.spider._encode_play_id("/play/123-1-2.html"), "play/123-1-2")
+        self.assertEqual(self.spider._decode_play_id("play/123-1-2"), "https://www.jqqzx.cc/play/123-1-2.html")
+
+    def test_parse_search_list_maps_items_to_compact_vod_ids(self):
+        payload = '{"list":[{"id":"888","name":"搜索影片","pic":"https://img.example/888.jpg"}]}'
+        self.assertEqual(
+            self.spider._parse_search_list(payload),
+            [
+                {
+                    "vod_id": "vod/888",
+                    "vod_name": "搜索影片",
+                    "vod_pic": "https://img.example/888.jpg",
+                    "vod_remarks": "",
+                }
+            ],
+        )
+
+
+if __name__ == "__main__":
+    unittest.main()
diff --git a/py/剧圈圈.py b/py/剧圈圈.py
new file mode 100644
index 0000000..ebbaa58
--- /dev/null
+++ b/py/剧圈圈.py
@@ -0,0 +1,79 @@
+# coding=utf-8
+import json
+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://www.jqqzx.cc"
+        self.headers = {
+            "User-Agent": "Mozilla/5.0",
+            "Accept-Language": "zh-CN,zh;q=0.9,en;q=0.8",
+            "Referer": self.host + "/",
+        }
+        self.categories = [
+            {"type_id": "dianying", "type_name": "电影"},
+            {"type_id": "juji", "type_name": "剧集"},
+            {"type_id": "dongman", "type_name": "动漫"},
+            {"type_id": "zongyi", "type_name": "综艺"},
+            {"type_id": "duanju", "type_name": "短剧"},
+        ]
+
+    def init(self, extend=""):
+        return None
+
+    def getName(self):
+        return self.name
+
+    def homeContent(self, filter):
+        return {"class": self.categories}
+
+    def _build_url(self, path):
+        return urljoin(self.host + "/", str(path or "").strip())
+
+    def _clean_text(self, text):
+        return re.sub(r"\s+", " ", re.sub(r"<[^>]+>", " ", str(text or ""))).strip()
+
+    def _encode_vod_id(self, href):
+        matched = re.search(r"/vod/([^/?#]+)\.html", self._build_url(href))
+        return f"vod/{matched.group(1)}" if matched else ""
+
+    def _decode_vod_id(self, vod_id):
+        matched = re.search(r"^vod/([^/?#]+)$", str(vod_id or "").strip())
+        return self._build_url(f"/vod/{matched.group(1)}.html") if matched else ""
+
+    def _encode_play_id(self, href):
+        matched = re.search(r"/play/([^/?#]+)\.html", self._build_url(href))
+        return f"play/{matched.group(1)}" if matched else ""
+
+    def _decode_play_id(self, play_id):
+        matched = re.search(r"^play/([^/?#]+)$", str(play_id or "").strip())
+        return self._build_url(f"/play/{matched.group(1)}.html") if matched else ""
+
+    def _parse_search_list(self, payload):
+        try:
+            data = json.loads(str(payload or "{}"))
+        except Exception:
+            return []
+        items = []
+        for item in data.get("list", []):
+            item_id = self._clean_text(item.get("id"))
+            item_name = self._clean_text(item.get("name"))
+            if not item_id or not item_name:
+                continue
+            items.append(
+                {
+                    "vod_id": f"vod/{item_id}",
+                    "vod_name": item_name,
+                    "vod_pic": self._build_url(item.get("pic")),
+                    "vod_remarks": "",
+                }
+            )
+        return items