============================================
MimesisCheat 懒人安装器 v1.0.0 使用说明
============================================

============================================

============================================
============================================
一、安装器用途
--------------------------------------------
本安装器用于为 MIMESIS（迷魅狩猎）安装、修复和卸载 MimesisCheat。

安装器完全离线运行，不联网下载内容。它会自动检测游戏目录，并按需安装：

- MimesisCheat v1.2.2
- MelonLoader 0.7.3（游戏未安装或文件不完整时）
- MorePlayers（可选）
- MimicAPI（可选）

重要说明：
- MorePlayers 和 MimicAPI 不是 MimesisCheat 的必需前置。
- 0Harmony 已包含在 MelonLoader 中，不需要单独安装。
- MonoBleedingEdge 由游戏本体提供，安装器不会复制或覆盖它。

二、运行环境
--------------------------------------------
- Windows 10 或 Windows 11，x64
- MIMESIS Steam 版本
- 安装器自带 .NET 运行时，无需单独安装 .NET
- 建议关闭杀毒软件的实时拦截后再运行安装器
- 安装、修复或卸载前必须先关闭 MIMESIS

三、解压与启动
--------------------------------------------
1. 解压：

   MimesisCheat懒人安装器_v1.0.0_win-x64.zip

2. 解压后必须保持以下结构：

   MimesisCheatInstaller.exe
   README.md
   使用说明.txt
   payload\
       game_root\
       mods\
       optional\
       payload.manifest.json

3. 不要把 MimesisCheatInstaller.exe 单独移动出来。
   安装器需要同目录下的 payload 文件夹才能校验和安装文件。

4. 双击：

   MimesisCheatInstaller.exe

四、自动检测游戏目录
--------------------------------------------
安装器会按以下顺序查找 MIMESIS：

1. 上次使用的游戏目录
2. Steam 安装路径
3. Steam libraryfolders.vdf 中的库目录
4. appmanifest_2827200.acf
5. 常见磁盘路径：
   - <盘符>\steamapps\common\MIMESIS
   - <盘符>\SteamLibrary\steamapps\common\MIMESIS
   - <盘符>\Steam\steamapps\common\MIMESIS

如果自动检测失败：

1. 点击“浏览...”。
2. 选择包含 MIMESIS.exe 的游戏根目录。
3. 不要选择 MIMESIS_Data 或 Mods 子目录。

有效游戏目录必须包含：

- MIMESIS.exe
- MIMESIS_Data\Managed\Assembly-CSharp.dll
- MonoBleedingEdge

五、界面状态说明
--------------------------------------------
游戏目录
- 有效：检测到正确的 MIMESIS 游戏目录
- 无效：目录缺少游戏文件

MelonLoader
- 完整：版本、文件和依赖目录齐全
- 未安装/不完整：安装时会自动补齐
- 0.7.3.0：当前检测到的版本

MimesisCheat
- 已安装：Mods\MimesisCheat\MimesisCheat.dll 存在
- 未安装：需要点击“安装 / 更新”

可选组件
- MorePlayers：有/无
- MimicAPI：有/无

六、全新安装
--------------------------------------------
适用于电脑还没有安装 MelonLoader 的情况。

1. 关闭 MIMESIS。
2. 启动 MimesisCheatInstaller.exe。
3. 确认游戏目录。
4. 根据需要在“可选组件”中勾选：
   - MorePlayers（可选）
   - MimicAPI（可选）
5. 点击“安装 / 更新”。
6. 确认安装。
7. 等待进度完成。
8. 启动游戏。

全新安装会复制：

- <游戏目录>\version.dll
- <游戏目录>\MelonLoader\
- <游戏目录>\Mods\MimesisCheat\

七、已有 MelonLoader 时更新
--------------------------------------------
如果检测到完整且版本匹配的 MelonLoader 0.7.3：

- 安装器不会覆盖 MelonLoader。
- 只安装或更新：
  <游戏目录>\Mods\MimesisCheat\

点击“安装 / 更新”即可。

八、MelonLoader 不完整时
--------------------------------------------
如果 MelonLoader 仅部分存在，安装器会：

1. 先备份现有 version.dll、MelonLoader 和 Mods\MimesisCheat。
2. 只补齐缺失的文件。
3. 然后安装或更新 MimesisCheat。

九、MelonLoader 版本不匹配
--------------------------------------------
如果检测到的版本不是 0.7.3：

1. 安装器会显示当前版本和目标版本。
2. 不会静默覆盖。
3. 如需更新，请勾选：
   强制更新 MelonLoader
4. 然后再次点击“安装 / 更新”。
5. 更新前会自动备份原文件。

