Lv.9

别扒拉我

原创

该内容使用了刷新卡，原发布时间：3个月前

汪枫『MOD』模组管家

游戏玩家的免费模组管理神器

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

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

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

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

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

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

【v0.1.3】 点击跳转

【v0.0.2】 点击跳转

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

核心功能一览

📦

智能安装

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

🔄

一键排序

前缀排序模式精准控制模组加载顺序，上移/下移/置顶/置底灵活调整，一键应用到当前 MOD 仓库

🔁

启停回撤

一键启用/禁用全部模组，应用与回撤状态变更，批量操作更安心

🔍

搜索定位

实时关键词搜索，输入模组名称即可秒级定位，支持模糊匹配

💾

整合包分享

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

📚

MOD仓库

设置独立的 MOD 仓库目录，更换路径自动迁移模组，同名文件跳过不覆盖

灵活配置

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

页面导航控制

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

按钮开关控制

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

功能区控制

搜索框、统计卡片、游戏封面、操作按钮等组件独立开关，按需精简界面

配置持久化

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

整合包管理

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

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

加载排序详解

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

手动排序

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

还原排序

一键还原到上次应用排序前的顺序，调整不满意时快速回退

前缀排序模式

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

同步状态

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

还原排序使用场景：调整排序后如果不满意，可一键还原到上次应用前的顺序，无需手动逐个回退，避免误操作打乱模组加载顺序。

已实装功能

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

🧭 导航页面

功能	说明	状态	实装版本
📊 启动总览	游戏封面、统计卡片、一键启动	实装	v0.0.1
📦 模组管理	添加/删除/启用/禁用模组，智能解压安装	实装	v0.0.1
🔀 加载排序	上移/下移/置顶/置底，还原排序与排序同步	实装	v0.0.1
⚙️ 设置	游戏路径、MOD 仓库路径配置与迁移提示	实装	v0.0.1

🎮 启动总览 — 功能组件

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

🧩 全局功能

功能	说明	状态	实装版本
🔔 版本检查	启动时自动检查是否有新版本，发现更新时提示下载，保持使用最新版本	实装	v0.1.5
💡 更新引导	根据版本差距给出不同程度的更新提示，旧版本使用风险更低	实装	v0.1.5

📦 模组管理 — 操作页面

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

功能	说明	状态	实装版本
➕ 添加模组	支持 ZIP/7z/RAR 格式智能解压安装，自动识别压缩包内 ModInfo.xml 定位真实模组目录	实装	v0.1.5更新功能
🗑️ 删除模组	删除选中的单个模组，操作前二次确认，避免误删	实装	v0.1.5更新功能
🧹 删除禁用	一键清理所有禁用状态的模组，释放磁盘空间	实装	v0.3.0
📦 一键打包	将选中的单个模组打包为独立压缩包，适合单独分享	实装	v0.3.0
✔️ 应用	一键应用所有待变更的启用/禁用状态，批量执行后自动刷新列表仅当存在待变更状态时按钮可用，无变更时自动禁用	实装	v0.0.2
↩️ 回撤	一键撤销所有待变更的启用/禁用状态，恢复到上次应用时的状态仅当存在待变更状态时按钮可用，无变更时自动禁用	实装	v0.0.2
✅ 启用全部	一键将所有模组标记为启用，配合「应用」批量生效，省去逐个操作	实装	v0.3.0
❌ 禁用全部	一键将所有模组标记为禁用，配合「应用」批量生效，排查冲突更高效	实装	v0.3.0
🔍 搜索Mod	实时关键词搜索，输入模组名称即可秒级定位，支持模糊匹配	实装	v0.1.5更新功能

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

🔄 加载排序 — 操作按钮

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

⚙️ 设置 — 路径配置

功能	说明	状态	实装版本
游戏路径	自动检测 Steam 安装路径，支持手动浏览指定	实装	v0.0.1
模组路径（MOD仓库）	你的 MOD 仓库：存放和管理所有模组；更换路径时自动剪切旧模组，启动时检测游戏安装目录并提示迁移	实装	v0.3.0

📂 MOD 仓库与迁移

功能	说明	状态	实装版本
仓库路径配置	在设置页把「模组路径（MOD仓库）」设为游戏目录之外的文件夹，作为统一模组仓库；未设置时启动引导前往设置	实装	v0.3.0
自动迁移	更换 MOD 仓库时自动剪切旧仓库中的模组与 Mods_disabled，同名模组跳过不覆盖，跨盘自动回退复制	实装	v0.3.0
启动检测	启动时检测游戏安装目录 Mods，若仍有模组则提示迁移到设置中的 MOD 仓库；未设置仓库时引导前往设置	实装	v0.3.0
路径保护	禁止把游戏安装目录 Mods 设为仓库，仓库与游戏目录不能互相包含，避免误移动或循环迁移	实装	v0.3.0
结果提示	迁移完成后提示成功数量；同名跳过与失败项单独列出，失败模组保留原路径并允许下次重试	实装	v0.3.0

