nxapi SplatNet 2数据备份指南:如何下载全部历史对战、鲑鱼跑结果与X Rank记录

原创2026-11-13 10:36:161,820 阅读

nxapi SplatNet 2数据备份指南:如何下载全部历史对战、鲑鱼跑结果与X Rank记录

nxapi 是开源的任天堂 Switch 应用接口工具,支持命令行、Electron 桌面应用和 TypeScript 库三种形态。这篇 nxapi SplatNet 2 数据备份指南将教你用几条命令把 SplatNet 2(Splatoon 2 游戏内应用)里的对战记录、鲑鱼跑(Salmon Run)结果和 X Rank 赛季记录全部下载到本地,实现个人战绩的永久存档。🦑

nxapi SplatNet 2 数据备份桌面应用界面,可管理 Discord 在线状态与 Switch 好友

为什么用 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。

nxapi 菜单栏应用与 SplatNet 2 等游戏专属服务界面,展示账号与 Web services 菜单

持续自动备份: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 参数)

几点实用建议:

  1. 定期执行:建议把 dump-results + dump-records 加入定时任务,或直接用 monitor 常驻运行
  2. 图片默认不下载:--battle-images 会明显增加请求量,按需开启
  3. 数据目录可迁移:整个备份目录就是普通文件集合,可复制到网盘冷备份
  4. 安全说明:该接口与 splatnet2statink 等主流工具同源,长期被社区使用;nxapi 的调试日志(DEBUG=nxapi:*)中可能包含 token,分享日志时注意脱敏

至此,你已掌握 nxapi SplatNet 2 数据备份的完整流程:nso auth 登录 → dump-results 下载对战与鲑鱼跑 → dump-records 补齐档案 → x-rank-seasons 核对 X Rank 赛季 → monitor 持续增量存档。祝存档顺利!🐙

登录后查看全文
nxapi