nxapi SplatNet 2数据备份指南:如何下载全部历史对战、鲑鱼跑结果与X Rank记录
nxapi SplatNet 2数据备份指南:如何下载全部历史对战、鲑鱼跑结果与X Rank记录
nxapi 是开源的任天堂 Switch 应用接口工具,支持命令行、Electron 桌面应用和 TypeScript 库三种形态。这篇 nxapi SplatNet 2 数据备份指南将教你用几条命令把 SplatNet 2(Splatoon 2 游戏内应用)里的对战记录、鲑鱼跑(Salmon Run)结果和 X Rank 赛季记录全部下载到本地,实现个人战绩的永久存档。🦑
为什么用 nxapi 做 SplatNet 2 战绩备份?
Switch 游戏内的 SplatNet 2 界面只能翻看最近的战绩,没有导出功能。而 nxapi 直接调用任天堂官方接口,可以把数据以 JSON 和官方分享图片的形式落盘保存:
- 对战记录:普通 / 排名 / 私人 / 祭典对战的完整详情(KDA、涂地、武器、队友)
- 鲑鱼跑结果:每次任务(job)的完整数据,包括同伴信息
- 用户档案:等级、生涯累计数据、生涯墨水挑战、头像卡
- X Rank 赛季:赛季列表与战力排名数据
- 增量备份:已存在的文件不会重复下载,适合配合监控模式长期积累存档
官方命令行说明见 docs/cli.md,API 库文档见 docs/lib/splatnet2.md。
快速上手:安装 nxapi 并登录 Nintendo Account
备份前需要先安装 nxapi 并登录 Nintendo Account(要求账号曾绑定过 Switch 主机;SplatNet 2 本身不需要在线会员即可使用,见 README.md)。
# 1. 全局安装(需先安装 Node.js 和 npm)
npm install --global nxapi
# 2. 登录 Nintendo Account,会生成授权链接,登录后粘贴回终端
nxapi nso auth
登录成功后,会话 token 会保存在本地数据目录(默认路径按系统不同,可用 nxapi --data-path ./data ... 自定义)。登录流程实现可参考 src/cli/nso/auth.ts。
登录后可以验证身份和玩家信息:
nxapi splatnet2 user
# 输出类似:Player xxx (Splatoon 2 ID xxxx, NSA ID xxxx) level 60
一键下载:对战记录与鲑鱼跑结果
核心命令是 nxapi splatnet2 dump-results,它会下载当前 SplatNet 2 接口提供的全部对战(regular / ranked / private / festival)和鲑鱼跑结果,并写入指定目录(默认 <数据目录>/splatnet2):
# 下载全部对战 + 鲑鱼跑结果到数据目录下的 splatnet2 文件夹
nxapi splatnet2 dump-results
# 下载到自定义目录
nxapi splatnet2 dump-results data/splatnet2
常用可选参数(定义见 src/cli/splatnet2/dump-results.ts):
| 参数 | 作用 |
|---|---|
--battle-summary-image |
同时下载"战绩列表分享"的官方汇总图片 |
--battle-images |
同时下载每场对战的官方分享图片 |
--no-coop |
只下载对战记录,跳过鲑鱼跑 |
--no-battles |
只下载鲑鱼跑结果,跳过对战 |
--no-check-updated |
用户档案未更新时也强制刷新汇总数据 |
下载逻辑在 src/common/splatnet2/dump-results.ts:每场对战保存为 splatnet2-result-{玩家ID}-{对战号}-...json,鲑鱼跑保存为 splatnet2-coop-result-{玩家ID}-{job_id}.json,文件已存在则自动跳过,因此可以安全地反复执行。
💡 关于"全部历史":SplatNet 2 官方接口本身只保留最近的战绩列表(对战约最近 50 场,鲑鱼跑为接口返回的完整列表)。想积累完整历史,请配合下一节的监控模式持续存档,越早开始存档越完整。
补充备份:用户档案、生涯挑战与头像卡
dump-records 命令负责对战之外的档案类数据:
# 下载用户档案(含生涯累计数据)
nxapi splatnet2 dump-records
# 附加生涯墨水挑战记录
nxapi splatnet2 dump-records --challenges
# 附加官方"头像卡"图片(可指定最爱舞台/颜色)
nxapi splatnet2 dump-records --profile-image --favourite-stage "Starfish Mainstage" --favourite-colour purple
# 附加英雄纪录(Octo Canyon)与首页时间线(CPOD FM)
nxapi splatnet2 dump-records --hero-records --timeline
参数定义见 src/cli/splatnet2/dump-records.ts。同样支持增量下载:默认只在新数据可用时重新写入。
X Rank 记录:列出赛季并查询战力
X Rank(X 力量)按月度赛季结算。CLI 内置命令可以列出全部 X Rank 赛季(自 2018 年 3 月起),实现见 src/cli/splatnet2/x-rank-seasons.ts:
# 升序列出全部 X Rank 赛季(ID、起止时间、结算状态)
nxapi splatnet2 x-rank-seasons
# JSON 输出,方便脚本处理
nxapi splatnet2 x-rank-seasons --json
如果需要某赛季的 X 力量汇总与排行榜数据(例如查询自己的 X 段位战绩),可以通过 nxapi/splatnet2 库调用 getXPowerRankingSummary / getXPowerRankingLeaderboard 方法,赛季工具函数(getXRankSeasons、toXRankSeasonId 等)用法示例都在 docs/lib/splatnet2.md,赛季计算逻辑源码在 src/api/splatnet2-xrank.ts。
持续自动备份:monitor 监控模式
一次下载只是起点,真正的"全量存档"靠 nxapi splatnet2 monitor(实现见 src/cli/splatnet2/monitor.ts):它循环检查 SplatNet 2,发现新对战 / 新鲑鱼跑任务就自动增量下载,已存在的数据直接跳过。
# 启动监控(默认每 15 分钟检查一次)
nxapi splatnet2 monitor data/splatnet2
# 自定义检查间隔:每 30 分钟一次
nxapi splatnet2 monitor data/splatnet2 --update-interval 1800
监控还支持与 Discord 在线状态联动:nxapi nso presence --splatnet2-monitor 会在你玩 Splatoon 2 联机时自动拉取最新战绩(详见 docs/cli.md)。配合 Docker 长期运行(项目自带 Dockerfile 和 docker-compose.yml),就能做到"打完一局,自动存档"。
备份文件速查与注意事项
一个完整的备份目录大致长这样:
splatnet2-results-summary-*-latest.json—— 最近一次对战汇总(summary)splatnet2-result-{玩家ID}-{对战号}-ranked.json—— 单场对战详情(含双方队友昵称与头像)splatnet2-coop-summary-*.json/splatnet2-coop-result-{玩家ID}-{job}.json—— 鲑鱼跑汇总与单局详情splatnet2-records-*.json—— 用户档案、生涯数据*.png—— 官方分享图片(需开启对应 image 参数)
几点实用建议:
- 定期执行:建议把
dump-results+dump-records加入定时任务,或直接用 monitor 常驻运行 - 图片默认不下载:
--battle-images会明显增加请求量,按需开启 - 数据目录可迁移:整个备份目录就是普通文件集合,可复制到网盘冷备份
- 安全说明:该接口与 splatnet2statink 等主流工具同源,长期被社区使用;nxapi 的调试日志(
DEBUG=nxapi:*)中可能包含 token,分享日志时注意脱敏
至此,你已掌握 nxapi SplatNet 2 数据备份的完整流程:nso auth 登录 → dump-results 下载对战与鲑鱼跑 → dump-records 补齐档案 → x-rank-seasons 核对 X Rank 赛季 → monitor 持续增量存档。祝存档顺利!🐙