更新日志

v0.3.0 更新内容重要更新

类型	更新内容
改名	软件全面更名为「汪枫『MOD』模组管家」，同步更新窗口标题、安装包、说明文档与全部页面文案
新增	新增「MOD 仓库」概念：设置页的模组路径即你的 MOD 仓库，统一存放、启停、排序全部模组
新增	新增仓库迁移：更换模组路径时自动剪切旧仓库模组与 Mods_disabled，同名跳过、不覆盖，跨盘自动回退复制
新增	新增启动检测：检测游戏安装目录 Mods 中残留的模组，提示迁移到设置中的 MOD 仓库；未设置仓库时引导前往设置
新增	新增设置页「!」提示图标：悬停与点击均可查看 MOD 仓库用途、路径选择原因与迁移注意事项
新增	新增模组管理功能：删除禁用、启用全部、禁用全部、一键打包、添加整合包、打包整合包
优化	优化模组路径输入：输入过程实时保存，失焦/回车时统一校验并执行迁移，避免逐字移动文件
修复	修复启动迁移目标错误地使用推荐路径的问题，现统一迁移到设置中的 MOD 仓库；禁止将游戏安装目录 Mods 设为仓库

往期更新内容

v0.2.1 更新内容常规更新

类型	更新内容
修复	修复三色主题切换时部分模块颜色常量未同步更新，导致切换后部分 UI 颜色异常
修复	修复切换到纯黑主题后关闭再次启动，主体窗体背景未恢复纯黑的问题
修复	修复浅色主题导航栏字体大小与深灰/纯黑主题不一致的问题（14px → 统一 18px）
修复	修复直接运行入口脚本时无法找到项目模块的路径问题
修复	修复 RAR 支持库导入路径错误：标准化为 `from third_party import rarfile`，与 modpack_io、modpack_import 等模块保持一致，解决添加 RAR 模组时提示「RAR支持库不可用」的问题
修复	修复关闭 EAC 启动游戏无法初始化 Steam 的问题：改用 `steam://rungameid/{appid}/{launch_args}` URL 协议启动，确保 Steam 运行时正常初始化，本地 EXE 作为兜底方案
修复	修复主窗口软件名称显示冗余版本号的问题（标题栏与窗口内渐变标题同步去除 v0.2.1 后缀，版本号仅在设置页保留）
优化	优化主题切换体验：切换后实时保存到配置文件，下次启动自动恢复上次使用的主题
优化	优化模组管理与加载排序页面按钮样式：统一分类描边设计，按功能语义使用不同颜色（移动调整=橙、应用=绿、还原删除=红、打包模板=蓝），统一字号 15px，四种状态均带描边
优化	优化代码架构：根目录入口文件迁移至 app/entry.py，模组管理页面迁移至 pages/mods_page.py，删除根目录遗留兼容层
优化	性能优化： • data.ini 批量读取缓存（首次读取提速 1.4x，缓存命中提速 3.1x） • 搜索输入防抖（200ms 延迟，减少连续输入时的表格重绘） • 模块级 mtime 验证缓存机制，文件未修改时直接返回内存数据
优化	优化 EAC 按钮样式：字号调整为 16px、padding 0px 3px，移除鼠标悬停浮动提示框，按钮自适应尺寸避免放大后显示异常
优化	优化添加模组对话框主题适配：浅色/深灰/纯黑三主题完整覆盖（主窗体背景、容器边框、按钮、表格、统计标签、标题栏、拖放区），切换主题后所有控件颜色实时刷新
优化	优化拖放区域提示文字颜色：浅色主题下由灰色调整为黑色（C_TEXT_PRIMARY），深灰/纯黑主题保持高对比白色，三主题可读性统一
新增	新增启动模式切换区域：启动总览页面新增启动模式标签 + 「切换模式」按钮，支持自动/Steam/本地EXE 三种模式循环切换，状态自动保存到配置
新增	新增七日杀 EAC 开关功能：启动总览页面新增 EAC 状态切换按钮（仅七日杀显示），支持一键切换 EAC 启用/禁用状态，状态自动保存到配置，下次启动生效
新增	Mod 预览面板正式实装：右侧分割区域展示 Mod 详情信息（描述、版本、兼容性等）
新增	新增拖放式模组加载功能：支持多文件拖放（.zip/.7z/.rar），自绘虚线边框拖放区域，拖入时高亮反馈与忽略文件计数，后台线程逐个解压并实时更新进度，错误信息直接显示在状态列，无文件数量与大小限制
新增	新增独立可拖动添加模组对话框：无边框独立顶层窗体（Qt.Window），可通过标题栏拖动把手自由移动，光标手势反馈（OpenHand/ClosedHand），固定尺寸 560×520 避免布局抖动
新增	新增系统原生文件选择窗体：「选择文件」按钮调用 Windows 系统原生 QFileDialog，自动记忆用户上次调整后的窗体尺寸，支持压缩包过滤与多选
重构	整体代码架构重构迁移： • 删除根目录遗留兼容层，所有调用方改为直接导入新路径 • mods/ 子模块从 14 个扩充至 22 个（拆分 filter_service、version_compat、preview_builder、theme_refresher 等） • 模组管理主文件从 ~4500 行精简至 ~2150 行（-52%）

