python-qdairlines-helper 0.0.6__py3-none-any.whl

qdairlines_helper/controller/user_login.py

@@ -0,0 +1,91 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     user_login.py
+# Description:  用户登录控制器
+# Author:       ASUS
+# CreateDate:   2026/01/04
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from typing import Dict, Any
+from qdairlines_helper.utils.log_utils import logger
+from playwright.async_api import Page, BrowserContext
+from qdairlines_helper.po.login_page import LoginPage
+import qdairlines_helper.config.url_const as url_const
+from qdairlines_helper.controller.home import load_home_po
+from playwright.async_api import Error as PlaywrightError, TimeoutError as PlaywrightTimeoutError
+from qdairlines_helper.utils.po_utils import get_ip_access_blocked_msg, parse_user_info_from_page_response
+
+
+async def open_login_page(*, page: Page, protocol: str, domain: str, timeout: float = 60.0) -> LoginPage:
+    url_prefix = f"{protocol}://{domain}"
+    login_url = url_prefix + url_const.login_url
+    await page.goto(login_url)
+
+    login_po = LoginPage(page=page, url=login_url)
+    await login_po.url_wait_for(url=login_url, timeout=timeout)
+    logger.info(f"即将进入青岛航空官网登录页面，页面URL<{login_url}>")
+    ip_access_blocked_msg = await get_ip_access_blocked_msg(page=page, timeout=3)
+    if ip_access_blocked_msg:
+        raise EnvironmentError(ip_access_blocked_msg)
+    return login_po
+
+
+async def _user_login(
+        *, page: LoginPage, protocol: str, domain: str, username: str, password: str, timeout: float = 60.0
+) -> None:
+    # 1. 输入用户名
+    username_input = await page.get_login_username_input(timeout=timeout)
+    await username_input.fill(value=username.strip())
+    logger.info(f"青岛航空官网登录页面，用户名<{username}>输入完成")
+
+    # 2. 输入密码
+    password_input = await page.get_login_password_input(timeout=timeout)
+    await password_input.fill(value=password.strip())
+    logger.info(f"青岛航空官网登录页面，密码<{password}>输入完成")
+
+    # 3. 点击易盾验证logo
+    check_logo_icon = await page.get_check_logo_icon(timeout=timeout)
+    await check_logo_icon.click(button="left")
+    logger.info("青岛航空官网登录页面，【易盾验证logo】点击完成")
+
+    # 4. 获取校验成功的结果
+    check_pass_text = await page.get_check_pass_text(timeout=timeout)
+    logger.info(f"青岛航空官网登录页面，易盾验证logo点击后，校验结果【{check_pass_text}】获取完成")
+
+    # 4. 点击登录
+    login_btn = await page.get_login_btn(timeout=timeout)
+    await login_btn.click(button="left")
+    logger.info("青岛航空官网登录页面，【登录】按钮点击完成")
+
+    # 5. 加载首页页面对象，加载成功说明进入了首页，登录成功
+    try:
+        await load_home_po(page=page.get_page(), protocol=protocol, domain=domain, timeout=timeout)
+        logger.info(f"青岛航空官网登录页面，用户：{username}, 密码：{password}登录成功")
+    except (PlaywrightError, PlaywrightTimeoutError, EnvironmentError, RuntimeError, Exception) as e:
+        raise RuntimeError(f"青岛航空官网登录页面，用户：{username}, 密码：{password}登录失败，原因：{e}")
+
+
+async def user_login_callback(
+        *, page: Page, context: BrowserContext, protocol: str, domain: str, username: str, password: str,
+        timeout: float = 60.0, **kwargs: Any
+) -> Dict[str, Any]:
+    # 1. 打开登录页面
+    login_po = await open_login_page(page=page, protocol=protocol, domain=domain, timeout=timeout)
+
+    # 2. 开启网络监听
+    keywords = [url_const.auth_form_api_url, url_const.login_after_api_url]
+    network_logs = await login_po.capture_network(
+        keywords=keywords, include_post_data=True, include_response_body=True, parse_form_data=True
+    )
+    # network_logs1 = await login_po.capture_network_by_route(keywords=keywords, parse_form_data=True)
+
+    # 2. 执行登录操作
+    await _user_login(
+        page=login_po, protocol=protocol, domain=domain, username=username, password=password, timeout=timeout
+    )
+    user_info = parse_user_info_from_page_response(network_logs=network_logs)
+    user_info.update(dict(storage_state=await context.storage_state()))
+    return user_info

