卫戍协议强化学习实验的独立可视化工具。浏览轨迹与诊断报告,检查各轮站位、朝向、装备、商店与盟约,并播放原生战斗帧。
Python 3.10 及以上。基础文件浏览使用 Python 标准库与浏览器。
git clone https://github.com/ArkStrongholdRL/ArkGuardRL-Viewer.git
cd ArkGuardRL-Viewer
python3 -m venv .venv
.venv/bin/python -m pip install -e .
.venv/bin/arkguardrl-viewer --results-root /absolute/path/to/results打开 http://127.0.0.1:8765。也可以运行 python -m arkguardrl_viewer,参数相同。
服务绑定本机地址。查看服务器上的记录时使用 SSH 隧道转发该端口。
基础部署区棋盘直接使用快照中的单位名称、坐标和朝向。完整原生渲染可挂载已有游戏安装与 Pixi 依赖。
arkguardrl-viewer --results-root /path/to/results \
--engine-root /path/to/Stronghold-Protocol \
--vendor-root /path/to/existing/public/vendor--engine-root 应包含 data/、shared/、public/js/ 等目录。
原生渲染器与资源从该安装读取。--vendor-root 默认使用游戏的 public/vendor。
.jsonl、.ndjson及其.gz压缩文件支持完整状态轨迹。记录可直接保存,也可包装在record字段。state或after字段提供状态,header与footer提供元数据和结果。.json、.json.gz支持诊断报告与训练指标。ready可以是各轮快照,也可以包含before、after及漏怪等诊断字段。页面展示已记录的 Ready 前局面,完整诊断字段保留在原始记录中。- 仅有动作的
actions.jsonl.gz可通过下方导出命令在匹配版本的 Core 中重放,生成状态和战斗帧。缺少状态的文件在观察台显示其记录元数据。 - 首页的“打开战斗帧播放器”接受
arkguardrl/native-battle-replay-v1JSONL,支持播放、拖动进度、倍速、位置和血条。
JSON 报告解压后上限 32 MiB。JSONL 按需读取状态帧,扫描上限 512 MiB 解压数据或 50,000 个状态。单行上限 8 MiB。
这一功能使用另行安装的 ArkGuardRL-Core、对应平台的原生扩展和游戏数据。 重放需要与原记录匹配的游戏版本、Core、初始核心、DIY 配置和引擎种子。
arkguardrl-replay \
--data-root /path/to/Stronghold-Protocol/data \
--native-library /path/to/_native.so \
--core band_sarkazb --seed 543260021 \
--actions /path/to/actions.jsonl.gz \
--out /path/to/new-replay.jsonl \
--html /path/to/new-replay.html--seed 对无头动作日志必填,有头记录可从元数据读取。JSON 动作文件接受 engine_seed、actions 和可选 core、diy、setup_revision。
--core 默认 band_chen,应按原始记录指定。导出保留实际胜负,输出路径须为新文件。
--sample-ticks 默认 3,对应 30 Hz 引擎约每 100 ms 采样一次。
生成的 HTML 可直接打开,包含播放器和全部帧数据。
保留原观察台的人工接管与示范记录入口。该入口使用已有 Research/Core 的基础 route policy 运行时,需要另外安装兼容的 arkguardrl-research、Core、Torch 与游戏运行环境。新 EntityTransformer 模型的实时接管接线仍需适配。
人工示范写入结果目录,保留动作来源与 on_policy=False 标记。此功能目前按原实现迁移,独立仓库首次发布尚未完成实时对局运行确认。
从 ArkGuardRL-Core 的训练观察台和原生回放工具拆出。采用 GPL-3.0-or-later,来源说明见 NOTICE.md。