SkyMeter

SkyMeter 是面向《碧蓝幻想：Relink》的非官方 Windows 本地战斗分析工具，也是基于 MIT 许可 GBFR Logs 延伸开发的非官方社区衍生版。它保留 GBFR Logs 用户熟悉的队伍 DPS 悬浮窗、历史战报、招式追踪、DPS 图表、SBA、配装和多语言能力，并加入双主题战斗档案、活动日历、强化报表和可选的 AI 冒险手记。

当前版本：0.9.1
仓库性质：源码公开、仅限非商业使用。商业使用必须获得 SkyMeter 权利人的书面授权。

SkyMeter 与 Cygames、Granblue Fantasy、《碧蓝幻想：Relink》及其发行方不存在隶属、授权或背书关系。游戏名称仅用于说明兼容对象。游戏名称、角色名称及相关商标归各自权利人所有。

SkyMeter 不是 GBFR Logs 原作者发布的官方后续版本。项目会明确保留上游 MIT 版权声明，不以原作者名义提供支持或背书。

功能展示

以下画面由 SkyMeter 的真实界面组件配合匿名演示数据生成，不包含真实玩家日志。

实时队伍 DPS 悬浮窗

羊皮古卷主页与活动日历

现代 Bento 战斗记录

详细战报与队伍伤害构成

AI 冒险手记

功能概览

实时队伍悬浮窗

• 显示本机玩家、AI 队友和联机队友的实时 DMG、DPS 与队伍占比。
• 为四个队伍位置提供独立颜色，便于在战斗中快速区分。
• 支持透明度、玩家名称、完整数值或 k / m / b 简写等设置。
• 保持轻量、透明和低干扰；可以通过系统托盘重新打开或切换点击穿透。

战斗档案

• 自动保存每场被识别的战斗记录，并按日期、任务、敌人和角色筛选。
• 支持分页、排序、批量选择和删除。
• 记录任务结果、战斗时长、队伍成员与角色；无法可靠判定的数据会显示为“未确认”，不会伪造结果。
• 首页提供累计战斗、总 DMG、平均 DPS、胜率、近期时长趋势和活动日历。
• 日历使用飞艇标记有记录的日期，可直接查看当天战斗。

详细战报

• 队伍伤害构成：每位玩家使用不同颜色显示 DMG、DPS、占比、峰值和 SPS。
• 招式拆分：按角色、技能和攻击派生汇总伤害、次数与占比。
• DPS 时间线：查看战斗过程中的伤害变化，而不只看最终平均值。
• SBA：在当前采集版本能够取得数据时显示奥义槽变化；缺失时明确标记不可用。
• 角色配置：在能够取得数据时显示武器、因子、专属能力和其他配装快照。
• 深链接：从首页的总 DMG 和 DPS 卡片可分别跳到伤害构成和时间线区域。

双界面主题

• 羊皮古卷：桌面、古书、破损纸页和墨水字体构成的幻想战报界面。
• 现代 Bento：清晰、克制、适合高信息密度阅读的现代界面。
• 主题、字体与配色会成套切换，并记住玩家选择，下次启动继续使用。
• 支持开书、翻页和内容墨迹出现动画，也可以关闭动态效果。

音乐

• 内置“旅途”为 SkyMeter 自有的程序化纯器乐，由 Web Audio 在本机实时合成，不包含人声或第三方录音。
• 音乐默认关闭，支持独立音量控制。
• 可选择本机 MP3 / OGG / WAV / M4A / AAC / FLAC 文件作为自定义音乐；程序只保存路径，不复制音乐文件。

AI 冒险手记

• 支持 OpenAI Chat Completions 兼容接口，玩家自行填写 API 地址、模型和密钥。
• 只有玩家在单份战报中主动点击生成时才会联网，功能默认关闭。
• 根据任务、敌人、队伍构成和战斗表现生成不同风格的吟游诗人短篇。
• 支持编年史、公会报告、角色日记和轻松逸闻等叙事风格。
• 默认隐藏玩家名称；不发送完整事件流、账号信息、配装、API 密钥或本地文件。
• 生成内容单独保存在本地，可重新生成、复制或删除，不修改原始战斗记录。

多语言

界面支持：

• 简体中文
• 繁体中文
• English
• 日本語
• 한국어

安装与使用

安装包

1. 从 GitHub Releases 下载最新的 SkyMeter-*.msi。
2. 运行安装程序，可选择非系统盘目录。
3. 启动《碧蓝幻想：Relink》。
4. 启动 SkyMeter；若采集模块被系统阻止，再尝试以管理员身份运行。

