AdeptiScanner-GI
基于OCR的原神物品扫描器,提供手动和自动两种模式。_使用前请阅读以下说明。最新版本下载链接见此处_
AdeptiScanner 需要微软提供的一些工具才能运行,这些工具在游戏中较为常见,你很可能已经安装了。
- 如果启动时扫描器报错,可能是缺少这些工具。安装程序下载链接见此处。你需要同时安装 x86 和 x64 版本
警告和重要说明
- 程序自动扫描模式需以管理员身份运行。
- 使用自动模式时,程序会控制你的鼠标。扫描过程中可按 Esc 暂停。非暂停状态下请勿移动或使用鼠标。
- 根据我对原神服务条款的理解,使用此扫描器应被允许,因为我认为它不会带来不公平的竞争优势。就我所知,目前还没有人因使用此类程序而受到处罚,但如果你担心,建议避免使用自动模式。
- AdeptiScanner 依赖特定颜色值来识别图像内容
- 任何改变游戏颜色的因素都可能影响识别结果。例如 Reshade、Windows 夜间模式、F.lux、Nvidia 滤镜及色盲补偿工具等都会干扰。
- 图像锐化也会以此方式影响颜色。最常见的例子是 AMD Radeon 软件中的“Radeon 图像锐化”。
更新新版本
- 程序内置可选的更新检查器,可通知游戏数据和扫描器更新
- 游戏数据更新可一键处理
- 扫描器更新会打开新版本下载页面,并导出你的设置,新版本启动时可导入
- 也可手动通过替换
ScannerFiles文件夹中的ArtifactInfo.json文件来更新游戏数据。最新版见此处
武器模式
- 武器模式的使用方法与常规(圣遗物)模式相同
- 建议按等级排序武器列表,以免遗漏你真正关心的低稀有度武器
- 武器模式自动扫描时,页面上所有武器都与已扫描武器相同时扫描停止;而圣遗物模式只需任一遗物相同即可停止
通过 enka.network 导入角色
- (可选)扫描你的圣遗物和/或武器
- 这样 AdeptiScanner 可显示你拥有但尚未导入的角色
- 确保你的资料展示设置为显示角色详情
- 若更改了此设置,退出至标题界面再进入,以快速刷新展示数据
- 打开 AdeptiScanner 的
Characters标签页,输入UID点击获取 - 更换展示的角色,重复第3步
- 若执行了第1步,获取按钮下方的文本框应显示你尚未导入但拥有的角色列表
- 退出至标题界面再进入,可快速刷新展示数据
扫描准备
- 推荐将游戏设置为窗口模式,分辨率为1600x900,但非必需
- 其他宽高比和分辨率可能也能正常工作,但未经过同等程度的测试
- 全屏模式可用,但需要启用
高级->处理句柄功能设置(默认启用) - 打开主背包中的圣遗物部分,选择一个带有完整物品描述的五星圣遗物
- 点击“捕获”
- 确保预览图与良好示例匹配,如果不匹配,尝试在游戏中稍微移动摄像机以更改背景,然后从步骤2重新开始!类似这样
- 在
旅行者名称文本框中输入你的游戏内昵称/旅行者名。 - 如果不输入此项,任何装备在你旅行者身上的扫描圣遗物都将被错误识别为装备在错误角色或未装备
- Wanderer 名称也有相应设置
手动扫描
- 按照“如何准备扫描”中的说明操作。扫描时不要移动游戏窗口,也不要遮挡捕获区域
- 选择你想扫描的圣遗物,点击
读取属性按钮 - 扫描器主要针对4星和5星圣遗物进行了测试。虽然它掌握了所有等级圣遗物的信息,但可能无法读取部分低等级圣遗物
- 对每个你想手动扫描的圣遗物重复步骤2
自动扫描
- 使用自动模式时,程序将控制你的鼠标。扫描过程中可以按Esc键暂停
- 除非暂停,自动扫描时不要移动或使用鼠标
- 自动扫描仅在以管理员身份运行本程序时正常工作
- 自动扫描将滚动浏览你的整个圣遗物库存,导出时会应用过滤
- 按照“如何准备扫描”中的说明操作
- 滚动圣遗物列表,使顶部行的星级和底部行的白色/米色标签均完全可见且留有一定边距。

- 点击
开始自动按钮 - 扫描过程中,你可以按键盘的Esc键暂停扫描
继续将使扫描器恢复扫描处理完后停止会让扫描器立即停止滚动新圣遗物,但会完成所有已扫描圣遗物的处理立即停止会让扫描器立即退出自动扫描,不保存任何扫描结果- 扫描器会在认为已滚动完圣遗物列表或遇到与之前相同属性的圣遗物时自动停止
- 如果提前停止(例如因两个圣遗物属性相同),你可以手动滚动到下一屏幕并点击
开始自动。之前的结果不会自动删除。
导出结果
- 使用手动、自动扫描或两者结合扫描圣遗物
- 根据需要配置
导出过滤部分 - 你可以使用一个模板文件,所有内容除圣遗物详情外都会从中复制。方法是将一个GOOD格式的json放入
ScannerFiles文件夹并重命名为ExportTemplate.json - 如果需要,可以通过
高级->加载圣遗物文件按钮合并多个GOOD格式json的圣遗物。合并时不会进行重复检测 - 点击
导出结果按钮,结果将保存为带时间戳的文件,存放在ScannerFiles文件夹中 - 你可以更改导出过滤器后多次点击导出按钮,每次导出都会生成一个独立文件
非管理员权限或无进程句柄功能时的特殊信息
点击展开
在这些条件下,适用以下额外要求
- 不支持全屏模式的原神
- 捕获过程无法自动切换焦点至游戏,因此在捕获或任何扫描游戏窗口的功能过程中,游戏窗口不得被遮挡
- 要捕获游戏,游戏必须位于主显示器上,覆盖该屏幕的中间部分,并且有一个可见的白色窗口标题栏(可以用记事本或类似程序“伪造”)
- 在1080p显示器上满足这些条件的示例图片

联系方式
- 在此仓库创建 issue 或 pull request
- 我还未创建 Discord,因为不确定兴趣程度。如果未来需要,我会创建一个
- 我在社区创建的 原神开发者 Discord 中,用户名与此相同
- 我也在 原神优化器 Discord 中。对于较小的问题欢迎 @ 我,但较长的讨论最好在原神开发者 Discord 或私信我进行
致谢
- 角色导入依赖 API Enka.Network
- 使用的一些功能大量基于 WFInfo 的代码,该程序是为《Warframe》设计的基于 OCR 的辅助工具
- 使用的 tesseract 模型由 此类似程序 的作者训练并提供
- 该扫描器的主要目的是更方便地将你的圣遗物导入到 原神优化器 中,但它应兼容任何使用 GOOD 格式的程序