大漠插件Python模块文件清单
一、文件说明
| 文件名 |
类型 |
作用 |
是否必须 |
备注 |
| dm_module.py |
源码文件 |
核心功能模块(封装DM插件所有接口) |
✅ 必须 |
32位编译,需匹配Python位数 |
| xd47243.dll |
DLL文件 |
大漠插件核心库 |
✅ 必须 |
需与dm_module.pyc放在同一目录 |
| Go.dll |
DLL文件 |
大漠插件依赖库 |
✅ 必须 |
需与dm_module.pyc放在同一目录 |
| 测试窗口.exe |
可执行文件 |
测试用窗口程序(提供测试句柄) |
❌ 可选 |
运行测试脚本时需提前启动,用于窗口绑定/操作测试 |
| python-3.10.8.exe |
可执行文件 |
python安装程序文件(32位) |
❌ 可选 |
编写python代码的必要文件,也可自行到官网下载 |
| DM_Dict.txt |
文本文件 |
文字识别字库文件 |
❌ 可选 |
文字识别(Ocr/FindStr)功能依赖,需放在脚本同目录 |
| test.txt |
文本文件 |
文件读取测试示例文件 |
❌ 可选 |
测试ReadFile接口用,无则跳过该测试项 |
| test_pic.bmp |
图片文件 |
图像识别测试示例图片 |
❌ 可选 |
测试FindPic/FindPicSim接口用,无则该测试项报错 |
| test_capture.bmp |
图片文件 |
截图测试输出文件 |
❌ 可选 |
Capture接口截图后生成,无需提前准备 |
| main.py |
源码文件 |
完整功能测试脚本 |
❌ 可选 |
验证DM插件所有核心接口,含窗口/鼠标/键盘/图像/文字等测试 |
二、环境要求
- Python版本:3.8+(推荐3.10.8),32位 ;
- 操作系统:Windows 10/11(仅支持Windows);
- 权限说明:
- 普通权限可运行基础功能;
- 窗口绑定/操作失败时,需以管理员身份运行Python脚本;
- 依赖说明:无额外Python包依赖(无需pip安装任何包)。
三、使用方法
3.1 基础部署
- 将所有文件解压到同一目录(建议目录路径无中文/空格,如
D:\dm_test\);
- 确认
xd47243.dll、Go.dll 与 dm_module.py 同目录;
- 若需测试文字识别功能,将
DM_Dict.txt 放在脚本同目录。
3.2 快速运行测试脚本
# 1. 启动测试窗口(必须先启动,否则窗口绑定测试跳过)
import subprocess
import os
exe_path = os.path.join(os.path.dirname(__file__), "测试窗口.exe")
p = subprocess.Popen(exe_path)
# 2. 导入并使用DM插件
from dm_module import * # type: ignore[import] # 忽略导入检查
from ctypes import c_long # 导入c_long(关键)
# 初始化大漠
ret = LoadDm(r"xd47243.dll", r"Go.dll")
if not ret:
print("❌ DM插件初始化失败")
else:
# 创建大漠对象
dm = DmSoft()
# 注册(破J版空字符串即可)
dm.Reg("", "")
print(f"✅ 插件版本:{dm.Ver()}")
# 执行完整测试(可选)
# test_dm_functions() # 需复制测试函数到脚本中
# 释放资源
FreeDm()
# 3. 关闭测试窗口
p.terminate()
|