十、可选组件
--------------------------------------------
MorePlayers
- 可选勾选。
- 安装到：
  <游戏目录>\Mods\Rxflex-MorePlayers\

MimicAPI
- 可选勾选。
- 安装到：
  <游戏目录>\Mods\NeoMimicry-MimicAPI\

不勾选时不会安装或覆盖这两个模组。

十一、修复安装
--------------------------------------------
适用于以下情况：

- MelonLoader 文件损坏
- MimesisCheat.dll 丢失
- payload 之前复制不完整
- 游戏更新后文件缺失

操作：

1. 关闭游戏。
2. 点击“修复安装”。
3. 安装器逐个文件校验 SHA-256。
4. 只复制缺失或哈希不一致的文件。
5. 已存在且正确的文件不会重复覆盖。

十二、卸载
--------------------------------------------
默认卸载行为：

- 删除：
  <游戏目录>\Mods\MimesisCheat\
- 保留：
  - MelonLoader
  - version.dll
  - MorePlayers
  - MimicAPI
  - UserData 中的配置

如果要同时删除可选模组：

- 勾选“MorePlayers（可选）”
- 勾选“MimicAPI（可选）”

高级卸载：

- 勾选“卸载时同时移走 MelonLoader（高级）”
- 点击“卸载辅助”
- 安装器会把 MelonLoader 和 version.dll 移动到备份目录，而不是永久删除
- 其他依赖 MelonLoader 的 Mod 会失去加载环境

十三、安装日志
--------------------------------------------
日志目录：

%TEMP%\MimesisCheatInstaller\

文件名示例：

install-20260915-182031.log

日志包含：

- 游戏目录检测
- payload 校验
- 备份路径
- 每个文件的复制结果
- 错误和异常信息

安装记录：

<游戏目录>\MimesisCheatInstaller\install.json

十四、备份目录
--------------------------------------------
自动备份位置：

<游戏目录>\MimesisCheatInstallerBackup\<时间戳>\

备份可能包含：

- version.dll
- MelonLoader\
- Mods\MimesisCheat\
- Mods\Rxflex-MorePlayers\
- Mods\NeoMimicry-MimicAPI\

十五、命令行用法
--------------------------------------------
安装或更新：

MimesisCheatInstaller.exe --game-dir "D:\steam\steamapps\common\MIMESIS" --install --silent --yes

修复：

MimesisCheatInstaller.exe --game-dir "D:\steam\steamapps\common\MIMESIS" --repair --silent --yes

卸载：

MimesisCheatInstaller.exe --game-dir "D:\steam\steamapps\common\MIMESIS" --uninstall --silent --yes

可选参数：

--optional-moreplayers
--optional-mimicapi
--force-meloader
--remove-meloader

十六、常见问题
--------------------------------------------
1. 提示“未找到 MIMESIS 游戏目录”
   - 点击“浏览...”手动选择游戏根目录。
   - 确认目录中存在 MIMESIS.exe。

2. 提示“MIMESIS 正在运行”
   - 完全退出游戏后重试。
   - 确认任务管理器中没有 MIMESIS.exe。

3. 提示“未找到 MonoBleedingEdge”
   - 在 Steam 中右键 MIMESIS。
   - 选择“属性 -> 已安装文件 -> 验证游戏文件的完整性”。

4. 提示访问被拒绝
   - 关闭游戏和 Steam。
   - 右键安装器，选择“以管理员身份运行”。

5. 游戏启动后没有 MimesisCheat
   - 检查：
     <游戏目录>\Mods\MimesisCheat\MimesisCheat.dll
   - 检查 MelonLoader 日志：
     <游戏目录>\MelonLoader\Logs\
   - 确认 version.dll 和 MelonLoader 目录没有被杀毒软件隔离。

6. MelonLoader 版本不匹配
   - 勾选“强制更新 MelonLoader”。
   - 再次点击“安装 / 更新”。

7. 安装完成后想恢复旧文件
   - 打开 MimesisCheatInstallerBackup。
   - 找到对应时间戳目录。
   - 将备份内容复制回游戏目录。

十七、安全说明
--------------------------------------------
- 安装器完全离线，不联网下载。
- payload 文件在安装前会进行 SHA-256 校验。
- 安装前自动备份。
- 不打包或覆盖游戏本体文件。
- 不复制 MonoBleedingEdge。
- 不修改 UserData 中的用户配置。
- 默认卸载不会删除 MelonLoader 和其他 Mod。

十八、版本信息
--------------------------------------------
安装器版本：1.0.0
MimesisCheat：1.2.2
MelonLoader：0.7.3
MorePlayers：2.0.2（可选）
MimicAPI：0.3.0（可选）
