项目仓库:galhack/Subahibi_iOS。 安装包:Releases。
把 ケロQ《素晴らしき日々 ~不連続存在~》(BGI/Ethornell 引擎,HD 版,产品名 SubarashikihibiHD)
原生移植到 iPhone、iPad、Mac、Apple TV、Apple Vision Pro。日文原版与【冥月·凌雪汉化组】中文补丁都可以游玩。
游戏本体和本篇汉化需由玩家自行取得并导入。 本仓库与应用仅内置本文署名的后日谈社区增量, 不附原游戏 EXE、游戏封包、音乐、影片、本篇汉化 EXE 或玩家存档。
项目及四个平台应用已内置 Knockin' on heaven's door 后日谈社区汉化, 导入自己的游戏本体和本篇汉化后,选择简体中文即可使用。启动器提供启用开关, 后日谈入口仍按原作进度开放。
致敬并感谢原社区汉化作者「笑笑竺斋」! 原汉化包出处:素晴日后日谈笑笑汉化补丁。 本项目保留原译文及剧情中的署名,仅进行 Apple 增量封装、加载与兼容字体适配。 使用方法见 后日谈补丁说明,资源位于 app/Resources/AfterstoryCHS。
各版本的改动与验证记录见 版本更新记录。
- 引擎:开源的 BGI 重实现 OpenBGI(C99,GPL-2.0),
本项目为它补上了这款游戏需要的部分:
- 新增 1.647 引擎版本配置(指令集从原版 BGI.exe 中逐表恢复,见
tools/re/); - CompressedBG v2 图像解码(本作 5697 张图中有 5650 张是 v2,全部零失败);
- 游戏用到而缺失的 3 条指令、1.647 的帧率与文字函数行为、直接从封包播放影片。
- 新增 1.647 引擎版本配置(指令集从原版 BGI.exe 中逐表恢复,见
- Apple 后端(
engine/openbgi/src/os/apple/):引擎在独立线程运行;Metal 呈现; Core Text 渲染字形(日文用冬青黑体/明朝;中文按 GBK 解码,优先使用汉化包自带 font.ttf,缺字回退苹方); AudioToolbox 输出声音;pl_mpeg 解码 MPEG-1 影片;存档与游戏数据分离保存。 - 中文补丁:应用会在首次选择中文时自动解开
BGI-CHS.exe内的 Enigma Virtual Box 虚拟文件 (汉化剧本与图片),不需要在电脑上做任何预处理。 - 应用外壳:SwiftUI + UIKit,一个工程同时构建 iOS/iPadOS、Mac(Mac Catalyst)、tvOS、visionOS 原生版本。
已在以下真机验证(2026-10):iPhone 16 Pro Max、iPad Pro、Apple TV 4K、Apple Vision Pro(原生 visionOS 应用), 日文与中文均可进入剧情;存档、读档跨重启可用;影片可从封包直接播放。
- 正版游戏的安装目录(含
sysprg.arc、system.arc、sysgrp.arc、data01000.arc…data05010.arc等)。 - 想玩中文版时,目录中还需要汉化补丁的
BGI-CHS.exe与font.ttf(即"已打汉化补丁"的目录)。 - 一台装有 Xcode(含 iOS/tvOS/visionOS 平台)的 Mac;侧载 iPhone/iPad 也可以用 Sideloadly。
- 一个 Apple ID(免费账户即可,签名有效期 7 天,需定期重新安装;付费开发者账户为 1 年)。
需要的设备空间:游戏数据约 4.3 GB,中文补丁解包后另需约 350 MB。
无需自行构建时,可直接下载 v0.1.7 Release 中对应设备的文件:
| 设备 | Release 安装包 | 安装方式 |
|---|---|---|
| iPhone / iPad | Subahibi-ios.ipa | 使用 Sideloadly 和自己的 Apple ID 签名后侧载 |
| Mac | Subahibi-mac.zip | 解压后打开应用,首次启动时选择游戏本体目录 |
| Apple TV | Subahibi-tvos.ipa | 需自行签名安装;也可按下方 Xcode 步骤构建并安装 |
| Vision Pro | Subahibi-visionos.ipa | 需自行签名安装;也可按下方 Xcode 步骤构建并安装 |
校验文件:SHA256SUMS.txt。 上述应用均已内置后日谈社区汉化,游戏本体与本篇汉化仍需自行导入。 使用现成安装包可以跳过下面的本地构建步骤;覆盖更新时保留原应用,避免删除已有数据和存档。
git clone https://github.com/galhack/Subahibi_iOS.git
cd Subahibi_iOS
SUBAHIBI_TEAM=<你的 Team ID> tools/apple/gen_project.sh
open app/Subahibi.xcodeprojTeam ID 可在 Xcode › Settings › Accounts 中查看(免费账户的个人团队也有 Team ID)。
也可以把它写进 app/.team(单行,不会提交到 git),之后直接运行 tools/apple/gen_project.sh。
脚本会自动下载 XcodeGen(仅在本机 build/ 目录中)。工程无需额外安装 Metal 工具链或任何第三方库。
tools/apple/build_mac.sh # 生成 build/Subahibi-mac.zip(本机签名,内置后日谈社区汉化)解压后把 Subahibi.app 拖到「应用程序」。首次打开如被系统拦截,请右键 › 打开(该应用未经公证)。
也可以在 Xcode 中选择 "My Mac (Mac Catalyst)" 直接运行。Mac 版无需 Apple ID。
启动后点「选择游戏目录…」,指向电脑上的游戏安装目录即可,不需要复制数据;选择会被记住。
存档、汉化解包保存在 ~/Library/Application Support/Subahibi/。
用 Xcode(四种设备都适用,Apple TV / Vision Pro 推荐此方式)
- 用数据线或同一局域网把设备与 Mac 配对(Apple TV 与 Vision Pro 在 Xcode › Window › Devices and Simulators 中配对)。
- 在 Xcode 顶部选择目标设备,点击 Run(▶)。首次需要在设备上开启"开发者模式",并在 设置 › 通用 › VPN 与设备管理 中信任你的开发者证书。
用 Sideloadly(iPhone / iPad)
tools/apple/build_ipa.sh ios # 生成 build/Subahibi-ios.ipa(未签名,内置后日谈社区汉化)在 Sideloadly 中选择该 IPA、你的设备和 Apple ID,点击 Start。
免费 Apple ID 每台设备最多同时保留 3 个侧载应用,若安装失败请先删除一个旧的侧载应用。
应用第一次打开时会提示"尚未找到游戏文件"。把整个游戏目录放进应用即可,目录名随意。
| 设备 | 推荐方式 |
|---|---|
| iPhone / iPad | 数据线连接 Mac → 访达 › 选中设备 › 文件 › 「美好的每一天」→ 把游戏目录拖进去 |
| Vision Pro | 用隔空投送把游戏目录发到 Vision Pro,保存到「文件 › 我的 Apple Vision Pro › 美好的每一天」;或用下面的局域网传输 |
| Apple TV | 只能用局域网传输(tvOS 没有文件管理) |
| 任意设备 | 局域网传输(见下) |
-
在设备上打开应用,打开「局域网接收游戏文件」,记下屏幕上显示的 地址 和 配对码。
-
在同一网络的 Mac 上运行(只需系统自带的 Python 3):
python3 tools/push_data.py --host <设备地址> --code <配对码> /path/to/你的游戏目录
脚本只发送需要的文件(
.arc封包、BGI-CHS.exe、font.ttf、BGI.gdb、BGI.hvl), 设备上已有且大小相同的文件会跳过,中断后重新运行即可续传。 -
传完后在应用里点「重新检查」。
配对码每次开启服务都会重新生成;连续输错 5 次会自动更换配对码并暂停接收。
已连接 Xcode 的设备也可以直接把文件写进应用的数据容器(iPhone/iPad/Vision Pro 写到 Documents/Game,
Apple TV 写到 Library/Caches/Game):
xcrun devicectl device copy to --device <设备> \
--source data01000.arc --source ... \
--destination Documents/Game \
--domain-type appDataContainer --domain-identifier org.local.subahibi.<Team ID>在启动页选择语言(检测到汉化补丁时可选「简体中文」),点「开始游戏」。 首次选择中文时会先解开汉化补丁(几秒钟)。
| 输入 | 对应 |
|---|---|
| 轻点 | 鼠标左键(推进文字、选择) |
| 双指轻点 | 鼠标右键(游戏菜单 / 隐藏文字框) |
| 上下滑动 | 鼠标滚轮(向下滑 = 打开回想) |
| 长按 | 按住 Ctrl(快进),松手停止 |
| Mac / iPad 鼠标与触控板 | 与 PC 版相同:按下、拖动(如回想滚动条)、左右键、滚轮 |
| 硬件键盘 | Enter、空格、Esc、方向键、Ctrl(按住快进)、Page Up/Down 等 |
| Apple TV 遥控器 | 触控板移动指针,按下 = 左键,返回键 = 右键,上/下键 = 滚轮,播放/暂停 = 按住快进 |
| 游戏手柄 | 左摇杆移动指针,A = 左键,B = 右键,RT = 快进,十字键上/下 = 滚轮 |
| Vision Pro | 注视 + 捏合 = 轻点;其余同触控 |
游戏结束(标题选 EXIT)后应用会提示退出,再次游玩请重新打开应用。
- 存档与游戏数据分开保存(iPhone/iPad/Vision Pro 在 Application Support,Mac 在
~/Library/Application Support/Subahibi,Apple TV 在缓存区),日文版与中文版各自独立 (汉化版存档含 GBK 文本,原版作品同样不能混用)。 - 首次启动时会把游戏目录中的
BGI.gdb(全局设定、已读记录、CG 收集)复制一份作为起点, 电脑上的进度因此可以带过来。 - 删除应用会同时删除存档。iPhone/iPad 可在访达中备份应用数据。
- 免费 Apple ID 签名 7 天后过期,需要重新安装(不会删除已导入的数据和存档)。
- Apple TV:tvOS 只允许应用写入缓存区,游戏数据、汉化解包与存档都保存在那里; 系统空间紧张时可能被清除(届时需重新传输数据,存档也会丢失),重要进度请留意。
- Vision Pro 的注视不会产生"悬停",按钮的高亮会在点击时才出现。
- 0.1.7 已内置后日谈社区汉化;其余未汉化内容仍取决于玩家导入的本篇补丁。
- 游戏目录中的
fcxzzd.arc是与游戏无关的文本文件,不需要也不会被传输。
| 路径 | 内容 |
|---|---|
engine/openbgi/ |
OpenBGI 引擎(上游版本见 engine/UPSTREAM_COMMIT)及本项目修改 |
engine/openbgi/src/os/apple/ |
Apple 平台后端 |
app/ |
XcodeGen 工程定义、Swift 外壳、EVB 解包器 |
tools/re/ |
原版 BGI.exe 分析脚本(操作码表恢复、缺失指令普查等) |
tools/sim/ |
无头模拟构建与场景脚本 |
tools/apple/ |
工程生成、IPA 打包、图标生成 |
tools/check/ |
图像解码全量检查、截断模糊测试、EVB 比对 |
在 Mac 上不用模拟器即可运行同一套 Apple 后端:
cd engine/openbgi && make PLATFORM=apple CC=clang VORBIS=stb bin/openbgi-hosttest
bin/openbgi-hosttest /path/to/game --seconds=60 --script="wait 10 click 640 480 shot out.png"
bin/openbgi-hosttest /path/to/game --overlay=<解包后的汉化目录> --font=/path/to/game/font.ttf --chinese ...真机/模拟器上可用环境变量做无人值守测试:SUBAHIBI_AUTOSTART=ja|zh 跳过启动页,
SUBAHIBI_SCRIPT="wait 6 click 640 480 shot title" 注入输入并把截图写到 Documents/Debug/。
引擎测试与大图加载回归测试:
cd engine/openbgi
make -j8 PLATFORM=apple CC=clang VORBIS=stb test
# 可选:用自己购买的游戏验证全部 10 张超过 32 MiB 的图片
BGI_GAME_DIR=/absolute/path/to/game bin/test_imageloadtests/imageload.c 默认生成临时图片,覆盖同步加载、等待加载和缓存命中,
不含游戏素材。内存检查可用 make -B 重建该测试,并设置
OPT="-O1 -g -fsanitize=address,undefined -fno-omit-frame-pointer";
完成后用默认编译选项重新构建,避免混用带检查器的目标文件。
本仓库忽略游戏目录、封包、凭证、签名文件、构建结果、agents.md / AGENTS.md
及 IMPLEMENTATION_PLAN.md。公开源码不包含本地调试报告和存档。
- 本项目代码(含引擎修改与 Apple 后端、应用外壳)以 GPL-2.0 发布,见
LICENSE。 - 第三方组件(OpenBGI、pl_mpeg、stb_vorbis、参照 GARbro 的 CBG v2 算法)见
THIRD_PARTY_NOTICES.md。 - 《素晴らしき日々 ~不連続存在~》及其一切内容版权归 ケロQ 所有;中文补丁归【冥月·凌雪汉化组】所有, 请遵守其声明(勿用于商业用途)。本项目与上述权利人无关,仅供已购买正版的玩家在自己的设备上游玩。
- 后日谈社区汉化致敬原作者 笑笑竺斋,出处为 素晴日后日谈笑笑汉化补丁。 社区译文及字体等资源保留原署名,不因随项目发布而改变其原有权利归属。