NapCatQQ-Desktop 项目启动与配置教程

1. 项目的目录结构及介绍

NapCatQQ-Desktop 项目是一个为 NapCatQQ 提供管理界面（GUI）的开源项目。以下是项目的目录结构及各部分的功能介绍：

NapCatQQ-Desktop/
├── .github/                # GitHub 相关的配置文件
├── docs/                   # 文档目录
├── src/                    # 源代码目录
│   └── main.py             # 主程序文件
├── .gitignore              # Git 忽略文件
├── .gitmodules             # Git 子模块配置文件
├── LICENSE                 # 项目许可证文件
├── README.md               # 项目说明文件
├── main.spec               # PyInstaller 打包配置文件
├── main_debug.spec         # PyInstaller 调试打包配置文件
├── project.pro             # Qt Creator 项目文件
├── pyproject.toml          # 项目配置文件
├── requirements.txt        # 项目依赖文件
└── ...                     # 其他相关文件

2. 项目的启动文件介绍

项目的启动文件是 src/main.py，这是整个程序的主入口。以下是 main.py 的基本结构和功能：

import sys
from PySide6.QtWidgets import QApplication
from PySide6.QtCore import Qt
from PyQt5 import QtWidgets

# 导入自定义的窗口类
from NapCatDesktop import NapCatMainWindow

# 设置 DPI
QApplication.setAttribute(Qt.AA_EnableHighDpiScaling, True)
QApplication.setAttribute(Qt.AA_UseHighDpiPixmaps, True)

# 创建应用程序实例
app = QApplication(sys.argv)

# 创建主窗口实例
main_window = NapCatMainWindow()

# 展示主窗口
main_window.show()

# 运行应用程序
sys.exit(app.exec())

在 main.py 中，我们首先设置了 DPI 缩放，然后创建了一个应用程序实例，接着创建了一个主窗口实例并展示它，最后进入应用程序的主循环。

3. 项目的配置文件介绍

项目的配置文件主要包括 pyproject.toml 和 requirements.txt。

• pyproject.toml：这是一个项目配置文件，用于定义项目的元数据和依赖。例如：

[build-system]
requires = ["setuptools", "wheel"]
build-backend = "setuptools.build_meta"

[tool.setuptools]
packages = ["NapCatDesktop"]

• requirements.txt：这个文件列出了项目运行所需的 Python 包依赖。例如：

PySide6
PyQt5
...

确保在开始项目之前，已经正确安装了这些依赖项。可以使用以下命令安装：

pip install -r requirements.txt

以上就是 NapCatQQ-Desktop 项目的启动和配置基本教程。按照以上步骤，您可以顺利地运行和配置该项目。