本地插件 使用文档
版本：Beta V 0.5.0.1026 ｜ 适用页面：左侧导航「插件管理 → 本地插件」
一、功能概览
本地插件用于浏览、搜索、启停、清理你已安装到 BepInEx/plugins 目录的全部插件（.dll），是管理本机插件资产的主控台。
| 能力 | 说明 |
|---|---|
| 分类页签 | 全部 / 启用 / 禁用 / 冲突GUID / 插件重复 |
| 中文翻译 | 名称与功能介绍自动匹配云端中文翻译，进入页面时自动同步 |
| 搜索 | 按名称 / GUID / 文件名 / 中文译名 关键词过滤（输入自动防抖搜索） |
| 排序 | 名称 / GUID / 作者 / 文件名 / 修改时间，均支持正序、倒序 |
| 启停 | 右侧开关单击即切换；或勾选后「批量启用 / 批量禁用」 |
| 重复删除 | 「插件重复」页签下一键清理散落的重复副本（移入回收站） |
| 上传云端 | 勾选本地插件一键上传至云端插件库（管理员功能） |
| 状态总览 | 顶栏实时显示 启用 x / 禁用 x / 总计 x |
| 信息透明 | 版本 / 被依赖数 / GUID / 网址 / 修改时间 / 大小 / 功能介绍 全展示 |
二、前置配置（重要：依赖本地扫描）
本地插件列表来自本地扫描数据库，首次使用请先在「数据看板」完成游戏目录设置并执行一次扫描，否则页面为空。
- 进入页面时自动同步云端插件中文翻译库，命中翻译的插件显示中文名称与中文功能介绍，未命中回退原文；
- 插件启停通过改文件后缀实现（
.dll↔.dl_），与游戏实际加载状态完全一致。
三、界面导览
┌ 顶栏：全部 │ 启用 │ 禁用 │ 冲突GUID │ 插件重复
│ ☑全选(已选: n) [批量启用] [批量禁用] [重复删除] [上传云端*] 搜索框 [默认排序(GUID)▾]
│ 右侧状态：启用 155 / 禁用 19 / 总计 174
├ 中：插件列表（DLL 徽标 / 名称 / 版本 / 被依赖数 / GUID / 网址 / 修改时间 / 大小 / 功能介绍）
│ 每条右侧：[文件夹图标=定位文件] [启用开关]
└ 底栏：◀上一页 第x/y页(共 n 条) 下一页▶ │ 跳页输入框 [跳转]
* 上传云端仅管理员账号可见。
四、页签口径说明
| 页签 | 口径 |
|---|---|
| 全部 | 本地全部插件 |
| 启用 / 禁用 | 按当前启停状态筛选（以磁盘文件后缀为准） |
| 冲突GUID | 同一 GUID 存在多个副本的插件（多版本并存，建议只保留最新） |
| 插件重复 | 同文件哈希散落在多个路径的插件（重复删除即清理这些副本） |
五、基本操作
| 操作 | 方式 |
|---|---|
| 启用 / 禁用单个插件 | 点击条目右侧开关（.dll ↔ .dl_，绿色=启用） |
| 批量启用 / 禁用 | ☑勾选目标 →「批量启用 / 批量禁用」 |
| 清理重复副本 | 切到「插件重复」页签 → 点「重复删除」→ 副本移入回收站 |
| 上传云端 | ☑勾选插件 →「上传云端」（仅管理员可见） |
| 定位文件 | 点击条目右侧文件夹图标，打开所在目录并选中该文件 |
| 搜索 | 输入关键词自动搜索（防抖），覆盖名称 / GUID / 文件名 / 中文译名 |
| 排序 | 顶栏下拉切换排序字段与方向；默认按 GUID 排序（同作者自动聚合） |
| 翻页 | 每页 20 条；「上一页 / 下一页」或输入页码点「跳转」 |
六、进阶说明
6.1 被依赖数
条目上的「被依赖 (n)」表示有多少个其他插件声明依赖它。禁用前看一眼，避免把关键依赖关掉导致连锁报错。
6.2 冲突GUID
同一 GUID 的多个副本会让游戏加载行为不确定。建议在该页签核对版本号，仅保留最新一份，其余禁用或删除。
6.3 重复删除
- 将「插件重复」页签下所有散落副本移入系统回收站，不会直接物理删除，可从回收站恢复；
- 此功能需要会员等级 ≥ 2，未达等级时会提示权限不足。
七、常见问题
| 现象 | 处理 |
|---|---|
| 页面空白 / 提示数据库不存在 | 先到「数据看板」设置游戏目录并执行扫描（见二） |
| 开关拨了没反应 | 游戏正在运行导致文件被占用，关闭游戏后重试 |
| 名称没显示中文 | 云端翻译库未收录该插件，会回退显示原文；翻译库持续扩充 |
| 「重复删除」提示权限不足 | 需会员等级 ≥ 2 |
| 看不到「上传云端」按钮 | 仅管理员账号可见 |
| 删除了重复副本想恢复 | 删除为移入回收站，从系统回收站还原即可 |
文档与软件同版本维护；界面按钮以实际版本为准。