Repository navigation
Releases
v0.1.0
KRKR-ns v0.1.0
下载附件 krkrsdl2.nro,放到 SD 卡的 sdmc:/switch/KRKR-ns/ 目录下替换原文件即可使用;真机按原有方式经 HBMenu 加载,模拟器直接加载该 NRO。升级时保留现有游戏与存档目录。
MD5: 3a2d32b4f9f71fdc7c42bb60bcbc2455
SHA-256: a4eb3a01bfe6fa084cc046876ed711a7d4eeffeb8de7813ebe590e6150f5b3a0
2026-11-08
- 修复长时间游玩后不定时闪退。
- 新增
Scripts.evalJSONStorage,读档清单、图鉴等以 JSON 保存数据的作品可以正常开始新游戏。 - 修复以空字符串作为对象索引键时被当作「按下标取值」而抛错退出的问题。
- 释放内存时不再把不属于引擎堆的指针交给系统释放,改为记录后跳过,避免堆被污染引起连锁崩溃。
对应源码:b51a0ad5。
历史更新记录(点击展开)
2026-11-05
- 修复长时间快进或连续切换场景后内存被耗尽、画面变黑并退出的问题:使用按大小分级的分配器,大块内存释放后即可被复用,不再把堆切碎。
- 修复启动页动画播放中点击、再切换页面返回时变成黑屏的问题:动画停止后画面继续按引擎原本的规则绘制,渲染目标重建后不再空白。
- 修复读取超大静态立绘(例如 3099×3256 的 WebP)时进程直接退出的问题,大尺寸图片可以正常显示。
- 移除已不再使用的位图池与临时诊断输出,降低常驻内存与日志体积。
- 崩溃时把信号记录到
log/last-crash.txt,便于回报问题时定位。
对应源码:ce0db4cb。
2026-11-04
- 场景切换和读档的卡顿大幅减少,进入章节、打开菜单、读取存档不再卡上好几秒。
- 游戏资源和图片读得更快,启动和加载场景更省时间。
- 画面合成更多交给 GPU,转场和 E-mote 动态立绘更顺畅,重复上传和回读明显减少。
- 长时间游玩内存更平稳;绘制线程按核心分配,不再和主线程抢同一个核。
- 启动流程、画面显示与部分渲染行为跟参考实现对齐,减少个别作品的启动和显示异常。
对应源码:ce0db4cb。
2026-10-16
- 修复 Switch 音频缓冲等待停滞导致的部分 OP 播放卡住,完善音频设备关闭和输出异常处理。
- 修正 E-mote 父子坐标与透明辅助层的变换继承,修复部分动画贴图错位。
- 修复 E-mote 动画的自源遮罩、嵌套裁剪与乘算显示,避免烟雾等效果越界和遮挡异常,并兼容半分辨率渲染。
2026-10-07
- 新增内置 scriptsEx,支持脚本对象遍历、深拷贝、结构比较、上下文与属性访问。
- 新增 layerExImage 图像滤镜与高斯模糊、shrinkCopy 平均采样缩小,以及 layerExSave 的 PNG / TLG5 导出、图像区域查询和透明度处理。
- 新增基于 PlutoVG 的 layerExDraw,支持路径、形状、轮廓文字和字体绘制。
- 新增 extrans 的 wave、mosaic、turn、rotatezoom、rotatevanish、rotateswap 和 ripple 转场,完善重复进入和退出游戏时的转场资源清理。
- 补齐 fstat 的目录检查与创建、目录树遍历、文件截断、资源导出、路径搜索和文件 MD5 查询。
- 修复图层原地缩放和仿射复制时源像素被覆盖造成的画面撕裂。
- 修复音频停止、切换和游戏重启时的线程锁冲突,避免部分播放结束回调阻塞主线程。
- 修复 Switch 上 VideoOverlay.prepare 未启动播放导致部分游戏等待影片时停留在空白画面的问题。
- 减少预渲染字体加载时的冗余临时文件读写,以及文字测量时共享位图的整图复制。
- 优化脚本原生成员复制、PSB 重复键与小对象引用清理,减少场景加载和返回标题时的分配开销。
- 释放 E-mote 上传完成后的解码暂存像素,静态画面复用已上传纹理,减少内存占用与重复上传。
- 完善主线程阶段、慢音频、资源读取与可选脚本清理耗时的诊断记录。
对应源码:929aecdb。
2026-10-04
- 参照 Kirikiroid2 社区版内置的 windowEx 能力,完整补齐窗口与显示器兼容接口:显示器与工作区信息、系统度量、光标位置、窗口几何与最大化/最小化状态、非客户区常量、窗口消息名表以及窗口控制菜单与菜单位图相关成员。控制台不具备的窗口装饰和原生菜单保持惰性,探测与调用均可正常应答。
- 内置 KAGParser 新增扩展标签支持:参数宏(pmacro)与循环标签(while / endwhile / break / continue),并修正宏参数透传(*)会清空已解析属性的问题。
- 上述兼容能力修复了按 Kirikiroid2 生态打包的多款作品在启动引导阶段中断、停留在黑屏的问题。
- 修复实机上部分作品选择后无法启动的问题:声音缓冲的解码线程改为首次播放时才创建,避免游戏引导阶段构造的缓冲池占满实机线程上限;线程创建失败时会先释放引擎缓存重试,并记录平台错误。
- 启动游戏前释放启动器界面占用的美术与预览表面及图形缓存,降低实机运行时的内存占用。
- 仓库整理:仓库仅保留构建 NRO 所需的源码与构建文件,开发、测试与调试资产保留在本地,不再随仓库发布;
tools/下仅 FFmpeg 构建脚本与补丁随仓库发布。
对应源码:9f646c6e。
2026-10-03
- 参照 Kirikiroid2 处理游戏同目录 patch.tjs 的执行异常,记录错误后继续尝试正常启动。
- 修复 MenuItem 派生对象清理及输入回调中关闭窗口时的资源生命周期问题,改善退出游戏的稳定性。
- 游戏切换时清理 KAG 剧情缓存,修复连续启动和退出多个游戏后误用上一游戏剧情、出现黑屏的问题。
- 修复 Switch 手柄确认键重复触发游戏快捷键,完善快速点击、多手柄按键状态及游戏库到游戏的按键衔接。
- 修复浏览带有 vpAg 元数据的 PNG 时选择封面闪退,保留游戏正常加载图片时的元数据。
对应源码:ae3915c0。
2026-10-01
- 新增按内容识别的 FFmpeg 独立音频后备解码,修复以
.ogg命名的 AAC/M4A 人物及系统语音无法播放,保留 WAV、Vorbis 和 Opus 的原解码优先级。 - 修复部分游戏快速读档时的窗口辅助对象清理崩溃,正确处理未调用基类构造的 Window 派生对象。
- 优化大面积 E-mote 矩形的纹理坐标复用,减少重复取样计算,保留原像素混合与几何覆盖规则。
- 完善绘制线程创建失败时的资源清理与同步回退;修复影片重复打开时的自定义输入缓冲泄漏及 Windows 视频定位的编译边界。
- 合并兼容性、模块与性能故障文档,统一阅读入口和当前能力说明。
对应源码:f894b070.
2026-09-30
- 完善 MenuItem 弹出菜单、子菜单、勾选与单选、快捷键和手柄/键盘/触摸操作,保持每个窗口独立的菜单状态与游戏已有菜单类优先级。
- 修复菜单迁移改变能力探测导致的游戏启动异常,以及兼容脚本中丢弃返回值时文件操作未执行的问题。
- 新增视频按时间和帧跳转、指定片段循环,并保留跳转前的播放或暂停状态。
- 参照 Kirikiroid2 的软件绘制策略,批量处理 E-mote 网格,增加严格矩形快路径与源行复用,减少逐三角形提交和等待。
- 并行处理大型内置交叉淡化与规则图转场的独立目标行,按 Switch 进程可用核心配置自动绘制线程。
- 减少 E-mote 回拷中未变化像素的重复写入,扩展大型游戏的资源路径索引,并补充图层和转场耗时记录。
2026-09-27
-
同步 README 中的近期功能、稳定性改进及插件许可说明,记录默认推送与 Release 更新约定。
-
新增原生 layerExRaster,修复依赖波纹转场的剧情卡死。
-
修复退出时脚本清理异常导致的重复清理循环。
-
修复视频等待期间音频补给不足造成的断流,完善 EOF 排空及播放输出重建。
-
同步回归夹具与模拟器调试工具。
-
修复返回标题后的持续卡顿:有限 E-mote 动画结束后正确更新播放状态,让游戏停止重复绘制;保留循环动画、变量驱动和最后姿态,并恢复停止后重播。
-
修复退出语音播完仍停留黑屏:引擎重启时重建声音状态定时器,修正音频工作线程的休眠唤醒顺序,退出等待可自然完成,无需点击黑屏跳过。
-
修复短声音提前结束:区分首次播放前的零采样计数与队列耗尽,保留完整的 Opus、Vorbis 和 PCM 播放时长。
-
完善兼容接口与软件绘制:修正 MenuItem 删除及子项状态,完善支持的视频音量、位置和流信息查询;跳过确实无效的透明网格和像素绘制。
-
修复带子目录的归档资源查找:按完整相对路径匹配图片等资源,避免不同目录的同名文件被误加载,修复由此引起的菜单图片错位及裁切。
-
保留资源覆盖兼容性:保留兼容脚本、补丁及翻译资源的覆盖优先权,以及不带目录名称的查找回退;复用现有归档索引,避免重复读取资源内容。
-
重新设计游戏库界面:采用浅色背景、柔和色块和新的标志,完善 Switch 按键提示与 A 确认、B 返回的操作。
-
优化游戏切换与动效:复用文字和图片图层缓存,按实际时间更新过渡动画;普通切换不扫描游戏资源,启动文件按需加载。
-
新增预览图和头像设置:支持浏览游戏散图及标准 XP3 内的图片,为每个游戏分别选择预览图和头像,并支持 SD 卡自定义图片。
-
新增图片处理与持久化:保持比例裁剪,生成独立缩略图缓存,重启后恢复选择;修复空用途字段导致设置丢失的问题。
-
完善图库操作:修正整数页码,支持手柄翻页和用途、来源切换,完善失败图片提示、取消加载和恢复默认。
-
提高图片读取稳定性:检查图片尺寸、归档和解码边界,跳过损坏或需要专用解码的资源,完善返回启动器后的资源状态清理。
自定义图片放入 sdmc:/switch/KRKR-ns/Artwork/。需要专用解码的游戏图片可使用自定义图片替代。
对应源码:4027d2f1。
2026-09-26
- 修复连续快速存档异常退出:补齐原生
Storages.moveFile,使已有存档正常轮换到备份槽位。 - 完善文件移动与存档保护:支持中文文件名与设备路径;移动失败保留源文件,拒绝覆盖已有目标,成功后刷新存储缓存。
- 新增原生 AlphaMovie 支持:支持 AJPM/AMV 透明动画的 DCT 与 zlib alpha 解码,补齐播放、停止、循环、跳帧、下一段切换及资源清理接口;采用逐帧解码和最多 32 MiB 的受限缓存。
- 修复快速读档与存档兼容性:保留没有独立启动脚本的补充包优先级,避免入口归档覆盖配置并导致已有存档被拒绝。
- 修复设置界面异常退出:补齐内置
layerStwCopy.dll的可用性探测与加载,确保界面转场对象正常初始化。 - 修复返回启动器后音频残留:退出时停止并释放实际使用的队列音频,避免背景音乐继续播放。
- 优化会话重建稳定性:停止旧定时器并清理待处理事件,避免旧回调在新会话中继续执行。
- 完善 XP3 内容过滤契约:支持逐文件上下文、六参数提取回调与完整数据读取,改善带内容过滤的归档兼容性。
- 新增 Layer 绘图接口:实现
blendRect、stretchPile、stretchBlend、affineBlend,补齐矩形混合、缩放与仿射混合能力。 - 优化字体与文本渲染兼容性:隔离不同会话的私有字体,修复忽略文本渲染返回值时的图层更新,并改善脚本正则表达式兼容性。
对应源码:35798f88。
2026-09-19
- 对话缺字修复(字形级字体回退):标题内嵌的日文字体缺简体字形时,自动回退到默认字体(Noto Sans SC)补齐该字形,并把回退字形按主字体的基线对齐(否则偏高)。照 Kirikiroid2 的 FreeTypeFontRasterizer 逐行移植。
- TextRender renderText 时序:按 Kirikiroid2 真机行为改为渲染完立即累加——此前要等缓冲刷新,KAGEX 标题在渲染后立刻读取该属性(履历 HistoryTextStore.storeRender 的输入)会拿到空串。
- 新增文档:
docs/KIRIKIROID2_COMPARISON.md(现已合入docs/KIRIKIROID2_PORTING_PLAN.md)——与 Kirikiroid2 的显示/文本/插件/脚本/归档/输入/影音逐子系统对照,含 APK 私有插件清单与同名源文件函数级扫描(43 个文件存在 K2 独有函数,已列行动项:TJS String 的 IndexOf/SubString/Trim、Layer 的 affineBlend/blendRect/stretchBlend/AssignTexture、XP3 content filter 等)。
2026-09-18
- 手柄可以操作游戏:左摇杆直接移动引擎光标(此前合成鼠标事件不更新 SDL 光标,游戏读不到位置),十字键改为发送方向键、走 KAG 自带的键盘导航(对话框左右切换「是/否」、Enter/A 确认);A/B/X/Y 映射确认/返回/空格/回车,Start=Esc、L3=Ctrl 快进、L/R=滚轮。
- 点击按自身位置判定:触摸与模拟器鼠标的「点击位置与按压同时到达」曾用上一帧的命中结果判定,确认框里的「是」会被判成「否」(对话框关闭、什么都没发生);现在位置跳变的点击延后 20ms 投递,先让游戏跑一次自己的每帧判定。可用标记文件
sdmc:/switch/KRKR-ns/no-click-delay.txt关闭该延迟做对照。 - 影片(OP/logo)可播放,且播完不再闪退:FFmpeg 子集加入 MPEG-PS 支持(
mpegps解复用器、mpegvideo/mp3探测用解复用器、MPEG-1/2 与 MP2/MP3 解码器);并修复影片结束时音频排空的缓冲区越界——此前表现为影片一播完就卡死闪退。 - 旧 KAG 标题的注释按钮不再抛
System.inputString缺失异常;目前尚无文字输入界面,注释内容会原样保留。 - 汉化 / Kirikiroid2 时代作品可启动:补齐两个 Kirikiroid2 专有 API——
Storages.setTextEncoding(汉化包 patch.tjs 用它把脚本切到 GBK,现在显式 GBK 会在无 BOM 文本探测里优先;否则 Shift-JIS 会先接走、解成乱码)与Window.PassThroughDrawDevice(其dt*drawer 常量与绘制设备的drawer属性一并提供,KAGEX 的 override.tjs 读它决定菜单补丁分支)。 - 启动器记住入口归档:每个游戏目录上次挂载的入口会记入
saves/<目录>/entry.txt,重启后自动沿用(汉化版是独立归档时不必每次重选);启动时日志会打印每个目录解析出的入口及其来源。 - 退出不再闪退:引擎重建时
Application改为在脚本引擎关闭之后才销毁(此前 TJS finalizer 会经Application->PrintConsole撞空指针)。 - 窗口尺寸修正:
Window.fullScreen返回真实值;画面可见行数改由游戏声明的 client 尺寸决定;不再定义kirikiriz;收回自造的 WindowEx 成员;保留 Kirikiroid2 确实提供的Window.PassThroughDrawDevice与dt*常量。