RetroSprite v0.1.0

RetroSprite v0.1.0

RetroSprite v0.1.0 is the first formal GitHub release intended for long-term user downloads. The APK is signed with the project release key and includes a SHA-256 checksum asset.

RetroSprite v0.1.0 是首个面向普通用户长期下载的 GitHub 正式版本。APK 使用项目 release key 签名，并随 Release 提供 SHA-256 校验文件。

Includes

• RetroArch AI Service hotkey integration with the in-game voice overlay.
• Local sherpa-onnx ASR for short Chinese / English voice questions.
• Evidence-grounded GKP retrieval and low-spoiler AnswerPolicy.
• Stronger supported-game detection with GKP title_aliases expanded across RetroArch system ids.
• Hotkey voice foreground-service refresh before ASR to improve microphone capture stability.
• BYOK current-screen translation for explicit translation intents.
• Diagnostics with ASR metrics, pipeline stage, source ids, LLM status, latency, failures, and feedback.
• Six bundled real game GKP Lite packs:
  • Shining Force II / 光明力量2
  • Golden Sun / 黄金太阳
  • Phantasy Star IV / 梦幻之星 IV
  • Langrisser II / 梦幻模拟战 II
  • Chrono Trigger / 时空之轮
  • Final Fantasy VI / 最终幻想 VI

Install

Download RetroSprite-v0.1.0-release.apk on your Android device, allow installation from the current browser or file manager, then configure RetroArch:

Settings -> Accessibility -> AI Service
AI Service URL: http://localhost:4404

Debug-signed preview builds usually cannot be upgraded directly to this release-signed APK. If installation fails over an older preview APK, uninstall the preview build first.

SHA-256

a06b95551480b5d61af58fd502445a99a6e8d065b79924ab250e0da3730abbcf  RetroSprite-v0.1.0-release.apk

RetroSprite v0.1.0 Preview 8

RetroSprite v0.1.0 Preview 8

本版本已合并到 main，对应 PR #11，目标提交 e69656cc95e050eefdaa2497073f8b85bca17837。

本次更新

• 增加热键语音调试注入：hotkey_voice_debug* 请求可以携带 question，通过同一套 overlay、日志和回答链路复现真机热键问题。
• 增加 ASR 音频诊断：记录 sample count、AudioRecord read count、read error count、peak amplitude 和 last-frame amplitude。
• 增加 Diagnostics 失败归因：对 ASR、GKP no-evidence、GKP disabled、截图缺失、BYOK API 配置/API 错误、权限和超时给出直接诊断提示。
• 改进 GKP ASR 变体归一化：支持 observed-asr 整句误识别的噪声前缀清理、截断尾部补全和更多同音映射。
• 6 个内置真实游戏包补充 RG476H 热键语音样本对应的 aliases 和 qa_goldens，覆盖 FF6 魔石系统、光明力量2 气合之玉、黄金太阳伊凡、梦幻之星 IV 技巧/技能、时空之轮玛尔等误识别。
• 新增 M18 QA / backlog / patch proposal / matrix / handoff / release audit / offline gate 脚本与测试。
• 更新 GitHub 默认中文 README、英文 README、Android README、项目介绍和 CHANGELOG。

已验证

• git diff --cached --check
• python3 -m unittest discover scripts/tests：281 tests，46 skipped
• python3 scripts/rc_release_audit.py
• ./gradlew :app:clean :app:testDebugUnitTest :app:assembleDebug
• 合并到 main 后重新执行 ./gradlew :app:clean :app:testDebugUnitTest :app:assembleDebug
• apksigner verify --print-certs RetroSprite-v0.1.0-preview.8-debug.apk

安装包说明