v0.2.0 更新内容重要更新

类型	更新内容
新增	新增三主题系统：浅色、深灰、纯黑三套主题色板，三态动画切换开关，全局样式实时重建，所有配色 WCAG 2.1 AA 合规
新增	新增 MOD 仓库多游戏支持：每个游戏可独立设置模组路径，不同游戏的模组互相隔离
新增	新增圆角无边框窗口
优化	优化字体系统
优化	优化配置文件结构
优化	优化 MOD管理配色饱和度
优化	优化启动时自动清理旧版本压缩包，仅保留最新版本

v0.1.5 更新内容重要更新

类型	更新内容
新增	新增 7z 压缩包格式支持：集成 py7zr 库，支持 7z 文件的识别、上传、解析和安装，包含文件格式验证、损坏检测、加密检测和智能解压逻辑
新增	新增右键菜单即时启用/禁用模组：右键点击模组可直接切换启用/禁用状态，即时生效并自动保存，无需点击”应用”按钮
新增	新增右键菜单删除模组功能：右键点击模组可直接删除，删除按钮从按钮栏移至右键菜单，界面更简洁
优化	优化禁用模组排序位置：禁用模组在列表中保持原始排序位置，不再自动移至列表底部；重新启用时恢复到禁用前的位置
优化	优化序号列编号格式：10 以内的编号去除前导零（如 01→1、02→2），10 及以上保持原样，编号序列更简洁一致
优化	优化打包配置：py7zr 库及其所有依赖项（含原生扩展 .pyd）正确包含在打包中，确保生成的 exe 在未安装 py7zr 的系统上独立运行

v0.1.4 更新内容常规更新

类型	更新内容
修复	修复迁移时控制台闪烁问题：使用原生文件操作，避免弹出命令行黑框窗口
修复	优化迁移速度：同盘使用 os.rename 原子操作瞬间完成，跨盘自动回退复制
修复	修复迁移「文件已存在」错误：迁移前检测同名目录，已存在则跳过不覆盖
修复	修复添加模组路径错误：使用 game_repo_dir 替代 repo_dir，确保模组添加到正确的游戏专属仓库目录
修复	修复整合包添加序号错误：新模组追加到现有序号末尾而非从 01 开始，避免序号冲突
修复	修复添加模组后列表不刷新问题：与应用按钮保持一致的刷新逻辑，包含重新排序和仪表盘刷新
修复	修复排序列表序号顺序错误：按文件夹名称前缀的数值排序，而非纯字母排序
优化	优化添加模组前仓库路径检查：未配置仓库路径时弹出提示，阻止后续操作

v0.1.3 更新内容常规更新

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

v0.0.2 更新内容常规更新

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

开发路线图 — 即将解锁

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

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

功能	说明	预期亮点
状态筛选	下拉框按「全部/启用/禁用」状态快速筛选模组	快速过滤
🔗 版本兼容	自动检测模组版本，与游戏版本进行兼容性比对	兼容检测
🏷️ 分类标签	自定义模组分类（UI/物品/建筑/武器等），横版分类栏快速切换	分类管理
右侧预览面板	选中模组后右侧显示详细信息预览，包含 ModInfo.xml 内容和版本兼容性检查结果	信息一目
Mod计数标签	表格底部实时显示当前模组总数和筛选结果数量	状态感知

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

功能	说明	预期亮点
分类筛选栏	表格上方横版分类按钮栏，按类别快速筛选模组	分类管理
类别列	模组表格中显示类别列，支持双击编辑自定义类别	自定义标签
右键管理类别	右键模组弹出菜单中的「管理类别」选项	快捷操作
💾 保存模板	将当前排序保存为命名模板，方便后续快速切换	方案存档
📂 应用模板	从已保存的模板列表中选择一套排序方案一键应用	快速切换
📋 管理模板	查看、重命名、删除已保存的排序模板	方案管理

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

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

🌟 未来愿景 — 更多可能

🎮

游戏列表

多游戏切换管理

🌐

获取模组

模组浏览下载

🤝

远程协助

远程帮助配置模组

支持游戏

当前首发支持七日杀，另有 8 款游戏已列入规划：

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