👁 阅读 16 次 · 更新于 2026-10-27

ACGM 本地模组使用文档

版本：Beta V 0.5.0.1026 ｜适用页面：左侧导航「模组管理 → 本地模组」

一、功能概览

本地模组用于浏览、搜索、启停、清理你已安装到游戏目录的全部 MOD（.zipmod / .zip），是管理本机模组资产的主控台。

能力	说明
分类页签	全部 / 启用 / 禁用 / 冲突GUID / 模组重复 / 社区模组 / 私密模组
搜索	按名称 / GUID / 文件名 / 作者关键词过滤
排序	作者 / 文件名 / 修改时间 / GUID / 文件大小，均支持正序、倒序
启停	右侧开关单击即切换；或勾选后「批量启用 / 批量禁用」
批量删除	勾选后一键移入回收站（可回收）
冲突处理	冲突页签自动勾选非最优版本，一键移动冲突模组到备份目录
去重清理	重复页签一键清理同哈希文件，释放磁盘空间
定位文件	文件夹图标直接打开模组所在目录并选中文件
信息透明	大小 / 作者 / 版本 / 类型 / 修改时间 / GUID / 被依赖数 / 网址全展示

二、前置配置（重要：依赖本地扫描）

本地模组列表来自本地扫描数据库，首次使用请先在「数据看板」完成游戏目录设置并执行一次扫描，否则页面为空。

点击右上角「刷新」可随时重新扫描模组目录、同步最新文件状态；
进入页面前会自动清理失效记录（磁盘上已不存在的文件），保证列表与磁盘一致。

三、界面导览

┌ 顶栏：全部 │ 启用 │ 禁用 │ 冲突GUID │ 模组重复 │ 社区模组 │ 私密模组
│        ☑全选(已选 n 项) [批量启用] [批量禁用] [删除模组] 搜索框▼ [GUID正序▾] [刷新]
├ 警示条：MOD 数量较多（xxxx 个），已启用分页浏览（数量 > 5000 时出现）
├ 中：模组列表（名称 / 大小 / 作者 / 版本 / 类型 / 修改时间 / GUID / 被依赖数 / 网址）
│    每条右侧：[文件夹图标=定位文件] [启用开关]
├ 勾选模组后底部状态栏显示文件路径
└ 底栏：◀上一页 第x/y页(共 n 个) 下一页▶ │ 跳页输入框 [跳转]

四、页签口径说明

页签	口径
全部	本地全部有效模组
启用 / 禁用	按当前启停状态筛选（以磁盘文件后缀为准，与游戏实际加载一致）
冲突GUID	同一 GUID 有 ≥2 个启用副本的模组（实时判定，禁用处理过的自动消失）
模组重复	同文件哈希存在多份副本的模组（删掉并重扫后自动消失）
社区模组	GUID 存在于云端公开库的模组
私密模组	本地有、云端公开库没有的模组

五、基本操作

操作	方式
启用 / 禁用单个模组	点击条目右侧开关（通过改文件后缀实现，绿色=启用）
批量启用 / 禁用	☑勾选目标 →「批量启用 / 批量禁用」
删除模组	☑勾选目标 →「删除模组」→ 确认后移入回收站
定位文件	点击条目右侧文件夹图标，打开所在目录并选中该文件
搜索	输入关键词 → 回车或点搜索，支持名称 / GUID / 文件名 / 作者
排序	顶栏下拉切换排序字段与方向；默认按 GUID 排序（同作者自动聚合）
翻页	每页 10 条；「上一页 / 下一页」或输入页码点「跳转」
重新扫描	点右上角「刷新」，同步磁盘最新状态

启用/禁用/删除/清理等写操作需登录后使用。

六、进阶：冲突与去重

6.1 冲突GUID

同一 GUID 的多个启用副本会导致游戏加载行为不确定。切到「冲突GUID」页签时，系统会自动勾选每组中的非最优版本（按版本号与文件路径智能排序），确认后可一键移动：

系统将保留每组 1 个最优版本，其余移动到备份目录（非删除）；
支持使用默认导出目录或临时指定，可设为默认；
移动完成后冲突条自动消失，如误删可从备份目录放回。

6.2 模组重复

完全相同的文件占了多份磁盘空间。切到「模组重复」页签时排序自动切换为文件大小倒序，疑似误报一眼可辨：

点「去重清理」：每组保留最新版本，其余移入回收站；
删除前会做全量哈希二次校验，非同源文件自动跳过，不会误删。

七、常见问题

现象	处理
页面空白 / 提示数据库不存在	先到「数据看板」设置游戏目录并执行扫描（见二）
开关变灰或操作提示"被占用"	游戏正在运行，关闭游戏后重试
提示"未配置模组扫描目录"	点「刷新」前请确认已在设置中配置模组扫描目录
删除了模组想恢复	删除为移入回收站，从系统回收站还原即可
冲突页签有条目但无法处理	冲突判定以"启用副本 ≥2"为准，先手动禁用多余副本
列表数字与看板不一致	点「刷新」重新扫描，进入页面时也会自动清理失效记录

文档与软件同版本维护；界面按钮以实际版本为准。

ACGM 本地模组 使用文档