-green?style=for-the-badge&logo=Github){kind=icon}
本项目仅作为学习参考用喵，请勿用作违法用途喵！(虽然我也想不到能做什么违法的事情就是了喵)
编写本项目所需的资料和资源均源于互联网收集喵(所以本人就是一个废物喵，什么都要依靠互联网喵(bushi))
本项目的初衷仅仅是为了供学习参考使用喵，本人从未想过要破坏音游圈的游戏平衡喵！(目前修改本地存档的操作不可能完成，如果你是抱着该目的来的话请另寻他路喵)[关于修改存档]
由于本喵本身技术的局限性喵，所以写出来的代码和注释可能不是很好喵，还请各位大佬谅解！
-
编写本项目时使用的是 python3.9.13 的喵，不能完全保证其他版本会不会出现问题喵，建议使用 python>=3.9 来运行喵~
-
注意在使用本项目前要先安装
PhiLocalLib/requirement.txt中的模块喵 -
abe的运行是需要 java 环境的喵，本喵用的是便携版 java11(jdk11) 的喵，可自行下载解压后放在 PhiLocalLib 下喵~(注意java9似乎也可以的喵)
-
adb工具本项目仓库已经在 PhiLocalLib 文件夹下了喵，非必要不建议去换adb版本喵~
-
abe工具本项目仓库也已经有了喵，如果要自己下载的话可以去此处下载新版来替换 PhiLocalLib 下的 abe.jar 喵~
直接运行喵：(用pip也可以的亚子喵(?))
pip3 install pycryptodome lxml
或者如果想要一点仪式感也可以运行喵：
pip3 install -r PhiLocalLib/requirement.txt
python GetSave.py [nogetab]
nogetab：不获取ab文件喵，直接开始解包喵（注意这个是方便debug的喵，不懂最好就别带这个参数，只是在debug时已经获取过ab备份包时可以用来跳过获取喵）
注意在获取ab备份包时尽可能不要输入密码喵！（就算它给你输密码的地方也不要输先喵！除非是不输密码就不能备份的情况喵，要不然就不要输密码喵！避免发生奇奇怪怪的错误bug喵）
目前能解密存档所有数据喵，输出同原存档一样的xml格式文件喵
python DecryptSave.py
运行后会读取目录下的com.PigeonGames.Phigros.v2.playerprefs.xml存档喵，然后输出已解密的DecryptSave.xml文件喵
说是说解析喵，严格来讲并不完全是喵，所以可以说是将xml存档转换解析并整理归类输出为json文件喵，但是大部分数据条目因为其命名的难懂性所以不整理归类了喵（已经整理差不多了喵，剩下的整理了也没有什么大用了喵）
python FormatSave.py
运行后会读取目录下DecryptSave.xml已解密存档文件喵，然后经解析后输出DecryptSave.json文件喵
DecryptSave.json文件的数据结构可以参考PhiLocalLib/FormatPgrLocalSave.py中game_save的定义喵，也可以参考JsonSave格式说明喵
Mivik已经做了有手机版软件了喵，其他提取方法可以参考一下Mivik的bot说明文档喵，要软件可以去Mivik的频道喵，频道里面也有完整的bot可以用喵
python GetSession.py [noget]
noget：不获取userdata文件喵，直接读取.userdata（注意这个是方便debug的喵，不懂最好就别带这个参数，只是在debug时已经获取过userdata时可以用来跳过获取喵）
直接拿编辑器打开PhiLocalLib/config.ini就可以了喵，本喵认为那点注释足够说明清楚各项配置的用途了喵
-
存档提取喵：(已模块化喵)(注释较为完整喵)
- 通过adb获取ab提取存档喵
- 防呆措施喵(bushi)
- 可利用root权限直接提取存档喵(快了快了喵)
- 将abe使用python实现喵(目前是对未加密的ab备份包能直接解包喵，加密的解包过程太复杂喵)
-
存档解密喵：(已模块化喵)(注释较为完整喵)
- 完全解密所有数据喵
-
存档解析喵：(已模块化喵)(注释较为完整喵)
- 简单归类整理各数据
-
存档修改喵：(已废弃，后续不再更新此功能)
- 经过测试，鸽游对本地存档似乎做了一些检查，所以修改本地存档基本不可能完成
-
其他喵：
- fuck_adb(adb的文件占用是真的烦喵！(恼))
- 获取本地SessionToken喵
- 整理屎山代码喵！！！(之前在搞其他东西喵，现在都没眼看这坨代码了喵)
此项目仅仅用于本地操作喵，云端操作可以看看文酱的项目PhigrosLibrary喵(本文档前面也留了链接喵)
喵！小小宣传一下废酱的项目Phi-Plugin，是一个适用于Yunzai-Bot V3的Phigros辅助插件喵！(本文档前面也留了链接喵)
介于本喵懒惰的性格喵，本项目也许应该可能大概会在未来也可能在现在某个时间突然停更或者消失喵(bushi)
(小声BB：我也不知道我为什么要写本地存档操作喵，就当是消遣吧喵。想专门搞这方面的大佬还是移步到文酱的项目PhigrosLibrary吧喵)
这东西啊喵，不好说喵，看情况吧喵
要进行存档修改就必须拥有手机系统最高权限(安卓叫ROOT、IOS叫越狱)
而且请不要将修改后的存档覆盖回去！会导致phigros游戏进度重置(跟把phigros数据清除了似的)，回到最开始安装phigros没有登录的样子！所以请非云存档玩家不要进行这种没有意义的尝试！！！
所以修改本地存档是不可能的，请不要进行任何无意义尝试，否则后果自负！
- 为项目增加了
GNU GPLv3许可证
- 整理了屎山代码，将N个函数的传参和对应注释简要修改优化了一下可能也许大概？
- 更新了一些函数的用法
- 将配置文件类型改为ini(少装一个库~)，删除了一些没有什么必要的配置项
- 使用python实现了无加密AB备份包解包(加密的AB包解密逻辑有点看不太懂，希望有大佬浇浇)
- 更新了README.md，给README.md增加了更新日志~
- 更新README.md
- 更新README.md
- 新增了用来把已经解密了的存档加密回去的功能(EncryptPgrLocalSave.py)
- 把AES加解密的函数放进ActionLib.py里面了，方便其他模块调用
- 这次更新并没有做过多的错误检查，并且ModifyPgrLocalSave.py并没有完全写好，也已经没有必要写好了
- 经过测试鸽游已经对本地存档做了检查，具体逻辑并不清楚，但是修改本地存档的操作是不可能完成的了
- 增加了一个需要依赖的包(前面更新都忘记了这个包了)
- 稍微改了一下错误提示，减少误解
- 更正了README.md中的部分内容(之前改文件夹名忘记连着README.md一起改了)
- 增加了一个需要依赖的包(前面更新都忘记了这个包了)
- 稍微改了一下错误提示，减少误解
- 更正了README.md中的部分内容(之前改文件夹名忘记连着README.md一起改了)
- 将存档解密和存档解析分离为两个模块(DecryptPgrLocalSave.py和FormatPgrLocalSave.py)
- 把项目主模块文件夹改名为PhiLocalLib
- 给所有模块基本都添加了注释，方便参考研究和后续项目维护
- 编写了Json_Info.md，简要说明了本项目输出的json格式存档数据结构
- 在readme.md添加了下载release的快捷方式
- 小小修正了一下快捷下载指向的图片api参数
- 更新了README.md
- 增加了获取sessionToken的功能
- 优化了部分代码逻辑，增加了一些注释
- 项目库文件夹改名，并且使用"__init__.py"让"PhigrosLocal"文件夹被识别为软件包，更方便调用代码
- 配置文件类型改为yaml格式，使其拥有注释
- 增加了一些新功能函数，具体自己去翻代码吧
- 增加了README.md，使项目拥有一个说明书
- 修了一个类型警告(虽然修不修应该都没事)
- 动了点DecryptPgrLocalSave.py的代码，加了点注释，优化了一丢丢代码逻辑，进一步分了类，多分了个Opened(看起来是收藏品是否打开的意思)
- 重新整理了代码和注释，小小优化了一下代码结构；
- 将部分功能函数拆分至ActionLib中，以更方便调用；
- 把配置改为一个独立的配置文件config.json，在ActionLib中提供便捷调用获取配置