DropDeltaGUI 通过对核心算法主程序的封装，来实现识别🛆的游戏视频来获取搜索信息并给出统计和汇总，使用 GUI 进行交互，主要框架为 Tauri。
配套项目有：
- drop_delta：核心算法CLI程序。
- DropDeltaServer：最简化版本的服务端。
如果您在寻找核心的算法CLI程序，请选择 drop_delta。如果您在寻找一个可部署的最简服务端请选择 DropDeltaServer。
- 封装了大部分核心算法中的功能，提供用户友好的 GUI 界面。
- 补全了数据分析和展示的功能，可以可视化的获取搜索数据信息。
- 目前综合识别正确率70%左右
注意！目前所有路径不支持中文字符！
-
目前仅对 Windows 做了相关适配。
-
确保电脑上安装了 WebView 2。
WebView 2 已自动安装在 Windows 10（从版本 1803 开始）和更高版本的 Windows 上
-
可选：安装 CUDA12.9 及对应cudnn，仅GPU版本需要。
在 release 中下载安装包，根据安装包指引即可完成安装。如果已经安装了核心算法程序可输入对应地址并使用已安装的核心算法程序，否则可以选择自动安装 CPU / GPU 版本核心算法程序。
首次启动后，默认进入“视频处理”页面，但是需要先完成一些准备工作才能开始处理视频和查看数据。
在首次启动的时候，可以选择将安装时附带的物品，物品价格表以及容器读入到数据库。
或者如果您已经有了一个适配的服务端地址，可以稍后在服务器交互界面向服务器请求数据。推荐在这里直接读取本地数据，以便于在没有服务器的情况下处理视频。
点击右上角的齿轮按钮，打开设置。
在设置页面中点击第一个卡片的“导入 Init Data”按钮，来执行默认数据导入。
玩家指的是同一个用户可能具有的不同账号之间的唯一标识符，通过玩家可以将使用同一个 DropDelta 的不同账号的数据区分，同时可以共用配置（如果两个账号画面设置相同）设置和一些服务器下载的统计数据。
点击左侧侧边栏的“玩家管理”，进入相应页面。
进入页面后，如果是第一次使用则会显示当前无玩家，点击右上角添加玩家并输入一个可以区分你的不同账号的字符串。
给多个账号配置同一个玩家，会使得两个账号数据混在一起，如果没有特殊需要可以给两个账号使用不同的玩家身份。
配置文件是进行视频解析的一些必须数据，根据每个人游戏视频分辨率以及一些画面设置的不同而不同，因此每个用户在使用的时候必须生成自己的配置文件。
配置文件本身比较复杂，尽管有UI辅助，仍然不是一件容易的事，但是配置文件的好坏直接影响到视频解析效果，因此需要格外小心。
配置文件的生成需要您录制一段简短的游戏视频，具体来说有以下要求：
- 录制时需要保证屏幕无遮挡，例如英伟达的实时参数信息，需要关闭或者设置仅录制游戏本身画面。
- 视频中，不能携带任何胸挂和背包，背包和胸挂会挤压搜索 UI 位置，造成参数不准。
- 请在点击“出发”按钮前开始录制。
- 至少搜索两个容器，包括人机/干员盒子，等有搜索 UI 的容器，但不包括电脑以及露天容器等无 UI资源点。
- 确保帧率和画质就是之后录制用来解析的游戏视频的帧率和画质。推荐使用30 fps 或者 25 fps 录制，不推荐超过60帧，及低于5帧，过高使得处理速度慢，过低会导致误识别率高。码率无要求，尽可能清晰，但是过高码率可能导致硬盘空间不足。
- 推荐使用英伟达的自带录屏，对游戏影响小。
有关录制的参数，下面给出一个示例，注意屏幕分辨率为2560*1080，不同屏幕分辨率的码率可以不同，分辨率越高选取码率也高一点。
如果使用英伟达录制，那么可以通过以下选项来保证仅录制游戏，即关闭桌面录制。
通过以下选项来关闭性能参数。
如果必须打开性能参数，推荐调节到屏幕下方左侧/中部/右部均可。
综合以上要求，比较推荐的配置视频录制方式是干员选择威龙，地图选择普通大坝或者普通长弓，清空装备后进入地图跑刀，搜索2-3个容器（包括人机盒子）后自雷，结束录制即可。
视频录制成功后，检查是否满足以上要求。
接下来开始制作配置文件，点击左侧侧边栏的“配置管理”，进入相应页面。
首先点击视频管理，进入视频页面，接下来点击选择视频卡片，打开导入视频对话框。
点击对话框第一行右侧的“文件夹”按钮，打开文件选择器，在其中选择刚刚录制的视频。
选择好视频后，直接点击右下角确认即可，生成中间视频可能需要一点时间，取决于导入视频的帧率和时长。
如果您导入视频的分辨率较低（1080p 以下）可以将缩放系数调高来让中间视频更加清晰。
视频导入成功后，选择页面上方的“地图特征”选项卡。
进入页面后点击“新增一帧”，打开对话框。选择刚刚导入的视频，然后点击第二行右侧的“剪刀”按钮，来打开帧选择器。
进入帧选择器后，改变视频进度，让画面暂停于刚开始没进游戏没匹配之前要开始匹配的位置，这时候右下角应该有“配装”以及“出发按钮”。确认绿色的两个按钮出现在画面中后，点击右下角“对勾”确认选择，然后生成帧。
Tip: Space：暂停；S：倒回5s；W：前进5s；A：上一帧；D下一帧；按住AD可以缓慢加速。
接下来回到对话框点击确认生成。
增加了一帧后，这时候再次点击添加按钮，同样的步骤，但是选择另一个包含“配装”以及“出发按钮”的帧，来增加配置文件健壮性。
接下来选择一个未标注的图片，点击图片下方的标注按钮进行标注。
打开标注画板后，看下方的标注提示来进行标注。
不想标注/希望取消标注按下Esc，单个标注错误点击清空。
WASD控制画面上下左右，鼠标滚轮控制画面缩放。
工具栏中从上到下，分别是：“点选择”， “矩形选择”， “水平线”，“垂直线”。
首先在右侧工具栏找到“点选择”（第一个选项）
接下来鼠标放在右下角零号大坝图片左上角，滑动滚轮放大，可以使用WASD微调来让左上角处于画面中央。注意不要左键点击画板，否则会标注到错误位置或者不能进行下一步。
点击这个卡片的左上角像素块，进行标注
接下来点击右下角的绿色箭头，进行下一步标注。
成功后，点击工具栏的“矩形选择”（第二个），并且使用滚轮和WASD微调让绿色按钮处于画面中央。
接下来放大绿色按钮左上角，用鼠标点击一下绿色区域左上角来选择矩形的左上角。（先不进行二次点击，让选区跟随鼠标即可）
点击时，矩形选区左上角自动吸附到最近的网格交点，因此尽可能不要在方格中间点击，可能会偏移到其他地方。
接下来使用鼠标滚轮，让画面缩小，方便移动画面更快。（这里还没有进行第二次点击）
同时按下D键，移动画面到绿色矩形右下角，再放大，点击右下角像素，来固定矩形选区。这里不可以反向标注，也就是不能先标注右下角再标注左上角，需要先标注左上角在标注右下角。
注意：不要超出绿色区域范围，否则效果不好，并且尽可能贴合绿色区域，不要差太多。
标注成功后点击右下角“对勾”来完成一帧标注。
可以看到标注完成后Tag变为“已标注”。接下来对另一个图片进行相同的操作。
两张图片均标注完成后，点击图片下方的Switch，切换状态为ON。激活后的图片及标注会被用来生成测试图片，未被激活的图片及标注不会被用来生成测试图片。
这里可以先只激活一张图片，或者两个都激活，为了演示并且查看特定图片标注情况，此处先激活一张图片。
激活后点击右上角的生成测试图片按钮，等待生成测试图片。
生成完成后，激活图片的“已标注” Tag 出现一个小点，提示存在对应的测试图片，鼠标移动到“已标注” Tag 上即可看到图片的小窗口预览。如果需要细致观察图片，点击“已标注” Tag 即可固定小窗，固定后可点小窗中测试图片，即可放大预览。
可以看到测试图片效果不好，预期的效果图为中间为白色方块，外侧均为黑色。这里外部也出现了白色。遇到这种情况，可以点击右上角“扳手”按钮，打开生成设置页面。
因为目前情况是程序把一部分背景色也当成按钮颜色一部分，导致了背景也染成了白色，因此可以选择调低覆盖率。这里我调为92，点击确认。（每个人电脑上需要覆盖率可能都不相同，可以多试一试）
调节后，背景中的白色直接消失了，即生成测试图片效果不错。
如果中间文字并未被挖空，也是没有影响的，如下图也是可以的。
NOTE：这个地方需要反复调节，其他几个特征也是同理，这里给出一个调节参数的Tip：
- 最常用的是覆盖率，如果白色区域过多，染到了背景上，就可以尝试调低覆盖率后继续生成。如果矩形区域存在空洞，可以适当调高。
- 当调节覆盖率会导致要么背景也被染色，要么内部就少一块，就可以尝试增加K值，或者调节K值，多尝试几次。
- 部分特征具有背景色过滤比例，会在计算好颜色范围后挖去背景色，当背景染上的颜色较多的时候可以适当调高，如果矩形区域产生了空洞，可以调低。
- HSV扩展比例能控制的效果较少，一般不怎么调节，效果不明显。
- 多个图片之间只会生成一个配置，也就是说，如果单个图片调好了，可能多加入一些图片及标注就会影响原本效果较好的图片。因此如果当发现怎么调节都调节不好的时候，可以战略性关闭一些图片的激活 Switch，仅使用一部分来生成测试图片，以此来保持较好的效果。
确保第一个图片标注对应的测试图片已经效果较好了，就可以打开激活第二个图片及标注，注意：激活第二个图片也会影响第一个图片，如果发现反复调节不好，可以尝试关闭一些图片的标注。
两个都标注好了就可以点击上方下一个选项卡：“容器特征”。
之后的三个特征，其实流程都差不多，这里为了缩小篇幅，重复的截图就不在给出了。
依然推荐选择复数个关键帧，关键帧的要求是，画面中要有搜索容器的 UI，并且UI不可以还在平移动画中。（刚打开一个容器，容器的 UI 会从画面右侧平移一段距离，必须等平移结束后再截图。）
示例图片如下：
人机/玩家盒子也可以接收，这里不给出具体截图了，这里推荐截图2-3张，来提升准确率，最好是不同的容器。
接下来依然是对截好的关键帧进行标注，这里要标注的内容较多，如果标注错误并且已经提交，可以点击 esc 键来取消整段标注。
首先第一个是容器 UI 格子的左上角，也就是图中箭头所指位置，下面给出概览图，标注图，最终远视图。
接下来是容器格子 UI 上方的红色信息 UI，这里需要框选，尽可能框选准确，这里给出概览图，左上角标注图，右下角标注图，最终远视图。因为红色矩形区域较长，推荐固定好左上角选区后，用鼠标滚轮缩放一下，来方便 WASD 移动。
接下来选择红色信息 UI 上方的黑色背景，注意不要选取到红色区域的像素，可以距离红色区域一个像素来保证这一点。给出左上角选取，右下角选取，最终远视图。
接下来选取一个容器 UI 中的格子，不要求位置，只要框出格子即可。框选的时候外接边框可以框也可以不框，算法有5像素左右容差。给出概览图，左上角标注图，右下角标注图，最终远视图。
最后是一个水平线的标注，为了简单起见，就标注在玩家UI的下边界，如下图。
完成以上标注后点击右下角按钮确认即可，可以直接激活对应图片及标注来生成测试图片，也可以等所有全都标注完成后再进行标注。
标注理想效果为，画面中有一块区域为白色矩形其他地方为黑色。
下图中生成的测试图片，基本合格，但是白色矩形有部分黑色漏洞，可以调节覆盖率，将覆盖率调高后的结果图也给出在下方。
接下来对每个帧进行标注，最后确保生生成测试图片具有较好效果即可。
接下来进入下一个选项卡：“搜索特征”。
搜索特征对关键帧的要求是，画面中必须存在“F 搜索 容器名”这样的搜索提示，如下图。
选取不同容器的两帧后开始进行标注。
首先标注 F 键的外接矩形，也就是按照 F 键的轮廓进行标注，尽量贴合轮廓。下面给出标注起始点，终点，以及最终远视图。
接下来对 F 键内部的内接矩形进行标注，注意不要圈到白色区域外。下面给出起点，终点，以及最终远视图。
接下来选择文字内部的黑色背景，横向竖向选择均可，给出最终远景图。
最终较好的效果图，只有按钮那里是白色，其余地方都是黑色或者是斑点。这里生产的按钮轮廓不够锐利，有些缺损可以考虑调节一下覆盖率和背景过滤比例。
增加覆盖率降低过滤比例后稍微变好了一点。
其他的图片标注好后也可以激活进行测试，这里有些情况下某些图片可能会污染整个生成结果，如果最终效果不好，可以尝试关闭一些标注保留剩余标注来产生一个比较好的结果。
在某些情况下，如果容器的颜色比较鲜艳也会影响测试结果，可以优先选择暗色调的容器的对应搜索提示进行标注。
注意这个标注很多情况下都是标不好的，这不是标注的问题，这个地方的特征本身就难以标注/生成完美。
这个地方的特征，只有当玩家输入视频中，搜索容器没搜索完全的时候才会启用，因此如果您觉得这里怎么都调不好，可以仅选择调节到某个较好的结果，不必苛求完美。
接下来进入选项卡“匹配特征”。
这个特征的关键帧，要求画面中最上方，出现匹配成功的字样，如下图。
这里推荐取两帧：在刚匹配成功的时候，这个时候的上方绿色条带颜色最亮，然后会缓慢变暗，推荐截取最亮和较暗的两帧。较暗帧如上图，最亮帧如下。
接下来进行标注，标注的矩形区域为绿色条带。
注意这里绿色条带往往紧紧挨着画布边缘，不要标注到屏幕外面。另外注意不要圈到绿色条带之外，可能会比较明显的影响生成图片效果。
另外选取好左上角后可以缩放鼠标滚轮后 WASD 来操控画面，这样移动的更快可以节省时间。下面给出起点，终点，还有远视图。
标注完成后即可开始生成。生成图片期望效果是上半部分白色，下半部分纯黑。下面是刚刚的标注生成的图片。
这一步也比较难以调节出完美的样子，但是和上一个特征不一样，这里如果缺失/没有标注好会导致整个视频识别失败，因此尽量多调整一下，上图效果就差不多可以，有部分白色溢出问题不大。
下面的也差不多可用。
如果发现溢出的部分较多，可以调低覆盖率，下面是调低覆盖率后结果。
到此标注全部完成，选择最后一个选项卡“当前参数预览”。
这个选项卡可以看到之前的标注图片，鼠标移动上去可以看到具体标注坐标，点击图片可以进到对应文件夹。
这里选择右下角的“生成配置”按钮来使用之前的标注生成一份配置文件。时间较长，大概等于前面4个生成时间的总和。
生成成功后可以回到“配置管理”选项卡看到自己生成的配置，说明配置彻底完成。
配置生成后就可以开始识别了。
识别视频的要求为：
- 录制的时候必须在点击“出发”按钮前开始录制才能识别相关对局，组队情况下可以不自己点击，但是必须录到存在出发按钮的画面。
- 录制的时候可以录制多个对局，只要磁盘空间足够。
- 录制的时候不要遮挡刚刚配置生成中标注的特征点。如：在搜索容器的时候左键点击了某个物品，然后打开了物品信息的卡片，遮挡了上方红色 UI，就会导致这一段搜索被丢失。
所以刚刚的配置视频可以正好拿来测试，或者您也可以选择一个符合上述要求的视频。
点击添加视频区域/拖动视频到添加区域，来导入视频。
导入后右侧自动弹出视频信息/处理界面。
可以点击转换帧率进行帧率转换操作，将原视频帧率降低来加速后面的处理，仅视频帧率较高的时候推荐，如90帧。低帧率下直接设置间隔来抽帧速度更快。
可以点击选择视频来重新选择一个视频。
滑动信息面板，在下方填写选项，包括“所属玩家”，“配置选择”，“处理间隔”，以及选填的视频时间。
所属玩家指的是视频的游戏账号对应的玩家。
配置选择就是刚刚生成的配置，如果不改动画面选项/更换显示器等，基本不用更改。
处理间隔，是一个关键选项，指的是在原视频基础上抽帧的周期。如：这个视频是30fps，处理间隔设置为5就等效为6fps的视频。这里推荐让等效 fps 在5-15，低于5fps 会使得数据大量丢失，高于15fps，则会有很多不必要信息，延长处理时间。一般来说，可以让等效 fps 在5-10范围，性价比最高。
视频时间点指的是，视频开始录制的时间，如果使用英伟达录屏，视频名字里会自带时间如：“Delta Force 2026.02.07 - 15.26.48.03.mp4”，这种情况下不需要自己填写视频时间，如果视频名称里没有时间则需要手动填写不然会报错。
如果您使用 GPU 版本，请确保已经安装了 CUDA12.9 及配套 cudnn。
如果 CUDA12.9 不在环境变量中/不是优先级最高的 CUDA，请先完成 CUDA 环境设置：点击右上角窗口栏中齿轮图标进入设置页面，在左侧环境变量中填入 CUDA 主目录地址（eg：E:\NVIDIA GPU Computing Toolkit\CUDA\v12.9），之后保存并应用更改，确认保存成功后即可正常操作。
如果您使用 GPU 版本，发现处理 Last Parse 的时候卡住不动说明CUDA配置有问题，这时候使用任务管理器搜索 DropDelta，然后停止两个进程，一个 UI 一个算法核心进程。之后就可重新配置 CUDA 或寻找错误原因了。
接下来就可以开始生成了，点击开始处理按钮，就可以开始了，时间可能比较长，请耐心等待。
完成了以上的处理后，数据已经存入数据库，可以进入左侧侧边栏的“数据统计”页面。
如果第一次进入，弹出报错是正常的，说明你还没有配置服务器地址，先关掉报错。
然后在弹出的对话框中选择自己的玩家，如果不小心关闭了，可以在右上角重新打开选择玩家对话框。
选择完成后综合统计会显示一个“均衡玩家”的占位符，实际上这不是真实的报告，因为还未同步服务器数据。
首先点击右上角的“云朵”按钮，打开服务器操作对话框。
首先填写服务器的 url 和 apikey。
如果您个人/第三方架设了服务端，那么请填入对应服务器 url 和 apikey。
如果您没有/不知道第三方服务端，那么可以填入这个url: dropdelta.top:5011 ，这是一个最小实现的简单服务端，但是不确定您看到文档时是否还存在。apikey 可以任意填写，推荐您填写的时候选择一个不会和别人撞到一起的 apikey 否则服务端会把您和他人的数据混在一起，可以填写您的游戏 uid 等具有唯一属性的字符串。这里不推荐写入任何和隐私相关的字符！
填写成功后点击下方“获取基础数据”按钮来从服务端下载如：物品，物品价格，容器的一些数据，以识别对应新物品或者统计的时候使用新的价格表，服务器价格表并非每天更新，取决于服务端。
如果您不想上传自己的数据，请勿点击同步统计数据。上传的服务器可能属于第三方，请确保其安全性。
成功后点击“同步统计数据”即可把本地数据不记名上传，并且下载服务器上存储的玩家平均爆率等信息，便于之后计算玩家的排名等信息。
同步完成后个人报告中有些原本是NOINFO的地方就会变成真实数据，并且玩家称号也会基于排名计算。
可以点击右上角的分享按钮来分享个人报告。分享的图片比例和当前窗口中对应区域的宽高比有关。如果您想制作便于在手机上查看的长图，请缩小窗口的宽度；如果您想制作便于在电脑上查看的宽图，请全屏化后分享。
点击上方容器统计选项卡，跳转到对应页面。
其中容器包括玩家本地搜索过的容器和服务器其他玩家搜索过的容器，可以查看卡片右侧状态了解信息。
可以点击过滤条件对下方容器进行过滤，也可以点击容器卡片查看具体数据。
点击物品统计选项卡，可以看到物品统计页面。
其中均为被对应玩家搜索出的物品，同样可以进行过滤和查看卡片信息操作。
点击设置页面，可以选择硬件加速模式，指的是识别视频的时候是否使用硬件加速，默认自动，如果是GPU版本就是开启，CPU版本就是关闭。如果是A卡强制使用硬件加速可能导致读取视频出错。
- 确保已安装 Git 并加入环境变量。
- 确保可以访问 GIthub 等网站，并且可以在命令行添加代理，如果在命令行操作中遇到网络问题，打开命令行代理。
- 为了安装对应版本 pnpm，需要满足安装 Nodejs（推荐版本：v24.13.1）。
- 可以运行 DropDelta 核心算法程序。
打开终端，输入以下命令全局安装 pnpm。
npm install -g pnpm@10.30.1进入项目主文件夹（DropDeltaGUI）并打开终端，执行安装依赖。
pnpm install如果要运行项目，必须确保输出exe同级目录下存在一个 dfdr_exe_path.txt，其中存储可以运行的一个核心算法程序（drop_delta）的地址，如：D:\DropDelta\drop_delta\drop_delta.exe。
对于开发模式，输出exe位置为 <项目主文件夹>\src-tauri\target\debug\dfdrgui.exe，对于打包模式，输出exe位置为<项目主文件夹>\src-tauri\target\release\dfdrgui.exe。
执行以下命令，成功后会同时启动后端和前端窗口。
pnpm tauri dev执行以下命令，等待一段时间后打包exe会出现在<项目主文件夹>\src-tauri\target\release\dfdrgui.exe。
pnpm tauri build制作安装包需要使用 InnoSetup（推荐版本：6.7.1），可以从这个页面下载对应版本。如果要制作中文安装包，还需要下载中文补丁，并放置在 <InnoSetup主文件夹>\Languages\ChineseSimplified.isl ，中文补丁在这个页面下载。
使用 innoSetup 打开项目主目录下的 setup.iss 文件，首先必须修改 MySourceGPUFiles 以及 MySourceCPUFiles 两个define，分别对应GPU版本核心算法程序文件夹内所有文件和CPU版本核心算法程序文件夹内所有文件，eg： D:\delta_force_drop_rate\build-clang-release\drop_delta_gpu\*。
其余设置可以根据具体情况修改，但是如果没有特殊要求就可以开始打包。成功后安装包会出现在 <DropDeltaGUI主文件夹>\SetUpOutput\ 中。