Lv.7

别扒拉我

原创

该内容使用了刷新卡，原发布时间：1星期前

枫神『MOD』模组管家

游戏模组管理神器

v0.1.4 | 作者：枫纹墨客 | 免费软件，禁止倒卖

简介核心功能已实装功能更新日志开发路线图支持游戏下载常见问题

为什么选择枫神『MOD』模组管家？

你是否厌倦了手动管理七日杀的模组？是否因为模组排序错误导致游戏崩溃？是否想和朋友分享你的模组整合包却不知从何下手？

枫神『MOD』模组管家是一款专为七日杀玩家设计的免费桌面工具，提供模组安装、启用/禁用、排序、搜索、分类、整合包导入导出等一站式管理功能，让你告别繁琐的手动操作，轻松玩转模组！

【内容简介与使用讲解，请看完整个合集每个版本更新内容都是单独使用说明】

【v0.1.3】点击跳转

【v0.0.2】点击跳转

特别声明：本软件工具免费使用，如遇付费倒卖，请立即退款举报并反馈作者。

核心功能一览

📦

智能安装

ZIP/7z/RAR 自动识别解压，智能穿透嵌套目录精确定位，一键安装到 Mods 目录

🔄

一键排序

前缀排序模式精准控制模组加载顺序，上移/下移/置顶/置底灵活调整，一键应用到游戏目录

🗂️

分类管理

自定义模组分类标签，横版分类筛选栏，快速定位目标模组

🔍

搜索筛选

实时搜索、状态筛选（启用/禁用）、分类筛选三重过滤，秒级定位

💾

整合包分享

一键导入/导出整合包，自动生成配置文件，打包单个模组快速分享

🛡️

存档备份

一键备份/加载游戏存档，快速打开存档目录，再也不怕存档丢失

灵活配置

内置多项功能开关，按需启用/禁用，打造你的专属管理界面：

页面导航控制

控制每个导航页面的显示/隐藏：总览、模组管理、加载排序、设置等

按钮开关控制

每个操作按钮独立开关：添加、删除、启用全部、打包整合包等

功能区控制

搜索框、筛选下拉、分类栏、预览面板、类别列等独立开关

配置持久化

开关状态自动保存到配置文件，重启后保持上次设置

整合包管理

想和朋友分享你的模组配置？整合包功能让你轻松实现：

功能	说明
📦 打包整合包	将当前所有模组打包为一个压缩包，自动生成 modpack.ini 配置文件，记录模组列表、排序和分类信息
📥 添加整合包	导入整合包后自动解压安装所有模组，读取 modpack.ini 恢复排序和分类
🎁 一键打包	将单个模组打包为独立压缩包，方便分享给其他玩家

加载排序详解

七日杀模组的加载顺序至关重要，排序错误可能导致模组冲突或游戏崩溃。本工具提供完整的排序管理方案：

手动排序

上移 / 下移 / 置顶 / 置底，直观便捷调整加载优先级

排序模板

保存当前排序为模板，一键应用历史模板，管理多套排序方案

前缀排序模式

自动为模组文件夹添加数字前缀（如 1-ModName），确保游戏按指定顺序加载

同步状态

实时显示排序同步状态，模组变更后自动提示是否需要重新排序

排序模板使用场景：当你有多套模组配置（如”纯净生存”、”重度魔改”、”PVP竞技”），可以为每套配置保存一个排序模板，随时一键切换，无需重新手动排列。

已实装功能

以下功能已在当前版本中完整实现，开箱即用：

🧭 导航页面

功能	说明	状态	实装版本
📊 启动总览	游戏封面、统计卡片、一键启动、存档管理	实装	v0.0.1
📦 模组管理	添加/删除/启用/禁用模组，智能解压安装	实装	v0.0.1
🔀 加载排序	上移/下移/置顶/置底，排序模板管理	实装	v0.0.1
⚙️ 设置	游戏/模组路径配置，一键检测默认路径	实装	v0.0.1

🎮 启动总览 — 功能组件

