xfcloudcard 0.1.0__tar.gz

xfcloudcard-0.1.0/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: xfcloudcard
+Version: 0.1.0
+Summary: 云控卡密验证客户端库 - 支持 AES+HMAC 加密通信、心跳保活、离线上报
+Author: songxf
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/songxf/xfcloudcard
+Project-URL: Source, https://github.com/songxf/xfcloudcard
+Project-URL: Issues, https://github.com/songxf/xfcloudcard/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Security :: Cryptography
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Requires-Dist: pycryptodome>=3.15.0
+
+# xfcloudcard
+
+云控卡密验证客户端库，支持 AES-256-CBC + HMAC-SHA256 加密通信、心跳保活、离线上报。
+
+## 安装
+
+```bash
+pip install xfcloudcard
+```
+
+## 快速开始
+
+### 方式一：上下文管理器（推荐）
+
+```python
+from xfcloudcard import CardClient
+
+with CardClient(server_url="http://localhost:8000", key="your-key") as client:
+    result = client.verify("CARD-XXXX-XXXX-XXXX-XXXX")
+    if result['success']:
+        # 业务代码写这里
+        pass
+# 退出 with 块时自动停止心跳 + 发送离线通知
+```
+
+### 方式二：装饰器（最简洁）
+
+```python
+from xfcloudcard import require_card
+
+@require_card(server_url="http://localhost:8000", key="your-key")
+def main():
+    # 仅当卡密验证通过后才执行
+    print("验证通过，执行业务逻辑...")
+
+main()
+```
+
+### 方式三：命令行
+
+```bash
+# 交互模式
+xfcloudcard
+
+# 直接验证
+xfcloudcard --card CARD-XXXX-XXXX-XXXX-XXXX
+
+# 只验证，不启动心跳
+xfcloudcard --card CARD-XXXX-... --once
+```
+
+## API
+
+### `CardClient(server_url, key, heartbeat_interval=60)`
+
+| 方法 | 说明 |
+|------|------|
+| `verify(card_key)` | 验证卡密，成功后自动启动心跳 |
+| `verify_only(card_key)` | 只验证，不启动心跳 |
+| `close()` | 停止心跳并发送离线通知 |
+| `is_online()` | 返回心跳是否运行中 |
+
+### `require_card(server_url, key, heartbeat_interval=60, exit_on_fail=True)`
+
+装饰器，在业务函数执行前自动验证卡密。
+
+## 依赖
+
+- `requests >= 2.25.0`
+- `pycryptodome >= 3.15.0`
+
+## 协议
+
+MIT

xfcloudcard-0.1.0/README.md

@@ -0,0 +1,74 @@
+# xfcloudcard
+
+云控卡密验证客户端库，支持 AES-256-CBC + HMAC-SHA256 加密通信、心跳保活、离线上报。
+
+## 安装
+
+```bash
+pip install xfcloudcard
+```
+
+## 快速开始
+
+### 方式一：上下文管理器（推荐）
+
+```python
+from xfcloudcard import CardClient
+
+with CardClient(server_url="http://localhost:8000", key="your-key") as client:
+    result = client.verify("CARD-XXXX-XXXX-XXXX-XXXX")
+    if result['success']:
+        # 业务代码写这里
+        pass
+# 退出 with 块时自动停止心跳 + 发送离线通知
+```
+
+### 方式二：装饰器（最简洁）
+
+```python
+from xfcloudcard import require_card
+
+@require_card(server_url="http://localhost:8000", key="your-key")
+def main():
+    # 仅当卡密验证通过后才执行
+    print("验证通过，执行业务逻辑...")
+
+main()
+```
+
+### 方式三：命令行
+
+```bash
+# 交互模式
+xfcloudcard
+
+# 直接验证
+xfcloudcard --card CARD-XXXX-XXXX-XXXX-XXXX
+
+# 只验证，不启动心跳
+xfcloudcard --card CARD-XXXX-... --once
+```
+
+## API
+
+### `CardClient(server_url, key, heartbeat_interval=60)`
+
+| 方法 | 说明 |
+|------|------|
+| `verify(card_key)` | 验证卡密，成功后自动启动心跳 |
+| `verify_only(card_key)` | 只验证，不启动心跳 |
+| `close()` | 停止心跳并发送离线通知 |
+| `is_online()` | 返回心跳是否运行中 |
+
+### `require_card(server_url, key, heartbeat_interval=60, exit_on_fail=True)`
+
+装饰器，在业务函数执行前自动验证卡密。
+
+## 依赖
+
+- `requests >= 2.25.0`
+- `pycryptodome >= 3.15.0`
+
+## 协议
+
+MIT