qdairlines_helper/http/__init__.py

@@ -0,0 +1,11 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     __init__.py
+# Description:  http协议处理包
+# Author:       ASUS
+# CreateDate:   2026/01/06
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""

qdairlines_helper/http/flight_order.py

@@ -0,0 +1,86 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     flight_order.py
+# Description:  航班订单模块
+# Author:       ASUS
+# CreateDate:   2026/01/06
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from aiohttp import CookieJar
+from typing import Optional, Dict, Any
+import qdairlines_helper.config.url_const as url_const
+from http_helper.client.async_proxy import HttpClientFactory as _HttpClientFactory
+
+
+class FlightOrder:
+
+    def __init__(
+            self, *, playwright_state: Dict[str, Any], token: Optional[str], proxy: Optional[Dict[str, Any]] = None,
+            domain: Optional[str] = None, protocol: Optional[str] = None, timeout: Optional[int] = None,
+            retry: Optional[int] = None, enable_log: Optional[bool] = None, cookie_jar: Optional[CookieJar] = None
+    ):
+        self._domain = domain or "127.0.0.1:18070"
+        self._protocol = protocol or "http"
+        self._timeout = timeout or 60
+        self._retry = retry or 0
+        self._token = token
+        self._origin = f"{self._protocol}://{self._domain}"
+        self._enable_log = enable_log or True
+        self._cookie_jar = cookie_jar or CookieJar()
+        self._proxy = proxy
+        self._playwright_state: Dict[str, Any] = playwright_state
+        self.http_client: Optional[_HttpClientFactory] = None
+
+    def _get_http_client(self) -> _HttpClientFactory:
+        """延迟获取 HTTP 客户端"""
+        if self.http_client is None:
+            self.http_client = _HttpClientFactory(
+                protocol=self._protocol,
+                domain=self._domain,
+                timeout=self._timeout,
+                retry=self._retry,
+                enable_log=self._enable_log,
+                cookie_jar=self._cookie_jar,
+                playwright_state=self._playwright_state
+            )
+        return self.http_client
+
+    def _get_headers(self) -> Dict[str, str]:
+        headers = {
+            "content-type": "application/json;charset=utf-8",
+            "origin": self._domain,
+            "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/143.0.0.0 Safari/537.36",
+            "authorization": f"Bearer {self._token}"
+        }
+        return headers
+
+    async def get_order_details(
+            self, *, pre_order_no: str, user_id: str, proxy: Optional[Dict[str, Any]] = None,
+            headers: Dict[str, str] = None, is_end: Optional[bool] = None
+    ) -> Dict[str, Any]:
+        json_data = {
+            "orderNo": pre_order_no,
+            "plat": "NB2C",
+            "userId": user_id
+        }
+        _headers = self._get_headers()
+        if headers is not None:
+            _headers.update(headers)
+        _headers["referer"] = f"{self._origin}{url_const.order_detail_url}?orderNo={pre_order_no}&orderType=2"
+        if is_end is None:
+            is_end = True
+        if proxy:
+            self._proxy = proxy
+        exception_keywords = [r'<h3[^>]*class="font-bold"[^>]*>([^<]+)</h3>']
+        return await self._get_http_client().request(
+            method="POST",
+            url=url_const.order_info_api_url,
+            headers=_headers,
+            is_end=is_end,
+            json_data=json_data,
+            proxy_config=self._proxy or None,
+            exception_keywords=exception_keywords
+        )

qdairlines_helper/po/__init__.py

@@ -0,0 +1,11 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     __init__.py
+# Description:  po对象包
+# Author:       ASUS
+# CreateDate:   2026/01/04
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""

qdairlines_helper/po/add_passenger_page.py