功能	说明	状态	实装版本
统计卡片	模组总数/启用/禁用数量一目了然，实时刷新	实装	v0.0.1
游戏封面图	七日杀专属封面图展示，沉浸式视觉体验	实装	v0.0.1
▶ 启动游戏	一键启动七日杀，无需手动查找游戏目录	实装	v0.0.1

📦 模组管理 — 操作页面

模组管理是本工具的核心页面，提供完整的模组生命周期管理：

功能	说明	状态	实装版本
➕ 添加模组	支持 ZIP/7z/RAR 格式智能解压安装，自动识别压缩包内 ModInfo.xml 定位真实模组目录	实装	v0.0.1
🗑️ 删除模组	单个删除或一键删除所有禁用模组，释放磁盘空间	实装	v0.0.1
✔️ 应用	一键应用所有待变更的启用/禁用状态，批量执行后自动刷新列表仅当存在待变更状态时按钮可用，无变更时自动禁用	实装	v0.0.2
↩️ 回撤	一键撤销所有待变更的启用/禁用状态，恢复到上次应用时的状态仅当存在待变更状态时按钮可用，无变更时自动禁用	实装	v0.0.2

智能解压原理：工具会自动分析压缩包内部结构，识别是否包含多层嵌套目录，智能定位到 ModInfo.xml 所在的模组根目录，无需手动整理文件结构。

🔄 加载排序 — 操作按钮

功能	说明	状态	实装版本
⬆️ 上移	将选中模组向上移动一行，调整加载优先级	实装	v0.0.1
⬇️ 下移	将选中模组向下移动一行，降低加载优先级	实装	v0.0.1
⏫ 置顶	将选中模组一键移至排序列表最顶部，确保最高加载优先级；在列表顶部时自动禁用	实装	v0.1.3
⏬ 置底	将选中模组一键移至排序列表最底部，确保最低加载优先级；在列表底部时自动禁用	实装	v0.1.3
⌨️ 快捷键移动	按 Ctrl+↑ 快速上移选中模组，按 Ctrl+↓ 快速下移选中模组，提升排序操作效率	实装	v0.1.3
✅ 应用排序	确认当前排序后一键应用到游戏目录，自动重命名文件夹前缀实现排序生效	实装	v0.0.1
🔄 还原排序	撤销未应用的排序修改，恢复到上次应用时的排序状态	实装	v0.0.1
排序同步状态	实时显示排序是否与模组列表同步，避免操作冲突	实装	v0.0.1

⚙️ 设置 — 路径配置

功能	说明	状态	实装版本
游戏路径	自动检测 Steam 安装路径，支持手动浏览指定	实装	v0.0.1
模组路径	模组目录配置，一键恢复默认路径	实装	v0.0.1
📂 仓库路径	VFS 仓库目录配置，设置后自动迁移现有模组到仓库，支持多游戏独立存储。可在 ⚙️ 设置 — 路径配置中进行相关配置	实装	v0.1.3

📂 VFS 仓库管理

功能	说明	状态	实装版本
仓库路径配置	设置统一仓库根目录，系统自动创建游戏子目录实现多游戏隔离存储，配置入口：⚙️ 设置 — 路径配置 — 仓库路径	实装	v0.1.3
自动迁移	设置仓库路径后自动检测传统模式模组，弹出进度对话框显示迁移进度，支持取消操作，迁移完成后显示成功/失败统计	实装	v0.1.3
目录联接	迁移后 Mods/ 目录下仅保留 Junction 联接链接，游戏本体文件不会被修改，确保安全隔离	实装	v0.1.3
多游戏隔离	每个游戏拥有独立的仓库子目录（如 repo/7daystodie/），不同游戏的模组自动隔离存储，互不干扰	实装	v0.1.3
进度对话框	迁移过程中显示实时进度条、阶段描述、详细操作日志，支持取消按钮，完成后显示统计结果	实装	v0.1.3

更新日志

v0.1.4 更新内容

