XXMI启动器：一站式游戏模型管理神器 🎮

为什么选择XXMI启动器？🛠️

还在为不同游戏的模型导入器切换而抓狂？🤯 每次更新游戏后都要手动适配各种工具？XXMI启动器就是你的游戏装备管理器，帮你解决四大痛点：

• 多游戏统一管理：像游戏库一样整合GIMI（原神）、SRMI（星穹铁道）、WWMI（鸣潮）和ZZMI（绝区零），告别桌面图标混乱
• 全自动配置：检测到新游戏就像NPC触发任务一样自动激活适配流程，新手也能秒上手
• 智能更新系统：自动推送工具更新就像游戏补丁推送，永远保持最佳兼容性
• 银行级安全验证：所有组件都经过数字签名验证，杜绝恶意文件入侵你的游戏档案

场景化启动指南 🚀

新手友好模式：三步上手

1. 获取启动器

   • 从官方仓库克隆项目：git clone https://gitcode.com/gh_mirrors/xx/XXMI-Launcher
   • 进入项目目录并安装依赖：cd XXMI-Launcher && pip install -r requirements.txt

2. 首次启动设置

   • 运行启动器：python src/xxmi_launcher/app.py
   • 首次启动会自动打开游戏检测向导，像创建游戏角色一样完成初始设置
   • ⚠️ 确保游戏已安装在默认路径，否则需要手动指定游戏目录

3. 安装模型导入器

   • 在主界面点击对应游戏的磁贴（如"GIMI"对应原神）
   • 点击"安装导入器"按钮，等待进度条完成（类似游戏资源下载）
   • 安装完成后会显示"准备就绪"状态，此时已可开始使用模型功能

资深玩家自定义流程

1. 高级启动配置

   • 按住Shift键启动程序进入开发者模式
   • 在设置界面开启"自定义命令行"选项，解锁高级启动参数
   • 示例配置：--game=gimi --skip-update --proxy=localhost:8080（指定游戏、跳过更新、使用代理）

2. 多版本管理

   • 在"./Themes/Default/Shortcuts"目录下创建不同游戏版本的快捷方式
   • 通过设置中的"版本切换器"快速切换不同游戏版本
   • ⚠️ 自定义版本可能导致部分功能失效，请做好备份

3. 命令行启动技巧

   # 创建桌面快捷启动脚本
   import subprocess
   
   def launch_xxmi(game="xxmi", mods=True):
       args = ["python", "src/xxmi_launcher/app.py", f"--game={game}"]
       if mods:
           args.append("--enable-mods")
       subprocess.run(args, check=True)
   
   if __name__ == "__main__":
       launch_xxmi("gimi")  # 直接启动原神模型导入器
   

进阶技巧：释放全部潜力 ⚡

性能优化三板斧

1. 资源预加载设置

   • 在设置>高级选项中，勾选"预加载常用模型"
   • 调整缓存大小至可用内存的20%（如16GB内存设置3GB）
   • 效果：模型加载速度提升40%，切换场景无卡顿

2. 后台更新管理

   • 启用"智能更新"功能，启动器会像Steam后台更新一样
   • 在游戏运行时仅下载更新包，下次启动时自动安装
   • 路径：设置>更新>后台更新策略

3. 快捷键大师

   • Ctrl+G：快速切换游戏
   • Ctrl+R：刷新模型列表
   • F12：截取当前游戏画面（自动保存至"./screenshots"）
   • 可在设置>快捷键中自定义所有操作的按键

问题排查工具箱

1. 日志查看器

   • 遇到启动问题时，通过"帮助>查看日志"打开日志文件
   • 常见错误码解析：
     • 0x001：游戏路径未找到（检查游戏安装目录）
     • 0x002：导入器版本不兼容（尝试更新启动器）
     • 0x003：权限不足（以管理员身份运行）

2. 修复工具

   • 运行"工具>修复安装"可自动修复损坏的配置文件
   • 重置用户设置：删除"./config"目录后重启程序
   • ⚠️ 修复操作会保留游戏数据，但自定义设置将丢失

生态拓展：打造你的游戏工具箱 🔧

插件开发入门

XXMI启动器支持Python插件扩展，就像游戏模组一样丰富功能：

1. 插件目录结构

   plugins/
   └── my_plugin/
       ├── __init__.py      # 插件入口
       ├── main.py          # 核心逻辑
       └── manifest.json    # 插件信息
   

2. 示例：自动截图插件

   # main.py
   from xxmi_launcher.core.event_manager import EventManager
   
   class AutoScreenshotPlugin:
       def __init__(self):
           EventManager.register("game_loaded", self.on_game_loaded)
           
       def on_game_loaded(self, game):
           print(f"检测到{game}启动，自动截图功能已激活")
           # 实现截图逻辑...
   
   # 插件入口
   def init_plugin():
       return AutoScreenshotPlugin()
   

3. 分享你的创作

   • 将插件打包为.zip文件
   • 通过启动器的"插件商店"功能分享给其他玩家
   • 优质插件有机会被官方收录到默认安装包

主题定制指南

1. 创建自定义主题

   • 复制"./Themes/Default"目录并重命名为你的主题名
   • 修改主题目录中的图片和配置文件
   • 在设置>外观中切换到你的主题

2. 图标替换教程

   • 替换"./Themes/Default/MainWindow"下的图片文件
   • 保持相同的文件名和尺寸（建议使用WebP格式）
   • 示例：替换"button-start.png"自定义启动按钮外观

3. 主题分享平台

   • 访问官方论坛的"主题分享区"展示你的作品
   • 参与月度主题设计大赛赢取游戏周边
   • 优质主题将被纳入官方主题商店

---

XXMI启动器就像一把万能瑞士军刀，既能满足新手玩家的简单需求，又能为高级用户提供无限可能。无论你是刚接触模型导入的新手，还是追求极致自定义的资深玩家，这款工具都能成为你游戏创作之路上的得力助手！🎨

现在就通过以下命令开始你的模型导入之旅吧：

git clone https://gitcode.com/gh_mirrors/xx/XXMI-Launcher && cd XXMI-Launcher && pip install -r requirements.txt && python src/xxmi_launcher/app.py

记住，最好的配置永远是适合自己的配置。探索设置面板，尝试不同组合，打造专属于你的游戏辅助工具！