• 本次上传资产：RetroSprite-v0.1.0-preview.8-debug.apk
• SHA-256：de4c8e40dc74097714acae6bf4918052c38c00f21f850b43ef6dfc4eb4906424
• 签名状态：Android Debug 签名，证书 DN 为 C=US, O=Android, CN=Android Debug
• 发布状态：GitHub Pre-release
• 原因：项目目前没有 release signing config / release keystore；本次 assembleRelease 到 lintVitalAnalyzeRelease 后长时间静默停留并被停止，不作为安装资产发布。

体积说明

本次 clean debug APK 约 251MB。经 zipinfo 检查，体积主要来自当前内置的 sherpa-onnx-streaming-paraformer-bilingual-zh-en ASR 模型：

• encoder.int8.onnx：约 153MB
• decoder.int8.onnx：约 66MB

RetroSprite v0.1.0 Preview 7

RetroSprite v0.1.0 Preview 7

本版本已合并到 main，对应 PR #10，目标提交 c5fd2cc53f26d53ea0dacb9f6dd5104d0bb80319。

本次更新

• 屏幕翻译增加二次修复：如果模型第一次只返回英文 OCR 原文，会自动要求模型重新翻译为简体中文。
• 屏幕翻译提示词改为统一 JSON 输出；对白/剧情文本输出中文译文，菜单/状态/装备界面保留英文 source 供玩家对照。
• 结构化翻译解析器支持 dialogue / text 等文本模式，避免对白页面把英文原文展示给玩家。
• 热键语音现在支持直接说“翻译”，不会因为问题太短而被普通问答长度门槛拦截。
• 屏幕翻译结果页显示时间延长到 10 秒，方便在掌机屏幕上阅读多页翻译。
• 设置页文案补充“翻译”作为可用唤起词。

已验证

• git diff --cached --check
• ./gradlew :app:clean :app:testDebugUnitTest :app:assembleDebug
• ./gradlew :app:assembleRelease
• 合并后在 main 重新执行 ./gradlew :app:clean :app:testDebugUnitTest :app:assembleDebug
• apksigner verify --print-certs RetroSprite-v0.1.0-preview.7-debug.apk

安装包说明

• 本次上传资产：RetroSprite-v0.1.0-preview.7-debug.apk
• 签名状态：Android Debug 签名，证书 DN 为 C=US, O=Android, CN=Android Debug
• 发布状态：GitHub Pre-release
• 原因：项目目前没有 release signing config / release keystore，assembleRelease 产物是 unsigned APK，不适合作为用户直接安装包发布。

体积说明

本次 clean debug APK 约 251MB。经 zipinfo 检查，体积主要来自当前内置的 sherpa-onnx-streaming-paraformer-bilingual-zh-en ASR 模型：

• encoder.int8.onnx：约 153MB
• decoder.int8.onnx：约 66MB

RetroSprite v0.1.0 Preview 6

RetroSprite v0.1.0 Preview 6

本版本已合并到 main，对应 PR #9，目标提交 ff0bbc7779a42e6cb6e080fea49aa0f224aa89fd。

本次更新

• 改进 Sherpa ASR 最终文本选择：当 final transcript 丢失较完整的 partial 片段时，优先保留更可用的识别结果，减少短问题尾音被截断的问题。
• 改进本地 GKP 检索：对已知低剧透实体增加更稳的兜底匹配，减少“明明知识包里有但没有证据”的情况。
• 改进不完整语音问题的回答策略：对“怎么获”这类截断片段给出更明确的重说提示，不再勉强编造答案。
• 优化知识包和设置页面：搜索、筛选、导入预检、语音/问答/屏幕翻译配置的文案和布局更清晰。
• 修正 .gitignore：只忽略根目录 /UI/ 设计源稿，避免在大小写不敏感文件系统上误隐藏 Android ui 源码文件。

已验证

• git diff --cached --check
• ./gradlew :app:clean :app:testDebugUnitTest :app:assembleDebug
• ./gradlew :app:assembleRelease
• 合并后在 main 重新执行 ./gradlew :app:clean :app:testDebugUnitTest :app:assembleDebug
• apksigner verify --print-certs RetroSprite-v0.1.0-preview.6-debug.apk

