nfcscript 0.0.15__tar.gz → 0.0.17__tar.gz

{nfcscript-0.0.15 → nfcscript-0.0.17}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: nfcscript
-Version: 0.0.15
+Version: 0.0.17
 Summary: A plugin-based core engine for DSL-style NFC testing automation.
 Author: crthu
 Requires-Python: >=3.14
@@ -36,13 +36,13 @@ nfcscript test_card.py -p COM21
 nfcscript test_card.py -r acr122u
 
 # 开启追踪层
-nfcscript test_card.py --trace=protocol,debug
+nfcscript test_card.py --trace-layer=protocol,debug
 
 # 设置日志级别
-nfcscript test_card.py --level=trace
+nfcscript test_card.py --trace-level=driver
 
 # 组合使用
-nfcscript test_card.py -p COM21 -r pn532 --trace=protocol,debug --level=trace
+nfcscript test_card.py -p COM21 -r pn532 --trace-layer=protocol,debug --trace-level=driver
 ```
 
 ### nfc-cli - 交互式命令行
@@ -120,8 +120,8 @@ from nfc import *
 connect()
 
 # 开启追踪
-trace.driver = True
-trace.protocol = True
+trace.filter.driver = True
+trace.filter.protocol = True
 
 # 寻卡（自动切换协议解析器）
 card_info = active()
@@ -195,11 +195,11 @@ with session() as reader:
 
 | 属性 | 说明 |
 |------|------|
-| `trace.driver = True` | 启用 driver 层 |
-| `trace.protocol = True` | 启用 protocol 层 |
-| `trace.debug = False` | 禁用 debug 层 |
-| `trace.level = "warning"` | 设置最低日志级别 |
-| `trace.level = 30` | 或用数字 |
+| `trace.filter.driver = True` | 启用 driver 层 |
+| `trace.filter.protocol = True` | 启用 protocol 层 |
+| `trace.filter.debug = False` | 禁用 debug 层 |
+| `trace.filter.level = "warning"` | 设置最低日志级别 |
+| `trace.filter.level = 30` | 或用数字 |
 
 ```python
 # 简洁写法
@@ -207,9 +207,9 @@ trace.app("UID: AA BB CC DD")
 trace.debug("[auth] Rt: 80 81")
 
 # 属性控制
-trace.driver = True
-trace.protocol = True
-trace.level = "debug"
+trace.filter.driver = True
+trace.filter.protocol = True
+trace.filter.level = "debug"
 ```
 
 ### assertions.py
@@ -257,7 +257,7 @@ trace.level = "debug"
 |------|------|--------|
 | `NFC_PORT` | 串口号 | - |
 | `NFC_READER` | 读卡器类型 | - |
-| `NFC_TRACE` | 启用的层 (逗号分隔) | - |
+| `NFC_TRACE_LAYER` | 启用的层 (逗号分隔) | - |
 | `NFC_TRACE_LEVEL` | 最低日志级别 | `warning` |
 | `NFC_CARD_PATH` | 外部卡片模块搜索路径 (分号分隔) | - |
 
@@ -273,8 +273,8 @@ trace.level = "debug"
 ```
 NFC_PORT=COM20
 NFC_READER=pn532
-NFC_TRACE_LEVEL=warning
-NFC_TRACE=protocol,debug
+NFC_TRACE_LAYER=protocol,warning,error,app
+NFC_TRACE_LEVEL=protocol
 ```
 
 ## AI 编写脚本

{nfcscript-0.0.15 → nfcscript-0.0.17}/README.md

@@ -26,13 +26,13 @@ nfcscript test_card.py -p COM21
 nfcscript test_card.py -r acr122u
 
 # 开启追踪层
-nfcscript test_card.py --trace=protocol,debug
+nfcscript test_card.py --trace-layer=protocol,debug
 
 # 设置日志级别
-nfcscript test_card.py --level=trace
+nfcscript test_card.py --trace-level=driver
 
 # 组合使用
-nfcscript test_card.py -p COM21 -r pn532 --trace=protocol,debug --level=trace
+nfcscript test_card.py -p COM21 -r pn532 --trace-layer=protocol,debug --trace-level=driver
 ```
 
 ### nfc-cli - 交互式命令行
@@ -110,8 +110,8 @@ from nfc import *
 connect()
 
 # 开启追踪
