添加whatshub工单

2026-06-20 04:47:34 +08:00
parent a6c87e8e25
commit d5a0ffa6db
271 changed files with 9377 additions and 303 deletions
@@ -0,0 +1,138 @@
+<?php
+
+declare(strict_types=1);
+
+namespace app\common\library\scrm\spider;
+
+use app\common\library\scrm\AbstractScrmSpider;
+use app\common\library\scrm\UnifiedScrmData;
+
+/**
+ * Whatshub 云控蜘蛛（Real Browser + Turnstile 过盾 + UI 翻页）
+ *
+ * 时序：Cloudflare Turnstile → 密码弹窗 authActions → API 拦截 → UI 翻页
+ */
+class WhatshubSpider extends AbstractScrmSpider
+{
+    /** 列表 API 路径 */
+    private const API_LIST = '/api/whatshub-counter/workShare/open/detail';
+
+    /** 详情/统计 API 路径 */
+    private const API_DETAILS = '/api/whatshub-counter/workShare/open/statistics';
+
+    /** 默认每页条数 */
+    private const DEFAULT_PER_PAGE_COUNT = 20;
+
+    private string $pageUrl;
+
+    private string $account;
+
+    private string $password;
+
+    private UnifiedScrmData $unifiedData;
+
+    public function __construct(
+        string $pageUrl,
+        string $account = '',
+        string $password = '',
+        string $nodeHost = 'http://127.0.0.1:3001'
+    ) {
+        parent::__construct($nodeHost);
+        $this->pageUrl = $pageUrl;
+        $this->account = $account;
+        $this->password = $password;
+        $this->unifiedData = new UnifiedScrmData();
+    }
+
+    /** @return array<string, mixed> */
+    protected function getSpiderConfig(): array
+    {
+        $host = (string) parse_url($this->pageUrl, PHP_URL_HOST);
+
+        return [
+            'pageUrl'        => $this->pageUrl,
+            'listApi'        => self::API_LIST,
+            'detailApi'      => self::API_DETAILS,
+            'listMethod'     => 'POST',
+            'paginationMode' => self::MODE_UI,
+            'authActions'    => [
+                // Element Plus 密码弹窗：仅注入可见 input
+                ['type' => 'vue_fill', 'selector' => '.el-input__inner', 'value' => $this->password],
+                ['type' => 'wait', 'ms' => 500],
+                ['type' => 'vue_click', 'selector' => '.vxe-button-group .theme--primary'],
+                ['type' => 'wait', 'ms' => 2200],
+            ],
+            // Whatshub 专用：Real Browser + Turnstile + Captcha API 兜底 + 会话复用
+            'antiBot'        => [
+                'enabled'            => true,
+                'profile'            => 'real',
+                'turnstile'          => true,
+                'solverFallback'     => true,
+                'sessionKey'         => 'whatshub:' . $host,
+                'challengeTimeoutMs' => 60000,
+            ],
+        ];
+    }
+
+    /**
+     * @param array<string, mixed>|null $listFirstPageData
+     * @param array<string, mixed>|null $countData
+     */
+    protected function extractListTotalPages($listFirstPageData, $countData = null)
+    {
+        $defaultPerPage = self::DEFAULT_PER_PAGE_COUNT;
+        $this->unifiedData->total = (int) ($listFirstPageData['data']['total'] ?? 0);
+
+        if ($this->unifiedData->total <= $defaultPerPage) {
+            return 1;
+        }
+
+        return (int) ceil($this->unifiedData->total / $defaultPerPage);
+    }
+
+    /** @return array<string, mixed> */
+    protected function buildListPageParams(int $page): array
+    {
+        return ['pageNum' => $page, 'pageSize' => self::DEFAULT_PER_PAGE_COUNT];
+    }
+
+    /** @return array<string, mixed> */
+    protected function getUiPaginationConfig(): array
+    {
+        return [
+            'nextBtnSelector' => '.vxe-pager--next-btn',
+            'waitMs'          => 1500,
+        ];
+    }
+
+    protected function parseToUnifiedData($detailData, array $allListPagesData): UnifiedScrmData
+    {
+        $unifiedData = $this->unifiedData;
+
+        if (is_array($detailData)) {
+            $unifiedData->todayNewCount = (int) ($detailData['data']['dayNewFans'] ?? 0);
+        }
+
+        foreach ($allListPagesData as $pageRaw) {
+            if (!is_array($pageRaw)) {
+                continue;
+            }
+            $records = $pageRaw['data']['rows'] ?? [];
+            if (!is_array($records)) {
+                continue;
+            }
+            foreach ($records as $item) {
+                if (!is_array($item) || empty($item['account'])) {
+                    continue;
+                }
+                $number = (string) $item['account'];
+                $isOnline = isset($item['isOnline']) && (int) $item['isOnline'] === 1;
+                $unifiedData->addNumber($number, $isOnline, (int) ($item['dayNewFans'] ?? 0));
+            }
+        }
+
+        $unifiedData->total = count($unifiedData->numbers);
+
+        return $unifiedData;
+    }
+}