GameKit：AI 友好的 2D 小游戏工具链（TypeScript 三端构建）

Memory Game 是一款面向 4 岁以上儿童的 Android 记忆翻牌游戏，最早于 2014 年发布，仓库描述为「Simple and beautiful memory game for kids」。它的设计目标很明确：没有广告、没有账号、不收集任何数据。玩家点击 Play 后，会沿着一条由若干回合组成的「路线」前进，在计时结束前找出配对卡牌并收集星星。

README 记录了这款游戏的完整生命周期：2014 至 2019 年以 Java 编写并上架 Google Play，最后一个版本为 2019 年 2 月的 1.01.001007；2019 年 11 月因未跟上开发者政策被下架，代码随之停滞，期间 Android 平台向前推进了十二个 API 级别；2026 年项目重启，整体从 Java 迁移到 Kotlin，重构、调试、测试并准备重新发布，同时保留原有美术与玩法。

技术要点

项目是一个标准的 Android Studio 工程，技术栈为 Kotlin、AndroidX、Gradle Kotlin DSL，target SDK 36，min SDK 24。README 中值得注意的工程细节包括：

• 美术资源流水线：原始素材存放在 art/original，应用绘制的所有内容都由一个 Gradle 任务从原图生成，因此修改原图只需重跑任务并提交。
• 卡牌矢量化：每张卡牌先用 Real-ESRGAN 放大 4 倍，再用 vtracer 描摹为路径，并按几何位置把身体、眼睛、瞳孔、阴影等部件标记进 app/src/main/assets/characters/<name>.chr。应用在 Canvas 上绘制，任意尺寸都清晰，并带有动画：正面朝上时呼吸与眨眼，配对成功时跳跃。标记错误可在 art/character-overrides.txt 中修正。
• UI 美术：按钮、弹窗、主题卡等被转换为矢量 drawable，颜色渗入透明区域，轮廓从 alpha 通道描摹并用作裁剪路径，柔和投影变成一条半透明路径。
• 文字与运行时绘制：图片本身不带文字，带字原图保留在 art/original/lettered，tools/erase-lettering.py 生成去字副本，应用在运行时以玩家语言绘制文字。
• 标题与图标：标题是难以描摹的斜线纹理，保留为 WebP；英文使用手作原版，tools/generate-titles.py 以同样风格生成其他语言版本。启动图标与商店图标同样由 art/original/app_icon.png 生成。
• 本地化：翻译是 tools/i18n 下的 Python 数据，每种语言一个字典，tools/i18n/generate.py 据此生成 values-<locale> 资源。显示字体 Grobold 只有拉丁字母，因此 @font/game 按语言解析为 Rubik、Baloo 2 或 Mitr（均为 Open Font License），中日韩使用系统字体。

如何构建

README 给出的常用命令如下：

./gradlew :app:assembleDebug        # debug 构建，可与商店版本共存安装
./gradlew :app:testDebugUnitTest    # 游戏逻辑单元测试
./gradlew :app:lintDebug            # lint，警告视为错误
./gradlew checkKeystore             # 校验签名 keystore 配置
scripts/verify-release.sh           # 生成签名 release APK + AAB 并做上传前检查

签名与 Play 商店清单见 docs/RELEASE.md，签名材料不会存放在仓库中。隐私政策由 sromku.github.io 站点仓库发布。

重新生成美术资源需要先安装 webp，并从 GitHub Releases 下载 macOS 版的 realesrgan-ncnn-vulkan 与 vtracer，然后执行：

brew install webp
./gradlew regenerateArt -Prealesrgan=/path/to/realesrgan-ncnn-vulkan -Pvtracer=/path/to/vtracer