-trace.driver = True
-trace.protocol = True
+trace.filter.driver = True
+trace.filter.protocol = True
 
 # 寻卡（自动切换协议解析器）
 card_info = active()
@@ -185,11 +185,11 @@ with session() as reader:
 
 | 属性 | 说明 |
 |------|------|
-| `trace.driver = True` | 启用 driver 层 |
-| `trace.protocol = True` | 启用 protocol 层 |
-| `trace.debug = False` | 禁用 debug 层 |
-| `trace.level = "warning"` | 设置最低日志级别 |
-| `trace.level = 30` | 或用数字 |
+| `trace.filter.driver = True` | 启用 driver 层 |
+| `trace.filter.protocol = True` | 启用 protocol 层 |
+| `trace.filter.debug = False` | 禁用 debug 层 |
+| `trace.filter.level = "warning"` | 设置最低日志级别 |
+| `trace.filter.level = 30` | 或用数字 |
 
 ```python
 # 简洁写法
@@ -197,9 +197,9 @@ trace.app("UID: AA BB CC DD")
 trace.debug("[auth] Rt: 80 81")
 
 # 属性控制
-trace.driver = True
-trace.protocol = True
-trace.level = "debug"
+trace.filter.driver = True
+trace.filter.protocol = True
+trace.filter.level = "debug"
 ```
 
 ### assertions.py
@@ -247,7 +247,7 @@ trace.level = "debug"
 |------|------|--------|
 | `NFC_PORT` | 串口号 | - |
 | `NFC_READER` | 读卡器类型 | - |
-| `NFC_TRACE` | 启用的层 (逗号分隔) | - |
+| `NFC_TRACE_LAYER` | 启用的层 (逗号分隔) | - |
 | `NFC_TRACE_LEVEL` | 最低日志级别 | `warning` |
 | `NFC_CARD_PATH` | 外部卡片模块搜索路径 (分号分隔) | - |
 
@@ -263,8 +263,8 @@ trace.level = "debug"
 ```
 NFC_PORT=COM20
 NFC_READER=pn532
-NFC_TRACE_LEVEL=warning
-NFC_TRACE=protocol,debug
+NFC_TRACE_LAYER=protocol,warning,error,app
+NFC_TRACE_LEVEL=protocol
 ```
 
 ## AI 编写脚本

{nfcscript-0.0.15 → nfcscript-0.0.17}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "nfcscript"
-version = "0.0.15"
+version = "0.0.17"
 description = "A plugin-based core engine for DSL-style NFC testing automation."
 readme = "README.md"
 requires-python = ">=3.14"
@@ -24,9 +24,6 @@ testpaths = ["tests"]
 [tool.uv]
 package = true
 