SkyMeter 使用 Windows 自带的 Microsoft Edge WebView2 Runtime。多数 Windows 10/11 设备已安装；缺失时需要从微软安装 WebView2 Runtime。

社区发布的 MSI 当前没有商业代码签名证书，Windows 可能显示“未知发布者”或 SmartScreen 提示；请只从本仓库的 Releases 页面下载，并核对发布说明中的 SHA-256。

数据位置

SkyMeter 的用户数据保存在：

%APPDATA%\app.skymeter.relink

这里可能包含战斗数据库、界面设置和日志。请勿将该目录上传到 Issue、网盘或公开仓库。 如需反馈问题，请先删除玩家名称、API 地址、路径和其他个人信息。

隐私

• 默认情况下，战斗采集、统计和存储全部在本机完成。
• 不提供遥测，不自动上传战斗日志、玩家名称或配装。
• AI 手记是唯一的可选联网功能；请求只发送到玩家自己配置的接口。
• API 密钥保存在 Windows 凭据管理器，不写入普通配置文件，也不会从后端重新返回给前端。

完整说明见 PRIVACY.md。

风险说明

SkyMeter 需要向游戏进程加载采集 DLL 并读取运行状态，因此安全软件可能误报。游戏更新也可能改变内存布局，使部分采集能力暂时失效或导致不稳定。请自行评估风险、备份重要数据，并遵守游戏适用的服务条款和当地法律。

本项目用于个人战斗分析，不提供物品修改、存档修改、自动操作或对其他玩家造成不公平影响的功能。

从源码构建

环境

• Windows 10/11 x64
• Node.js 20 或兼容版本
• Rust toolchain（版本见 rust-toolchain.toml）
• Microsoft C++ Build Tools
• WebView2 Runtime

开发

npm.cmd ci
cargo build --release --package hook
npm.cmd run tauri -- dev

验证

npm.cmd test -- --run
npm.cmd run tsc
npm.cmd run lint
npm.cmd run format-check
cargo test --workspace
npm.cmd run build

生成 MSI

cargo build --release --package hook
npm.cmd run tauri -- build

构建脚本会从工作区的 target/release/hook.dll 复制采集模块。不要使用来源不明的 DLL 替换它。

项目结构

src/          React / TypeScript 界面、状态管理和展示逻辑
src-tauri/    Rust 桌面后端、会话引擎、SQLite 与系统集成
src-hook/     注入游戏进程的 Rust 采集模块
protocol/     采集模块与桌面后端之间的版本化协议

数据流：

游戏事件 -> SkyMeter Capture -> 本地命名管道 -> 会话引擎 -> SQLite / UI
                                                         -> 玩家主动生成 -> 自定义模型 API

贡献

欢迎提交 Bug 修复、兼容性修复、本地化和界面改进。提交前请阅读 CONTRIBUTING.md；贡献者保留自己贡献的版权，同时授权 SkyMeter 权利人继续维护项目并单独授予商业许可。

请勿提交：

• 真实战斗数据库、日志和玩家身份信息；
• API 密钥、令牌、私有接口地址或本机绝对路径；
• 游戏官方图片、音乐、模型、解包文件或其他未获授权的资源；
• 来源或再分发权不明确的字体、图片和音频；
• 用于作弊、存档修改、自动操作或绕过安全措施的功能。

许可

SkyMeter 自有代码和原创素材采用 PolyForm Noncommercial License 1.0.0：可查看、学习、修改及作非商业使用；任何商业使用必须先获得 SkyMeter 权利人的书面授权。

SkyMeter 包含从 false-spring/gbfr-logs 继承并修改的 MIT 许可代码。上游部分仍受原 MIT 许可证约束，SkyMeter 的非商业许可不会撤销上游已经授予的权利。实际打包或使用的第三方组件见 THIRD_PARTY_NOTICES.md。

商业授权说明见 COMMERCIAL-LICENSE.md。

致谢

感谢 False Spring 发布 MIT 许可的 GBFR Logs。SkyMeter 在其基础架构之上进行了持续重构和扩展。

联系方式（Contact）

本项目由 keyandishou 发起并维护，欢迎社区贡献。如遇使用、兼容性或源码构建问题，欢迎通过 GitHub Issues 或邮件 zjhkira@163.com 联系。反馈前请移除真实玩家名称、战斗日志、API 密钥和本机路径。

如果 SkyMeter 对你有帮助，欢迎在 GitHub 给项目一个 ⭐，让更多 Relink 玩家找到它。