@@ -0,0 +1,155 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     add_passenger_page.py
+# Description:  添加乘客页面对象
+# Author:       ASUS
+# CreateDate:   2026/01/04
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from typing import Optional
+from playwright.async_api import Page, Locator
+from playwright_helper.libs.base_po import BasePo
+import qdairlines_helper.config.url_const as url_const
+
+
+class AddPassengerPage(BasePo):
+    url: str = url_const.add_passenger_url
+    __page: Page
+
+    def __init__(self, page: Page, url: Optional[str] = None) -> None:
+        super().__init__(page, url or url_const.add_passenger_url)
+        self.__page = page
+
+    async def get_add_passenger_btn(self, passenger_type: str, timeout: float = 5.0) -> Locator:
+        """
+        获取添加乘客页中的【添加成人|添加儿童|添加婴儿】按钮
+        :param passenger_type: 乘客类型，成人|儿童|婴儿
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        if passenger_type == '成人':
+            btn_text = "添加成人"
+        elif passenger_type == "儿童":
+            btn_text = "添加儿童"
+        elif passenger_type == "婴儿":
+            btn_text = "添加婴儿"
+        else:
+            raise EnvironmentError(f"乘客类型<{passenger_type}>暂不支持")
+        selector: str = f'//div[@class="el-row"]//button[@class="search_btn" and contains(text(), "{btn_text}")]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_add_passenger_plane(self, timeout: float = 5.0, position_index: int = 0) -> Locator:
+        """
+        获取添加乘客页中的乘机人信息面板，按索引提取
+        :param timeout: 超时时间（秒）
+        :param position_index: 元素位置索引，该元素在页面中可能存在多组，默认从第0组开始
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = f'xpath=//label[@for="passengerAdult{position_index}"]/../../../..'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_passenger_type_checkbox(
+            self, passenger_type: str, timeout: float = 5.0, position_index: int = 0
+    ) -> Locator:
+        """
+        获取添加乘客页中的旅客类型【成人|儿童|婴儿】单选框
+        :param passenger_type: 乘客类型，成人|儿童|婴儿
+        :param timeout: 超时时间（秒）
+        :param position_index: 元素位置索引，该元素在页面中可能存在多组，默认从第0组开始
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        if passenger_type == '成人':
+            passenger_class = f"passengerAdult{position_index}"
+        elif passenger_type == "儿童":
+            passenger_class = f"passengerChild{position_index}"
+        elif passenger_type == "婴儿":
+            passenger_class = f"passengerBaby{position_index}"
+        else:
+            raise EnvironmentError(f"乘客类型<{passenger_type}>暂不支持")
+        selector: str = f'//label[@for="{passenger_class}"]/span[@class="checkbox"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_passenger_username_input(self, locator: Locator, timeout: float = 5.0) -> Locator:
+        """
+        获取添加乘客页中的乘客姓名输入框
+        :param locator: 乘机人信息面板  passenger_plane的Locator对象
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=.//input[contains(@placeholder, "乘机人姓名")]'
+        return await self.get_sub_locator(locator=locator, selector=selector, timeout=timeout)
+
+    async def get_gender_checkbox(self, locator: Locator, gender: str, timeout: float = 5.0) -> Locator:
+        """
+        获取添加乘客页中的乘客性别【男|女】单选框
+        :param locator: 乘机人信息面板  passenger_plane的Locator对象
+        :param gender: 性别
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        if gender in ['male', '男', '男士', '男生']:
+            index = 0
+        else:
+            index = -1
+        selector: str = f'xpath=.//label[@tabindex="{index}"]//span[@class="el-radio__inner"]'
+        return await self.get_sub_locator(locator=locator, selector=selector, timeout=timeout)
+
+    async def get_id_type_dropdown(self, locator: Locator, timeout: float = 5.0) -> Locator:
+        """
+        获取添加乘客页中的证件号码类型下拉菜单按钮
+        :param locator: 乘机人信息面板  passenger_plane的Locator对象
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = f'xpath=.//input[contains(@placeholder, "请选择")]'
+        return await self.get_sub_locator(locator=locator, selector=selector, timeout=timeout)
+
+    async def get_id_type_dropdown_selection(self, id_type: str = "身份证", timeout: float = 5.0) -> Locator:
+        """
+        获取添加乘客页中的证件号码类型下拉菜单按钮
+        :param id_type: 乘机人的证件类型
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = f'xpath=//div[@x-placement="bottom-start"]//ul[@class="el-scrollbar__view el-select-dropdown__list"]//span[contains(text(), "{id_type}")]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_id_no_input(self, locator: Locator, timeout: float = 5.0) -> Locator:
+        """
+        获取添加乘客页中的乘客证件号码输入框
+        :param locator: 乘机人信息面板  passenger_plane的Locator对象
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=.//input[contains(@placeholder, "请输入证件号")]'
+        return await self.get_sub_locator(locator=locator, selector=selector, timeout=timeout)
+
+    async def get_service_mobile_input(self, timeout: float = 5.0) -> Locator:
+        """
+        获取添加乘客页中的联系人手机号码输入框
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=//input[contains(@placeholder, "请输入联系人手机号码")]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_agree_checkbox(self, timeout: float = 5.0) -> Locator:
+        """
+        获取添加乘客页中的【已阅读并同意】单选框
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = f'xpath=//label[contains(text(), "已阅读并同意")]/../label/span'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_next_btn(self, timeout: float = 5.0) -> Locator:
+        """
+        获取添加乘客页中的【下一步】按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=//div[@class="el-row"]//button[contains(text(), "下一步")]'
+        return await self.get_locator(selector=selector, timeout=timeout)

qdairlines_helper/po/air_order_page.py

@@ -0,0 +1,24 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     profile_page.py
+# Description:  机票查询页面对象
+# Author:       ASUS
+# CreateDate:   2026/01/04
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from typing import Optional
+from playwright.async_api import Page
+from playwright_helper.libs.base_po import BasePo
+import qdairlines_helper.config.url_const as url_const
+
+
+class AirOrderPage(BasePo):
+    url: str = url_const.air_order_url
+    __page: Page
+
+    def __init__(self, page: Page, url: Optional[str] = None) -> None:
+        super().__init__(page, url or url_const.air_order_url)
+        self.__page = page

qdairlines_helper/po/book_search_page.py

@@ -0,0 +1,189 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     book_search_page.py
+# Description:  预订查询页面对象
+# Author:       ASUS
+# CreateDate:   2026/01/04
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+import re
+from typing import Optional, Dict, Any, List
+from playwright.async_api import Page, Locator
+from playwright_helper.libs.base_po import BasePo
+from qdairlines_helper.utils.log_utils import logger
+import qdairlines_helper.config.url_const as url_const
+from playwright_helper.utils.type_utils import convert_order_amount_text, safe_convert_advanced
+from playwright.async_api import Error as PlaywrightError, TimeoutError as PlaywrightTimeoutError
+
+
+class BookSearchPage(BasePo):
+    url: str = url_const.book_search_url
+    __page: Page
+
+    def __init__(self, page: Page, url: Optional[str] = None) -> None:
+        super().__init__(page, url or url_const.book_search_url)
+        self.__page = page
+
+    async def get_reminder_dialog_continue_book_btn(self, timeout: float = 5.0) -> Locator:
+        """
+        获取预订搜索页的温馨提醒弹框中的【继续购票】按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//div[@class="el-dialog__body"]//button[contains(@class, "search_btn")]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_depart_city_input(self, timeout: float = 5.0) -> Locator:
+        """
+        获取预订搜索页搜索栏的起飞城市输入框
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//div[contains(@class, "flight_search_form")]//input[@id="orig"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_arrive_city_input(self, timeout: float = 5.0) -> Locator:
+        """
+        获取预订搜索页搜索栏的抵达城市输入框
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//div[contains(@class, "flight_search_form")]//input[@id="dest"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_depart_date_input(self, timeout: float = 5.0) -> Locator:
+        """
+        获取预订搜索页搜索栏的起飞日期输入框
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//div[contains(@class, "flight_search_form")]//input[contains(@placeholder, "去程日期")]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_flight_query_btn(self, timeout: float = 5.0) -> Locator:
+        """
+        获取预订搜索页搜索栏的【查询机票】按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//div[contains(@class, "flight_search_form")]//button[@class="search_btn"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_flight_info_plane(self, timeout: float = 5.0) -> Locator:
+        """
+        获取预订搜索页航班内容栏航班基本信息
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//div[@class="airlines_cont"]//div[@class="text-center el-row"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_flight_no(self, locator: Locator, timeout: float = 5.0) -> str:
+        """
+        获取预订搜索页航班编号
+        :param timeout: 超时时间（秒）
+        :param locator: flight_info_plane Locator 对象
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=(.//div[contains(@class, "flight_qda")]/span)[2]'
+        sub_locator: Locator = await self.get_sub_locator(locator=locator, selector=selector, timeout=timeout)
+        return (await sub_locator.inner_text(timeout=timeout)).strip()
+
+    async def get_flight_product_nav(self, locator: Locator, product_type: str, timeout: float = 5.0) -> Locator:
+        """
+        获取预订搜索页航班产品类型nav
+        :param timeout: 超时时间（秒）
+        :param product_type: 产品类型
+        :param locator: flight_info_plane Locator 对象
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        if product_type == "经济舱":
+            index = 1
+        elif product_type == "超级经济舱":
+            index = 2
+        elif product_type == "公务舱":
+            index = 3
+        else:
+            raise EnvironmentError(f"产品类型参数值<{product_type}>无效，目前仅支持<经济舱，超级经济舱，公务舱>")
+        selector: str = f'xpath=(.//div[contains(@class, "nav_item el-col el-col-24")])[{index}]'
+        return await self.get_sub_locator(locator=locator, selector=selector, timeout=timeout)
+
+    async def get_flight_products(self, timeout: float = 5.0) -> Dict[str, Any]:
+        """
+        获取预订搜索页航班内容栏所有航班产品
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//div[@class="airlines_cont"]//div[@class="text-center cabinClasses_info el-row" and not(@style="display: none;")]/table/tbody/tr'
+        products_locator: Locator = await self.get_locator(selector=selector, timeout=timeout)
+        locators: List[Locator] = await products_locator.all()
+        flight_products = dict()
+        for locator in locators:
+            try:
+                booking_btn: Locator = await self._get_flight_product_booking_btn(locator=locator, timeout=timeout)
+                amounts: Dict[str, Any] = await self._get_flight_product_price(locator=locator, timeout=timeout)
+                seats_status: int = await self._get_flight_product_seats_status(locator=locator, timeout=timeout)
+                cabin = await self._get_flight_product_cabin(locator=locator, timeout=timeout)
+                flight_products[cabin] = dict(
+                    amounts=amounts, cabin=cabin, seats_status=seats_status, booking_btn=booking_btn
+                )
+            except (PlaywrightError, PlaywrightTimeoutError, EnvironmentError, RuntimeError, Exception) as e:
+                logger.warning(e)
+                continue
+        return flight_products
+
+    async def _get_flight_product_cabin(self, locator: Locator, timeout: float = 5.0) -> str:
+        """
+        获取预订搜索页航班内容栏航班产品下的舱位
+        :param timeout: 超时时间（秒）
+        :param locator: flight_product Locator 对象
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=.//div[@class="ticket_clazz"]/div/span'
+        locator: Locator = await self.get_sub_locator(locator=locator, selector=selector, timeout=timeout)
+        text: str = (await locator.inner_text(timeout=timeout)).strip()
+        match = re.search(r'\((.*?)舱\)', text)
+        if match:
+            return match.group(1).strip()
+        raise RuntimeError(f"获取到的航班舱位信息：{text}，提取异常")
+
+    async def _get_flight_product_price(self, locator: Locator, timeout: float = 5.0) -> Dict[str, Any]:
+        """
+        获取预订搜索页航班内容栏航班产品下的销售价格
+        :param timeout: 超时时间（秒）
+        :param locator: flight_product Locator 对象
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=.//div[@class="price_flex_top"]/span'
+        locator: Locator = await self.get_sub_locator(locator=locator, selector=selector, timeout=timeout)
+        amount_text: str = (await locator.inner_text(timeout=timeout)).strip()
+        return convert_order_amount_text(amount_text=amount_text)
+
+    async def _get_flight_product_booking_btn(self, locator: Locator, timeout: float = 5.0) -> Locator:
+        """
+        获取预订搜索页航班内容栏航班产品下的【购票】按钮
+        :param timeout: 超时时间（秒）
+        :param locator: flight_product Locator 对象
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=（.//td[@class="ticket_num"]/div/span)[1]'
+        return await self.get_sub_locator(locator=locator, selector=selector, timeout=timeout)
+
+    async def _get_flight_product_seats_status(self, locator: Locator, timeout: float = 5.0) -> int:
+        """
+        获取预订搜索页航班内容栏航班产品下的余票信息
+        :param timeout: 超时时间（秒）
+        :param locator: flight_product Locator 对象
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = 'xpath=（.//td[@class="ticket_num"]/div/span)[2]'
+        locator: Locator = await self.get_sub_locator(locator=locator, selector=selector, timeout=timeout)
+        more_seats_text: str = (await locator.inner_text(timeout=timeout)).strip()
+        match = re.search(r'\d+', more_seats_text)
+        if match:
+            return safe_convert_advanced(value=match.group(1).strip())
+        else:
+            return 999999

qdairlines_helper/po/cash_pax_info_page.py

@@ -0,0 +1,74 @@
+# -*- coding: utf-8 -*-
+"""
+# ---------------------------------------------------------------------------------------------------------
+# ProjectName:  python-qdairlines-helper
+# FileName:     cash_pax_info_page.py
+# Description:  支付类型页面对象
+# Author:       ASUS
+# CreateDate:   2026/01/05
+# Copyright ©2011-2026. Hunan xxxxxxx Company limited. All rights reserved.
+# ---------------------------------------------------------------------------------------------------------
+"""
+from typing import Optional
+from urllib.parse import urlparse, parse_qs
+from playwright.async_api import Page, Locator
+from playwright_helper.libs.base_po import BasePo
+from qdairlines_helper.utils.log_utils import logger
+import qdairlines_helper.config.url_const as url_const
+
+
+class CashPaxInfoPage(BasePo):
+    url: str = url_const.cash_pax_info_url
+    __page: Page
+
+    def __init__(self, page: Page, url: Optional[str] = None) -> None:
+        super().__init__(page, url or url_const.cash_pax_info_url)
+        self.__page = page
+
+    async def get_payment_type_checkbox(self, payment_type: str, timeout: float = 5.0) -> Locator:
+        """
+        获取支付方式页面中的支付类型【支付宝|微信|汇付天下|易宝支付】单选框
+        :param payment_type: 支付类型，支付宝|微信|汇付天下|易宝支付
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        if payment_type == '支付宝':
+            for_class = 0
+        elif payment_type == "微信":
+            for_class = 1
+        elif payment_type == "汇付天下":
+            for_class = 2
+        elif payment_type == "易宝支付":
+            for_class = 3
+        else:
+            raise EnvironmentError(f"支付类型<{payment_type}>暂不支持")
+        selector: str = f'xpath=//label[@for="passengerAdult{for_class}"]//span[@class="checkbox"]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_confirm_payment_btn(self, timeout: float = 5.0) -> Locator:
+        """
+        获取支付方式页面中的【确认支付】按钮
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        selector: str = '//button[@class="search_btn" and contains(text(), "确认支付")]'
+        return await self.get_locator(selector=selector, timeout=timeout)
+
+    async def get_pre_order_no(self, timeout: float = 5.0) -> str:
+        """
+        获取青岛航空官网订单号
+        :param timeout: 超时时间（秒）
+        :return: (是否存在, 错误信息|元素对象)
+        """
+        try:
+            query = urlparse(self.__page.url).query
+            params = parse_qs(query)
+            # 取第一个值（即使有多个 orderNo）
+            pre_order_no = params.get('orderNo', [""])[0]
+            if pre_order_no and len(pre_order_no) == 18 and pre_order_no.startswith("OW") is True:
+                return pre_order_no
+        except (Exception,):
+            logger.error(f"支付方式页面获取到的url={self.__page.url}，信息异常")
+        selector: str = '//div[@class="order-form"]//span[contains(text(), "订单编号")]/../span[@class="font_red"]'
+        locator = await self.get_locator(selector=selector, timeout=timeout)
+        return (await locator.inner_text()).strip()