xfcloudcard-0.1.0/pyproject.toml

@@ -0,0 +1,41 @@
+[build-system]
+requires = ["setuptools>=68.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "xfcloudcard"
+version = "0.1.0"
+description = "云控卡密验证客户端库 - 支持 AES+HMAC 加密通信、心跳保活、离线上报"
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.8"
+authors = [
+    {name = "songxf"},
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Topic :: Security :: Cryptography",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+    "requests >= 2.25.0",
+    "pycryptodome >= 3.15.0",
+]
+
+[project.urls]
+Homepage = "https://github.com/songxf/xfcloudcard"
+Source = "https://github.com/songxf/xfcloudcard"
+Issues = "https://github.com/songxf/xfcloudcard/issues"
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["xfcloudcard*"]
+
+[tool.setuptools.package-data]
+xfcloudcard = ["py.typed"]

xfcloudcard-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

xfcloudcard-0.1.0/xfcloudcard/__init__.py

@@ -0,0 +1,24 @@
+"""
+xfcloudcard - 云控卡密验证客户端库
+
+支持 AES-256-CBC + HMAC-SHA256 加密通信、
+心跳保活、离线上报，可作为库集成到业务代码中。
+
+快速开始:
+    >>> from xfcloudcard import CardClient
+    >>> with CardClient(server_url="http://localhost:8000", key="your-key") as client:
+    ...     result = client.verify("CARD-XXXX-XXXX-XXXX-XXXX")
+    ...     if result['success']:
+    ...         pass  # 业务代码
+"""
+
+from .client import CardClient, require_card
+
+__version__ = "0.1.0"
+__author__ = "songxf"
+__license__ = "MIT"
+
+__all__ = [
+    "CardClient",
+    "require_card",
+]

xfcloudcard-0.1.0/xfcloudcard/client.py

@@ -0,0 +1,453 @@
+"""
+卡密验证客户端库
+支持作为库导入使用，也支持命令行运行。
+
+作为库使用：
+    from client import CardClient
+
+    with CardClient(server_url="http://...", key="...") as client:
+        result = client.verify("CARD-XXXX-XXXX-XXXX-XXXX")
+        if result['success']:
+            # 业务代码
+            pass
+    # 退出 with 块时自动停止心跳并发送离线通知
+
+或使用装饰器：
+    from client import require_card
+
+    @require_card(server_url="http://...", key="...")
+    def main():
+        # 仅当卡密验证通过时才执行
+        pass
+
+    main()
+"""
+import sys
+import os
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+import json
+import time
+import signal
+import threading
+from typing import Optional, Callable, Any
+
+from crypto import CryptoManager
+from device_info import get_device_sn, get_ip_address
+
+
+# 默认配置（可通过环境变量或参数覆盖）
+DEFAULT_SERVER_URL = "http://localhost:8000"
+DEFAULT_KEY = "cloud-card-system-key-32bytes!!"
+
+
+class CardClient:
+    """
+    卡密验证客户端（支持上下文管理器）
+
+    用法:
+        with CardClient(server_url="http://...", key="...") as client:
+            result = client.verify("CARD-XXXX-...")
+            if result['success']:
+                # 业务代码
+                pass
+    """
+
+    def __init__(
+        self,
+        server_url: str = None,
+        key: str = None,
+        heartbeat_interval: int = 60,
+    ):
+        """
+        Args:
+            server_url: 服务器URL，默认 http://localhost:8000
+            key:        加密密钥（必须与服务器端相同，32字节或任意长度）
+            heartbeat_interval: 心跳间隔秒数（默认60秒）
+        """
+        self.server_url = (server_url or DEFAULT_SERVER_URL).rstrip('/')
+        raw_key = (key or DEFAULT_KEY).encode('utf-8')
+        self.crypto = CryptoManager(raw_key)
+        self.device_sn = get_device_sn()
+        self.ip_address = get_ip_address()
+        self.heartbeat_interval = heartbeat_interval
+
+        self._heartbeat_running = False
+        self._heartbeat_thread: Optional[threading.Thread] = None
+        self._current_card_key: Optional[str] = None
+        self._lock = threading.Lock()
+
+    # ─────────────────────────────────────────────
+    # 上下文管理器
+    # ─────────────────────────────────────────────
+    def __enter__(self):
+        return self
+
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        self.close()
+        return False
+
+    # ─────────────────────────────────────────────
+    # 公开 API
+    # ─────────────────────────────────────────────
+
+    def verify(self, card_key: str) -> dict:
+        """
+        验证卡密。
+        验证成功时自动启动心跳线程；验证失败或卡密不变时复用已有心跳。
+
+        Returns:
+            dict: {
+                'success': bool,
+                'message': str,
+                'remaining_seconds': int,
+                'rate_limited': bool,   # 是否因频率限制被拒
+            }
+        """
+        result = self._send_verify_request(card_key)
+
+        if result.get('success') and not result.get('rate_limited'):
+            with self._lock:
+                self._current_card_key = card_key
+                self._start_heartbeat_unsafe()
+
+        return result
+
+    def verify_only(self, card_key: str) -> dict:
+        """
+        只验证卡密，不启动心跳（适用于一次性检查场景）。
+
+        Returns:
+            同 verify()
+        """
+        return self._send_verify_request(card_key)
+
+    def close(self):
+        """停止心跳并发送离线通知。可重复调用。"""
+        self._stop_heartbeat()
+        self._send_offline()
+        self._current_card_key = None
+
+    def is_online(self) -> bool:
+        """当前是否有活跃心跳"""
+        return self._heartbeat_running
+
+    # ─────────────────────────────────────────────
+    # 内部方法
+    # ─────────────────────────────────────────────
+
+    def _send_verify_request(self, card_key: str) -> dict:
+        """构造、加密、发送验证请求，返回解析后的结果字典。"""
+        import requests
+
+        request_data = {
+            'card_key': card_key,
+            'device_sn': self.device_sn,
+            'ip_address': self.ip_address,
+            'timestamp': int(time.time()),
+        }
+
+        try:
+            payload = self._encrypt_and_sign(request_data)
+        except Exception as e:
+            return _err(f"加密失败: {e}")
+
+        try:
+            response = requests.post(
+                f"{self.server_url}/api/card/verify",
+                json=payload,
+                timeout=10,
+            )
+            if response.status_code != 200:
+                return _err(f"服务器错误: {response.status_code}")
+        except requests.exceptions.RequestException as e:
+            return _err(f"网络错误: {e}")
+
+        result = self._decrypt_response(response.json())
+        return result
+
+    def _start_heartbeat_unsafe(self):
+        """调用前需持有 self._lock"""
+        if self._heartbeat_running:
+            return
+        self._heartbeat_running = True
+        self._heartbeat_thread = threading.Thread(
+            target=self._heartbeat_loop, daemon=True
+        )
+        self._heartbeat_thread.start()
+
+    def _stop_heartbeat(self):
+        with self._lock:
+            if not self._heartbeat_running:
+                return
+            self._heartbeat_running = False
+        if self._heartbeat_thread:
+            self._heartbeat_thread.join(timeout=2)
+
+    def _heartbeat_loop(self):
+        import requests
+
+        while self._heartbeat_running and self._current_card_key:
+            try:
+                request_data = {
+                    'device_sn': self.device_sn,
+                    'ip_address': self.ip_address,
+                    'card_key': self._current_card_key,
+                    'timestamp': int(time.time()),
+                }
+                payload = self._encrypt_and_sign(request_data)
+
+                resp = requests.post(
+                    f"{self.server_url}/api/client/heartbeat",
+                    json=payload,
+                    timeout=5,
+                )
+                if resp.status_code != 200:
+                    print(f"[心跳] 发送失败: {resp.status_code}")
+            except Exception as e:
+                print(f"[心跳] 发送失败: {e}")
+
+            # 可中断的休眠
+            for _ in range(self.heartbeat_interval):
+                if not self._heartbeat_running:
+                    break
+                time.sleep(1)
+
+    def _send_offline(self):
+        if not self._current_card_key:
+            return
+        import requests
+
+        try:
+            request_data = {
+                'device_sn': self.device_sn,
+                'timestamp': int(time.time()),
+            }
+            payload = self._encrypt_and_sign(request_data)
+
+            resp = requests.post(
+                f"{self.server_url}/api/client/offline",
+                json=payload,
+                timeout=5,
+            )
+            if resp.status_code == 200:
+                print("[离线] 已通知服务器")
+            else:
+                print(f"[离线] 通知失败: {resp.status_code}")
+        except Exception as e:
+            print(f"[离线] 发送失败: {e}")
+
+    # ─────────────────────────────────────────────
+    # 加密 / 解密辅助
+    # ─────────────────────────────────────────────
+
+    def _encrypt_and_sign(self, data: dict) -> dict:
+        plaintext = json.dumps(data)
+        encrypted = self.crypto.encrypt(plaintext)
+        data_to_sign = encrypted['ciphertext'] + encrypted['iv']
+        signature = self.crypto.generate_hmac(data_to_sign)
+        return {
+            'ciphertext': encrypted['ciphertext'],
+            'iv': encrypted['iv'],
+            'signature': signature,
+        }
+
+    def _decrypt_response(self, response_data: dict) -> dict:
+        try:
+            to_verify = response_data['ciphertext'] + response_data['iv']
+            if not self.crypto.verify_hmac(to_verify, response_data['signature']):
+                return _err("响应签名验证失败")
+
+            decrypted = self.crypto.decrypt(
+                response_data['ciphertext'],
+                response_data['iv'],
+            )
+            return json.loads(decrypted)
+        except Exception as e:
+            return _err(f"解析响应失败: {e}")
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# 装饰器：@require_card(...)
+# ─────────────────────────────────────────────────────────────────────────────
+
+def require_card(
+    server_url: str = None,
+    key: str = None,
+    heartbeat_interval: int = 60,
+    exit_on_fail: bool = True,
+):
+    """
+    装饰器：在业务函数执行前自动验证卡密。
+    验证成功时自动管理心跳和离线通知。
+
+    用法:
+        @require_card(server_url="http://...", key="...")
+        def main():
+            # 仅当验证通过时才执行
+            pass()
+
+    参数:
+        exit_on_fail: 验证失败时是否直接退出进程（默认 True）
+    """
+    def decorator(func: Callable) -> Callable:
+        def wrapper(*args, **kwargs):
+            with CardClient(
+                server_url=server_url,
+                key=key,
+                heartbeat_interval=heartbeat_interval,
+            ) as client:
+                card_key = _prompt_or_env_card_key()
+                if not card_key:
+                    print("未提供卡密，退出。")
+                    if exit_on_fail:
+                        sys.exit(1)
+                    return None
+
+                result = client.verify(card_key)
+                _print_result(result)
+
+                if not result.get('success'):
+                    if exit_on_fail:
+                        sys.exit(1)
+                    return None
+
+                return func(*args, **kwargs)
+        return wrapper
+    return decorator
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# CLI 辅助函数（供 python client.py 使用）
+# ─────────────────────────────────────────────────────────────────────────────
+
+def _prompt_or_env_card_key() -> Optional[str]:
+    """优先从环境变量 CARD_KEY 读取，否则交互式输入"""
+    import os
+    key = os.environ.get("CARD_KEY")
+    if key:
+        return key.strip()
+    try:
+        return input("请输入卡密: ").strip() or None
+    except (EOFError, KeyboardInterrupt):
+        return None
+
+
+def _print_result(result: dict):
+    remaining = result.get('remaining_seconds', 0)
+    if result['success']:
+        print(f"✅ 验证成功: {result['message']}")
+        print(f"   剩余时间: {_format_time(remaining)}")
+    else:
+        print(f"❌ 验证失败: {result['message']}")
+
+
+def _format_time(seconds: int) -> str:
+    if seconds <= 0:
+        return "已过期"
+    d, h = divmod(seconds, 86400)
+    h, m = divmod(h, 3600)
+    m, s = divmod(m, 60)
+    parts = []
+    if d:
+        parts.append(f"{d}天")
+    if h:
+        parts.append(f"{h}小时")
+    if m:
+        parts.append(f"{m}分钟")
+    if s or not parts:
+        parts.append(f"{s}秒")
+    return "".join(parts)
+
+
+def _err(msg: str) -> dict:
+    return {'success': False, 'message': msg, 'remaining_seconds': 0}
+
+
+# ─────────────────────────────────────────────────────────────────────────────
+# CLI 入口（python client.py ...）
+# ─────────────────────────────────────────────────────────────────────────────
+
+def _cli_main():
+    import argparse
+
+    parser = argparse.ArgumentParser(description='卡密验证客户端')
+    parser.add_argument('--server', default=DEFAULT_SERVER_URL, help='服务器URL')
+    parser.add_argument('--key', default=DEFAULT_KEY, help='加密密钥')
+    parser.add_argument('--card', help='卡密（直接验证模式）')
+    parser.add_argument('--once', action='store_true', help='只验证一次，不启动心跳')
+    parser.add_argument('--interactive', action='store_true', help='交互模式')
+    parser.add_argument('--heartbeat', type=int, default=60, help='心跳间隔秒数')
+    args = parser.parse_args()
+
+    client = CardClient(
+        server_url=args.server,
+        key=args.key,
+        heartbeat_interval=args.heartbeat,
+    )
+
+    # 信号处理：Ctrl+C 时优雅退出
+    def _cleanup(signum=None, frame=None):
+        print("\n正在退出...")
+        client.close()
+        print("感谢使用，再见！")
+        sys.exit(0)
+
+    try:
+        signal.signal(signal.SIGINT, _cleanup)
+        signal.signal(signal.SIGTERM, _cleanup)
+    except ValueError:
+        pass  # 非主线程中无法设置 signal
+
+    print("=" * 60)
+    print(f"设备序列号: {client.device_sn}")
+    print(f"IP地址: {client.ip_address}")
+    print("=" * 60)
+
+    if args.card:
+        result = client.verify_only(args.card) if args.once else client.verify(args.card)
+        _print_result(result)
+        if result.get('success') and not args.once:
+            print(f"\n💓 心跳已启动（间隔 {args.heartbeat} 秒），按 Ctrl+C 退出...")
+            _wait_forever()
+        return
+
+    if args.once:
+        card_key = _prompt_or_env_card_key()
+        if not card_key:
+            return
+        result = client.verify_only(card_key)
+        _print_result(result)
+        return
+
+    # 交互模式（默认）
+    print("交互模式（输入 'quit' 退出）\n")
+    while True:
+        try:
+            card_key = input("请输入卡密: ").strip()
+            if card_key.lower() == 'quit':
+                _cleanup()
+            if not card_key:
+                print("卡密不能为空！")
+                continue
+            result = client.verify(card_key)
+            _print_result(result)
+            if result.get('success'):
+                print(f"\n💓 心跳已启动，按 Ctrl+C 退出...")
+                _wait_forever()
+        except KeyboardInterrupt:
+            _cleanup()
+        except Exception as e:
+            print(f"错误: {e}")
+
+
+def _wait_forever():
+    try:
+        while True:
+            time.sleep(1)
+    except KeyboardInterrupt:
+        pass
+
+
+if __name__ == "__main__":
+    _cli_main()

xfcloudcard-0.1.0/xfcloudcard/crypto.py

@@ -0,0 +1,104 @@
+"""
+客户端加密解密模块
+使用AES-256-CBC加密和HMAC SHA256签名
+密钥派生：从主密钥派生独立的加密密钥和HMAC密钥（与服务端保持一致）
+"""
+import base64
+import hashlib
+import hmac
+from Crypto.Cipher import AES
+from Crypto.Util.Padding import pad, unpad
+
+
+class CryptoManager:
+    """加密管理器（客户端版本）"""
+
+    def __init__(self, key: bytes):
+        """
+        初始化加密管理器，从主密钥派生独立密钥
+
+        Args:
+            key: 主密钥（必须与服务器端相同，任意长度）
+        """
+        # 主密钥归一化为32字节
+        if len(key) != 32:
+            key = hashlib.sha256(key).digest()
+        # 派生独立密钥：加密密钥 和 HMAC密钥（与服务端一致）
+        self.enc_key = hashlib.sha256(key + b"enc").digest()
+        self.hmac_key = hashlib.sha256(key + b"hmac").digest()
+
+    def encrypt(self, data: str) -> dict:
+        """
+        加密数据
+
+        Args:
+            data: 要加密的字符串数据
+
+        Returns:
+            包含加密数据和IV的字典
+        """
+        from Crypto.Random import get_random_bytes
+
+        # 生成随机IV (16字节)
+        iv = get_random_bytes(16)
+
+        # 创建AES加密器
+        cipher = AES.new(self.enc_key, AES.MODE_CBC, iv)
+
+        # 加密数据
+        ciphertext = cipher.encrypt(pad(data.encode('utf-8'), AES.block_size))
+
+        # 返回base64编码的密文和IV
+        return {
+            'ciphertext': base64.b64encode(ciphertext).decode('utf-8'),
+            'iv': base64.b64encode(iv).decode('utf-8')
+        }
+
+    def decrypt(self, ciphertext: str, iv: str) -> str:
+        """
+        解密数据
+
+        Args:
+            ciphertext: base64编码的密文
+            iv: base64编码的IV
+
+        Returns:
+            解密后的字符串
+        """
+        # 解码base64
+        ciphertext_bytes = base64.b64decode(ciphertext)
+        iv_bytes = base64.b64decode(iv)
+
+        # 创建AES解密器
+        cipher = AES.new(self.enc_key, AES.MODE_CBC, iv_bytes)
+
+        # 解密并去除填充
+        plaintext = unpad(cipher.decrypt(ciphertext_bytes), AES.block_size)
+
+        return plaintext.decode('utf-8')
+
+    def generate_hmac(self, data: str) -> str:
+        """
+        生成HMAC签名
+
+        Args:
+            data: 要签名的数据
+
+        Returns:
+            HMAC签名（十六进制字符串）
+        """
+        return hmac.new(self.hmac_key, data.encode('utf-8'), hashlib.sha256).hexdigest()
+
+    def verify_hmac(self, data: str, signature: str) -> bool:
+        """
+        验证HMAC签名
+
+        Args:
+            data: 原始数据
+            signature: HMAC签名
+
+        Returns:
+            签名是否有效
+        """
+        expected_signature = self.generate_hmac(data)
+        return hmac.compare_digest(expected_signature, signature)

xfcloudcard-0.1.0/xfcloudcard/device_info.py

@@ -0,0 +1,99 @@
+"""
+设备信息收集模块
+"""
+import socket
+import uuid
+import platform
+import hashlib
+
+
+def get_device_sn() -> str:
+    """
+    获取设备序列号
+    
+    Returns:
+        设备序列号（基于硬件信息生成的唯一标识）
+    """
+    # 尝试获取真实的硬件序列号
+    try:
+        # Windows
+        if platform.system() == "Windows":
+            import wmi
+            c = wmi.WMI()
+            for item in c.Win32_BIOS():
+                return item.SerialNumber.strip()
+        # Linux
+        elif platform.system() == "Linux":
+            try:
+                with open('/etc/machine-id', 'r') as f:
+                    return f.read().strip()
+            except:
+                try:
+                    with open('/var/lib/dbus/machine-id', 'r') as f:
+                        return f.read().strip()
+                except:
+                    pass
+        # macOS
+        elif platform.system() == "Darwin":
+            import subprocess
+            output = subprocess.check_output(['system_profiler', 'SPHardwareDataType'])
+            for line in output.decode('utf-8').split('\n'):
+                if 'Serial Number' in line:
+                    return line.split(':')[1].strip()
+    except:
+        pass
+    
+    # 如果无法获取真实序列号，则基于MAC地址和硬件信息生成一个
+    mac = uuid.getnode()
+    machine_info = f"{platform.node()}-{platform.machine()}-{platform.processor()}-{mac}"
+    device_sn = hashlib.sha256(machine_info.encode()).hexdigest()[:32]
+    
+    return device_sn
+
+
+def get_ip_address() -> str:
+    """
+    获取本机IP地址
+    
+    Returns:
+        本机IP地址
+    """
+    try:
+        # 创建一个UDP socket连接到外部地址（不会真正发送数据）
+        s = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
+        s.connect(("8.8.8.8", 80))
+        ip_address = s.getsockname()[0]
+        s.close()
+        return ip_address
+    except:
+        # 如果无法获取，返回回环地址
+        return "127.0.0.1"
+
+
+def get_device_info() -> dict:
+    """
+    获取设备完整信息
+    
+    Returns:
+        设备信息字典
+    """
+    return {
+        'device_sn': get_device_sn(),
+        'ip_address': get_ip_address(),
+        'hostname': platform.node(),
+        'platform': platform.system(),
+        'platform_release': platform.release(),
+        'platform_version': platform.version(),
+        'architecture': platform.machine(),
+        'processor': platform.processor()
+    }
+
+
+if __name__ == "__main__":
+    # 测试
+    print("设备序列号:", get_device_sn())
+    print("IP地址:", get_ip_address())
+    print("\n完整设备信息:")
+    info = get_device_info()
+    for key, value in info.items():
+        print(f"  {key}: {value}")

xfcloudcard-0.1.0/xfcloudcard.egg-info/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: xfcloudcard
+Version: 0.1.0
+Summary: 云控卡密验证客户端库 - 支持 AES+HMAC 加密通信、心跳保活、离线上报
+Author: songxf
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/songxf/xfcloudcard
+Project-URL: Source, https://github.com/songxf/xfcloudcard
+Project-URL: Issues, https://github.com/songxf/xfcloudcard/issues
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Topic :: Security :: Cryptography
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+Requires-Dist: requests>=2.25.0
+Requires-Dist: pycryptodome>=3.15.0
+
+# xfcloudcard
+
+云控卡密验证客户端库，支持 AES-256-CBC + HMAC-SHA256 加密通信、心跳保活、离线上报。
+
+## 安装
+
+```bash
+pip install xfcloudcard
+```
+
+## 快速开始
+
+### 方式一：上下文管理器（推荐）
+
+```python
+from xfcloudcard import CardClient
+
+with CardClient(server_url="http://localhost:8000", key="your-key") as client:
+    result = client.verify("CARD-XXXX-XXXX-XXXX-XXXX")
+    if result['success']:
+        # 业务代码写这里
+        pass
+# 退出 with 块时自动停止心跳 + 发送离线通知
+```
+
+### 方式二：装饰器（最简洁）
+
+```python
+from xfcloudcard import require_card
+
+@require_card(server_url="http://localhost:8000", key="your-key")
+def main():
+    # 仅当卡密验证通过后才执行
+    print("验证通过，执行业务逻辑...")
+
+main()
+```
+
+### 方式三：命令行
+
+```bash
+# 交互模式
+xfcloudcard
+
+# 直接验证
+xfcloudcard --card CARD-XXXX-XXXX-XXXX-XXXX
+
+# 只验证，不启动心跳
+xfcloudcard --card CARD-XXXX-... --once
+```
+
+## API
+
+### `CardClient(server_url, key, heartbeat_interval=60)`
+
+| 方法 | 说明 |
+|------|------|
+| `verify(card_key)` | 验证卡密，成功后自动启动心跳 |
+| `verify_only(card_key)` | 只验证，不启动心跳 |
+| `close()` | 停止心跳并发送离线通知 |
+| `is_online()` | 返回心跳是否运行中 |
+
+### `require_card(server_url, key, heartbeat_interval=60, exit_on_fail=True)`
+
+装饰器，在业务函数执行前自动验证卡密。
+
+## 依赖
+
+- `requests >= 2.25.0`
+- `pycryptodome >= 3.15.0`
+
+## 协议
+
+MIT

xfcloudcard-0.1.0/xfcloudcard.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+README.md
+pyproject.toml
+xfcloudcard/__init__.py
+xfcloudcard/client.py
+xfcloudcard/crypto.py
+xfcloudcard/device_info.py
+xfcloudcard.egg-info/PKG-INFO
+xfcloudcard.egg-info/SOURCES.txt
+xfcloudcard.egg-info/dependency_links.txt
+xfcloudcard.egg-info/requires.txt
+xfcloudcard.egg-info/top_level.txt

xfcloudcard-0.1.0/xfcloudcard.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

xfcloudcard-0.1.0/xfcloudcard.egg-info/requires.txt

@@ -0,0 +1,2 @@
+requests>=2.25.0
+pycryptodome>=3.15.0

xfcloudcard-0.1.0/xfcloudcard.egg-info/top_level.txt

@@ -0,0 +1 @@
+xfcloudcard