SaberLab v2.1.0

PP 预测与更快的刷新🎉

PP prediction & a faster refresh🎉

🔍更新内容 What's in v2.1.0

• PP 预测（准确率预览） 点击任意 ranked 回放的 PP 值，在下方弹出准确率预览小窗：查看该谱面在不同准确率下的预估 PP，公式复刻自 ScoreSaber 官方（误差 ±0.1%）。
  PP prediction (accuracy preview) Click a ranked replay's PP value to open an accuracy-preview popover: read the estimated PP at any accuracy, using ScoreSaber's official formula (±0.1% deviation).

• 逐场 PP 计算 总览 / 历史 / 详情里的 PP 现在按每条本地回放的实际准确率独立计算；NF 场次按有效分折算。
  Per-play PP Overview / history / detail PP is now computed per local replay from its actual accuracy; NF plays use the effective score.

• 更快的一键刷新 批量分析不再逐条调用 AI 生成报告；AI 报告改为在详情页手动生成，一键刷新速度大幅提升。
  Faster one-click refresh Batch analysis no longer calls the AI per replay; reports are now generated on demand from the detail page , making the refresh much faster.

• 启动自动替换旧实例 重新启动 SaberLab 时会自动顶掉 6980 上残留的旧实例并重新绑定 6980，窗口不再「消失」；其他程序占用端口时依旧安全顺延，不会误杀。
  Launcher replaces stale instances Relaunching SaberLab replaces the previous instance on 6980 (verified identity), so its window never gets lost; unrelated port occupants are never touched and still trigger the safe fallback.

• LocalLeaderboard 副本恢复 回放文件被外部删除时会明确标注「文件缺失」；若安装了 LocalLeaderboard mod，一键刷新会自动用其副本找回并修复这类回放。
  LocalLeaderboard safety copy If a replay file was deleted externally, a clear "File missing" mark appears; with LocalLeaderboard installed, one-click refresh auto-recovers such replays from its copy.

• 保存设置不再清空分析数据 修复此前保存任意设置都会清空分析缓存的 bug。
  Settings save no longer wipes analysis Fixed a bug where saving any setting cleared the analysis cache.

• 更多细节打磨 toast 改为顶部居中（带进度条）、多语言补全。
  More polish Top-center toasts with progress bars, and i18n completions.

🚀 快速开始 Quick Start

1. 解压 SaberLab-v2.1.0-win64.zip 到任意目录，双击 SaberLab.exe 启动。
   Unzip and run SaberLab.exe.

2. 打开「设置」→「游戏路径」，选择 Beat Saber 游戏根目录。
   In Settings → Game Path, select your Beat Saber root folder.

3. 点击「⚡ 一键刷新」导入回放；在「云端数据」页选择数据源并拉取数据计算动态水平。
   Click ⚡ Quick Refresh to import replays; on the Cloud Data page pick your source and fetch your dynamic level.

4. (可选)配置 AI 报告：在程序目录的 .env 中填入 DEEPSEEK_API_KEY（参考自带 .env.example）。未配置时自动使用内置规则报告。
   Optional: add DEEPSEEK_API_KEY to the .env next to SaberLab.exe (see .env.example); the built-in rule-based report is used otherwise.

🔧 完整变更记录 Full Changelog

• CHANGELOG.md (简体中文)
• CHANGELOG.en.md (English)

SaberLab v2.0.0

SC/BL 双平台云端数据🎉

SC/BL Dual-platform cloud data 🎉

🔍更新内容 What's in v2.0.0

• 插件系统与 3D 回放独立 新增第一方插件目录 plugins/；3D 回放（Local-ChroViewer，GPL-2.0）已独立为外部项目，用户版内置该插件，开箱即用
  Plugin system & standalone 3D viewer A first-party plugins/ directory is now loaded at startup; the 3D replay viewer (Local-ChroViewer, GPL-2.0) became an independent external project and ships inside the user edition. This plugin is already included in the user version.

• BeatLeader 数据导入 云端数据源可在 ScoreSaber / BeatLeader 间切换（设置 → 玩家），玩家 ID 两平台通用（从回放自动解析）；两平台数据独立缓存，来回切换互不影响
  BeatLeader import Switch the cloud data source between ScoreSaber and BeatLeader (Settings → Player); the player ID is shared and auto-parsed from replays. Each platform keeps its own cache — switch back and forth freely.

• 个人动态星级色谱 颜色表示曲目难度相对你当前水平的位置：黄色基准由你最近的高 PP 成绩自动计算
  Personal dynamic star palette Colors now show a map's difficulty relative to YOUR level — the yellow baseline is computed from your top-20 PP scores.