类型	更新内容
修复	修复 VFS 迁移时控制台频繁闪烁问题：使用 _winapi 原生 API 创建 Junction，消除 cmd.exe 黑框窗口弹出
修复	修复 VFS 迁移速度慢问题：同盘使用 os.rename 原子操作瞬间完成，跨盘优化 copytree 流程
修复	修复 VFS 迁移”文件已存在”错误：使用 is_junction() 替代 os.path.exists() 判断，正确识别 broken junction
修复	修复添加模组路径错误：使用 game_repo_dir 替代 repo_dir，确保模组添加到正确的游戏专属仓库目录
修复	修复整合包添加序号错误：新模组追加到现有序号末尾而非从 01 开始，避免序号冲突
修复	修复添加模组后列表不刷新问题：与应用按钮保持一致的刷新逻辑，包含重新排序和仪表盘刷新
修复	修复排序列表序号顺序错误：VFS 模式下按 Junction 名称前缀序号排序，而非纯名称字母排序
优化	优化添加模组前仓库路径检查：未配置仓库路径时弹出提示，阻止后续操作

v0.1.3 更新内容

类型	更新内容
新增	新增 VFS 仓库管理功能：模组统一存储到独立仓库目录，Mods/ 目录下仅保留 Junction 联接链接，支持多游戏隔离存储
新增	新增仓库路径配置：在 ⚙️ 设置 — 路径配置中设置仓库根目录，系统自动创建游戏子目录
新增	新增迁移进度对话框：显示实时进度条、阶段描述、详细操作日志，支持取消按钮，完成后显示统计结果
新增	新增文件浏览路径默认打开行为：优先打开已配置路径，未配置则打开”此电脑”根目录
新增	新增置顶/置底按钮条件禁用：在列表顶部时置顶禁用，底部时置底禁用，无选中时全部禁用
新增	新增快捷键移动排序：按 Ctrl+↑ 快速上移选中模组，按 Ctrl+↓ 快速下移选中模组，提升排序操作效率
新增	新增”发现新版本”按钮条件显示：仅在检测到更新时显示，未检测到或检查失败时隐藏
优化	优化加载排序页面按钮状态管理，统一上移/下移/置顶/置底按钮的禁用逻辑

v0.0.2 更新内容

类型	更新内容
修复	修复删除按钮功能不生效的问题（确认弹窗返回值判断逻辑错误）
修复	修复点击操作按钮后表格选中行丢失的问题
修复	修复状态循环变更（启用→禁用→启用）后应用/回撤按钮仍可点击的问题
修复	修复所有弹窗（确认、提示、错误等）背景为黑色的问题
修复	修复内置 UnRAR.exe 在子进程中挂起导致 RAR 文件无法解压的问题（替换为官方 UnRAR 5.71 x64 版本）
修复	修复启用/禁用模组时因文件锁导致 [WinError 5] 权限拒绝错误（新增安全移动机制：自动重试 + 回退策略）
修复	修复应用排序后模组顺序错乱的问题（基于重命名计划映射更新排序记录，而非重新扫描磁盘）
修复	修复模组管理页面序号列与文件名前缀序号不一致的问题（序号列现在显示文件夹名称中的实际前缀数字）
修复	修复文件选择对话框按钮汉化在切换选择后丢失的问题（延迟重绘机制确保汉化映射持久生效）
修复	修复 QDialog 未导入导致文件选择对话框崩溃的问题
新增	新增「应用」按钮：一键批量应用所有待变更的启用/禁用状态，无待变更时自动禁用
新增	新增「回撤」按钮：一键撤销所有待变更的启用/禁用状态，恢复到上次应用时的状态，无待变更时自动禁用
新增	内置 RAR 解压支持（rarfile 库 + UnRAR.exe），无需额外安装即可解压 RAR 格式模组
新增	状态变更智能缓存：启用→禁用→启用或禁用→启用→禁用时自动识别为无实质变更，移除缓存
优化	禁用 MOD 名称列拖动排序，防止误操作导致行顺序错乱
优化	表格列宽交互优化：加载序号/状态列固定宽度，Mod名称列可拖动调整并设最小宽度，备注列自动填充剩余空间
优化	操作按钮焦点优化，点击按钮不会导致表格失去选中状态
优化	启用/禁用模组改为原子重命名操作（os.rename），避免产生文件副本，跨盘自动回退到安全移动
优化	移除所有弹窗右上角问号帮助按钮，界面更简洁
优化	文件选择对话框全面汉化：按钮、标签、侧边栏、工具提示均支持中文显示，切换选择后汉化不丢失

