SuperAPI AI 工具集

underworld-overseer-save-mapper

通用与其它

查看项目

更新于 10-16 04:58

技能介绍

用途:本技能用于校验《Underworld Overseer》的 .json 存档,并配合上游项目 RobThePCGuy/Underworld-Overseer-Save-Mapper 生成或排查交互式地牢地图。它只可视化用户自有存档,不修改游戏进度,也不是存档编辑器,不适用于其他存档格式、存档修改或受保护游戏数据的逆向。

主要能力:安装或更新上游地图工具(不复制游戏存档);校验存档结构;生成交互式 HTML 地牢地图;诊断缺失单元格、标签或输出问题;检查坐标边界、描述符数量与重复坐标。

使用方式:先保存源存档副本并记录路径与哈希,切勿覆盖游戏当前存档。校验命令: python3 .agent-skills/underworld-overseer-save-mapper/scripts/validate_save.py /path/to/save.json 仅检查时加 --json。存档需为顶层对象并含 Map 列表,每个单元格含整数 X、Y 坐标和非空字符串 DescriptorID;重复 (X, Y) 视为有歧义。安装/检查上游: bash .agent-skills/underworld-overseer-save-mapper/scripts/setup.sh --check bash .agent-skills/underworld-overseer-save-mapper/scripts/setup.sh --install 安装器使用独立数据目录与虚拟环境,安装 pandas 和 matplotlib(pathlib 属 Python 标准库,不应从 PyPI 安装)。随后在本地终端运行上游 main.py,当前 UI 会优先查找 ~/AppData/LocalLow/MyronSoftware/UnderworldOverseer/Saves,若目录不可用则程序在提供自定义路径前退出。

验证点:输出 HTML 存在且非空;渲染坐标边界与校验输出一致;代表性描述符出现在图例中;搜索、缩放/平移、颜色控制和深色模式在本地可用;存档文件未被改动。

限制:上游 README 称项目为 beta,标注 MIT,但所查提交的根目录没有 LICENSE 文件,因此不要按已核实许可证再分发其代码或二进制文件。浏览器仅用于查看生成的 HTML,不必为解析存档使用浏览器自动化。