使用 LunaBox 下载

什么是 LunaBox

LunaBox 是一款快速、美观、功能丰富的轻量视觉小说管理工具。除下载功能外，它还能帮你整理游戏库、记录游玩时间，并通过内置 AI 助手分析你的游玩习惯。

主要功能：

• 游戏管理 — 自定义分类与灵活的元数据管理，整理你的游戏库
• 游玩时长统计 — 自动记录游玩时长，生成多维度统计图表
• AI 分析 — 内置 AI 助手，分析游玩习惯并生成趣味报告
• 云备份 — 支持 S3 和 OneDrive，安全同步与备份数据
• 下载集成 — 自动解压、校验文件完整性、支持断点续传

安装 LunaBox

从官方网站下载并安装 LunaBox：https://box.lunarain.site

目前提供两种 Windows 版本：

• 安装版（setup）：推荐普通用户使用。安装过程中会自动尝试注册 lunabox:// 协议，下载按钮通常开箱即用。数据默认保存在 %APPDATA%\LunaBox。
• 便携版（portable）：解压即用，但首次使用前通常需要手动注册 lunabox:// 协议。数据默认保存在程序目录。

如果你之后更换了便携版目录、重装系统，或发现安装版无法正常通过协议启动 LunaBox，也可以重新执行下面的命令。

# 切换到 lunacli 所在目录，执行注册协议命令
.\lunacli.exe --register-protocol

# 将 lunacli 添加到系统环境变量后，可以直接使用，安装版会自动处理环境变量注册
lunacli --register-protocol

参照LunaBox文档

LunaBox 目前仅支持 Windows。移动设备上不会显示 LunaBox 按钮。

在 Shionlib 中禁用或启用 LunaBox 按钮

LunaBox 下载按钮默认显示。禁用方式：

1. 打开设置 → 下载（或前往 /user/settings/download）
2. 找到 LunaBox 设置项
3. 取消勾选显示 LunaBox 下载按钮

禁用后，下载面板中每个文件行的 Aria2 按钮和普通下载按钮旁边，将不再出现 LunaBox 图标按钮。

使用 LunaBox 下载

1. 在任意游戏页面点击下载，打开下载面板
2. 找到你想要的资源和文件
3. 点击月亮图标按钮，将下载任务推送到 LunaBox
4. 如果需要 Turnstile 验证，在弹出窗口中完成验证——验证通过后任务会自动发送给 LunaBox
5. 切换到 LunaBox，下载即已开始

每次推送时，LunaBox 会收到以下信息：

常见问题

点击 LunaBox 按钮没有反应

优先检查是否已正确注册 lunabox:// 协议：

• 安装版：一般会自动注册；如果失效，参照上文重新注册协议，或者重新安装通常即可修复
• 便携版：请先启动 LunaBox，再在文件所在目录执行 .\lunacli.exe --register-protocol

执行命令后关闭后重新启动再试。

下载任务没有出现在 LunaBox 中

• 检查浏览器或系统是否拦截了 lunabox:// 协议
• 检查是否有“是否打开 LunaBox”的确认弹窗被忽略

LunaBox 没有提前打开，能直接下载吗

可以。只要协议已注册，点击 Shionlib 的月亮图标按钮开始下载后，协议会自动启动 LunaBox，并把当前下载请求带过去。

Turnstile 验证后下载没有开始

Turnstile 弹窗在验证通过后会自动关闭。如果下载仍未开始，再次点击月亮图标即可——本次会话中签名链接已缓存，无需再次验证。