安装包说明

• 本次上传资产：RetroSprite-v0.1.0-preview.6-debug.apk
• 签名状态：Android Debug 签名，证书 DN 为 C=US, O=Android, CN=Android Debug
• 发布状态：GitHub Pre-release
• 原因：项目目前没有 release signing config / release keystore，assembleRelease 产物是 unsigned APK，不适合作为用户直接安装包发布。

体积说明

本次 clean debug APK 约 251MB。经 zipinfo 检查，体积主要来自当前内置的 sherpa-onnx-streaming-paraformer-bilingual-zh-en ASR 模型：

• encoder.int8.onnx：约 153MB
• decoder.int8.onnx：约 66MB

这次不是旧版 APK 中出现过的 ZIP gap / 增量打包空洞问题。

RetroSprite v0.1.0 Preview 5

RetroSprite v0.1.0 Preview 5

This GitHub pre-release is built from main at merge commit 3567657.

Highlights

• Added hotkey voice-triggered current-screen translation. Say “翻译一下”, “读一下”, “这是什么意思”, or translate this after the RetroArch AI Service hotkey to translate the current paused screen.
• Added BYOK OpenAI-compatible screen translation providers with Settings templates for SiliconFlow, OpenRouter, and custom endpoints. Recommended model: Qwen/Qwen3-VL-8B-Instruct.
• Added structured menu/equipment/status translation rendering so menu screens can appear as concise bilingual HUD cards.
• Added built-in screen translation glossary and post-processing for current-game terms.
• Added diagnostics logging for question_source=hotkey_screen_translation and output_mode=hotkey_screen_translation:text; logs store the final Chinese translation and screenshot byte count, not screenshot Base64.
• Updated README, English README, Android README, architecture docs, protocol docs, and project-level CHANGELOG.md.
• Updated the Final Fantasy VI GKP Lite pack to 0.1.1 with PlayStation / PSX / PS1 Final Fantasy Anthology - Final Fantasy VI RetroArch labels.

Verification

• git diff --cached --check
• JAVA_HOME="/opt/homebrew/Cellar/openjdk@17/17.0.19/libexec/openjdk.jdk/Contents/Home" ./gradlew :app:clean :app:testDebugUnitTest :app:assembleDebug
• Re-ran the same clean test/build command on merged main.
• APK signature verified with apksigner verify --print-certs

Signing Note

This APK is signed with the Android debug certificate (CN=Android Debug). It is suitable for GitHub preview distribution and device testing, but it is not a Play Store or production-signed release.

:app:assembleRelease was attempted but did not produce a production release: the project has no release signing configuration, and release lint failed while downloading intellij-core-31.2.2 from Google Maven because the TLS handshake was terminated.

RetroSprite v0.1.0 Preview 4

RetroSprite v0.1.0 Preview 4

This GitHub pre-release is built from main at merge commit a725669.

Highlights

• Chinese README is now the default GitHub homepage, with the English README linked from the top.
• Current bundled GKP Lite coverage includes six games:
  • Chrono Trigger / 时空之轮
  • Final Fantasy VI / 最终幻想 VI
  • Golden Sun / 黄金太阳
  • Langrisser II / 梦幻模拟战 II
  • Phantasy Star IV / 梦幻之星 IV
  • Shining Force II / 光明力量 2
• ASR packaging is switched to sherpa-onnx-streaming-paraformer-bilingual-zh-en.
• GKP schema, migrations, retrieval/localization behavior, QA scripts, and gkp-builder tooling were updated for the latest release candidate.
• ONNX model files are tracked with Git LFS to keep the GitHub repository publishable.

Install And Use

Download RetroSprite-v0.1.0-preview.4-debug.apk from the assets below and install it on the target Android handheld or emulator. Configure RetroArch AI Service to call the RetroSprite local endpoint, then use the RetroArch AI hotkey while a supported game is running.

