bettergi-scripts-list/repo/js/背包扫描/README.md
AYAPNZ 2a916442c6
新增js脚本:背包扫描 (#3845)
* 新增脚本:背包扫描

* 更新 settings.json
2026-11-16 10:11:34 +08:00

94 lines
4.7 KiB
Markdown
Raw Permalink 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.

# 背包扫描
扫描原神背包里各页签的物品,认出每种东西有多少个,写一份文字报告并留一份历史记录;
填了关注材料的话,还会把这些物品的数量一起推一条通知。
物品靠图标模板比对认出来,数量先按数字模板比对、读不出再走 OCR 兜底。
这也是它对分辨率挑剔的原因:所有取样坐标都是按 1920×1080 定的。
## 运行前
- 游戏分辨率必须是 1920×1080。不是这个分辨率时坐标会整体错位,结果基本不能看。
## 怎么用
将本脚本添加进配置组,默认设置即可全量扫描。
也可以按自己的情况改下面的设置。跑完看 `record/` 里的文件,
日志和通知里也会带一句统计(各页认出多少种)。
## 设置项
- **`账户名称`**:账户名称,用来给不同游戏账号分开存记录,
结果会写进 `record/<账户名>/`。默认「默认账户」,单账号不用改。
- **`关注材料`**:想单独看数量的材料名,多个用中文逗号分开
(英文逗号、顿号、分号、换行也行)。命中的物品会发通知,不填就只发统计行。
- **`扫描范围`**:扫描范围,六项,默认全勾。取消勾选就不扫对应项。
- **`绝版料理`**:绝版料理清单,勾选你确实拥有的。
取消勾选会把这个料理从识别名单里剔除,但是如果三种品质中你有任意一种就要勾选。
默认全勾,详见「常见问题」。
- **`调试`**:默认关。打开后会在 `record/<账户名>/` 下多建一个
`scan-<时间戳>/` 目录,存每屏截图和逐格识别明细。只在排查识别错误时开,
会明显增加磁盘占用和少量耗时。
## 扫描范围
| 名字 | 对应背包页签 | 统计方式 |
| --- | --- | --- |
| 养成道具 | 养成道具 | 整页按模板逐个识别 |
| 食物 | 食物 | 整页按模板逐个识别 |
| 材料 | 材料 | 整页按模板逐个识别 |
| 锻造矿 | 武器 | 只数固定名单 |
| 狗粮经验 | 圣遗物 | 只数固定名单 |
| 抽卡资源&摩拉 | 贵重道具 | 只数固定名单 |
前三个页签按模板库逐格统计,名单里没扫到的物品也会列成 `×0`,方便看出少了什么。
后三个页签不扫整页,只按一份固定名单找几样东西:武器页找三种精锻用矿,
圣遗物页找祝圣精华、祝圣油膏,贵重道具页找无主的星辉/星尘、纠缠之缘、相遇之缘、
原石和摩拉。所以「抽卡资源&摩拉」只报这几项属于正常,不是漏扫。
## 结果放在哪
`record/` 由脚本自己创建,不用手动建,按账户分目录:
```
record/<账户名>/
├── 扫描结果.txt 本次报告,每次覆盖
├── 扫描结果历史记录.txt 每次一段,最多留最近 30 次
└── scan-<时间戳>/ 只在 debug 开启时生成
├── pages/ 每屏截图,如 材料_p000.png
└── records.json 逐格识别明细,每行一条 JSON
```
`扫描结果.txt` 里有时间、耗时、各页统计和逐项数量(数量没读出来显示 `?`),
另有【问题】段放未识别格子、拖拽失败等异常。
历史记录是纯文本分段,段头形如
`===== 第 3 次 · 2026-11-14 22:00:01 · 耗时 41.2s =====`,最新一次排在最前面。
## 常见问题
### 某种物品没被识别出来
先看 `扫描结果.txt` 的【问题】段:未识别的格子会列出来,并写明它前后是什么物品,
方便你对照背包找位置。常见原因:
- 模板库还没收录这个物品(新版本新增的东西)。报告会提示
「可能是模板库尚未包含它们,请更新脚本或等待作者更新」。
- 分辨率不是 1920×1080,坐标整体错位。先看日志有没有报错。
- 数量数字没读出来。该项数量显示 `?`,不会写为 0。
- 绝版料理的勾选不对,见下一条。
如果确实觉得脚本有问题,请打开 `debug` 重跑一次,
并将最新时间 `debug` 文件夹附带两份结果文件打包发送给作者。
作者在BGI官方V8、V14群,可以来这两个群撅作者
### 绝版料理怎么处理
在「绝版料理」里只勾你确实拥有的那几样。取消勾选就是告诉脚本「我没有」,
脚本会把它从识别名单里剔掉。默认是全勾的;如果你其实一样都没有,保持全勾只会多花一点时间,
把没有的都取消更快。
### `debug` 开关怎么用
平时关着。遇到「明明有却没扫到」「数量不对」「报告里冒出未识别」时打开,
重跑一次,然后看 `record/<账户名>/scan-<时间戳>/`:`pages/` 是每屏截图,
`records.json` 每行一条 JSON,记着该格的候选、分数和数量。