fix(mem_scanner): fix context_size logic and update sops

This commit is contained in:
Liang Jiaqing
2026-02-09 18:32:15 +08:00
parent 656a3fe45e
commit 3a9a5ee2aa
6 changed files with 174 additions and 7 deletions

39
memory/ljqCtrl_sop.md Normal file
View File

@@ -0,0 +1,39 @@
# ljqCtrl 使用与坐标转换 SOP
## 0. API 快速参考 (Signatures)
- `ljqCtrl.dpi_scale`: float (缩放系数 = 逻辑宽度 / 物理宽度)
- `ljqCtrl.SetCursorPos(z)`: 移动鼠标到逻辑坐标 z=(x, y)
- `ljqCtrl.Click(x, y=None)`: 模拟点击。支持 `Click((x, y))``Click(x, y)`
- `ljqCtrl.Press(cmd, staytime=0)`: 模拟按键。如 `Press('ctrl+c')`
- `ljqCtrl.FindBlock(fn, wrect=None, threshold=0.8)`: 找图。返回 `((center_x, center_y), is_found)`
- `ljqCtrl.MouseDClick(staytime=0.05)`: 鼠标双击
## 1. 环境载入
必须先将 `../memory` 加入路径,才能导入工具模块:
```python
import sys, os, pygetwindow as gw
sys.path.append("../memory")
import ljqCtrl
```
## 2. 核心High-DPI 物理坐标换算
`ljqCtrl``Click/MoveTo` 接口接收的是**物理像素坐标**。
当使用 `pygetwindow` 等工具获取窗口位置(逻辑坐标)时,必须除以缩放系数。
- **换算公式**`物理坐标 = 逻辑坐标 / ljqCtrl.dpi_scale`
- **注意**3840 (4K) 仅为当前开发机示例,实际物理边界由系统环境决定,代码应始终通过 `dpi_scale` 动态计算。
## 3. 窗口操作与点击流程
1. **激活窗口**:使用 `gw.getWindowsWithTitle('标题')` 获取窗口,执行 `restore()``activate()`
2. **坐标计算**
```python
win = gw.getWindowsWithTitle('微信')[0]
# 计算窗口内某个点的逻辑坐标 (lx, ly)
# 转换为物理坐标并点击
px, py = lx / ljqCtrl.dpi_scale, ly / ljqCtrl.dpi_scale
ljqCtrl.Click(px, py)
```
## 4. 避坑指南
- **物理验证**:模拟操作前必须确保窗口已通过 `activate()` 置于前台。
- **偏移量**:所有的相对偏移像素值(如“向右移动 10 像素”)同样需要除以 `dpi_scale`