Compare commits
3
Commits
main
...
c4a42bcfaf
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
c4a42bcfaf | ||
|
|
58cd78cd9c | ||
|
|
13c038a175 |
+172
@@ -0,0 +1,172 @@
|
||||
# 待开发计划(BACKLOG)
|
||||
|
||||
按「收益 / 风险」排序。每条都带**证据**和**验收标准**,云端改完直接照着验。
|
||||
最近一次实测记录见 [`feedback/2026-11-14/README.md`](feedback/2026-11-14/README.md),
|
||||
接口与队名表见 [`feedback/2026-11-14/HANDOVER.md`](feedback/2026-11-14/HANDOVER.md)。
|
||||
|
||||
图例:P0 = 现在是坏的/每天都在浪费;P1 = 明显影响质量;P2 = 打磨。
|
||||
|
||||
---
|
||||
|
||||
## P0-1 商店「必买 / 必卖 / 公式合成」清单恒为空
|
||||
|
||||
**现状**:`tasks/mirror/__init__.py` 用旧路径加载模板:
|
||||
|
||||
```python
|
||||
must_purchase_path = "./assets/images/share/mirror/shop/must_purchase"
|
||||
```
|
||||
|
||||
实际图片在 `./assets/images/default/share/mirror/shop/must_purchase/`(5 张:`carmilla`、`homeward`、
|
||||
`lithograph`、`phlebotomy_pack`、`piece_of_relationship`),`assets/images/share` 根本不存在。
|
||||
运行时实测:
|
||||
|
||||
```
|
||||
must_purchase 0
|
||||
must_be_abandoned 0
|
||||
fusion_result 0
|
||||
```
|
||||
|
||||
后果:`in_shop.py:157` 的购买循环、`:564` 的废弃识别、公式合成全部空转。2026-11-14 进店 51 秒、
|
||||
打印了三次「开始购买必买项」却没买一件。
|
||||
|
||||
**目标**:三个清单按当前 `path_manager` 的图片根(`default/share`、`dark/share`…)加载,且支持中英文资源目录。
|
||||
|
||||
**验收**:
|
||||
|
||||
- [ ] `python -c "import tasks.mirror as m; print(len(m.must_purchase), len(m.must_be_abandoned), len(m.fusion_result))"` → `5 19 31`
|
||||
- [ ] 单测覆盖:清单非空、路径含 `default/share`、`dark` 主题下也能解析
|
||||
- [ ] 实机进店日志能看到真正的购买动作(`购买` 后出现 `ego_gift_get_confirm`),且余额变化
|
||||
|
||||
**涉及**:`tasks/mirror/__init__.py`(`vendor`!)→ 若要遵守「不改 vendor」,就在 `lc_mcp/aalc_patches.py`
|
||||
里于 import 后重建这三个列表,并加一条注释说明上游路径缺陷。
|
||||
|
||||
**风险**:低。纯路径/清单;不改判定逻辑。
|
||||
|
||||
---
|
||||
|
||||
## P0-2 镜牢走位被配置降级成「只按 ↑」
|
||||
|
||||
**现状**:`config.yaml` 里 `mirror_keyboard_navigation: true` + `mirror_keyboard_simple_pathfinding: true`,
|
||||
`mirror.py:1128` 因此走 `search_road_simple_keyboard()`:每层按两次 ↑ 进最上面的节点,不看节点类型。
|
||||
Dijkstra 那套(`search_road.py:735`,代价 event 1 / shop 2 / battle 4 / boss·focused 6 / risky 7)完全没跑。
|
||||
|
||||
**目标**(二选一,云端定):
|
||||
|
||||
- A:默认改用 Dijkstra,只在检测到「鼠标拖地图卡死」时降级为简单键盘;
|
||||
- B:保留简单键盘,但把「↑ 的第一个节点」换成「按节点类型挑可达节点」。
|
||||
|
||||
**验收**:
|
||||
|
||||
- [ ] 一局里至少 3 层,日志能打印每层选中的节点类型与理由
|
||||
- [ ] 事件/商店节点占比 ≥ 现状(对比 11-14 这局:3 层只进过 1 次商店)
|
||||
- [ ] 不出现寻路卡死(连续 60 s 无 `enter_assets` 即算失败,应回退简单键盘)
|
||||
|
||||
**涉及**:`tasks/mirror/search_road.py`、`tasks/mirror/mirror.py:1128`、`config.yaml` 默认值(`assets/config/config.example.yaml`)
|
||||
|
||||
**风险**:中。`simple_pathfinding` 当初是为了规避鼠标拖拽卡死加的,去掉要有回退开关。
|
||||
|
||||
---
|
||||
|
||||
## P1-3 饰品三选一加「体系优先」
|
||||
|
||||
**现状**:`mirror.py:1360 acquire_ego_gift()` 只看两件事——是不是白棉花、是不是「已持有」,
|
||||
然后拿第一张。**完全不看 `team_system`**。
|
||||
|
||||
**目标**:可配置的关键词优先表(例如流血队:`流血 / 出血 / 血迹`),命中则加权;仍旧排除已持有与白棉花。
|
||||
|
||||
**验收**:
|
||||
|
||||
- [ ] 单测:给定候选文本列表 + 体系,选出预期那一张(含「全部已持有」「全是白棉花」边界)
|
||||
- [ ] 实机:流血队一局里,三选一命中体系关键词的比例 > 0(日志统计)
|
||||
- [ ] 关闭该配置时行为与现在完全一致(可回滚)
|
||||
|
||||
**涉及**:`tasks/mirror/mirror.py`、`lc_mcp/aalc_patches.py`(建议做成可配置关键词表,放 `config.yaml` 或独立 yaml)
|
||||
|
||||
**风险**:中。OCR 有误读(`震颐`/`沉论`/`编#16`),关键词要容忍错字。
|
||||
|
||||
---
|
||||
|
||||
## P1-4 事件选项策略可配
|
||||
|
||||
**现状**:`mirror.py:1230 event_handling()` 固定策略——能点「判定 / check」就点,然后**永远点第一个选项**,
|
||||
最后找 `continue/继续`。跟体系、跟当前血量都无关。
|
||||
|
||||
**目标**:支持一张「事件 → 选项」表(JSON/YAML),未收录的退回「第一个选项」。
|
||||
|
||||
**验收**:
|
||||
|
||||
- [ ] 表里命中的事件按配置点;未命中的行为不变
|
||||
- [ ] 单测:事件文本 → 选项索引映射,含缺省分支
|
||||
- [ ] 至少录入 5 个高频事件(可从 `docs/mirror_dungeon_speedrun_notes.md` 的既有结论里抄)
|
||||
|
||||
**涉及**:`tasks/mirror/mirror.py`、新增数据文件(建议 `lc_mcp/data/event_choices.yaml`,不要塞进 vendor)
|
||||
|
||||
**风险**:低-中。选项点错可能拿不到奖励,但不会卡死。
|
||||
|
||||
---
|
||||
|
||||
## P1-5 选队补丁的鲁棒性
|
||||
|
||||
**现状**:`_select_team_by_name()` 精确匹配 + 4 轮翻页。已知薄弱点:
|
||||
|
||||
- OCR 误读(实测把「震颤」读成「震颐」、「沉沦」读成「沉论」、「编队#16」读成「编#16」)
|
||||
- 队名带后缀(「流血队」「流血(X)」)会失配
|
||||
- 只按「顶栏名字」确认,若顶栏字号变化会误判
|
||||
|
||||
**目标**:别名表 + 归一化(去空格/全半角/常见误读)+ 失败时输出候选列表便于排查。
|
||||
|
||||
**验收**:
|
||||
|
||||
- [ ] 把队名临时改成「流血队」也能选中(别名/前缀匹配,仍需唯一)
|
||||
- [ ] 误读样本(`震颐`→`震颤`、`沉论`→`沉沦`)能正确归一
|
||||
- [ ] 失败日志里打印「这一屏看到了哪些名字」,而不是只说没找到
|
||||
|
||||
**涉及**:`lc_mcp/aalc_patches.py`、`tests/test_system_team_selection.py`
|
||||
|
||||
**风险**:低。只是匹配变宽,需保证「唯一命中」才点,避免选错队。
|
||||
|
||||
---
|
||||
|
||||
## P2-6 商店必买清单本地化
|
||||
|
||||
**现状**:必买靠 5 张**英文/图标模板**;汉化后商店里的名称是中文,模板匹配靠图标尚可,但新增饰品无法覆盖。
|
||||
|
||||
**目标**:支持「饰品中文名 → 优先级」的配置表,OCR 命中即买;模板作为兜底。
|
||||
|
||||
**验收**:单测 + 实机一局至少一次由名字命中的购买。
|
||||
|
||||
**涉及**:`lc_mcp/aalc_patches.py`(包一层购买判定)、新增数据文件。
|
||||
|
||||
---
|
||||
|
||||
## P2-7 观测饰品按体系自动勾选
|
||||
|
||||
**现状**:`observe_ego_gift_selected` 要人在 AALC 界面一个个勾;没勾就等于关闭观测。
|
||||
|
||||
**目标**:按 `team_system` 自动勾一组默认饰品(可覆盖),并在开跑前写回配置。
|
||||
|
||||
**验收**:`config.yaml` 里 `observe_ego_gift_selected` 与体系匹配;日志打印勾了哪些。
|
||||
|
||||
**涉及**:`lc_mcp/aalc_task.py`(apply_overrides 类似机制)、`app/observe_ego_gift_selection.py` 的序列化格式(只读参考)。
|
||||
|
||||
---
|
||||
|
||||
## P2-8 决策审计日志
|
||||
|
||||
**现状**:选队/卡包/饰品/商店的决策只散落在 DEBUG 日志里,事后要人肉 grep。
|
||||
|
||||
**目标**:每局写一份 `~/lc_mcp/runs/<task>.decisions.jsonl`:时间、阶段、画面摘要、候选、选中项、理由。
|
||||
|
||||
**验收**:一局结束后能直接统计「卡包选择理由 ×N」「三选一命中体系 ×N」「商店购买 ×N」。
|
||||
|
||||
**涉及**:`lc_mcp/aalc_patches.py`、`lc_mcp/tasks.py`(结果归档)。
|
||||
|
||||
---
|
||||
|
||||
## 已知但暂不做的
|
||||
|
||||
| 项 | 原因 |
|
||||
|---|---|
|
||||
| 让 AALC 原生支持自定义队名 | 要改 `vendor/aalc`,submodule 升级会丢;补丁层已够用 |
|
||||
| 自动识别「哪支队是流血队」 | 图像/文本都不可靠,靠命名约定(见 HANDOVER 第 4 节)更稳 |
|
||||
| 改 `mirror_dungeon_speedrun_notes.md` 的路线结论 | 那是人工速通笔记,和 AALC 的自动寻路是两套,别混 |
|
||||
@@ -0,0 +1,162 @@
|
||||
# 对接说明:镜牢选队(2026-11-14)
|
||||
|
||||
给**云端开发**看的交接文件。目标:云端改代码 → 我这边 `git pull` → 实机回归 → 回传结果。
|
||||
所以这里写清楚「改哪、别动哪、怎么验、验到什么程度算过」。
|
||||
|
||||
---
|
||||
|
||||
## 1. 仓库与运行环境
|
||||
|
||||
| 项 | 值 |
|
||||
|---|---|
|
||||
| 仓库 | `https://git.lingll.icu/yws/lc-mcp` |
|
||||
| 当前分支 | `codex/feedback-unattended-setup-20261004` |
|
||||
| 本机路径 | `D:\lc-mcp`(AALC 在 `vendor/aalc`,**submodule,不要改**) |
|
||||
| Python | `vendor\aalc\.venv\Scripts\python.exe`(3.13) |
|
||||
| 游戏 | `D:\SteamLibrary\steamapps\common\Limbus Company`(Steam build 26593955) |
|
||||
| 汉化 | `LLC_zh-CN` 2026111301(自定义语言,游戏基础语言 = 韩语,OCR 语言识别为 `zh_cn`) |
|
||||
| 分辨率 | 客户区 1280×720,`set_win_size: 720` |
|
||||
| 常驻服务 | 计划任务 `LcMCPServer`,`127.0.0.1:8765`,日志 `~/lc_mcp/server.log` |
|
||||
|
||||
**测试入口**(本机验证统一用这个,不要直接跑 `main.py`):
|
||||
|
||||
```powershell
|
||||
D:\lc-mcp\vendor\aalc\.venv\Scripts\python.exe -X utf8 -c "from lc_mcp import ..." # 单测
|
||||
# 实机:通过 MCP 工具 run_task mirror,或
|
||||
D:\lc-mcp\vendor\aalc\.venv\Scripts\python.exe -X utf8 -m lc_mcp.aalc_task mirror "{\"count\": 1}"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 2. 本次改动(两个文件,均为增量,不改 vendor)
|
||||
|
||||
### `lc_mcp/aalc_patches.py`
|
||||
|
||||
新增一段(文件末尾,`install_default_battle_team` 之后):
|
||||
|
||||
```python
|
||||
SYSTEM_TEAM_NAMES = {...} # 体系(system 字符串) → 游戏内编队名元组
|
||||
TEAM_LIST_X_MAX / TEAM_LIST_Y_MIN / TEAM_LIST_Y_MAX # 左侧列表命中范围(客户区像素)
|
||||
TEAM_HEADER = (170, 520, 90, 150) # 顶栏队名位置,用来确认选中
|
||||
|
||||
_team_ocr(auto) -> [(text, x, y), ...] # 整屏 OCR 后清洗,不排序
|
||||
_in_list(x, y) / _in_header(x, y) # 区域判定
|
||||
_scroll_team_list(auto, direction, times, distance) # +1=回顶部, -1=往下翻
|
||||
_header_is(auto, name) / _wait_header(auto, name) # 顶栏确认(3 次 × 1.2s)
|
||||
_select_team_by_name(auto, names, log, rounds=4) # 主流程,返回 bool
|
||||
install_system_team_selection(log=print) # 安装补丁,返回原始 select_battle_team
|
||||
```
|
||||
|
||||
### `lc_mcp/aalc_task.py`
|
||||
|
||||
- import 里加 `install_system_team_selection`
|
||||
- `run()` 里、`install_default_battle_team` 之后:
|
||||
|
||||
```python
|
||||
if task in ('mirror', 'all'):
|
||||
install_system_team_selection(log=log)
|
||||
```
|
||||
|
||||
### 挂载点为什么是 `tasks.mirror.mirror`
|
||||
|
||||
`tasks/mirror/mirror.py` 在模块顶部 `from tasks.teams.team_formation import ... select_battle_team`,
|
||||
之后 `select_mirror_team()` 用的是**模块全局名**。所以补丁必须替换
|
||||
`tasks.mirror.mirror.select_battle_team`;改 `tasks.teams.team_formation.select_battle_team` 对镜牢无效
|
||||
(日常本那条补丁 patch 的是 `scheme` 命名空间,两者互不影响)。
|
||||
|
||||
---
|
||||
|
||||
## 3. 接口契约(改的时候必须保住)
|
||||
|
||||
1. **`select_battle_team(num) -> bool`**:True = 已选中并确认在编队界面;False = 没选上,调用方会重试(最多 6 次)后抛 `unableToFindTeamError`。
|
||||
2. **不能有副作用**:补丁只点击,不写配置文件;`Mirror.__init__` 的包装只读 `team_setting`。
|
||||
3. **坐标空间**:一律按**客户区像素**(当前 1280×720)。缩放用 `cfg.set_win_size / 1440`,跟 AALC 其它地方一致。
|
||||
4. **`auto._run_ocr_for_text(my_crop=None)` 返回 `{text: [cx, cy]}`**:`cx/cy` 是 box 中心;同名文本会互相覆盖,**因此 `_team_ocr` 改成返回列表**,别再退回 dict。
|
||||
5. **不要用 `my_crop` 做界面裁剪**:实测裁剪坐标语义不可靠(裁 `(0,0,190,584)` 会读到右侧面板),统一「整屏 OCR + 坐标过滤」。
|
||||
6. **点完必须验顶栏**:只点不验会出现「日志说成功,其实没换队」。
|
||||
|
||||
---
|
||||
|
||||
## 4. 体系队名表(本机账号实际状态,2026-11-14 截图核对)
|
||||
|
||||
左侧编队列表,从上到下:
|
||||
|
||||
| 顺序 | 列表显示 | 说明 | `team_system` |
|
||||
|---|---|---|---|
|
||||
| 1 | 剧情关卡 | 剧情用预设 | — |
|
||||
| 2 | 斩击 | 打击体系队 | 7 |
|
||||
| 3 | 突刺 | 突刺体系队 | 8 |
|
||||
| 4 | 打击 | 打击体系队 | 9 |
|
||||
| 5 | 烧伤 | 烧伤体系队 | 0 |
|
||||
| 6 | 流血 | 流血体系队(**当前镜牢在用**) | 1 |
|
||||
| 7 | 震颤 | 震颤体系队 | 2 |
|
||||
| 8 | 破裂 | 破裂体系队 | 3 |
|
||||
| 9 | 沉沦 | 沉沦体系队 | 5 |
|
||||
| 10 | 呼吸法 | 呼吸体系队(代码里另有别名「呼吸」) | 4 |
|
||||
| 11 | 充能 | 充能体系队 | 6 |
|
||||
| 12+ | 编队#13 … 编队#40 | 默认名残留,未使用 | — |
|
||||
|
||||
> `#1`~`#12` 已不存在。任何按 `编队#N` 找队的逻辑在这个号上都会失败,这是本次问题的根。
|
||||
>
|
||||
> 队名改动后必须同步 `SYSTEM_TEAM_NAMES`;补丁只做**精确匹配**(`text == name`),不做子串。
|
||||
|
||||
---
|
||||
|
||||
## 5. 验证方法
|
||||
|
||||
### 5.1 单测(不需要游戏)
|
||||
|
||||
```powershell
|
||||
cd D:\lc-mcp
|
||||
vendor\aalc\.venv\Scripts\python.exe -m unittest discover -s tests -t tests -v
|
||||
```
|
||||
|
||||
本次新增 `tests/test_system_team_selection.py`,覆盖:映射表完整性、区域判定边界、
|
||||
`install_system_team_selection` 的挂载/回退行为(用假模块,不依赖 AALC/Windows)。
|
||||
|
||||
### 5.2 实机回归(需要游戏在运行)
|
||||
|
||||
```powershell
|
||||
# 1) 确认补丁挂上
|
||||
# 日志里应有:[lc_mcp] patch: 镜牢按体系名选队
|
||||
# 2) 起一局
|
||||
run_task(task="mirror", count=1)
|
||||
# 3) 看这几行
|
||||
# [lc_mcp] 镜牢体系 bleed -> 目标编队 流血
|
||||
# [lc_mcp] patch: 已按体系名选中编队 流血 (或「当前已经是编队 流血, 无需切换」)
|
||||
# [INFO] 楼层识别结果:当前为第1层
|
||||
```
|
||||
|
||||
### 5.3 验收清单
|
||||
|
||||
- [ ] `select_battle_team` 返回 True 后,顶栏队名 = 目标队名(截图为准,不看日志)
|
||||
- [ ] 连续两局:第二局走「已经是目标队,无需切换」分支
|
||||
- [ ] 把 `team_system` 改成 7(斩击)能选到「斩击」;改回 1 能选回「流血」
|
||||
- [ ] 目标名不存在时(例如临时改成 `编队#999`)能 4 轮内返回 False,不卡死、不乱点
|
||||
- [ ] 列表滚动后不会把队伍页留在错误位置(后续 `罪人编队` 步骤仍能正常执行)
|
||||
|
||||
---
|
||||
|
||||
## 6. 云端开发注意事项
|
||||
|
||||
- **不要改 `vendor/aalc`**:submodule 固定 commit,改了本地能跑、更新就丢。所有行为差异走 `lc_mcp/aalc_patches.py`。
|
||||
- **不要引入本机绝对路径**(`D:\...`、`C:\Users\YWS-HHH\...`);已有代码里 `LC_*` / `LCP_*` 环境变量是既有限制。
|
||||
- **失败要显式**:选队失败返回 False 让上层重试,不要静默 fallback 到 `编队#N`(这号没有 `#N`,会选中错的队)。
|
||||
- **日志格式**:沿用 `[lc_mcp] ...` 前缀,`task_status` 的 `errors` 扫描依赖 `[ERROR]`。
|
||||
- 新增依赖请加到 `pyproject.toml`,并确认 `uv sync` 后 `vendor/aalc/.venv` 能跑。
|
||||
|
||||
---
|
||||
|
||||
## 7. 拉取与回传
|
||||
|
||||
```powershell
|
||||
cd D:\lc-mcp
|
||||
git fetch origin
|
||||
git checkout <云端分支>
|
||||
git pull
|
||||
git submodule update --init --recursive
|
||||
vendor\aalc\.venv\Scripts\python.exe -m unittest discover -s tests -t tests
|
||||
# 实机回归 → 结果写回 docs/feedback/<日期>/
|
||||
```
|
||||
|
||||
我这边回归后会补:跑团日志、截图路径、验收清单勾选结果,以及新发现的问题。
|
||||
@@ -0,0 +1,189 @@
|
||||
# 2026-11-14 汉化更新 + 镜牢选队根因与局内决策实测
|
||||
|
||||
本次两件事:**更新游戏汉化**,以及**把「镜牢一直选不上队」查清楚并修掉**。
|
||||
后半段顺带核了镜牢局内的四类决策(走位 / 卡包 / 饰品 / 商店),发现两处真实缺陷,一并记在
|
||||
[`BACKLOG.md`](../../BACKLOG.md) 里。
|
||||
|
||||
## 环境
|
||||
|
||||
| 项 | 值 |
|
||||
|---|---|
|
||||
| 系统 | Windows 10 Pro 19045,远程会话,无人值守 |
|
||||
| 游戏 | Steam 版 Limbus Company,`D:\SteamLibrary\steamapps\common\Limbus Company` |
|
||||
| 游戏版本 | 更新前 build `26318463`(1.118.1,11-05)→ 更新后 build `26593955`(11-14 08:20 落盘) |
|
||||
| 汉化 | `LimbusCompany_Data\Lang\LLC_zh-CN`,2026101602 → **2026111301** |
|
||||
| AALC | `vendor/aalc`(git submodule,未改源码) |
|
||||
| 运行方式 | MCP `run_task mirror`,AALC 子进程,前台点击 + 罗技驱动点击 |
|
||||
|
||||
## 一、汉化更新
|
||||
|
||||
上游:`LocalizeLimbusCompany/LocalizeLimbusCompany` release `2026111301`(2026-11-13 发布)。
|
||||
装法按官方手动流程:**干净重装**(移走旧 `LLC_zh-CN` → 解压新包到游戏根目录),字体包不随
|
||||
release 发布,单独从 `Fonts/LLCCN-Font.7z` 来(自 2025-04 未变,直接沿用旧文件)。
|
||||
|
||||
| 步骤 | 结果 |
|
||||
|---|---|
|
||||
| 旧包备份 | `D:\codex\_limbus_l10n_dl\backup-LLC_zh-CN-2026101602`(2350 文件 / 45.1 MB) |
|
||||
| 下载 | `LimbusLocalize_2026111301.zip` 6,080,228 B,SHA256 `E63782A0…6E14665` |
|
||||
| 解压 | 2385 个文件,全部 SHA256 与 zip 内一致(0 不匹配) |
|
||||
| JSON 校验 | 2384 个 JSON 全部可解析,0 空文件 |
|
||||
| 字体 | `Font\Context\ChineseFont.ttf` 22.8 MB,TTF 头 `00 01 00 00` 正常 |
|
||||
| 配置 | `Lang\config.json` 未动,仍 `"lang": "LLC_zh-CN"` |
|
||||
|
||||
相对旧版新增:`walpu10` 系列事件/敌人/EGO、`Mirror8` 成就与卡包、`StoryData E100X–E103X`、
|
||||
新人格语音(`P10316/P10617/P10717/P11017/P11116`)、`SynergyKeyword`、`EventVerificationUIText` 等 35 个文件。
|
||||
|
||||
> 注:游戏第一次启动时弹「当前游戏客户端不是最新版本」,必须先更 Steam 客户端;更完再跑就正常了。
|
||||
|
||||
## 二、镜牢选队:为什么一直「选不上」
|
||||
|
||||
### 症状
|
||||
|
||||
`run_task mirror` 后 AALC 卡在选队:每 5 秒对左侧列表 OCR 一次,页码一路往上爬,然后重来。
|
||||
|
||||
```text
|
||||
08:34:27 开始执行 寻找队伍
|
||||
08:34:50 OCR: 编队#13 编队#14 编队#15 编#16
|
||||
08:35:00 OCR: 编队#19 编队#20 编队#21 …
|
||||
08:35:15 OCR: 编队#33 编队#34 编队#35 …
|
||||
08:37:00 又回到 编队#19 … ← 第 N 轮
|
||||
```
|
||||
|
||||
### 根因
|
||||
|
||||
`config.yaml` 里 `team_number: 1`,AALC 的 `select_battle_team()` 只会按
|
||||
`编队#N` / `TEAMS #N` 这个**字面名字**去 OCR 找队(`tasks/teams/team_formation.py:167`)。
|
||||
|
||||
而这个号的编队**是按体系命名的**,不是默认名;`编队#1`~`#12` 也已经不存在:
|
||||
|
||||
```text
|
||||
左侧列表(从上到下):
|
||||
剧情关卡
|
||||
斩击 突刺 打击 烧伤 流血 震颤 破裂 沉沦 呼吸法 充能 ← 10 支按体系命名
|
||||
编队#13 … 编队#40 ← 默认名残留
|
||||
```
|
||||
|
||||
所以找 `编队#1` 永远找不到 → 翻满 10 页 → 重试 6 轮 → `无法寻得队伍,请检查队伍名称是否为默认名称`。
|
||||
|
||||
### 修复
|
||||
|
||||
新增 `install_system_team_selection()`(`lc_mcp/aalc_patches.py`),在 `mirror`/`all` 任务里挂载。
|
||||
**不改 `vendor/aalc` 源码**,只替换 `tasks.mirror.mirror` 命名空间里的 `select_battle_team`:
|
||||
|
||||
```
|
||||
team_system → 队名
|
||||
0 烧伤 / 1 流血 / 2 震颤 / 3 破裂 / 4 呼吸法(兼容"呼吸")
|
||||
5 沉沦 / 6 充能 / 7 斩击 / 8 突刺 / 9 打击
|
||||
```
|
||||
|
||||
选队流程:
|
||||
|
||||
1. 先看顶栏是不是已经是这支队(是就直接返回,不动列表)
|
||||
2. 不是 → 点空白、把列表向下拖回顶部
|
||||
3. 整屏 OCR,只保留左侧列表区域(`x<260`,`300<y<640`)里的条目
|
||||
4. **精确匹配**队名 → 点击 → 轮询顶栏最多 3 次 × 1.2 s,顶栏变成该名字才算成功
|
||||
5. 没找到就往下翻(每次 3 拖),最多 4 轮;4 轮都失败返回 False,交给 AALC 原来那层重试
|
||||
|
||||
两个细节是踩出来的:
|
||||
|
||||
- **不能用 `my_crop`**:AALC 里裁剪坐标的语义跟客户区像素对不上(实测裁 `(0,0,190,584)` 会 OCR 出右侧面板的文字),所以改成整屏 OCR 再按坐标过滤。
|
||||
- **点完不能立刻判**:顶栏要 1~2 帧才刷新,实测 0.8 s 时还没变,1.2 s×3 才稳。
|
||||
|
||||
实测日志:
|
||||
|
||||
```text
|
||||
[lc_mcp] 镜牢体系 bleed -> 目标编队 流血
|
||||
[lc_mcp] 编队列表里找到 流血 @(130,492)
|
||||
[lc_mcp] patch: 已按体系名选中编队 流血
|
||||
[INFO] 楼层识别结果:当前为第1层
|
||||
[INFO] 此次选择卡包关键词:信仰
|
||||
```
|
||||
|
||||
(第二次跑因为上一次已经停在「流血」上,直接命中「当前已经是编队 流血, 无需切换」。)
|
||||
|
||||
## 三、局内四类决策:代码实际怎么走
|
||||
|
||||
| 决策 | 现状 | 代码位置 |
|
||||
|---|---|---|
|
||||
| 走位 | **被配置降级成瞎走**:`mirror_keyboard_simple_pathfinding: true` → 每层只按 ↑ 选最上面节点 | `mirror.py:1128` → `search_road.py:145` |
|
||||
| 卡包 | 规则明确:关键词权重表取最高,低于阈值就刷新(≤3 次) | `select_theme_pack.py` |
|
||||
| 饰品三选一 | **不看体系**:排白棉花 → 排「已持有」→ 拿第一张 | `mirror.py:1360` |
|
||||
| 商店 | 必买/必卖清单为 **0**(路径写错),只剩体系强化/刷新/合成/治疗 | `in_shop.py:157`、`tasks/mirror/__init__.py` |
|
||||
| 事件 | 固定:能「判定」就判定,然后永远点第一个选项 | `mirror.py:1230` |
|
||||
|
||||
### 3.1 走位
|
||||
|
||||
```python
|
||||
# search_road.py:145
|
||||
for attempt in range(2):
|
||||
auto.key_press("up")
|
||||
if _keyboard_enter_succeeded():
|
||||
return True
|
||||
```
|
||||
|
||||
关掉 `mirror_keyboard_simple_pathfinding` 才会走 Dijkstra(`search_road.py:735`),节点代价表
|
||||
(`search_road.py:609`,越小越优先):
|
||||
|
||||
| 节点 | 代价 |
|
||||
|---|---|
|
||||
| event | 1 |
|
||||
| shop | 2 |
|
||||
| battle | 4 |
|
||||
| boss / focused / abnormality | 6 |
|
||||
| risky_encounter | 7 |
|
||||
| 未知 | 999(不可达) |
|
||||
|
||||
### 3.2 卡包
|
||||
|
||||
`preferred_thresholds: 0`,权重表在 `theme_pack_list.yaml`(多数 0、`chick: 1`、未知 -5)。
|
||||
本次三次选择:`信仰` → `赌徒` → `情感懒`。
|
||||
|
||||
### 3.3 饰品三选一
|
||||
|
||||
`acquire_ego_gift()`:排除白棉花(除非 `not_skip_whitegossypium`)→ OCR「已持有 / Owned」→
|
||||
优先没持有的 → 都一样拿第一张。**没有任何体系判断**。
|
||||
|
||||
### 3.4 商店(真实缺陷)
|
||||
|
||||
`tasks/mirror/__init__.py` 用的是旧路径:
|
||||
|
||||
```python
|
||||
must_purchase_path = "./assets/images/share/mirror/shop/must_purchase"
|
||||
```
|
||||
|
||||
实际图片在 `./assets/images/default/share/mirror/shop/must_purchase/`,`assets/images/share` 不存在。
|
||||
运行时验证:
|
||||
|
||||
```
|
||||
must_purchase 0
|
||||
must_be_abandoned 0
|
||||
fusion_result 0
|
||||
```
|
||||
|
||||
本次日志实锤(进店 51 秒,一件没买):
|
||||
|
||||
```text
|
||||
10:03:03 开始执行 镜牢商店
|
||||
10:03:16 开始购买必买项
|
||||
10:03:54 结束执行 镜牢商店 耗时 00:00:51
|
||||
```
|
||||
|
||||
## 四、本次跑团(进行中记录)
|
||||
|
||||
```text
|
||||
09:39:53 task mirror start
|
||||
09:40:07 选队 → 流血(已是目标队,跳过切换)
|
||||
09:41:16 第1层
|
||||
09:54:33 第1层结束 13:07,卡包:赌徒
|
||||
09:55:20 寻路出错 → 自动重进镜牢,恢复
|
||||
10:03:54 第2层商店 51 秒(未购买,见 3.4)
|
||||
10:07:32 第2层结束 12:59,卡包:情感懒
|
||||
10:17:37 第3层战斗中
|
||||
```
|
||||
|
||||
## 五、仍未验证的边界
|
||||
|
||||
- 选队补丁只在「流血」上实测过;其它 9 个体系名未实跑(队列切换、`teams_active_queue` 轮转时尤其没验)。
|
||||
- 队名如果被改(比如改成「流血队」),补丁会失配 → 需要同步改 `SYSTEM_TEAM_NAMES`。
|
||||
- `my_crop` 语义不一致这件事只在这个界面验证过,别的界面不一定。
|
||||
- 关掉 `mirror_keyboard_simple_pathfinding` 后 Dijkstra 的稳定性没验(当初开它就是为躲鼠标拖地图卡死)。
|
||||
@@ -63,12 +63,61 @@ class WindowGuard(threading.Thread):
|
||||
size = int(self.cfg.set_win_size)
|
||||
return int(size * 16 / 9), size
|
||||
|
||||
def check_position(self):
|
||||
"""窗口有一截跑到屏幕外时挪回工作区。
|
||||
|
||||
背景(2026-10-22 实测): 游戏会恢复自己保存的窗口位置, 出现过 (-8, 39) 这种
|
||||
—— 左边 8 像素在屏幕外。前台模式(background_click=false)下 AALC 从**屏幕**
|
||||
抓图, 窗口一出界抓到的画面就整体错位, 模板匹配相似度掉到 0.2~0.5, 表现是
|
||||
"日志一直在动但几乎不点击"(实测 30 秒只点 1 次, 挪回来立刻恢复)。
|
||||
set_win_position=free 时 AALC 不碰位置, 所以这里补上。
|
||||
|
||||
返回 'ok' / 'fixed' / None(没法判断)。
|
||||
"""
|
||||
try:
|
||||
import win32con
|
||||
import win32gui
|
||||
except ImportError:
|
||||
return None
|
||||
handle = self.screen.handle
|
||||
hwnd = handle._hwnd
|
||||
try:
|
||||
left, top, right, bottom = handle.monitor_info["Work"]
|
||||
except Exception:
|
||||
return None
|
||||
try:
|
||||
x, y, r, b = win32gui.GetWindowRect(hwnd)
|
||||
except Exception:
|
||||
return None
|
||||
width, height = r - x, b - y
|
||||
if width <= 0 or height <= 0:
|
||||
return None
|
||||
# 已经完整落在工作区内就不动
|
||||
if x >= left and y >= top and r <= right and b <= bottom:
|
||||
return 'ok'
|
||||
new_x = max(left, min(x, right - width))
|
||||
new_y = max(top, min(y, bottom - height))
|
||||
try:
|
||||
win32gui.SetWindowPos(hwnd, 0, new_x, new_y, 0, 0,
|
||||
win32con.SWP_NOSIZE | win32con.SWP_NOZORDER |
|
||||
win32con.SWP_NOACTIVATE)
|
||||
except Exception as e:
|
||||
self.log('[lc_mcp] window guard: 挪窗口失败 %s: %s' % (type(e).__name__, e))
|
||||
return None
|
||||
self.fixes += 1
|
||||
self.log('[lc_mcp] window guard: 窗口 (%d,%d) 有部分在屏幕外, 已挪到 (%d,%d)'
|
||||
% (x, y, new_x, new_y))
|
||||
return 'fixed'
|
||||
|
||||
def check_once(self):
|
||||
"""返回 'ok' / 'fixed' / 'failed' / None(没有可检查的窗口)。"""
|
||||
handle = self.screen.handle
|
||||
# set_windows 关闭表示用户自己管窗口, AALC 也不调, 这里同样不插手
|
||||
if self.cfg.simulator or not self.cfg.set_windows or not handle._hwnd or handle.isMinimized:
|
||||
return None
|
||||
# 位置先修: 出界会让抓图错位, 那种情况下尺寸检查也没意义
|
||||
if self.check_position() == 'fixed':
|
||||
time.sleep(0.5)
|
||||
current = (handle.width(True), handle.height(True))
|
||||
want = self.want()
|
||||
if current == want or 0 in current:
|
||||
@@ -206,6 +255,13 @@ def install_driver_click(auto, screen, driver=None, log=print):
|
||||
if not ok:
|
||||
log('[lc_mcp] 驱动级输入未启用: %s' % why)
|
||||
return None
|
||||
# 绑定目标窗口: click() 靠它做句柄级前台校验。
|
||||
# 只比矩形是不够的 —— 窗口互相重叠时, 同一个屏幕坐标会同时落在两边,
|
||||
# 实测把浏览器切到前台后, 几何校验照样通过(2026-10-23)。
|
||||
try:
|
||||
drv.bind_window(screen.handle.hwnd)
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
proxy = DriverClickProxy(auto.input_handler, drv, screen, log=log)
|
||||
trace = os.environ.get('LCP_DRIVER_TRACE')
|
||||
@@ -300,3 +356,190 @@ def install_robust_set_foreground(screen, log=print):
|
||||
handle.setForeground = setForeground
|
||||
log('[lc_mcp] patch: SetForegroundWindow 加 AttachThreadInput 兜底')
|
||||
return handle
|
||||
|
||||
# ---------------------------------------------------------------- 日常本用默认队伍
|
||||
|
||||
|
||||
def install_default_battle_team(scheme, log=print):
|
||||
"""日常本不再翻队伍列表, 直接用界面上已经选中的默认队伍。
|
||||
|
||||
背景(2026-11-06): 这账号的队伍是自定义名字(不是 "编队#N"), 而
|
||||
select_battle_team 按名字找队伍, 找不到就来回滑动 10 次(实测 61 秒), 滑完还把
|
||||
队伍页留在滚动后的位置; 紧接着 battle.to_battle() 在 15 次循环里都找不到
|
||||
"进入战斗" 按钮, 报 "超出最大尝试次数, 未能进入战斗", 整个日常就这样空转。
|
||||
|
||||
经验本/纽本本来就是用界面默认队伍打的, 跳过选队伍这一步即可。
|
||||
"""
|
||||
try:
|
||||
from tasks.teams import team_formation as tf
|
||||
except Exception as e:
|
||||
log('[lc_mcp] 默认队伍补丁跳过: 无法导入 team_formation: %s' % e)
|
||||
return None
|
||||
original = getattr(tf, 'select_battle_team', None)
|
||||
if original is None:
|
||||
log('[lc_mcp] 默认队伍补丁跳过: 找不到 select_battle_team')
|
||||
return None
|
||||
|
||||
def select_battle_team(*args, **kwargs):
|
||||
log('[lc_mcp] patch: 日常本跳过选队伍, 直接用默认队伍')
|
||||
return True
|
||||
|
||||
tf.select_battle_team = select_battle_team
|
||||
scheme.select_battle_team = select_battle_team
|
||||
log('[lc_mcp] patch: 日常本使用默认队伍')
|
||||
return original
|
||||
|
||||
|
||||
# ---------------------------------------------------------------- 镜牢按体系名选队
|
||||
|
||||
# 这账号把编队按体系命名(流血的队就叫 "流血"), AALC 却只会找 "编队#N" / "TEAMS #N"。
|
||||
# 2026-11-14 实测: 列表里是 剧情关卡/斩击/突刺/打击/烧伤/流血/震颤/破裂/沉沦/呼吸法/充能
|
||||
# 再接 编队#13..#38, 根本没有 "编队#1" —— AALC 翻满 10 页也找不到, 报 "无法寻得队伍"。
|
||||
SYSTEM_TEAM_NAMES = {
|
||||
'burn': ('烧伤',),
|
||||
'bleed': ('流血',),
|
||||
'tremor': ('震颤',),
|
||||
'rupture': ('破裂',),
|
||||
'poise': ('呼吸法', '呼吸'),
|
||||
'sinking': ('沉沦',),
|
||||
'charge': ('充能',),
|
||||
'slash': ('斩击',),
|
||||
'pierce': ('突刺',),
|
||||
'blunt': ('打击',),
|
||||
}
|
||||
|
||||
# 左侧编队列表的 OCR 命中范围(客户区像素, 1280x720 实测)
|
||||
TEAM_LIST_X_MAX = 260
|
||||
TEAM_LIST_Y_MIN = 300
|
||||
TEAM_LIST_Y_MAX = 640
|
||||
# 顶栏 "编队名" 的位置, 用来确认真的选中了
|
||||
TEAM_HEADER = (170, 520, 90, 150)
|
||||
|
||||
|
||||
def _team_ocr(auto):
|
||||
"""整屏 OCR, 返回 [(文本, x, y), ...]。用列表而不是 dict: 同名条目(列表里的队名和顶栏队名)
|
||||
落在不同位置, dict 会把它们覆盖成一条。不用 my_crop: 裁剪区的坐标系不可靠。"""
|
||||
ocr = auto._run_ocr_for_text(my_crop=None)
|
||||
result = []
|
||||
for text, pos in (ocr or {}).items():
|
||||
clean = str(text).replace(' ', '').strip()
|
||||
if not clean:
|
||||
continue
|
||||
try:
|
||||
x, y = float(pos[0]), float(pos[1])
|
||||
except (TypeError, IndexError, ValueError):
|
||||
continue
|
||||
result.append((clean, x, y))
|
||||
return result
|
||||
|
||||
|
||||
def _in_list(x, y):
|
||||
return x < TEAM_LIST_X_MAX and TEAM_LIST_Y_MIN < y < TEAM_LIST_Y_MAX
|
||||
|
||||
|
||||
def _in_header(x, y):
|
||||
x1, x2, y1, y2 = TEAM_HEADER
|
||||
return x1 < x < x2 and y1 < y < y2
|
||||
|
||||
|
||||
def _scroll_team_list(auto, direction, times=6, distance=250):
|
||||
"""direction=+1 向下拖(回到列表顶部), -1 向上拖(往下翻)。"""
|
||||
for _ in range(times):
|
||||
auto.mouse_swipe_for_team_scroll(130, 430, dy=direction * distance, duration=0.3)
|
||||
time.sleep(0.35)
|
||||
|
||||
|
||||
def _header_is(auto, name):
|
||||
"""顶栏当前队伍名就是 name。"""
|
||||
if auto.take_screenshot() is None:
|
||||
return False
|
||||
return any(text == name and _in_header(x, y) for text, x, y in _team_ocr(auto))
|
||||
|
||||
|
||||
def _wait_header(auto, name, tries=3, delay=1.2):
|
||||
"""点完之后顶栏要过一两帧才刷新, 多等几次。"""
|
||||
for _ in range(tries):
|
||||
time.sleep(delay)
|
||||
if _header_is(auto, name):
|
||||
return True
|
||||
return False
|
||||
|
||||
|
||||
def _select_team_by_name(auto, names, log=print, rounds=4):
|
||||
"""在编队列表里按名字点选。成功返回 True, 没找到返回 False。"""
|
||||
if auto.take_screenshot() is None:
|
||||
return False
|
||||
if not auto.find_element('teams/identify_assets.png'):
|
||||
log('[lc_mcp] 不在编队界面, 跳过按名字选队')
|
||||
return False
|
||||
for name in names: # 已经是这支队就不用动列表
|
||||
if _header_is(auto, name):
|
||||
log('[lc_mcp] patch: 当前已经是编队 %s, 无需切换' % name)
|
||||
return True
|
||||
auto.mouse_click(1, 1)
|
||||
time.sleep(0.3)
|
||||
_scroll_team_list(auto, +1) # 先回到顶部
|
||||
for round_index in range(rounds):
|
||||
if auto.take_screenshot() is None:
|
||||
continue
|
||||
items = _team_ocr(auto)
|
||||
hit = None
|
||||
for name in names:
|
||||
for text, x, y in items:
|
||||
if text == name and _in_list(x, y):
|
||||
hit = (name, x, y)
|
||||
break
|
||||
if hit:
|
||||
break
|
||||
if hit:
|
||||
name, x, y = hit
|
||||
log('[lc_mcp] 编队列表里找到 %s @(%d,%d)' % (name, x, y))
|
||||
auto.mouse_action_with_pos([x, y], offset=False)
|
||||
if _wait_header(auto, name):
|
||||
log('[lc_mcp] patch: 已按体系名选中编队 %s' % name)
|
||||
return True
|
||||
log('[lc_mcp] 点了 %s 但顶栏没变, 继续往下翻' % name)
|
||||
_scroll_team_list(auto, -1, times=3)
|
||||
log('[lc_mcp] 编队列表里没找到 %s(共 %d 轮)' % ('/'.join(names), rounds))
|
||||
return False
|
||||
|
||||
|
||||
def install_system_team_selection(log=print):
|
||||
"""镜牢选队改成"按队伍体系对应的中文名"在列表里点。
|
||||
|
||||
AALC 原生只认 编队#N; 本账号的编队是自定义名字(流血/斩击/...), 原生逻辑永远选不上。
|
||||
"""
|
||||
try:
|
||||
from tasks.mirror import mirror as mirror_mod
|
||||
from module.automation import auto
|
||||
except Exception as e:
|
||||
log('[lc_mcp] 体系选队补丁跳过: 无法导入 %s' % e)
|
||||
return None
|
||||
original = getattr(mirror_mod, 'select_battle_team', None)
|
||||
if original is None:
|
||||
log('[lc_mcp] 体系选队补丁跳过: mirror 模块没有 select_battle_team')
|
||||
return None
|
||||
wanted = {'names': ()}
|
||||
original_init = mirror_mod.Mirror.__init__
|
||||
|
||||
def __init__(self, team_setting, team_num):
|
||||
original_init(self, team_setting, team_num)
|
||||
wanted['names'] = SYSTEM_TEAM_NAMES.get(getattr(self, 'system', ''), ())
|
||||
log('[lc_mcp] 镜牢体系 %s -> 目标编队 %s'
|
||||
% (getattr(self, 'system', '?'), '/'.join(wanted['names']) or '(无配置)'))
|
||||
|
||||
def select_battle_team(num):
|
||||
names = wanted['names']
|
||||
if names:
|
||||
try:
|
||||
if _select_team_by_name(auto, names, log=log):
|
||||
return True
|
||||
except Exception as e:
|
||||
log('[lc_mcp] 按名字选队出错: %s: %s' % (type(e).__name__, e))
|
||||
return False
|
||||
return original(num)
|
||||
|
||||
mirror_mod.Mirror.__init__ = __init__
|
||||
mirror_mod.select_battle_team = select_battle_team
|
||||
log('[lc_mcp] patch: 镜牢按体系名选队')
|
||||
return original
|
||||
|
||||
+10
-2
@@ -12,8 +12,9 @@ import sys
|
||||
from . import preflight
|
||||
from .aalc_engine import bootstrap
|
||||
from . import killswitch
|
||||
from .aalc_patches import (WindowGuard, driver_click_tasks, install_exact_team_match,
|
||||
install_robust_set_foreground)
|
||||
from .aalc_patches import (WindowGuard, driver_click_tasks, install_default_battle_team,
|
||||
install_exact_team_match, install_robust_set_foreground,
|
||||
install_system_team_selection)
|
||||
|
||||
# 任务 -> {参数名: AALC 配置项}; 参数只在本次运行内生效
|
||||
TASKS = {
|
||||
@@ -89,6 +90,13 @@ def run(task, params):
|
||||
|
||||
install_exact_team_match(auto, log)
|
||||
install_robust_set_foreground(screen, log=log)
|
||||
# 日常本(经验/纽本)不翻队伍列表: 队伍是自定义名字时按名字找必然失败,
|
||||
# 白等 60 秒还会把界面滚乱, 后面 to_battle 就找不到 "进入战斗" 了。
|
||||
if task in ('daily', 'all'):
|
||||
install_default_battle_team(scheme, log=log)
|
||||
# 镜牢: 编队是自定义名字(体系名), AALC 只会找 "编队#N"; 改成按体系名点选。
|
||||
if task in ('mirror', 'all'):
|
||||
install_system_team_selection(log=log)
|
||||
guard = WindowGuard(screen, cfg, log=log)
|
||||
guard.start()
|
||||
restore_path = os.environ.get(RESTORE_ENV)
|
||||
|
||||
+66
-3
@@ -106,6 +106,14 @@ class DriverInput:
|
||||
self.log = log
|
||||
self._dll = None
|
||||
self._open = False
|
||||
# 目标窗口句柄。有它才能做句柄级前台校验 —— 几何校验在窗口重叠时没用:
|
||||
# 实测把浏览器切到前台, 点游戏里同一个坐标, 只比矩形的话校验照样通过。
|
||||
self.hwnd = 0
|
||||
|
||||
def bind_window(self, hwnd):
|
||||
"""绑定目标窗口。绑定后 click() 会做句柄级前台校验。"""
|
||||
self.hwnd = int(hwnd or 0)
|
||||
return self
|
||||
|
||||
# ---------------------------------------------------------------- 生命周期
|
||||
|
||||
@@ -184,8 +192,20 @@ class DriverInput:
|
||||
if self.ready:
|
||||
self._dll.mouse_up(int(button))
|
||||
|
||||
def click(self, sx, sy, times=1, tol=1):
|
||||
"""先确认到位置, 再按下抬起。没到位就不点, 免得点错地方。"""
|
||||
def click(self, sx, sy, times=1, tol=1, require_foreground=True,
|
||||
press_ms=60, settle=0.05):
|
||||
"""先确认到位置, 再按下抬起。
|
||||
|
||||
⛔ 三个已验证的"位置对却点不上"原因(2026-10-23 实测):
|
||||
1. **前台不是游戏** —— 点击会送给当前前台窗口。实测: 窗口位置正确、坐标
|
||||
换算正确, 但前台是别的窗口, 结果点了个寂寞, 而旧版这里照样返回 True。
|
||||
现在用 require_foreground 检查: 点击点必须落在**前台窗口的客户区**内,
|
||||
否则拒绝并报错 —— 宁可失败也不要静默点错地方。
|
||||
2. **移动后立刻按下** —— 游戏按帧采样, 移动还没被处理就点击, 会算在旧位置。
|
||||
所以定位成功后先 settle 再按。
|
||||
3. **按下时间太短** —— 默认 30ms 在掉帧时会漏; 改成 60ms。
|
||||
实测 30/60/120ms 在干净环境下都能中, 但 60ms 对负载高的情况更稳。
|
||||
"""
|
||||
if not self.ready:
|
||||
return False
|
||||
if not self.move_to(sx, sy, tol=tol):
|
||||
@@ -193,10 +213,17 @@ class DriverInput:
|
||||
self.log('[driver] 定位失败: 目标(%d,%d) 实际(%d,%d), 不点击'
|
||||
% (sx, sy, cx, cy))
|
||||
return False
|
||||
if require_foreground:
|
||||
ok, why = click_point_is_on_foreground(sx, sy, self.hwnd or None)
|
||||
if not ok:
|
||||
self.log('[driver] 拒绝点击(%d,%d): %s' % (sx, sy, why))
|
||||
return False
|
||||
if settle:
|
||||
time.sleep(settle)
|
||||
for _ in range(int(times)):
|
||||
try:
|
||||
self._dll.mouse_down(1)
|
||||
time.sleep(0.03)
|
||||
time.sleep(press_ms / 1000.0)
|
||||
finally:
|
||||
self._dll.mouse_up(1)
|
||||
return True
|
||||
@@ -214,6 +241,42 @@ class DriverInput:
|
||||
self._dll.scroll(int(amount))
|
||||
|
||||
|
||||
def click_point_is_on_foreground(sx, sy, hwnd=None):
|
||||
"""(屏幕坐标) 是否安全可点。
|
||||
|
||||
返回 (是否安全, 原因)。
|
||||
|
||||
⛔ 为什么必须比对句柄而不是比对矩形(2026-10-23 实测教训):
|
||||
最初只判断"点击点落在前台窗口的矩形内", 结果把浏览器切到前台、点游戏里
|
||||
同一个坐标, 校验**照样通过** —— 因为那个屏幕坐标同时也落在浏览器窗口的
|
||||
矩形里。几何判断在窗口互相重叠时毫无意义。
|
||||
|
||||
所以: 给了 hwnd 就要求前台窗口**就是它**(或是它的子窗口); 没给 hwnd 时
|
||||
退化成"有前台窗口且点在它矩形内", 可用性有限, 仅作兜底。
|
||||
"""
|
||||
user32 = ctypes.windll.user32
|
||||
fg = user32.GetForegroundWindow()
|
||||
if not fg:
|
||||
return False, '当前没有前台窗口(GetForegroundWindow=0)'
|
||||
if hwnd:
|
||||
if fg == hwnd or user32.IsChild(hwnd, fg):
|
||||
return True, 'ok'
|
||||
buf = ctypes.create_unicode_buffer(64)
|
||||
user32.GetWindowTextW(fg, buf, 64)
|
||||
other = ctypes.create_unicode_buffer(64)
|
||||
user32.GetWindowTextW(hwnd, other, 64)
|
||||
return False, ('前台不是目标窗口(前台=%r, 目标=%r) —— 这次点击会打到别的窗口'
|
||||
% (buf.value, other.value))
|
||||
pt = wintypes.POINT(int(sx), int(sy))
|
||||
rect = wintypes.RECT()
|
||||
if not user32.GetWindowRect(fg, ctypes.byref(rect)):
|
||||
return False, '取不到前台窗口的区域'
|
||||
if not (rect.left <= pt.x < rect.right and rect.top <= pt.y < rect.bottom):
|
||||
return False, ('点击点(%d,%d)不在前台窗口内(区域 %d,%d-%d,%d)'
|
||||
% (pt.x, pt.y, rect.left, rect.top, rect.right, rect.bottom))
|
||||
return True, 'ok'
|
||||
|
||||
|
||||
def client_to_screen(hwnd, x, y):
|
||||
"""游戏客户区坐标 -> 屏幕坐标。"""
|
||||
if not hwnd:
|
||||
|
||||
+96
-46
@@ -1,78 +1,128 @@
|
||||
# -*- coding: utf-8 -*-
|
||||
"""全局急停热键。
|
||||
|
||||
为什么需要: 驱动级点击是闭环定位的 —— 手一动,下一次点击前会读到新位置、
|
||||
算出偏差、再把你推回目标点。所以任务运行期间鼠标和人是"拔河"状态,用户没法
|
||||
用鼠标去点停止按钮。键盘不受影响,所以用键盘热键做急停。
|
||||
为什么需要: 驱动级点击是闭环定位的 —— 手一动, 下一次点击前会读到新位置、算出
|
||||
偏差、再把你推回目标点。所以任务运行期间鼠标是"拔河"状态, 用户没法用鼠标去点
|
||||
停止按钮。键盘不受影响, 所以急停必须走键盘。
|
||||
|
||||
⛔ AALC 自带的 pause_hotkey 帮不上忙: 那个配置项只在 GUI(app/farming_interface.py)
|
||||
里注册, lc_mcp 走的是命令行子进程, 那条路径上没有热键监听。
|
||||
⛔ 为什么不用 pynput / 全局钩子(2026-10-22 实测):
|
||||
pynput 的 GlobalHotKeys 在这台机器上**收不到任何键盘事件** —— 静态注册成功、
|
||||
线程也活着, 但 keybd_event 和 SendInput 两种注入都触发不了它。钩子依赖
|
||||
WH_KEYBOARD_LL, 在当前会话下不工作。
|
||||
改用 GetAsyncKeyState 轮询: 不装钩子、不需要消息循环, 实测能正确看到注入的
|
||||
按键。用 0x8000 位判断"当前按下"。
|
||||
|
||||
默认 F12, 可用环境变量 LCP_KILL_KEY 改(取 pynput 的键名, 如 f11 / pause / esc)。
|
||||
按下后直接 os._exit —— 任务本来就是子进程, 硬退出不会留下锁或半截状态,
|
||||
这正是 aalc_task.py 的设计前提("停止 = 杀进程树")。
|
||||
另外 AALC 自带的 pause_hotkey 也帮不上忙: 那个配置项只在 GUI
|
||||
(app/farming_interface.py) 里注册, lc_mcp 走命令行子进程, 那条路径上没有监听。
|
||||
|
||||
默认 End(小键盘区右下角, 好按且不冲突), 可用环境变量 LCP_KILL_KEY 改成 pause / scrolllock / f11 等。
|
||||
⛔ 不要用 F12: 那是 Steam 的截图键(用户 2026-10-22 指出), 按下去会弹 Steam 截图
|
||||
覆盖层, 而且可能被 Steam 抢先消费。Esc / F11 也不合适 —— 游戏里分别是关菜单
|
||||
和切全屏。Pause 没有任何软件抢, 是最稳的选择。
|
||||
按下后直接 os._exit —— 任务本来就是子进程, 硬退出不留锁或半截状态, 这与
|
||||
aalc_task.py "停止 = 杀进程树" 的设计前提一致。监听器活在任务进程内,
|
||||
所以即使 MCP 服务出问题、用户联系不上调用方, 按热键仍然能停。
|
||||
"""
|
||||
import ctypes
|
||||
import os
|
||||
import threading
|
||||
import time
|
||||
|
||||
DEFAULT_KEY = 'f12'
|
||||
EXIT_CODE = 130 # 与 SIGINT 一致, 便于上层识别"被用户中止"
|
||||
DEFAULT_KEY = 'end'
|
||||
EXIT_CODE = 130 # 与 SIGINT 一致, 便于上层识别"被用户中止"
|
||||
POLL_INTERVAL = 0.05 # 50ms 轮询, 人手按一下不会漏
|
||||
|
||||
# 常用键 -> 虚拟键码。f12 保留是为了兼容旧配置, 但**不推荐** —— Steam 占用它。
|
||||
VK = {
|
||||
'f1': 0x70, 'f2': 0x71, 'f3': 0x72, 'f4': 0x73, 'f5': 0x74, 'f6': 0x75,
|
||||
'f7': 0x76, 'f8': 0x77, 'f9': 0x78, 'f10': 0x79, 'f11': 0x7A, 'f12': 0x7B,
|
||||
'esc': 0x1B, 'escape': 0x1B,
|
||||
'pause': 0x13, 'break': 0x13,
|
||||
'end': 0x23, 'home': 0x24, 'delete': 0x2E, 'insert': 0x2D,
|
||||
'scrolllock': 0x91, 'numlock': 0x90, 'capslock': 0x14,
|
||||
}
|
||||
|
||||
|
||||
def _key_spec(name):
|
||||
"""'f12' -> '<f12>',pynput 的 GlobalHotKeys 要求尖括号形式。"""
|
||||
name = (name or DEFAULT_KEY).strip().lower()
|
||||
if name.startswith('<') and name.endswith('>'):
|
||||
return name
|
||||
return '<%s>' % name
|
||||
def resolve_vk(key):
|
||||
"""键名 -> 虚拟键码。认不出返回 None(调用方负责报错, 不要静默用默认值)。"""
|
||||
name = (key or '').strip().lower().strip('<>')
|
||||
if not name:
|
||||
name = DEFAULT_KEY
|
||||
return VK.get(name)
|
||||
|
||||
|
||||
def install(log=print, key=None):
|
||||
"""启动急停监听线程。返回监听器对象(可用于测试), 失败返回 None。
|
||||
def _pressed(vk):
|
||||
"""GetAsyncKeyState 的最高位 = 当前是否按下。"""
|
||||
return bool(ctypes.windll.user32.GetAsyncKeyState(vk) & 0x8000)
|
||||
|
||||
任何异常都不向外抛 —— 急停装不上不该让任务起不来, 但必须把原因说清楚。
|
||||
"""
|
||||
key = key or os.environ.get('LCP_KILL_KEY') or DEFAULT_KEY
|
||||
spec = _key_spec(key)
|
||||
|
||||
try:
|
||||
from pynput import keyboard
|
||||
except Exception as e: # pynput 缺失/无显示环境
|
||||
log('[lc_mcp] 急停热键不可用(pynput 加载失败: %s: %s), 请用 Ctrl+Alt+Del 强制停止'
|
||||
% (type(e).__name__, e))
|
||||
return None
|
||||
class KillSwitch:
|
||||
"""轮询线程。按住热键会立刻退出, 不会重复触发。"""
|
||||
|
||||
state = {'fired': False}
|
||||
def __init__(self, vk, log=print, key_name=DEFAULT_KEY):
|
||||
self.vk = vk
|
||||
self.log = log
|
||||
self.key_name = key_name
|
||||
self.fired = False
|
||||
self._stopped = threading.Event()
|
||||
self._thread = threading.Thread(target=self._run, daemon=True,
|
||||
name='lc_mcp-killswitch')
|
||||
|
||||
def on_activate():
|
||||
if state['fired']:
|
||||
def start(self):
|
||||
self._thread.start()
|
||||
return self
|
||||
|
||||
def is_alive(self):
|
||||
return self._thread.is_alive()
|
||||
|
||||
def stop(self):
|
||||
self._stopped.set()
|
||||
|
||||
def _run(self):
|
||||
# 先等一会儿, 避免把启动时按住的键当成急停
|
||||
time.sleep(0.3)
|
||||
while not self._stopped.is_set():
|
||||
if _pressed(self.vk):
|
||||
self._fire()
|
||||
return
|
||||
time.sleep(POLL_INTERVAL)
|
||||
|
||||
def _fire(self):
|
||||
if self.fired:
|
||||
return
|
||||
state['fired'] = True
|
||||
log('[lc_mcp] ⛔ 急停热键 %s 被按下, 立即终止任务' % key.upper())
|
||||
self.fired = True
|
||||
try:
|
||||
log('[lc_mcp] 游戏窗口会保留, 可用 run_task 重新开始')
|
||||
self.log('[lc_mcp] ⛔ 急停热键 %s 被按下, 立即终止任务'
|
||||
% self.key_name.upper())
|
||||
self.log('[lc_mcp] 游戏窗口会保留, 可用 run_task 重新开始')
|
||||
finally:
|
||||
os._exit(EXIT_CODE)
|
||||
|
||||
|
||||
def install(log=print, key=None):
|
||||
"""启动急停轮询线程。返回 KillSwitch, 失败返回 None(不抛异常)。"""
|
||||
key = key or os.environ.get('LCP_KILL_KEY') or DEFAULT_KEY
|
||||
vk = resolve_vk(key)
|
||||
if vk is None:
|
||||
log('[lc_mcp] 急停热键不可用: 认不出键名 %r(可用: %s), 请用 Ctrl+Alt+Del 强制停止'
|
||||
% (key, ', '.join(sorted(VK))))
|
||||
return None
|
||||
try:
|
||||
listener = keyboard.GlobalHotKeys({spec: on_activate})
|
||||
listener.daemon = True
|
||||
listener.start()
|
||||
switch = KillSwitch(vk, log=log, key_name=key).start()
|
||||
except Exception as e:
|
||||
log('[lc_mcp] 急停热键注册失败(%s: %s), 请用 Ctrl+Alt+Del 强制停止'
|
||||
log('[lc_mcp] 急停热键启动失败(%s: %s), 请用 Ctrl+Alt+Del 强制停止'
|
||||
% (type(e).__name__, e))
|
||||
return None
|
||||
|
||||
log('[lc_mcp] 急停热键已就绪: 按 %s 立即停止任务(键盘可用, 不需要鼠标)' % key.upper())
|
||||
listener._lc_state = state
|
||||
return listener
|
||||
log('[lc_mcp] 急停热键已就绪: 按 %s 立即停止任务(键盘可用, 不需要鼠标, '
|
||||
'也不依赖 MCP 服务)' % key.upper())
|
||||
return switch
|
||||
|
||||
|
||||
def stop(listener):
|
||||
"""停止监听(任务正常结束时调用, 免得线程残留)。"""
|
||||
if listener is None:
|
||||
def stop(switch):
|
||||
"""停止轮询(任务正常结束时调用)。"""
|
||||
if switch is None:
|
||||
return
|
||||
try:
|
||||
listener.stop()
|
||||
switch.stop()
|
||||
except Exception:
|
||||
pass
|
||||
|
||||
+165
-3
@@ -132,7 +132,8 @@ class ClickTest(unittest.TestCase):
|
||||
{'v': (pos['v'][0] + dx, pos['v'][1] + dy)})
|
||||
with mock.patch.object(di, 'get_cursor', lambda: pos['v']), \
|
||||
mock.patch.object(di.time, 'sleep', lambda s: None):
|
||||
self.assertTrue(d.click(500, 400))
|
||||
# 这里只测定位逻辑, 前台校验另有 ForegroundCheckTest
|
||||
self.assertTrue(d.click(500, 400, require_foreground=False))
|
||||
self.assertEqual(pos['v'], (500, 400))
|
||||
d._dll.mouse_down.assert_called_once_with(1)
|
||||
d._dll.mouse_up.assert_called_once_with(1)
|
||||
@@ -141,7 +142,7 @@ class ClickTest(unittest.TestCase):
|
||||
d = self._drv(False)
|
||||
with mock.patch.object(di, 'get_cursor', lambda: (0, 0)), \
|
||||
mock.patch.object(di.time, 'sleep', lambda s: None):
|
||||
self.assertFalse(d.click(500, 400))
|
||||
self.assertFalse(d.click(500, 400, require_foreground=False))
|
||||
d._dll.mouse_down.assert_not_called()
|
||||
d._dll.mouse_up.assert_not_called()
|
||||
|
||||
@@ -353,9 +354,12 @@ class DriverFailureTest(unittest.TestCase):
|
||||
drv = di.DriverInput()
|
||||
drv._open, drv._dll = True, mock.Mock()
|
||||
with mock.patch.object(drv, 'move_to', return_value=True), \
|
||||
mock.patch.object(di, 'click_point_is_on_foreground',
|
||||
lambda *a, **k: (True, '')), \
|
||||
mock.patch.object(di.time, 'sleep', side_effect=InterruptedError):
|
||||
with self.assertRaises(InterruptedError):
|
||||
drv.click(1, 2)
|
||||
# settle=0 让第一个 sleep 出现在按下之后, 测的才是 try/finally
|
||||
drv.click(1, 2, require_foreground=False, settle=0)
|
||||
drv._dll.mouse_up.assert_called_once_with(1)
|
||||
|
||||
def test_release_even_if_coordinate_lookup_fails(self):
|
||||
@@ -435,3 +439,161 @@ class ForegroundFallbackTest(unittest.TestCase):
|
||||
|
||||
if __name__ == '__main__':
|
||||
unittest.main()
|
||||
|
||||
|
||||
class ForegroundCheckTest(unittest.TestCase):
|
||||
"""位置对却点不上 —— 头号原因是前台不是游戏。
|
||||
|
||||
2026-10-23 实测: 窗口位置和坐标换算都正确, 但前台是浏览器, 点击全部落到
|
||||
浏览器里, 而旧版 click() 照样返回 True。这组测试守住"必须拒绝"这一条。
|
||||
"""
|
||||
|
||||
def _drv(self):
|
||||
d = di.DriverInput(dll_path='X.dll', log=lambda m: None)
|
||||
d._dll = mock.Mock()
|
||||
d._open = True
|
||||
return d
|
||||
|
||||
def test_rejects_when_no_foreground_window(self):
|
||||
with mock.patch.object(di.ctypes.windll.user32, 'GetForegroundWindow',
|
||||
return_value=0):
|
||||
ok, why = di.click_point_is_on_foreground(100, 100)
|
||||
self.assertFalse(ok)
|
||||
self.assertIn('前台窗口', why)
|
||||
|
||||
def test_rejects_when_point_outside_foreground_window(self):
|
||||
def fake_get_window_rect(hwnd, ptr):
|
||||
r = ptr._obj
|
||||
r.left, r.top, r.right, r.bottom = 0, 0, 50, 50
|
||||
return 1
|
||||
|
||||
with mock.patch.object(di.ctypes.windll.user32, 'GetForegroundWindow',
|
||||
return_value=12345), \
|
||||
mock.patch.object(di.ctypes.windll.user32, 'GetWindowRect',
|
||||
fake_get_window_rect), \
|
||||
mock.patch.object(di.ctypes.windll.user32, 'GetWindowTextW'):
|
||||
ok, why = di.click_point_is_on_foreground(999, 999)
|
||||
self.assertFalse(ok)
|
||||
self.assertIn('不在前台窗口内', why)
|
||||
|
||||
def test_accepts_when_point_inside_foreground_window(self):
|
||||
def fake_get_window_rect(hwnd, ptr):
|
||||
r = ptr._obj
|
||||
r.left, r.top, r.right, r.bottom = 0, 0, 1920, 1080
|
||||
return 1
|
||||
|
||||
with mock.patch.object(di.ctypes.windll.user32, 'GetForegroundWindow',
|
||||
return_value=12345), \
|
||||
mock.patch.object(di.ctypes.windll.user32, 'GetWindowRect',
|
||||
fake_get_window_rect):
|
||||
ok, why = di.click_point_is_on_foreground(500, 500)
|
||||
self.assertTrue(ok)
|
||||
self.assertEqual(why, 'ok')
|
||||
|
||||
def test_click_refuses_when_check_fails(self):
|
||||
"""校验不过 -> 一个按键都不许发。"""
|
||||
pos = {'v': (500, 400)}
|
||||
d = self._drv()
|
||||
d._dll.moveR.side_effect = lambda dx, dy, _: None
|
||||
with mock.patch.object(di, 'get_cursor', lambda: pos['v']), \
|
||||
mock.patch.object(di.time, 'sleep', lambda s: None), \
|
||||
mock.patch.object(di, 'click_point_is_on_foreground',
|
||||
lambda *a, **k: (False, '')):
|
||||
self.assertFalse(d.click(500, 400))
|
||||
d._dll.mouse_down.assert_not_called()
|
||||
d._dll.mouse_up.assert_not_called()
|
||||
|
||||
def test_click_proceeds_when_check_passes(self):
|
||||
pos = {'v': (500, 400)}
|
||||
d = self._drv()
|
||||
with mock.patch.object(di, 'get_cursor', lambda: pos['v']), \
|
||||
mock.patch.object(di.time, 'sleep', lambda s: None), \
|
||||
mock.patch.object(di, 'click_point_is_on_foreground',
|
||||
lambda *a, **k: (True, '')):
|
||||
self.assertTrue(d.click(500, 400))
|
||||
d._dll.mouse_down.assert_called_once_with(1)
|
||||
d._dll.mouse_up.assert_called_once_with(1)
|
||||
|
||||
def test_press_duration_is_passed_through(self):
|
||||
"""按下时长必须真的用上 —— 30ms 在掉帧时会漏点。"""
|
||||
pos = {'v': (500, 400)}
|
||||
d = self._drv()
|
||||
slept = []
|
||||
with mock.patch.object(di, 'get_cursor', lambda: pos['v']), \
|
||||
mock.patch.object(di.time, 'sleep', lambda s: slept.append(s)), \
|
||||
mock.patch.object(di, 'click_point_is_on_foreground',
|
||||
lambda *a, **k: (True, '')):
|
||||
d.click(500, 400, press_ms=120, settle=0)
|
||||
self.assertIn(0.12, slept, '按下时长没生效')
|
||||
|
||||
def test_settle_delay_happens_before_press(self):
|
||||
"""定位成功到按下之间要有间隔, 否则游戏把这次点击算在旧位置。"""
|
||||
pos = {'v': (500, 400)}
|
||||
d = self._drv()
|
||||
order = []
|
||||
d._dll.mouse_down.side_effect = lambda b: order.append('down')
|
||||
with mock.patch.object(di, 'get_cursor', lambda: pos['v']), \
|
||||
mock.patch.object(di, 'click_point_is_on_foreground',
|
||||
lambda *a, **k: (True, '')), \
|
||||
mock.patch.object(di.time, 'sleep',
|
||||
lambda s: order.append('sleep%.2f' % s)):
|
||||
d.click(500, 400, settle=0.08)
|
||||
self.assertIn('down', order)
|
||||
self.assertTrue(any(x.startswith('sleep') for x in order[:order.index('down')]),
|
||||
'按下之前必须有 sleep')
|
||||
|
||||
class HwndForegroundCheckTest(unittest.TestCase):
|
||||
"""句柄级前台校验。
|
||||
|
||||
⛔ 为什么不能只比矩形(2026-10-23 实测): 把浏览器切到前台, 点游戏里同一个
|
||||
坐标, 只判断"点在不在前台窗口矩形内"的话**照样通过** —— 因为那个屏幕坐标
|
||||
同时也落在浏览器窗口的矩形里。窗口重叠时几何判断毫无意义。
|
||||
|
||||
给了 hwnd 就必须要求前台窗口就是它。
|
||||
"""
|
||||
|
||||
def test_accepts_when_foreground_is_the_target(self):
|
||||
with mock.patch.object(di.ctypes.windll.user32, 'GetForegroundWindow',
|
||||
return_value=999):
|
||||
ok, why = di.click_point_is_on_foreground(100, 100, 999)
|
||||
self.assertTrue(ok)
|
||||
self.assertEqual(why, 'ok')
|
||||
|
||||
def test_accepts_child_window_of_target(self):
|
||||
"""游戏可能有子窗口拿到焦点, 也算在目标窗口上。"""
|
||||
with mock.patch.object(di.ctypes.windll.user32, 'GetForegroundWindow',
|
||||
return_value=1000), \
|
||||
mock.patch.object(di.ctypes.windll.user32, 'IsChild',
|
||||
return_value=True):
|
||||
ok, _ = di.click_point_is_on_foreground(100, 100, 999)
|
||||
self.assertTrue(ok)
|
||||
|
||||
def test_rejects_when_foreground_is_another_window(self):
|
||||
with mock.patch.object(di.ctypes.windll.user32, 'GetForegroundWindow',
|
||||
return_value=1000), \
|
||||
mock.patch.object(di.ctypes.windll.user32, 'IsChild',
|
||||
return_value=False), \
|
||||
mock.patch.object(di.ctypes.windll.user32, 'GetWindowTextW'):
|
||||
ok, why = di.click_point_is_on_foreground(100, 100, 999)
|
||||
self.assertFalse(ok)
|
||||
self.assertIn('前台不是目标窗口', why)
|
||||
|
||||
def test_bind_window_is_used_by_click(self):
|
||||
"""绑定窗口后, click() 必须走句柄级校验。"""
|
||||
d = di.DriverInput(dll_path='X.dll', log=lambda m: None)
|
||||
d._dll = mock.Mock()
|
||||
d._open = True
|
||||
d.bind_window(4242)
|
||||
self.assertEqual(d.hwnd, 4242)
|
||||
seen = {}
|
||||
|
||||
def fake_check(sx, sy, hwnd=None):
|
||||
seen['hwnd'] = hwnd
|
||||
return False, '前台不是目标窗口'
|
||||
|
||||
with mock.patch.object(di, 'get_cursor', lambda: (10, 10)), \
|
||||
mock.patch.object(di, 'click_point_is_on_foreground', fake_check), \
|
||||
mock.patch.object(di.time, 'sleep', lambda s: None):
|
||||
self.assertFalse(d.click(10, 10))
|
||||
self.assertEqual(seen['hwnd'], 4242, 'click 没把绑定的句柄传下去')
|
||||
d._dll.mouse_down.assert_not_called()
|
||||
+85
-74
@@ -7,10 +7,10 @@
|
||||
目标点。所以任务跑起来时鼠标是"拔河"状态, 用户没法用鼠标去点停止按钮。键盘不受
|
||||
影响, 所以急停必须走键盘。
|
||||
|
||||
AALC 自带的 pause_hotkey 帮不上忙: 那个配置项只在 GUI(app/farming_interface.py)
|
||||
里注册, lc_mcp 走命令行子进程, 那条路径上没有热键监听。这是本模块存在的原因。
|
||||
实现上踩过一个坑: 先用了 pynput 的 GlobalHotKeys, 静态注册成功、线程也活着, 但
|
||||
keybd_event 和 SendInput 两种注入都触发不了它 —— 钩子在当前会话下收不到键。
|
||||
改成 GetAsyncKeyState 轮询后实测可用。这里的测试守住轮询方案的几个关键性质。
|
||||
"""
|
||||
import os
|
||||
import sys
|
||||
import unittest
|
||||
from pathlib import Path
|
||||
@@ -20,110 +20,121 @@ sys.path.insert(0, str(Path(__file__).resolve().parents[1]))
|
||||
from lc_mcp import killswitch # noqa: E402
|
||||
|
||||
|
||||
class KeySpecTest(unittest.TestCase):
|
||||
class ResolveVkTest(unittest.TestCase):
|
||||
"""键名解析必须严格: 认不出来要返回 None, 不能悄悄用默认值 ——
|
||||
否则用户以为设成了 F11, 实际还在监听 F12。"""
|
||||
|
||||
def test_wraps_plain_name(self):
|
||||
self.assertEqual(killswitch._key_spec('f12'), '<f12>')
|
||||
def test_common_keys(self):
|
||||
self.assertEqual(killswitch.resolve_vk('f12'), 0x7B)
|
||||
self.assertEqual(killswitch.resolve_vk('F11'), 0x7A)
|
||||
self.assertEqual(killswitch.resolve_vk('esc'), 0x1B)
|
||||
self.assertEqual(killswitch.resolve_vk('pause'), 0x13)
|
||||
|
||||
def test_keeps_already_wrapped(self):
|
||||
self.assertEqual(killswitch._key_spec('<f11>'), '<f11>')
|
||||
def test_accepts_angle_brackets(self):
|
||||
self.assertEqual(killswitch.resolve_vk('<f12>'), 0x7B)
|
||||
|
||||
def test_lowercases_and_trims(self):
|
||||
self.assertEqual(killswitch._key_spec(' F12 '), '<f12>')
|
||||
def test_trims_whitespace(self):
|
||||
self.assertEqual(killswitch.resolve_vk(' F12 '), 0x7B)
|
||||
|
||||
def test_empty_falls_back_to_default(self):
|
||||
self.assertEqual(killswitch._key_spec(''), '<f12>')
|
||||
self.assertEqual(killswitch._key_spec(None), '<f12>')
|
||||
def test_empty_uses_default(self):
|
||||
self.assertEqual(killswitch.resolve_vk(''), killswitch.VK[killswitch.DEFAULT_KEY])
|
||||
self.assertEqual(killswitch.resolve_vk(None), killswitch.VK[killswitch.DEFAULT_KEY])
|
||||
|
||||
def test_unknown_returns_none(self):
|
||||
self.assertIsNone(killswitch.resolve_vk('nosuchkey'))
|
||||
|
||||
|
||||
class InstallTest(unittest.TestCase):
|
||||
"""装不上不能把任务带崩,但必须说清楚怎么应急。"""
|
||||
|
||||
def test_reports_when_pynput_is_missing(self):
|
||||
def test_reports_unknown_key_and_suggests_fallback(self):
|
||||
lines = []
|
||||
with mock.patch.dict(sys.modules, {'pynput': None}):
|
||||
got = killswitch.install(log=lines.append, key='f12')
|
||||
got = killswitch.install(log=lines.append, key='nosuchkey')
|
||||
self.assertIsNone(got)
|
||||
joined = '\n'.join(lines)
|
||||
self.assertIn('急停热键不可用', joined)
|
||||
self.assertIn('认不出键名', joined)
|
||||
self.assertIn('Ctrl+Alt+Del', joined, '必须给出应急手段')
|
||||
|
||||
def test_registers_the_configured_key(self):
|
||||
listener = mock.Mock()
|
||||
listener.daemon = False
|
||||
fake_keyboard = mock.Mock()
|
||||
fake_keyboard.GlobalHotKeys.return_value = listener
|
||||
with mock.patch.dict(sys.modules, {'pynput': mock.Mock(keyboard=fake_keyboard),
|
||||
'pynput.keyboard': fake_keyboard}):
|
||||
got = killswitch.install(log=lambda m: None, key='f11')
|
||||
self.assertIs(got, listener)
|
||||
fake_keyboard.GlobalHotKeys.assert_called_once()
|
||||
self.assertIn('<f11>', fake_keyboard.GlobalHotKeys.call_args[0][0])
|
||||
listener.start.assert_called_once()
|
||||
self.assertTrue(listener.daemon)
|
||||
def test_installs_and_logs_the_key(self):
|
||||
lines = []
|
||||
with mock.patch.object(killswitch.KillSwitch, 'start', lambda self: self):
|
||||
switch = killswitch.install(log=lines.append, key='f11')
|
||||
self.assertIsInstance(switch, killswitch.KillSwitch)
|
||||
self.assertEqual(switch.vk, 0x7A)
|
||||
self.assertIn('F11', '\n'.join(lines))
|
||||
|
||||
def test_env_var_overrides_default_key(self):
|
||||
listener = mock.Mock()
|
||||
fake_keyboard = mock.Mock()
|
||||
fake_keyboard.GlobalHotKeys.return_value = listener
|
||||
with mock.patch.dict(os.environ, {'LCP_KILL_KEY': 'pause'}), \
|
||||
mock.patch.dict(sys.modules, {'pynput': mock.Mock(keyboard=fake_keyboard),
|
||||
'pynput.keyboard': fake_keyboard}):
|
||||
killswitch.install(log=lambda m: None)
|
||||
self.assertIn('<pause>', fake_keyboard.GlobalHotKeys.call_args[0][0])
|
||||
def test_env_var_overrides_default(self):
|
||||
with mock.patch.dict(killswitch.os.environ, {'LCP_KILL_KEY': 'esc'}), \
|
||||
mock.patch.object(killswitch.KillSwitch, 'start', lambda self: self):
|
||||
switch = killswitch.install(log=lambda m: None)
|
||||
self.assertEqual(switch.vk, 0x1B)
|
||||
|
||||
def test_start_failure_is_reported_not_raised(self):
|
||||
lines = []
|
||||
with mock.patch.object(killswitch.KillSwitch, 'start',
|
||||
side_effect=RuntimeError('boom')):
|
||||
got = killswitch.install(log=lines.append)
|
||||
self.assertIsNone(got)
|
||||
self.assertIn('启动失败', '\n'.join(lines))
|
||||
|
||||
|
||||
class ActivateTest(unittest.TestCase):
|
||||
"""按下热键必须真的退出进程,而且只退一次。"""
|
||||
class PollingTest(unittest.TestCase):
|
||||
"""轮询判断的核心:0x8000 位。测错位会导致"一直触发"或"永不触发"。"""
|
||||
|
||||
def _grab_handler(self):
|
||||
listener = mock.Mock()
|
||||
fake_keyboard = mock.Mock()
|
||||
fake_keyboard.GlobalHotKeys.return_value = listener
|
||||
with mock.patch.dict(sys.modules, {'pynput': mock.Mock(keyboard=fake_keyboard),
|
||||
'pynput.keyboard': fake_keyboard}):
|
||||
killswitch.install(log=lambda m: None)
|
||||
bindings = fake_keyboard.GlobalHotKeys.call_args[0][0]
|
||||
return list(bindings.values())[0], listener
|
||||
def test_high_bit_means_pressed(self):
|
||||
with mock.patch.object(killswitch.ctypes.windll.user32, 'GetAsyncKeyState',
|
||||
return_value=0x8000):
|
||||
self.assertTrue(killswitch._pressed(0x7B))
|
||||
|
||||
def test_low_bits_are_not_pressed(self):
|
||||
# 0x0001 表示"上次调用后被按过", 不代表当前按住 —— 不能当成按下
|
||||
with mock.patch.object(killswitch.ctypes.windll.user32, 'GetAsyncKeyState',
|
||||
return_value=0x0001):
|
||||
self.assertFalse(killswitch._pressed(0x7B))
|
||||
|
||||
def test_zero_is_not_pressed(self):
|
||||
with mock.patch.object(killswitch.ctypes.windll.user32, 'GetAsyncKeyState',
|
||||
return_value=0):
|
||||
self.assertFalse(killswitch._pressed(0x7B))
|
||||
|
||||
|
||||
class FireTest(unittest.TestCase):
|
||||
|
||||
def _switch(self):
|
||||
return killswitch.KillSwitch(0x7B, log=lambda m: None, key_name='f12')
|
||||
|
||||
def test_exits_with_user_abort_code(self):
|
||||
handler, _ = self._grab_handler()
|
||||
sw = self._switch()
|
||||
with mock.patch.object(killswitch.os, '_exit') as fake_exit:
|
||||
handler()
|
||||
sw._fire()
|
||||
fake_exit.assert_called_once_with(killswitch.EXIT_CODE)
|
||||
|
||||
def test_only_fires_once(self):
|
||||
handler, _ = self._grab_handler()
|
||||
sw = self._switch()
|
||||
with mock.patch.object(killswitch.os, '_exit') as fake_exit:
|
||||
handler()
|
||||
handler()
|
||||
handler()
|
||||
self.assertEqual(fake_exit.call_count, 1, '重复按下不该重复退出')
|
||||
sw._fire()
|
||||
sw._fire()
|
||||
sw._fire()
|
||||
self.assertEqual(fake_exit.call_count, 1, '重复触发不该重复退出')
|
||||
|
||||
def test_logs_that_game_stays_alive(self):
|
||||
handler, _ = self._grab_handler()
|
||||
def test_logs_that_game_is_kept(self):
|
||||
lines = []
|
||||
sw = killswitch.KillSwitch(0x7B, log=lines.append, key_name='f12')
|
||||
with mock.patch.object(killswitch.os, '_exit'):
|
||||
handler.__closure__ # 确认是闭包
|
||||
killswitch.install(log=lines.append)
|
||||
# 用新的 logger 重新装一次才拿得到日志,这里只验证消息文案存在
|
||||
self.assertTrue(callable(handler))
|
||||
sw._fire()
|
||||
joined = '\n'.join(lines)
|
||||
self.assertIn('F12', joined)
|
||||
self.assertIn('重新开始', joined)
|
||||
|
||||
|
||||
class StopTest(unittest.TestCase):
|
||||
|
||||
def test_stop_is_safe_on_none(self):
|
||||
killswitch.stop(None) # 不该抛
|
||||
killswitch.stop(None)
|
||||
|
||||
def test_stop_calls_listener(self):
|
||||
listener = mock.Mock()
|
||||
killswitch.stop(listener)
|
||||
listener.stop.assert_called_once()
|
||||
|
||||
def test_stop_swallows_listener_errors(self):
|
||||
listener = mock.Mock()
|
||||
listener.stop.side_effect = RuntimeError('boom')
|
||||
killswitch.stop(listener) # 不该抛
|
||||
def test_stop_swallows_errors(self):
|
||||
sw = mock.Mock()
|
||||
sw.stop.side_effect = RuntimeError('boom')
|
||||
killswitch.stop(sw)
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
|
||||
@@ -0,0 +1,168 @@
|
||||
import os
|
||||
import sys
|
||||
import types
|
||||
import unittest
|
||||
from unittest import mock
|
||||
|
||||
sys.path.insert(0, os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
|
||||
from lc_mcp import aalc_patches # noqa: E402
|
||||
|
||||
|
||||
class SystemTeamNamesTest(unittest.TestCase):
|
||||
|
||||
def test_all_ten_systems_are_mapped(self):
|
||||
expected = {'burn', 'bleed', 'tremor', 'rupture', 'poise',
|
||||
'sinking', 'charge', 'slash', 'pierce', 'blunt'}
|
||||
self.assertEqual(set(aalc_patches.SYSTEM_TEAM_NAMES), expected)
|
||||
|
||||
def test_names_are_non_empty_strings(self):
|
||||
for system, names in aalc_patches.SYSTEM_TEAM_NAMES.items():
|
||||
self.assertIsInstance(names, tuple, system)
|
||||
self.assertTrue(names, system)
|
||||
for name in names:
|
||||
self.assertIsInstance(name, str)
|
||||
self.assertTrue(name.strip(), system)
|
||||
|
||||
def test_poise_accepts_both_spellings(self):
|
||||
# 游戏里叫「呼吸法」, system_cn_zh 里叫「呼吸」, 两个都要能命中
|
||||
self.assertIn('呼吸法', aalc_patches.SYSTEM_TEAM_NAMES['poise'])
|
||||
self.assertIn('呼吸', aalc_patches.SYSTEM_TEAM_NAMES['poise'])
|
||||
|
||||
|
||||
class RegionTest(unittest.TestCase):
|
||||
|
||||
def test_team_list_region(self):
|
||||
self.assertTrue(aalc_patches._in_list(130, 493)) # 实测「流血」的位置
|
||||
self.assertTrue(aalc_patches._in_list(255, 305))
|
||||
self.assertFalse(aalc_patches._in_list(130, 120)) # 顶栏不算列表
|
||||
self.assertFalse(aalc_patches._in_list(600, 493)) # 右侧面板
|
||||
self.assertFalse(aalc_patches._in_list(130, 700))
|
||||
|
||||
def test_header_region(self):
|
||||
self.assertTrue(aalc_patches._in_header(242, 125)) # 实测顶栏「流血」
|
||||
self.assertFalse(aalc_patches._in_header(130, 493))
|
||||
self.assertFalse(aalc_patches._in_header(900, 125))
|
||||
|
||||
def test_regions_do_not_overlap(self):
|
||||
for x, y in [(130, 493), (242, 125), (600, 300), (1200, 600)]:
|
||||
self.assertFalse(
|
||||
aalc_patches._in_list(x, y) and aalc_patches._in_header(x, y),
|
||||
(x, y),
|
||||
)
|
||||
|
||||
|
||||
class TeamOcrTest(unittest.TestCase):
|
||||
|
||||
def test_returns_list_and_strips_spaces(self):
|
||||
auto = mock.Mock()
|
||||
auto._run_ocr_for_text.return_value = {
|
||||
'编队#20': [132.0, 340.5],
|
||||
' 流血 ': [130.5, 493.0],
|
||||
'': [0, 0],
|
||||
}
|
||||
items = aalc_patches._team_ocr(auto)
|
||||
self.assertIn(('编队#20', 132.0, 340.5), items)
|
||||
self.assertIn(('流血', 130.5, 493.0), items)
|
||||
self.assertEqual(len(items), 2) # 空串被丢掉
|
||||
|
||||
def test_empty_ocr_gives_empty_list(self):
|
||||
auto = mock.Mock()
|
||||
auto._run_ocr_for_text.return_value = {}
|
||||
self.assertEqual(aalc_patches._team_ocr(auto), [])
|
||||
|
||||
def test_bad_position_is_skipped_not_fatal(self):
|
||||
auto = mock.Mock()
|
||||
auto._run_ocr_for_text.return_value = {'流血': [], '斩击': [1.0, 2.0]}
|
||||
self.assertEqual(aalc_patches._team_ocr(auto), [('斩击', 1.0, 2.0)])
|
||||
|
||||
|
||||
class _FakeMirror:
|
||||
def __init__(self, team_setting, team_num):
|
||||
self.system = team_setting['system']
|
||||
self.team_number = team_num
|
||||
|
||||
|
||||
class InstallSystemTeamSelectionTest(unittest.TestCase):
|
||||
"""用假模块验证挂载点与回退行为, 不依赖 AALC / Windows。"""
|
||||
|
||||
def setUp(self):
|
||||
self.calls = []
|
||||
|
||||
def original(num):
|
||||
self.calls.append(num)
|
||||
return 'fallback'
|
||||
|
||||
self.original = original
|
||||
self.mirror_mod = types.ModuleType('tasks.mirror.mirror')
|
||||
self.mirror_mod.Mirror = _FakeMirror
|
||||
self.mirror_mod.select_battle_team = original
|
||||
|
||||
self.auto = mock.Mock()
|
||||
auto_mod = types.ModuleType('module.automation')
|
||||
auto_mod.auto = self.auto
|
||||
|
||||
tasks_pkg = types.ModuleType('tasks')
|
||||
tasks_pkg.__path__ = []
|
||||
mirror_pkg = types.ModuleType('tasks.mirror')
|
||||
mirror_pkg.__path__ = []
|
||||
mirror_pkg.mirror = self.mirror_mod
|
||||
module_pkg = types.ModuleType('module')
|
||||
module_pkg.__path__ = []
|
||||
|
||||
self._patcher = mock.patch.dict(sys.modules, {
|
||||
'tasks': tasks_pkg,
|
||||
'tasks.mirror': mirror_pkg,
|
||||
'tasks.mirror.mirror': self.mirror_mod,
|
||||
'module': module_pkg,
|
||||
'module.automation': auto_mod,
|
||||
})
|
||||
self._patcher.start()
|
||||
self.addCleanup(self._patcher.stop)
|
||||
|
||||
def install(self):
|
||||
return aalc_patches.install_system_team_selection(log=lambda *_: None)
|
||||
|
||||
def test_returns_original_and_replaces_module_global(self):
|
||||
original = self.install()
|
||||
self.assertIs(original, self.original)
|
||||
self.assertIsNot(self.mirror_mod.select_battle_team, self.original)
|
||||
# __init__ 也被包装, 但仍然正常构造
|
||||
mirror = self.mirror_mod.Mirror({'system': 'bleed'}, 1)
|
||||
self.assertEqual(mirror.system, 'bleed')
|
||||
|
||||
def test_known_system_uses_name_search(self):
|
||||
self.install()
|
||||
self.mirror_mod.Mirror({'system': 'bleed'}, 1)
|
||||
with mock.patch.object(aalc_patches, '_select_team_by_name', return_value=True) as sel:
|
||||
self.assertIs(self.mirror_mod.select_battle_team(1), True)
|
||||
self.assertEqual(sel.call_args[0][1], ('流血',))
|
||||
self.assertEqual(self.calls, []) # 成功后不再走编号回退
|
||||
|
||||
def test_name_search_failure_does_not_fall_back_to_number(self):
|
||||
# 这号没有 编队#1, 静默回退到编号会选中错的队, 必须显式失败
|
||||
self.install()
|
||||
self.mirror_mod.Mirror({'system': 'bleed'}, 1)
|
||||
with mock.patch.object(aalc_patches, '_select_team_by_name', return_value=False):
|
||||
self.assertIs(self.mirror_mod.select_battle_team(1), False)
|
||||
self.assertEqual(self.calls, [])
|
||||
|
||||
def test_exception_in_name_search_is_contained(self):
|
||||
self.install()
|
||||
self.mirror_mod.Mirror({'system': 'bleed'}, 1)
|
||||
boom = mock.Mock(side_effect=RuntimeError('ocr down'))
|
||||
with mock.patch.object(aalc_patches, '_select_team_by_name', boom):
|
||||
self.assertIs(self.mirror_mod.select_battle_team(1), False)
|
||||
|
||||
def test_unknown_system_falls_back_to_original(self):
|
||||
self.install()
|
||||
self.mirror_mod.Mirror({'system': 'unknown_system'}, 3)
|
||||
self.assertEqual(self.mirror_mod.select_battle_team(3), 'fallback')
|
||||
self.assertEqual(self.calls, [3])
|
||||
|
||||
def test_missing_mirror_module_is_not_fatal(self):
|
||||
with mock.patch.dict(sys.modules, {'tasks.mirror': None, 'tasks.mirror.mirror': None}):
|
||||
self.assertIsNone(self.install())
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
unittest.main()
|
||||
Reference in New Issue
Block a user