Verification

• git diff --cached --check
• JAVA_HOME="/opt/homebrew/Cellar/openjdk@17/17.0.19/libexec/openjdk.jdk/Contents/Home" ./gradlew :app:clean :app:testDebugUnitTest :app:assembleDebug
• APK signature verified with apksigner verify --print-certs

Signing Note

This APK is signed with the Android debug certificate (CN=Android Debug). It is suitable for device testing and GitHub preview distribution, but it is not a Play Store or production-signed release. A production release still needs a real release keystore and Gradle signing configuration.

RetroSprite v0.1.0 Preview 3

RetroSprite v0.1.0 Preview 3

This pre-release publishes the six-game GKP Lite preview merged into main.

Supported games in this build

RetroSprite currently supports exactly six bundled real games:

• Shining Force II / 光明力量2
• Golden Sun / 黄金太阳
• Phantasy Star IV / 梦幻之星 IV
• Langrisser II / 梦幻模拟战 II
• Chrono Trigger / 时空之轮
• Final Fantasy VI / 最终幻想 VI

Includes

• Adds five Retro JRPG/SRPG Chinese Lite GKP packs and expands Shining Force II.
• Removes the old sample-2048 and sample-relay-station demo packs from bundled assets.
• Updates README files to state the current six-game support surface.
• Adds GKP Lite builder tooling, source/register docs, Room schema updates, resolver/retrieval improvements, ASR diagnostics, and tests.

Verification

• JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home" ./gradlew :app:clean :app:testDebugUnitTest :app:assembleDebug
• APK verified with apksigner verify --print-certs.
• Uploaded APK is the clean rebuild artifact, 70,222,489 bytes, SHA-256 57ee38fabcbb5ccd2d05a22d115ac0a9f8793acd424840d6f7e9a15aa13da944.

Signing note

The attached APK is debug-signed (CN=Android Debug) and this GitHub release is marked as a pre-release.

RetroSprite v0.1.0 Preview 2

RetroSprite v0.1.0 Preview 2

This pre-release publishes the latest RetroSprite Android project code merged into main.

Highlights:

• README now clearly states the current real supported game: Shining Force II / 光明力量2 for Sega Mega Drive / Genesis.
• sample-2048 and sample-relay-station are documented as demo/smoke-test packs, not production game support.
• Adds the latest Shining Force II GKP, template retrieval, ASR hotword, game-term normalization, request logging, voice overlay diagnostics, Room schema, QA feedback, and tests.

Verification:

• JAVA_HOME="/Applications/Android Studio.app/Contents/jbr/Contents/Home" ./gradlew testDebugUnitTest assembleDebug
• APK verified with apksigner verify --print-certs.

Signing note:

• The attached APK is debug-signed (CN=Android Debug) and this GitHub release is marked as a pre-release.

RetroSprite v0.1.0 Preview 1

RetroSprite v0.1.0 Preview 1

This is a GitHub pre-release for the current M10/M11 RetroSprite Android build.

Includes

• Hotkey-triggered in-game voice overlay for RetroArch AI Service wake events
• Local sherpa-onnx ASR path packaged for arm64-v8a devices
• Local GKP resolver/retrieval/AnswerPolicy pipeline with zero-LLM default behavior
• Bundled sample packs plus the Shining Force II / 光明力量2 trial GKP
• Diagnostics, Packs management, Settings helpers, and updated project README/docs

Artifact

• RetroSprite-v0.1.0-preview.1-debug.apk
• SHA-256 checksum is attached as RetroSprite-v0.1.0-preview.1-debug.apk.sha256

Notes

This APK is debug-signed with the Android debug certificate. It is suitable for device testing and GitHub preview distribution, but it is not a Play Store or production-signed release. The root-level UI/ and retro-sprite-layers/ design source directories were intentionally not included in this release.