镜牢选队改为按体系名点选;补交接文档、待开发计划与单测

Browse Source
本机账号的编队按体系命名(流血/斩击/突刺/…),AALC 只认 编队#N,导致镜牢永远
报「无法寻得队伍」。新增 install_system_team_selection:按 team_system 映射的
中文队名在列表里精确匹配并点选,点完用顶栏队名确认;失败显式返回 False,
不静默回退到编号(该账号没有 编队#1~#12)。

- lc_mcp/aalc_patches.py: 新增选队补丁与区域/OCR 辅助
- lc_mcp/aalc_task.py: mirror/all 任务挂载该补丁
- tests/test_system_team_selection.py: 15 个用例,不依赖 AALC/Windows
- docs/feedback/2026-11-14/: 实测记录 + 云端开发交接文件(含体系队名表)
- docs/BACKLOG.md: 待开发计划(商店清单路径 bug、走位降级、三选一按体系等)

单测:460 passed。
This commit is contained in:
Codex Agent
2026-11-14 10:22:35 +08:00
parent 58cd78cd9c
commit c4a42bcfaf
6 changed files with 888 additions and 2 deletions
+189
View File
@@ -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 的稳定性没验(当初开它就是为躲鼠标拖地图卡死)。