Files
lc-mcp/docs/WATCH.md
T
Codex Agent 324f9d23b8 值守文档: 把体检工具接进手册
上一轮新增了 audit_runs.py 但只在提交信息里提过 —— 又是一次"写了没人知道"。
手册第一节现在把值守要跑的两个命令并列出来:

  python scripts/modules_status.py   看历史(每轮结果/模组变化/狂气那一栏)
  python scripts/audit_runs.py       体检(日志与报告交叉核对, 揪出可疑记录)

并写明"异常行先过它一遍再下结论"、以及为什么不能手敲核对(我第一次 6 条全误报)。

test_doc_refs.py 会自动核对文档里引用的 scripts/xxx 是否存在, 所以这次接进去
同时也被测试覆盖到了。全套 310/310 通过。
2026-10-16 12:01:53 +08:00

179 lines
8.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 值守说明(挂机合成模块)
用户要求:**不打任何关卡**,只挂机等体力恢复、把体力合成成模块,合成完关掉游戏。
目标账号:LV 042 / NO. V894413125。**狂气(Lunacy)一分不许花。**
---
## 一、自动化构成
| 计划任务 | 节奏 | 作用 |
|---|---|---|
| `LcMCPConvertModules` | 每 4 小时 | 启动游戏 → 合成模块 → 关掉游戏 |
| `LcKeepDisplay` | 每 1 分钟 | 会话掉到 `Disc` 时把显示挂回 console |
| `LcMCPServer` | 登录时 | lc-mcp 的 TCP 服务(`127.0.0.1:8765`) |
| `LcMCPDailyCycle` | **已禁用** | 刷关卡用,本次明确不开 |
脚本入口:`scripts/convert_modules.py`
报告:`~/lc_mcp/modules/convert_*.json`,日志:`~/lc_mcp/modules/convert.log`
值守时跑这两个:
```powershell
python scripts/modules_status.py # 看历史: 每轮结果 / 模组变化 / 狂气那一栏
python scripts/audit_runs.py # 体检: 日志与报告交叉核对, 揪出可疑记录
```
`audit_runs.py` 退出码 0 = 全部吻合。它检查"每份报告都有对应的开始行、时间关系
成立、耗时和结果文本一致", 外加识别 mock 残留(同一秒扎堆、内容自相矛盾)。
**异常行先过它一遍再下结论** —— 手敲 PowerShell 核对很容易把"数据没问题"误判成
"数据有问题"(我第一次就 6 条全误报,见第八节)。
## 二、体力账本(实测标定)
* 恢复速度:**每 5.82 分钟 1 点**(实测 47 分钟回 8 点;标称 6 分钟)
* 上限:126
* 兑换率:**20 点体力 = 1 个模块**
* 4 小时间隔 → 攒约 41 点 → 换 2 个模块,且远不到上限,不浪费恢复量
实测对账(2026-10-16):
```
09:58 13
10:04 14 +1 / 6 分钟
10:44 21 +7 / 40 分钟
10:45 合成消耗 20 → 剩 1
11:01 4 1 + 16 分钟
```
## 三、界面流程与坐标(1600x900 基准,`lc_ui` 负责换算到实际客户区)
```
主界面底栏模组图标 (390,805)
→ Charge Enkephalin 面板
页签 [Modules] (619,283) / [Use Lunacy] (797,283) ⛔ / [Use Boxes] (957,283)
数量 » 取最大 (1019,413)
确认 Confirm (943,671) 取消 Cancel (656,670)
```
判定是否停在免费合成页签的依据:**兑换区显示体力条 `x/126`**(Use Lunacy 那边显示的是狂气)。
判不出来就不合成。
## 四、狂气的三道防线
1. **只点 `Modules` 页签**。`USE_LUNACY_TAB` 常量只用于"确认没点到它"。
2. **AST 测试盯着**:任何 `click()` 传入该坐标都会让测试失败(`test_convert_modules.py`)。
3. **前后相对比对**:这个数字是像素艺术字,OCR 会误读(实测真实 6636 读成 9699、
真实 6388 读成 8859),所以不信任绝对值,只看前后是否一致。
> ⛔ **第 3 道防线曾经整条哑掉**(2026-10-16 发现)。OCR 把标签 `LUNACY` 读成
> `UNACY`(首字母被吃掉),而代码写的是 `'LUNACY' in text` —— `UNACY` 不包含
> `LUNACY`,于是每次都被判成"读不到",静默跳过比对。
> **同屏的体力读数一直正常**,所以只看日志很容易以为是画面没渲染好。
> 现在认词根 `NACY`,并在标签完全读不出时按位置兜底(底栏 y 775~815、x<700
> 最靠左的短文本)。
>
> 教训:**"读不到 → 跳过"这种降级路径,必须能看出它到底跑没跑过。**
## 五、环境事实(2026-10-16 核实)
* **系统不会睡眠**:`STANDBYIDLE` AC/DC 均为 0;近 3 天无睡眠事件;已连续运行 62.4 小时
* 磁盘:C: 55 GB 可用,D: 138 GB 可用
* 网络:直连可用(`ProxyEnable=0`,Clash 6789 未运行)。Steam 商店页超时属区域限制,
不影响游戏 —— 游戏自己 `CONNECTING` 后能进主界面
* Steam:有自启项;实测启动游戏 exe 会自己把 Steam 拉起来
* 会话:`console` 会话存活;断线会被 `LcKeepDisplay` 在 1 分钟内挂回
* **今天断线 2 次**(09:48、10:30),看门狗两次都成功挂回 —— 断线不是小概率,
所以 `ensure_display()` 那层自检是必要的
### 关键配置(必须保持,改前先备份到 `~/lc_mcp/config.yaml.bak-<日期>`)
| 配置项 | 值 | 为什么不能动 |
|---|---|---|
| `set_lunacy_to_enkephalin` | `0` | AALC 从不购买狂气 —— 防线最底层 |
| `daily_task` | `false` | AALC 层面也不跑日常本;就算被误触发也只会跑空 |
| `set_win_size` | `900` | 1600x900,模板匹配的前提(720 会让识别退化) |
| `win_input_type` | `window_move` | 点击方式,换别的 Unity 会忽略 |
存档备份:`~/lc_mcp/config.yaml.bak-20261013`
## 六、任务配置与时间预算
`LcMCPConvertModules` 的动作与设置(2026-10-16 逐项核实):
```
Execute : D:\lc-mcp\vendor\aalc\.venv\Scripts\pythonw.exe
Arguments : -X utf8 "D:\lc-mcp\scripts\convert_modules.py"
WorkingDir : D:\lc-mcp
LogonType : Interactive # 会话断开(不是注销)时仍在跑
RunLevel : Limited # 非提权
多实例 : IgnoreNew # 不会和上一轮重叠
时间上限 : PT15M
错过就补跑 : True
Interval : PT4H # 10:03 / 14:03 / 18:03 / 22:03 / 02:03 / 06:03
```
**时间预算**(最坏情况加起来仍在上限内):
| 阶段 | 上限 |
|---|---|
| `launch_game` 等进程出现 | 240 s |
| `wait_main_menu` 等主界面 | 300 s |
| 读狂气/体力 + 合成 + 关游戏 | ~80 s |
| **合计** | **~10.3 分钟** < 15 分钟 ✅ |
> 万一游戏要下载大更新(实测有过 1.62 GB),会超过 15 分钟被任务强杀,游戏留在
> 内存里;下一轮 `launch_game` 会发现它已在运行并继续,不会卡死。
## 七、已知失败模式与处置
| 现象 | 原因 | 处置 |
|---|---|---|
| 截图全黑、OCR 空白 | RDP 断开把显示表面拆了 | 开跑前 `ensure_display()` 自检并跑看门狗 |
| 客户区变成 1278x719 | RDP 重连改了窗口 | 开跑前 `ensure_window_size(1600,900)` |
| 连不上 8765 | 服务没起来 | `ensure_server()` 自己拉起并等就绪 |
| 报"模组没变" | 可能已达上限,也可能界面没响应 | 关掉面板重开重试一次,仍不变才报 |
| 读不到体力 | 底栏还在淡入 | 重试 4 次;仍读不到就跳过(退出码 0),不贸然点合成 |
| 游戏停在副本里 | 上一轮被打断 | 下一轮 `back_init_menu` 会自行带回主界面 |
## 八、日志噪音约定
`convert.log` 是值守时要看的**真实运行记录**,不允许被测试污染。
测试通过 `QuietLogMixin` 把 `log()` 静音;判断方法是跑完测试看行数有没有变。
已经被污染过两次,塞进来的都是**看着像真出事**的行,很能误导人:
* `MCP 服务(8765)未监听, 尝试拉起` / `等服务就绪超时(0s)`
* `桌面未在出图(BitBlt 失败), 跑看门狗把显示挂回 console` / `看门狗执行失败: powershell not found`
**怎么分辨**(值守时看到异常行先做这一步):
1. **同一秒扎堆** —— 真实一轮至少跑几十秒,几行全在 `HH:MM:SS` 同一秒就是测试
2. **内容自相矛盾** —— 比如"powershell not found",而 powershell 明明在
3. **对不上报告** —— 去 `~/lc_mcp/modules/` 找同一时刻的 `convert_*.json`;
真实的运行一定有报告,且 `elapsed_s` 不为 0
确认是残留就直接删掉,别让它留在"病史"里。
> ⚠️ 第 3 条要注意时间对应关系:**日志的结论行写在一轮结束时,报告的 `started`
> 是开始时**,两者天然差一个 `elapsed_s`。正确的关系是
> `报告.started + elapsed ≈ 日志结论时刻`(实测 6/6 吻合)。
> 直接拿两个时间戳比会全部"对不上",反而误判成异常 —— 我自己第一次就这么错过了。
### 交叉核对脚本(可直接抄)
```powershell
$dir = "$env:USERPROFILE\lc_mcp\modules"
$runs = Get-Content "$dir\convert.log" -Encoding UTF8 | Where-Object { $_ -match '=== ' } |
ForEach-Object { if ($_ -match '^\[(.+?)\]\s*===\s*(.+?)\s*\((\w+)\), 耗时 (\d+)s ===') {
[pscustomobject]@{ end=[datetime]$Matches[1]; result=$Matches[2]; secs=[int]$Matches[4] } } }
Get-ChildItem "$dir\convert_*.json" | ForEach-Object {
$r = Get-Content $_.FullName -Encoding UTF8 | ConvertFrom-Json
$expect = ([datetime]$r.started).AddSeconds($r.elapsed_s)
$m = $runs | Where-Object { [math]::Abs(($_.end - $expect).TotalSeconds) -lt 5 } | Select-Object -First 1
if ($m -and $m.secs -eq $r.elapsed_s) { "OK $($r.started)" } else { "MISMATCH $($_.Name)" }
}
```