数据看板 使用文档

版本：Beta V 0.5.0.1026 ｜ 适用页面：左侧导航「数据看板」（软件首页）

一、功能概览

数据看板是打开 ACGM 的第一屏，汇总本地游戏资源的全部关键数字：卡片、模组、插件、云端资源一屏尽览，并内置一键扫描、一键启动、快捷目录等高频入口。

二、前置配置（重要：首次使用先设置游戏目录）

数据看板的全部统计来自本地扫描数据库，首次使用必须先完成游戏目录设置并执行一次扫描，否则各统计项显示为 0。

配置步骤：

1. 设置游戏目录：点击底部「设置游戏目录」，选择游戏根目录；设置成功后自动触发首次扫描，等待扫描完成即可看到全部统计数字。

1. 未登录状态：游客可浏览看板与本地统计；本地扫描、云端刷新、云端资源查看需登录后使用（点击对应按钮会弹出登录引导）。

三、界面导览

┌ 左上：卡片汇总（8 项小卡片，点击可跳转对应管理页）
├ 中上：系统公告（标题加粗，正文链接可点击）
├ 中部：卡片轮播（左右箭头 + 圆点指示，4 秒自动轮播）
├ 右上：本地模组（汇总 / 私密 / 启用插件 / 依赖缺失 / 可修复 / 冲突）
├ 右中：插件仓库（本地插件 / 启用插件 / 依赖缺失插件）
├ 右中：云端资源（云端模组 / 云端插件 + [刷新]）
├ 右下：快捷目录（10 个常用文件夹一键打开）
└ 底部：设置游戏目录 │ 启动器设置 │ 启动游戏 │ 启动工作室

四、统计项口径说明

统计每 5 分钟自动缓存，扫描完成后缓存立即失效重算；加载失败会弹出提示，不会静默显示全零。模组数超过 5000 时页面会弹出大数据提示，建议配合「超级加速」优化加载。

五、基本操作

六、扫描进度说明

• 进度面板：显示 枚举目录 → 计算哈希 → 解析元数据 → 写入数据库 → 解析缩略图 各阶段进度；
• 快速扫描：500ms 内完成的扫描不弹面板，以 Toast 提示完成；
• 扫描前自动清理：自动对账清理手动删文件产生的死数据与孤儿记录；
• 互斥保护：本地扫描与云端刷新互斥，云端刷新进行中会提示等待；与「云端模组」页共用同一把锁，不会并发冲突。

七、常见问题

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