终极KKManager使用指南：轻松管理Illusion游戏模组与插件的完整工具

KKManager是一款专为Illusion游戏打造的一站式模组管理工具，支持BepInEx框架下的各类模组、插件和角色卡片管理。无论是新手玩家还是资深开发者，都能通过它实现模组的一键安装、自动更新和故障修复，让游戏体验更加流畅便捷。

📌 核心功能亮点

1️⃣ 模组与插件综合管理

通过直观的界面浏览已安装的zipmods和插件，快速查看详细信息。核心功能实现位于src/KKManager.Core/Data/Plugins/目录，支持插件的自动加载与版本检测。

2️⃣ 智能自动更新系统

内置的更新引擎会定期检查模组新版本，自动下载并安装更新。更新模块源码路径：src/KKManager.Updater/，支持多种下载源配置。

3️⃣ 角色卡片管理中心

轻松导入、预览和组织游戏角色卡片，支持拖放操作直接加载至游戏。卡片处理逻辑位于src/KKManager.Core/Data/Cards/目录，兼容多种游戏版本格式。

4️⃣ 一键安装与卸载

简化模组安装流程，只需将zipmod文件拖入窗口即可自动完成安装。安装器实现代码：src/KKManager.Core/Functions/ModInstaller.cs。

5️⃣ 多游戏兼容性

完美支持Illusion系列多款游戏，包括KK、KKS、AI-Shoujo等。游戏类型定义位于src/KKManager.Core/Functions/GameType.cs。

🔧 快速开始使用

环境准备

1. 克隆仓库：git clone https://gitcode.com/gh_mirrors/kk/KKManager
2. 确保安装.NET Framework 4.7.2或更高版本

基本操作流程

1. 启动程序后，首次运行会自动检测游戏路径
2. 通过左侧导航栏切换不同内容标签页（模组/插件/卡片）
3. 安装模组：直接将zipmod文件拖入窗口或点击"浏览"按钮选择文件
4. 更新检查：点击顶部菜单栏"工具"→"检查更新"

🛠️ 高级功能

模组冲突检测

自动扫描并标记可能存在冲突的模组，帮助用户排查游戏异常问题。冲突检测算法位于src/KKManager.Core/Util/ModMatchFilter.cs。

批量操作工具

支持批量安装、卸载和更新模组，大幅提升管理效率。批量处理功能在src/KKManager/Windows/Content/SideloaderModsWindow.cs中实现。

自定义主题支持

可通过修改资源文件自定义界面主题，相关资源位于各窗口的resx文件中，如src/KKManager/Windows/MainWindow.resx。

📝 常见问题解决

游戏路径未找到

检查注册表或手动指定游戏安装目录，路径设置保存在src/KKManager.Core/Properties/Settings.settings中。

模组安装失败

1. 确认模组文件完整性
2. 检查是否与已安装模组存在冲突
3. 查看日志文件获取详细错误信息（日志位于程序目录下的logs文件夹）

🚀 最新版本特性

截至v1.4.1版本，主要更新包括：

• 优化了卡片加载性能
• 增加了对新游戏版本的支持
• 修复了导入HC卡片导致崩溃的问题
• 改进了多语言显示支持

💡 使用技巧

• 按住Ctrl键可多选模组进行批量操作
• 使用右侧筛选栏快速查找特定类型的模组
• 定期清理缓存文件可提升程序运行速度（缓存路径：src/KKManager.Core/Util/PathTools.cs中定义）

KKManager持续更新迭代，更多功能请关注项目仓库更新。如有使用问题，欢迎提交issue反馈！