✧*｡ (ˊᗜˋ*) ✧*｡

你好呀，这是一个通过OCR识别原神成就的项目
Hi, this is a project to identify Genshin Impact through OCR.
 

快速使用

1. clone本项目
2. 环境配置：运行setup_requeiment.cmd。
3. 启动原神。
4. 将原神的分辨率调整至1280×720（必须）。
5. 切换至成就页面并进入某个成就分类中，例如天地万象。
6. 不要最小化原神窗口（可切至后台）。
7. 启动start_server.exe（该程序强制服务以管理员模式启动GenshinAchievementRecognitionServer.py）（必须），等待其显示如下内容：

Loading Resource[GenshinAchievementRecognition]: 100%|███████████████████████████████████| 1/1 [xx:xx<xx:xx,  x.xxs/it]
xxxx-xx-xx xx:xx:xx INFO: Resources loading finish.

8. 启动start_client.exe（该程序强制服务以管理员模式启动GenshinAchievementRecognitionClient.py）。（必须）
9. 默认按q开始识别，按任意其他键取消。
10. 识别期间尽量不要进行操作，识别完成时会显示如下内容：

xxxx-xx-xx xx:xx:xx INFO: [xxxx]:[1005]: Start to save achievement record.
xxxx-xx-xx xx:xx:xx INFO: [xxxx]:[1006]: Achievement record saved. [path=gar/record/xxxx.guiar]
xxxx-xx-xx xx:xx:xx INFO: [xxxx]:[1004]: Task finish.

11. 您可以切换至其他成就分页重复7~9的操作步骤进行识别。
12. 格式转化：

csv：运行Guiar2Csv.py，输入游戏uid后可在gar/record/csv目录下找到输出结果。（推荐）
json：运行Guiar2Json.py，输入游戏uid后可在gar/record/json目录下找到输出结果。

输出示例

• {uid}.csv识别成就一览

• {uid}_incomplete.csv未完成成就

• 另有json格式输出，见 json格式输出

配置文件

• 位于gar文件夹内。

• 配置文件不存在时生成默认配置文件。

• config.json：

• window_name: 原神窗口名称，一般为原神或Genshin Impact。
• enable_gpu: 是否启用GPU，默认为False。
• 其他参数基本已经调整至最优水平（可能），不建议修改。

• server_config.json：

• host: 服务地址。
• port: 服务端口。
• enable_gamt: 是否启用gamt。
• gamt_file_path: gamt文件路径。
• enable_title_fix: 是否启用标题修复。
• title_fix_file_path: 标题修复文件路径。
• save_record: 是否保存识别记录。
• save_record_path: 识别记录保存位置的文件夹路径。
• save_record_backup: 是否保存备份识别记录。
• save_record_backup_path: 识别记录备份位置的文件夹路径。
• record_type: 暂无作用。

• client_config.json：

• host: 服务地址，应与server.config.json中的host相同。
• port: 服务端口，应与server.config.json中的port相同。
• start_key: 开始键，字符串类型，仅支持单个字母。

guiar文件

• guiar文件使用protobuf进行编码，由GuiarBlock和GuiarItem组成，其大致格式如下所示：

{length of the next GuiarBlock}{GuiarBlock{uid,group_id,[GuiarItem,GuiarItem,GuiarItem]}}

• GuiarBlock

• uid: 游戏内的uid
• group_id: 成就所属类别
• items: 一个或多个GuiarItem

• GuiarItem

• id: 成就id，同名成就仅取id最大的
• state: 成就完成状态，True为已完成，False为未完成
• data_a: 当成就完成时，该项目表示总计完成次数；当成就未完成时，该项目表示当前进度
• data_b: 当成就完成时，该项目表示guiar_date（见下方对应条目）；当成就未完成时，该项目表示目标进度

• guiar_date

• 该日期格式对year,month,day三个变量进行了编码。
• 编码公式：
  (year - 2020) * 384 + ((month - 1) << 5) + (day - 1)
• 解码公式：

       t = int(guiar_date / 384)
       year = t + 2020
       md = guiar_date - t * 384
       month = (md >> 5) + 1
       day = md % 32 + 1
       return year, month, day

• 变量具体类型请参考proto/Guiar.proto

gamt文件

• 该文件为原神成就映射表(Genshin Impact Achievement Mapping Table)
• 格式：

{去除空白字符、标点符号的成就标题},{成就标题},{成就id},{成就group_id}

title_fix文件

• 该文件为标题修复文件。由于OCR对相似中文字符难以辨别，如迁和迂、土和士等，外加原神游戏内字体笔画较粗，造成个别字符识别出错或失败。
• 格式：

{去除空白符、标点符号的错误标题},{去除空白符、标点符号的正确标题}

API文档

• API文档会在日后完善

友情链接

• Snap.Genshin