• 切割细节 12 格网格 + 左右手双 9 宫格，展示每个网格位置的切割轨迹与带符号切偏，直观看到 center 分丢在哪
  Slice details A 4×3 grid with dual 9-compass layouts visualizes cut paths and signed offsets, showing exactly where center score is lost.

• 无命令行窗口启动 启动不再弹出命令行窗口；窗口模式启动速度已优化
  No console window Startup no longer opens a console. Window-mode startup was optimized.

• 端口调整为 6980 默认端口改为 6980
  New default port 6980

🚀 快速开始 Quick Start

1. 解压 SaberLab-v2.0.0-win64.zip 到任意目录，双击 SaberLab.exe 启动。
   Unzip and run SaberLab.exe.

2. 打开「设置」→「游戏路径」，选择 Beat Saber 游戏根目录。
   In Settings → Game Path, select your Beat Saber root folder.

3. 点击「⚡ 一键刷新」导入回放；在「云端数据」页选择数据源并拉取数据计算动态水平。
   Click ⚡ Quick Refresh to import replays; on the Cloud Data page pick your source and fetch your dynamic level.

4. (可选)配置 AI 报告：在 data\.env 填入 DEEPSEEK_API_KEY。未配置时自动使用内置规则报告。
   Optional: add DEEPSEEK_API_KEY to data\.env for AI reports; the built-in rule-based report is used otherwise.

🔧 完整变更记录 Full Changelog

• CHANGELOG.md (简体中文)
• CHANGELOG.en.md (English)

SaberLab v1.5.0

多语言支持（中/英/日）🎉

Multi-language supported (EN/CN/JP)🎉

🔍更新内容 What's in v1.5.0

• 分析全面改为音符锚定 刀速/密度曲线现已根据 note 逐个精确计算，斜率趋势使用 note 组来计算（默认50 notes 一组），精度曲线现已完美匹配官方算法
  Analysis is now anchored to notes speed/density curves are computed per note (note-anchored), slope trends use note groups (Default 50 notes per group), and the accuracy curve now matches the replay's official record.

• 新增多语言选项 现已支持简体中文 / English / 日本語，语言文件自动搜寻——在 frontend/i18n/ 放置 json 文件，对应语言的切换按钮就会自动出现
  Multi-language supported Now supports English / 简体中文 / 日本語. Language files are auto-discovered — drop a new JSON into frontend/i18n/ and the language switch appears automatically.

• AI 报告语言跟随界面语言
  Reports now follow the UI language.

• 新增「使用 AI 生成报告」开关
  New "Use AI for Reports" toggle in Settings → AI. Off = instant rule-based report (no LLM call); On = LLM-generated report.

• 全新连续曲率圆角设计
  New squircle-corner design language across cards.

🔧 完整变更记录 Full Changelog

• CHANGELOG.md (简体中文)
• CHANGELOG.en.md (English)

❌ 此版本内置ChroViewer，为避免开源协议冲突，已移除 SaberLab-v1.5.0-win64.zip，新版本改为插件方式实现，体验更好。

❌This version includes the built-in ChroViewer. To avoid open-source license conflicts, SaberLab-v1.5.0-win64.zip has been removed; the new version implements this functionality via a plugin, offering a better user experience.

SaberLab v1.4.0

首个公开发布版 🎉
First public release 🎉

❌ 目前仅支持简体中文，不支持切换语言 Currently Simplified Chinese only; language switching is not supported

🗒️ v1.4.0 包含内容

What's in v1.4.0

• 自动检测歌曲文件，用户账号，自动计算和下载 Replay 相关数据
  Automatically detects song files and player accounts, and computes/downloads replay-related data

• 查看详尽的歌曲数据与图表
  View detailed song data and charts

• 获取基础的 AI 分析报告（如果配置了AI）
  Get basic AI analysis reports (if AI is configured)

• 使用 ChroViewer 查看3D回放视频
  Watch 3D replays with ChroViewer

• 查看完整游玩历史文件
  Browse your complete play history

• 对比任意两首 Replay 记录的基础数据
  Compare the base stats of any two replay records

• 从ScoreSaber获取完整的玩家数据
  Fetch complete player data from ScoreSaber

🔧 完整变更记录

Full Changelog

见仓库 CHANGELOG.md
See the repository CHANGELOG.md

❌ 此版本内置ChroViewer，为避免开源协议冲突，已移除 SaberLab-v1.4.0-win64.zip，新版本改为插件方式实现，体验更好。

❌This version includes the built-in ChroViewer. To avoid open-source license conflicts, SaberLab-v1.4.0-win64.zip has been removed; the new version implements this functionality via a plugin, offering a better user experience.