开发路线图 — 即将解锁

以下功能已进入开发计划，将在后续版本中逐步实现：

📋 第一阶段 — 模组管理增强

功能	说明	预期亮点
✅ 启用全部	一键将所有已禁用的模组重新启用，省去逐个点击的繁琐操作	效率翻倍
❌ 禁用全部	一键禁用所有模组，排查模组冲突时快速清空环境	冲突排查
📦 一键打包	将选中的单个模组打包为独立压缩包，适合单独分享	便捷分发
🔍 搜索Mod	实时关键词搜索，输入模组名称即可秒级定位，支持模糊匹配	精准查找
状态筛选	下拉框按「全部/启用/禁用」状态快速筛选模组	快速过滤
🔗 版本兼容	自动检测模组版本，与游戏版本进行兼容性比对	兼容检测
🗑️ 删除禁用	一键清理所有禁用状态的模组，释放磁盘空间	空间管理
🏷️ 分类标签	自定义模组分类（UI/物品/建筑/武器等），横版分类栏快速切换	分类管理
右侧预览面板	选中模组后右侧显示详细信息预览，包含 ModInfo.xml 内容和版本兼容性检查结果	信息一目
Mod计数标签	表格底部实时显示当前模组总数和筛选结果数量	状态感知

📋 第二阶段 — 深度管理体验

功能	说明	预期亮点
📦 添加整合包	导入他人分享的整合包压缩文件，自动解析 modpack.ini 配置并批量安装	社交分享
📦 打包整合包	将当前所有模组打包为一个整合包，自动生成 modpack.ini 配置文件	一键分享
分类筛选栏	表格上方横版分类按钮栏，按类别快速筛选模组	分类管理
类别列	模组表格中显示类别列，支持双击编辑自定义类别	自定义标签
右键管理类别	右键模组弹出菜单中的「管理类别」选项	快捷操作
💾 保存模板	将当前排序保存为命名模板，方便后续快速切换	方案存档
📂 应用模板	从已保存的模板列表中选择一套排序方案一键应用	快速切换
📋 管理模板	查看、重命名、删除已保存的排序模板	方案管理

📋 第三阶段 — 全面体验升级

功能	说明	预期亮点
游戏信息卡片	总览页面展示游戏版本号、安装路径、存档路径、备份路径等关键信息	信息聚合
启动模式切换	支持不同启动参数快速切换（如窗口模式、EAC关闭等）	灵活启动
快捷启用全部	总览页面直接操作一键启用所有模组	快捷操作
快捷禁用全部	总览页面直接操作一键禁用所有模组，快速清空环境排查冲突	快速排查
💾 备份存档	一键备份当前游戏存档到指定目录，防止存档损坏	数据安全
📂 加载存档	从备份目录选择存档一键恢复，轻松回滚游戏进度	进度恢复
📁 存档位置	一键打开游戏存档所在目录，方便手动管理	路径直达
🎮 游戏位置	一键打开游戏安装目录，快速定位配置文件	快速定位
存档路径配置	设置页面自定义存档目录路径，支持手动浏览指定	自定义路径
备份路径配置	设置页面自定义备份目录路径，将备份存放到安全位置	安全存储

🌟 未来愿景 — 更多可能

🎮

游戏列表

多游戏切换管理

🌐

获取模组

模组浏览下载

🤝

远程协助

远程帮助配置模组

支持游戏

当前已适配 9 款游戏，七日杀为首发支持：

游戏	模组目录	排序模式	状态
七日杀	Mods	前缀排序	已适配
僵尸毁灭工程	mods	前缀排序	规划中
骑马与砍杀2：霸主	Modules	前缀排序	规划中
幻兽帕鲁	Mods	前缀排序	规划中
潜渊症	Mods	前缀排序	规划中
暗黑地牢	mods	前缀排序	规划中
逃离塔科夫	BepInEx/plugins	无排序	规划中
梦之行	Mods	前缀排序	规划中
废品机械师	Mods	前缀排序	规划中