LunaBox

LunaBox 是一款面向视觉小说（Galgame）玩家的开源游戏库管理与游玩统计工具，由开发者 LunaRain_079（GitHub 账号 Saramanda9988）主导开发。该项目以“轻量、快速、功能丰富”为设计目标，采用 Wails 框架构建，旨在为视觉小说收藏者提供集游戏管理、时长追踪、数据分析与 AI 联动于一体的桌面端解决方案。LunaBox 遵循 AGPL v3 开源协议，支持 Windows、macOS 与 Linux 三大桌面平台。

项目背景

LunaBox 的诞生源于开发者自身的管理需求。据开发者在 LINUX DO 社区的推广帖中自述，其平时游玩大量 Galgame，曾使用过 Playnite、PotatoVN 等现有工具，但认为这些工具在 UI/UX 与统计功能上“总感觉差点意思”，于是决定自行开发一款更符合个人使用习惯的管理软件。项目在 UI 设计与统计功能上投入了较多精力，并集成了 AI 分析能力，发布后持续保持活跃更新。

项目早期代码托管于 GitHub（Saramanda9988/LunaBox），同时在 Gitee 上设有镜像仓库（LunaRain_079/LunaBox）。开发者另设有个人博客（lunarain.top）与项目文档站点（box.lunarain.site），用于发布开发日志与使用说明。

核心功能

游戏库管理与分类

LunaBox 提供完整的管理器与游戏启动器功能。用户可通过选择游戏可执行文件、扫描本地文件夹批量导入，或从其他平台导入数据。软件支持自定义分类，用户可创建灵活的分类体系对游戏库进行整理。

游玩时长追踪

游戏启动后，LunaBox 会自动追踪游玩时长。该功能支持对绝大部分 Galgame 及汉化壳进行时长监控，解决了传统本地游戏缺乏类似 Steam 时长记录能力的问题。

多维度数据统计

软件支持按日、周、月、年等多维度统计游玩数据，并可一键导出统计卡片用于分享保存。游戏详情页还提供了按“日”“年”及“全部”维度查看单个游戏游玩趋势的功能，支持最近 7 天、最近一年或完整游玩历史的视图切换。

AI 分析与联动

LunaBox 在 AI 功能集成方面较为深入。软件内置 AI 分析能力，可对游玩数据生成个性化趣味报告，并对游戏库进行“锐评”。同时，LunaBox 提供本地 MCP（Model Context Protocol）服务与 CLI 接口，允许外部 AI 助手或角色扮演工具通过本地端点获取用户的游戏列表、详情、游玩记录、元数据搜索结果及统计信息，使 AI 能够“更了解用户”。AI 总结功能还支持联网搜索以增强上下文质量。

数据导入与备份

LunaBox 支持从 PotatoVN、Playnite、Vnite 等管理工具导入已有数据，亦支持从 Steam、ReinaManager、YukiHub 导入游戏与游玩记录（Steam 与 Playnite 的游玩记录同步暂不支持）。云备份方面，软件支持本地备份，以及 AWS S3、七牛云、阿里云 OSS 等兼容 S3 协议的存储服务，并支持 OneDrive 云端备份。

多平台与兼容性支持

LunaBox 支持 Windows、macOS 与 Linux 三端运行。在 Linux 平台上，软件对 Steam Proton、Wine、CrossOver 进行了集成支持，包含转区与中文支持等预设。v1.13.0 版本进一步新增了 Linux 对本地 Proton 运行器的识别能力，并可从游戏启动设置中打开 Winetricks、Protontricks 等兼容工具。

技术特点

• 技术栈： LunaBox 基于 Wails v2 框架构建，后端采用 Go 1.24，前端使用 React 18 与 TypeScript，数据库为 DuckDB，构建工具为 Vite，样式方案为 UnoCSS，路由使用 TanStack Router，状态管理采用 Zustand，图表渲染基于 Chart.js。

• 轻量体积： 由于基于 Wails 构建，软件无需携带完整的浏览器内核，因此包体积较小。

• 隐私保护： 所有敏感数据均保存在用户本地设备中，不依赖强制云端服务。

• CLI 支持： 软件提供命令行模式，支持通过命令行进行游戏管理、启动、备份及程序数据修改。

• 协议集成： 支持 lunabox:// 协议请求处理，并可通过 IPC 客户端/服务端完成协议通信。

• 多语言与本地化： 项目文档与界面提供简体中文、日本語等多语言支持。

社区影响

LunaBox 在中文 Galgame 社区中获得了较高的关注度。在 Kungal 工具集平台上，该工具获得了平均 5.0 / 5.0 的实用性评分，浏览量超过 700 次。社区反馈中，有用户肯定了其轻量设计与功能丰富度，同时也指出了游戏数量较多时可能出现性能下降的问题（“游戏加多了容易卡”）。

项目获得了 SignPath Foundation 提供的免费代码签名服务支持。在 GitHub 上，LunaBox 获得了数百颗星标，在同类仓库中处于中上水平。开发者通过 GitHub Issues 与社区用户保持积极的反馈与修复互动，多个用户提出的功能建议与问题报告已在后续版本中得到响应。