AgentSkillsCN

netninja-qt-compat

实现并维护NET-NiNJA的Qt兼容性逻辑：根据CPU特性（SSE4.1/4.2）自动选择PyQt6或PyQt5，同时支持并遵守--gui=auto|qt6|qt5参数，避免在旧款CPU上因过早引入PyQt6而导致程序崩溃。当涉及GUI启动、需求规格或硬件限制时，可使用此技能。

SKILL.md
--- frontmatter
name: netninja-qt-compat
description: Implement and maintain NET-NiNJA's Qt compatibility logic: auto-select PyQt6 vs PyQt5 based on CPU features (SSE4.1/4.2), add and honor --gui=auto|qt6|qt5, and prevent premature PyQt6 imports that crash on legacy CPUs. Use when touching GUI startup, requirements, or hardware gating.

Netninja Qt Compat

Goal

Select the correct GUI backend at runtime (auto/Qt6/Qt5), guard imports to avoid crashes, and keep requirements consistent with the selected backend.

Read First

  • •cpu_features.py for SSE4.1/4.2 detection
  • •main.py and netreaper_gui.py for startup flow
  • •netreaper_gui_legacy.py for legacy GUI entry
  • •launch_gui.bat, launch_gui.ps1 for CLI surfaces
  • •requirements.txt, requirements_legacy.txt, requirements_windows.txt

Workflow

  1. •Decide backend selection rules:
    • •--gui=qt6 forces Qt6.
    • •--gui=qt5 forces Qt5.
    • •--gui=auto uses cpu_features.py and forces Qt5 if SSE4.1 or SSE4.2 is missing.
  2. •Centralize selection logic in one function (e.g., select_gui_backend) that returns backend + reason.
  3. •Enforce import order: never import PyQt6 before the selection decision. Use conditional or local imports after selecting backend.
  4. •Log the decision clearly (backend + reason) before GUI startup.
  5. •Keep requirements aligned: Qt6 in modern requirements, Qt5 in legacy requirements. Ensure launcher docs reflect the CLI flag.
  6. •Add a simple diagnostic command or log line that shows the detected CPU features and selected backend.

Output Expectations

  • •Runtime decision is deterministic and logged.
  • •Legacy CPUs never attempt PyQt6 import.
  • •CLI flag override works on all launch surfaces.