From c4a42bcfafbe60fb8ea39fa84c60fea1f7659bd7 Mon Sep 17 00:00:00 2001 From: Codex Agent Date: Sat, 14 Nov 2026 10:22:35 +0800 Subject: [PATCH] =?UTF-8?q?=E9=95=9C=E7=89=A2=E9=80=89=E9=98=9F=E6=94=B9?= =?UTF-8?q?=E4=B8=BA=E6=8C=89=E4=BD=93=E7=B3=BB=E5=90=8D=E7=82=B9=E9=80=89?= =?UTF-8?q?=EF=BC=9B=E8=A1=A5=E4=BA=A4=E6=8E=A5=E6=96=87=E6=A1=A3=E3=80=81?= =?UTF-8?q?=E5=BE=85=E5=BC=80=E5=8F=91=E8=AE=A1=E5=88=92=E4=B8=8E=E5=8D=95?= =?UTF-8?q?=E6=B5=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 本机账号的编队按体系命名(流血/斩击/突刺/…),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。 --- docs/BACKLOG.md | 172 ++++++++++++++++++++++++ docs/feedback/2026-11-14/HANDOVER.md | 162 +++++++++++++++++++++++ docs/feedback/2026-11-14/README.md | 189 +++++++++++++++++++++++++++ lc_mcp/aalc_patches.py | 187 ++++++++++++++++++++++++++ lc_mcp/aalc_task.py | 12 +- tests/test_system_team_selection.py | 168 ++++++++++++++++++++++++ 6 files changed, 888 insertions(+), 2 deletions(-) create mode 100644 docs/BACKLOG.md create mode 100644 docs/feedback/2026-11-14/HANDOVER.md create mode 100644 docs/feedback/2026-11-14/README.md create mode 100644 tests/test_system_team_selection.py diff --git a/docs/BACKLOG.md b/docs/BACKLOG.md new file mode 100644 index 0000000..d91f85d --- /dev/null +++ b/docs/BACKLOG.md @@ -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/.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 的自动寻路是两套,别混 | diff --git a/docs/feedback/2026-11-14/HANDOVER.md b/docs/feedback/2026-11-14/HANDOVER.md new file mode 100644 index 0000000..cb70d1c --- /dev/null +++ b/docs/feedback/2026-11-14/HANDOVER.md @@ -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/<日期>/ +``` + +我这边回归后会补:跑团日志、截图路径、验收清单勾选结果,以及新发现的问题。 diff --git a/docs/feedback/2026-11-14/README.md b/docs/feedback/2026-11-14/README.md new file mode 100644 index 0000000..f913c3d --- /dev/null +++ b/docs/feedback/2026-11-14/README.md @@ -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 目标编队 流血 +[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 的稳定性没验(当初开它就是为躲鼠标拖地图卡死)。 diff --git a/lc_mcp/aalc_patches.py b/lc_mcp/aalc_patches.py index ee2c41b..034a039 100644 --- a/lc_mcp/aalc_patches.py +++ b/lc_mcp/aalc_patches.py @@ -356,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 diff --git a/lc_mcp/aalc_task.py b/lc_mcp/aalc_task.py index 3858bf0..5cf538a 100644 --- a/lc_mcp/aalc_task.py +++ b/lc_mcp/aalc_task.py @@ -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) diff --git a/tests/test_system_team_selection.py b/tests/test_system_team_selection.py new file mode 100644 index 0000000..513687a --- /dev/null +++ b/tests/test_system_team_selection.py @@ -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()