-[tool.uv.sources]
-nfctester = { workspace = true }
-
 [dependency-groups]
 dev = [
     "pytest",
@@ -34,7 +31,7 @@ dev = [
 ]
 
 [tool.bumpversion]
-current_version = "0.0.15"
+current_version = "0.0.17"
 commit = true
 tag = true
 allow_dirty = true

{nfcscript-0.0.15 → nfcscript-0.0.17}/src/nfc/cli.py

@@ -41,8 +41,8 @@ def main():
     parser.add_argument("script", help="脚本文件路径")
     parser.add_argument("-p", "--port", default=None, help="串口号 (默认: NFC_PORT 环境变量或 COM20)")
     parser.add_argument("-r", "--reader", default=None, help="读卡器类型 (默认: NFC_READER 环境变量或 pn532)")
-    parser.add_argument("--trace", default=None, help="启用的层 (逗号分隔: driver,debug,protocol,warning,error,app,all)")
-    parser.add_argument("--level", default=None, help="最低日志级别 (trace/debug/warning/error/app, 默认: warning)")
+    parser.add_argument("--trace-layer", default=None, help="启用的层 (逗号分隔: driver,debug,protocol,warning,error,app,all)")
+    parser.add_argument("--trace-level", default=None, help="最低日志级别 (driver/debug/protocol/warning/error/app, 默认: warning)")
 
     args, extra = parser.parse_known_args()
 
@@ -64,23 +64,23 @@ def main():
 
     from nfc import trace
 
-    # 解析 --trace: 启用指定层
-    trace_env = os.environ.get("NFC_TRACE", "")
-    trace_arg = args.trace or trace_env
+    # 解析 --trace-layer: 启用指定层 (调试用，默认已开启 protocol/warning/error/app)
+    trace_env = os.environ.get("NFC_TRACE_LAYER", "")
+    trace_arg = args.trace_layer or trace_env
     if trace_arg:
-        trace.set_level("trace")  # 允许所有层可见
+        trace.filter.level = "driver"  # 允许所有层可见
         for name in trace_arg.split(","):
             name = name.strip().lower()
             if name == "all":
                 for layer in ["driver", "debug", "protocol", "warning", "error", "app"]:
-                    trace.set_layer(layer, True)
+                    setattr(trace.filter, layer, True)
             elif name:
-                trace.set_layer(name, True)
+                setattr(trace.filter, name, True)
 
-    # 解析 --level: 最低级别过滤
+    # 解析 --trace-level: 最低级别过滤
     level_env = os.environ.get("NFC_TRACE_LEVEL", "warning")
-    level_arg = args.level or level_env
-    trace.set_level(level_arg)
+    level_arg = args.trace_level or level_env
+    trace.filter.level = level_arg
 
     run_script(args.script)
 

{nfcscript-0.0.15 → nfcscript-0.0.17}/src/nfc/nfc_cli.py

@@ -172,13 +172,13 @@ def main():
         parser.error("需要指定卡片类型 (-c/--card) 或使用 --list-cards 查看可用类型")
 
     try:
-        connect(port=args.port, reader_type=args.reader)
+        reader.connect(port=args.port, reader_type=args.reader)
     except Exception as e:
         print(f"连接读卡器失败: {e}")
         sys.exit(1)
 
     try:
-        card = CardRegistry.create(args.card, reader=get_reader())
+        card = CardRegistry.create(args.card, reader=reader.target)
         methods = _get_methods(card)
 
         print(f"已连接卡片: {args.card}")
@@ -220,7 +220,7 @@ def main():
                 print(f"错误: {e}")
 
     finally:
-        close()
+        reader.close()
         print("已断开连接")
 
 

{nfcscript-0.0.15 → nfcscript-0.0.17}/src/nfc/reader.py

@@ -1,5 +1,10 @@
+import atexit
 import os
+import sys
 from contextlib import contextmanager
+from typing import Any
+
+from dotenv import load_dotenv
 from nfctester.drivers.card_reader import CardInfo, TransceiveBits
 from nfctester.registry import CardReaderRegistry
 from nfctester.trace import trace as _trace
@@ -7,44 +12,104 @@ from .assertions import ASSERT_EQUAL, ASSERT_IS_NOT_NONE, ASSERT_LEN
 from .checksum import GET_BCC
 from .hex_util import FORMAT_HEX
 
+_DOTENV_LOADED = False
+
+
+def _find_dotenv_all(start_dir: str) -> list[str]:
+    """从起始目录逐级向上搜索所有 .env 文件"""
+    chain = []
+    path = start_dir
+    while True:
+        env_path = os.path.join(path, ".env")
+        if os.path.exists(env_path):
+            chain.append(env_path)
+        parent = os.path.dirname(path)
+        if parent == path:
+            break
+        path = parent
+    chain.reverse()
+    return chain
+
+
+def _load_env_configs() -> None:
+    """按需加载当前目录及上级目录的 .env 文件"""
+    global _DOTENV_LOADED
+    if not _DOTENV_LOADED:
+        try:
+            cwd = os.getcwd()
+            for env_path in _find_dotenv_all(cwd):
+                load_dotenv(env_path, override=False)
+        except Exception:
+            pass
+        _DOTENV_LOADED = True
+
+
+# ─── 轻量读卡器门面单例 ───────────────────────────────────────────────────
 
-class _NFCState:
-    """单例状态管理，封装读卡器生命周期"""
+class _ReaderFacade:
+    """
+    读卡器单例门面对象 (`reader`)。
+    
+    统一维护读卡器连接状态，提供 `reader.rf = True / False` 属性控制，
+    并将所有属性与方法调用优先路由到当前模块顶层函数，或透传到底层 CardReader 实例。
+    """
+
+    def __init__(self) -> None:
+        self._target: Any = None
+        self._connected: bool = False
+
+    @property
+    def rf(self) -> bool:
+        """获取射频场状态。"""
+        return getattr(get_reader(), "rf_field", False)
+
+    @rf.setter
+    def rf(self, value: bool) -> None:
+        """设置射频场开关 (True / False)。"""
+        get_reader().rf_field = bool(value)
 
-    _instance = None
+    @property
+    def rf_field(self) -> bool:
+        """获取射频场状态 (rf 别名)。"""
+        return self.rf
 
-    def __new__(cls):
-        if cls._instance is None:
-            cls._instance = super().__new__(cls)
-            cls._instance._reader = None
-            cls._instance._connected = False
-        return cls._instance
+    @rf_field.setter
+    def rf_field(self, value: bool) -> None:
+        """设置射频场开关 (rf 别名)。"""
+        self.rf = value
 
     @property
-    def reader(self):
-        return self._reader
+    def mf_crypto(self) -> bool:
+        """获取 Mifare 硬件加密状态。"""
+        return getattr(get_reader(), "mf_crypto", False)
 
-    def connect(self, port: str = "COM20", reader_type: str = "pn532"):
-        self._reader = CardReaderRegistry.create(reader_type, transport="serial", port=port)
-        self._reader.open()
-        self._connected = True
-        _trace.log(f"Connected to {reader_type.upper()} on port {port}", layer="app")
+    @property
+    def target(self) -> Any:
+        """获取当前连接的底层 CardReader 实例。"""
+        return get_reader()
 
-    def disconnect(self):
-        if self._connected and self._reader:
-            self._reader.close()
-            self._connected = False
-            self._reader = None
-            _trace.log("Disconnected", layer="app")
+    def __getattr__(self, name: str) -> Any:
+        # 1. 优先路由到当前模块的顶层函数（如 reader.active -> active）
+        mod = sys.modules[__name__]
+        if hasattr(mod, name) and not name.startswith("_"):
+            return getattr(mod, name)
+        # 2. 其次透传给底层 CardReader 驱动实例（如 reader.mf_auth -> _target.mf_auth）
+        return getattr(self.target, name)
 
-    def ensure_connected(self):
-        ASSERT_IS_NOT_NONE(self._reader, msg="NFC driver not connected. Call connect() first.")
+    def __enter__(self):
+        get_reader()
+        return self
 
+    def __exit__(self, exc_type, exc_val, exc_tb):
+        pass
 
-_state = _NFCState()
 
+reader = _ReaderFacade()
 
-def connect(port: str = None, reader_type: str = None):
+
+# ─── 模块级顶层函数（单一事实来源） ──────────────────────────────────────────
+
+def connect(port: str = None, reader_type: str = None) -> None:
     """
     连接并初始化读卡器。
 
@@ -55,6 +120,7 @@ def connect(port: str = None, reader_type: str = None):
     Raises:
         ValueError: 未提供 port 或 reader_type 且环境变量未设置。
     """
+    _load_env_configs()
     if port is None:
         port = os.environ.get("NFC_PORT")
     if reader_type is None:
@@ -63,18 +129,53 @@ def connect(port: str = None, reader_type: str = None):
         raise ValueError("未指定串口，请通过 -p 参数、connect(port=...) 或 NFC_PORT 环境变量配置")
     if reader_type is None:
         raise ValueError("未指定读卡器类型，请通过 -r 参数、connect(reader_type=...) 或 NFC_READER 环境变量配置")
-    _state.connect(port, reader_type)
+
+    if reader._connected and reader._target is not None:
+        disconnect()
+
+    reader._target = CardReaderRegistry.create(reader_type, transport="serial", port=port)
+    reader._target.open()
+    reader._connected = True
+    _trace.log(f"Connected to {reader_type.upper()} on port {port}", layer="app")
+
+
+def disconnect() -> None:
+    """断开与读卡器的连接并释放资源。"""
+    if reader._connected and reader._target is not None:
+        try:
+            reader._target.rf_field = False
+        except Exception:
+            pass
+        try:
+            reader._target.close()
+        except Exception:
+            pass
+        reader._connected = False
+        reader._target = None
+        _trace.log("Disconnected", layer="app")
+
+
+def close() -> None:
+    """断开与读卡器的连接 (disconnect 别名)。"""
+    disconnect()
 
 
-def get_reader():
+def get_reader() -> Any:
     """
-    获取当前连接的读卡器实例，供 Card 类使用。
+    获取当前连接的读卡器实例，若未连接则尝试从环境变量自动连接。
 
     Returns:
         reader: 当前连接的读卡器实例。
     """
-    _state.ensure_connected()
-    return _state.reader
+    if not reader._connected or reader._target is None:
+        _load_env_configs()
+        port = os.environ.get("NFC_PORT")
+        reader_type = os.environ.get("NFC_READER")
+        if port and reader_type:
+            connect(port, reader_type)
+        else:
+            ASSERT_IS_NOT_NONE(reader._target, msg="NFC driver not connected. Call connect() first.")
+    return reader._target
 
 
 def active(low_layer: bool = False, ignore_error: bool = False, reqa_cmd: int = 0x26) -> CardInfo | None:
@@ -94,11 +195,10 @@ def active(low_layer: bool = False, ignore_error: bool = False, reqa_cmd: int =
               - 'atq' (list[int]): 卡片的 ATQ (Answer To Request)。
               - 'sak' (int):   卡片的 SAK (Select Acknowledge)。
     """
-    _state.ensure_connected()
-    reader = _state.reader
+    rdr = get_reader()
 
     if not low_layer:
-        return reader.active()
+        return rdr.active()
 
     # 手动底层寻卡流程
     # 1. REQA
@@ -109,6 +209,7 @@ def active(low_layer: bool = False, ignore_error: bool = False, reqa_cmd: int =
 
     # 2. 抗冲突与选择
     full_uid = []
+    sak = 0
     for cl in [1, 2, 3]:
         res = anticoll(cl_level=cl, nvb=0x20)
         if not res.data:
@@ -153,30 +254,35 @@ def active(low_layer: bool = False, ignore_error: bool = False, reqa_cmd: int =
     return info
 
 
-def transceive(data: list[int], tx_crc: bool = True, rx_crc: bool = True) -> list[int]:
+def transceive(data: list[int] | bytes, tx_crc: bool = True, rx_crc: bool = True) -> list[int]:
     """
     使用底层帧交互方式发送数据。
 
     Args:
-        data: 要发送的字节列表。
+        data: 要发送的字节列表或 bytes。
         tx_crc: 发送时是否自动添加 CRC。False 则原样发送。
         rx_crc: 接收时是否自动校验 CRC。False 则原样接收不校验。
 
     Returns:
         list[int]: 接收到的数据字节列表。
     """
-    _state.ensure_connected()
-    reader = _state.reader
-    res = reader.transceive(data, tx_crc=tx_crc, rx_crc=rx_crc)
+    rdr = get_reader()
+    raw_list = list(data) if isinstance(data, (bytes, bytearray)) else data
+    res = rdr.transceive(raw_list, tx_crc=tx_crc, rx_crc=rx_crc)
     return res.data if res and res.data else []
 
 
-def transceive_bits(data: list[int], last_tx_bits: int = 0, tx_crc: bool = True, rx_crc: bool = True) -> TransceiveBits:
+def transceive_bits(
+    data: list[int] | bytes,
+    last_tx_bits: int = 0,
+    tx_crc: bool = True,
+    rx_crc: bool = True,
+) -> TransceiveBits:
     """
     使用底层帧交互方式发送数据，并支持对最后一个字节进行位控制。
 
     Args:
-        data: 要发送的字节列表。
+        data: 要发送的字节列表或 bytes。
         last_tx_bits: 最后一个字节实际发送的有效位数 (1-7)，0 表示发送完整字节。
         tx_crc: 发送时是否自动添加 CRC。False 则原样发送。
         rx_crc: 接收时是否自动校验 CRC。False 则原样接收不校验。
@@ -184,9 +290,9 @@ def transceive_bits(data: list[int], last_tx_bits: int = 0, tx_crc: bool = True,
     Returns:
         TransceiveBits: 包含 data 和 bits 属性，失败返回空的 TransceiveBits(data=[], bits=0)。
     """
-    _state.ensure_connected()
-    reader = _state.reader
-    res = reader.transceive(data, last_tx_bits=last_tx_bits, tx_crc=tx_crc, rx_crc=rx_crc)
+    rdr = get_reader()
+    raw_list = list(data) if isinstance(data, (bytes, bytearray)) else data
+    res = rdr.transceive(raw_list, last_tx_bits=last_tx_bits, tx_crc=tx_crc, rx_crc=rx_crc)
     return res if res else TransceiveBits(data=[], bits=0)
 
 
@@ -273,33 +379,24 @@ def select(cl_level: int, uid: list[int]) -> list[int]:
     return transceive(cmd, tx_crc=True, rx_crc=True)
 
 
-def field_on():
+def field_on() -> None:
     """
-    开启 PN532 的 RF 场。
+    开启读卡器的 RF 场。
 
     Raises:
         AssertionError: 未连接读卡器时抛出。
     """
-    _state.ensure_connected()
-    _state.reader.rf_field = True
+    get_reader().rf_field = True
 
 
-def field_off():
+def field_off() -> None:
     """
-    关闭 PN532 的 RF 场。
+    关闭读卡器的 RF 场。
 
     Raises:
         AssertionError: 未连接读卡器时抛出。
     """
-    _state.ensure_connected()
-    _state.reader.rf_field = False
-
-
-def close():
-    """
-    断开与 PN532 读卡器的连接。
-    """
-    _state.disconnect()
+    get_reader().rf_field = False
 
 
 @contextmanager
@@ -308,8 +405,8 @@ def session(port: str = None, reader_type: str = None):
     上下文管理器，自动管理连接生命周期。
 
     用法:
-        with session("COM20") as reader:
-            card_info = reader.active()
+        with session("COM20") as r:
+            card_info = r.active()
     """
     if port is None:
         port = os.environ.get("NFC_PORT")
@@ -319,8 +416,44 @@ def session(port: str = None, reader_type: str = None):
         raise ValueError("未指定串口，请通过 session(port=...) 或 NFC_PORT 环境变量配置")
     if reader_type is None:
         raise ValueError("未指定读卡器类型，请通过 session(reader_type=...) 或 NFC_READER 环境变量配置")
-    _state.connect(port, reader_type)
+    connect(port, reader_type)
     try:
-        yield _state.reader
+        yield reader
     finally:
-        _state.disconnect()
+        disconnect()
+
+
+def _atexit_cleanup() -> None:
+    """进程退出时的 atexit 安全清理钩子：先关闭物理 RF 场，再关闭串口。"""
+    if reader._connected and reader._target is not None:
+        try:
+            reader._target.rf_field = False
+        except Exception:
+            pass
+        try:
+            reader._target.close()
+        except Exception:
+            pass
+
+
+atexit.register(_atexit_cleanup)
+
+
+__all__ = [
+    "reader",
+    "connect",
+    "disconnect",
+    "get_reader",
+    "active",
+    "transceive",
+    "transceive_bits",
+    "reqa",
+    "wupa",
+    "halt",
+    "anticoll",
+    "select",
+    "field_on",
+    "field_off",
+    "close",
+    "session",
+]

{nfcscript-0.0.15 → nfcscript-0.0.17}/src/nfc/trace.py

@@ -4,9 +4,7 @@ NFC Script Trace 模块
 统一日志 API，包装 nfctester.trace 的 6 层日志系统。
 层: driver, debug, protocol, warning, error, app
 
-支持两种控制方式：
-1. 属性控制: trace.driver = True, trace.level = "warning"
-2. 方法控制: trace.set_layer("driver", True), trace.set_level("warning")
+过滤器控制: trace.filter.driver = True, trace.filter.level = "warning"
 """
 
 from typing import Callable
@@ -55,27 +53,6 @@ def __getattr__(name):
     return getattr(_trace, name)
 
 
-def set_layer(layer: str, enable: bool = True):
-    """
-    开启或关闭追踪层。
-
-    Args:
-        layer: 层级名称 ("driver", "debug", "protocol", "warning", "error", "app")
-        enable: True 开启，False 关闭
-    """
-    _trace.set_layer(layer, enable)
-
-
-def set_level(level: str):
-    """
-    设置最低日志级别。
-
-    Args:
-        level: 级别名称 ("trace", "debug", "warning", "error", "app")
-    """
-    _trace.set_level(level)
-
-
 def set_parse(level: int = 1):
     """
     设置解析级别。