Skip to content

整体架构 ​

text
┌─────────────────────────────────────────────────────────────┐
│  C++ 客户端 (application/)                                   │
│   ├─ 登录链 (LoginAuth / LoginSession / ConnectInstance)     │
│   ├─ 数据包 (PacketBase + 各 packet 类, 网易协议)             │
│   ├─ 回调分发 (CallbackManger: 包 → 触发 Python 事件)         │
│   └─ Python 运行时 (PythonRuntime: 静态链入的 CPython 3.12)  │
├─────────────────────────────────────────────────────────────┤
│  Python 3.12 (部署在 exe 旁 source/)                         │
│   ├─ 标准库 source/Lib/                                      │
│   ├─ 框架入口 source/init.py                                 │
│   ├─ 框架实现 source/ntvector/ (插件管理、RPC 校验、打包)     │
│   ├─ 插件 scripts/<name>/__init__.py                         │
│   └─ 类型桩 source/Lib/site-packages/*.pyi (IDE 补全)        │
└─────────────────────────────────────────────────────────────┘

解释器是静态链接进 Program.exe 的

exe 旁没有 python312.dll。这与 Python 2.7 时代的形态一致(当年是静态 python27.lib,32 MB)。代价是官方 .pyd 动态扩展无法加载 —— 详见 静态链接与扩展限制。

分层职责 ​

层负责不负责
C++ 客户端网络连接、登录鉴权、协议编解码、游戏状态维护、事件分发业务逻辑
Python 框架(source/)加载插件、事件路由、RPC 反作弊校验、数据包解析(proton.py)协议实现

框架代码的模块划分见 Python 内嵌机制 · 框架模块划分。 | 插件(scripts/) | 你的业务逻辑 | 连接与协议细节 |

分界点是一套事件系统:C++ 侧收到数据包 → 分发给 Python → 插件注册的回调被调用。 插件要主动做事(发指令、移动、打开容器)时,调用 engine 等原生模块。

C++ 侧主要组成 ​

组件位置说明
登录链application/Core/LoginAuth / LoginSession / ConnectInstance
数据包application/Packets/PacketBase + 各协议包类
回调分发application/Core/CallbackManger.cpp协议包 → Python 事件
Python 运行时application/Python/PythonRuntime.cpp解释器初始化、19 个模块注册
原生 APIapplication/PythonAPI/pybind11 绑定(nbt / packets / game_state)
网络后端application/Network/RakNet / WebSocket / WebRTC / NetherNet
加密application/Crypto/AES / ChaCha20 / Rotor / ECC

本节目录 ​

第三方库请参阅各自目录下的许可证文件