Permafrost Engine：C 语言 OpenGL 实时战略（RTS）游戏引擎

Whatajong 是 masylum 在 GitHub 上公开的源码仓库，对应作者在 README 中给出的线上版本 whatajong.com。README 用一句话把它定位为“roguelike, Mahjong Solitaire”，即把麻将接龙（Mahjong Solitaire）与 Roguelike 类型结合起来的游戏。这个定位很有辨识度：麻将接龙通常以牌面配对、清空牌堆为核心，而 Roguelike 往往意味着单局进程、重复挑战与随机性；两者如何结合、是否包含关卡推进或道具系统，README 没有展开，需要结合源码和实际游玩进一步确认。仓库当前没有填写 GitHub 描述与 Topics，README 也非常简短，因此项目文档层面的信息有限，但这并不影响它作为一款已上线网页游戏源码的价值。

从仓库说明看，游戏主体代码位于 /src/renderer 目录。这个目录命名通常表示渲染层或前端表现层，意味着项目可能把游戏画面、界面交互与其余逻辑做了分层；不过 README 没有说明是否使用 Electron、Tauri 或其他桌面/浏览器容器，也没有列出具体框架，因此运行时形态应以 package.json 和源码为准，不能仅凭目录名断定。对准备阅读代码的人来说，/src/renderer 是最直接的入口区域，可先找到页面初始化、游戏主循环或状态入口，再顺着模块关系理解牌局如何呈现、用户输入如何处理以及界面如何更新。

核心特性

开发与测试流程在 README 中写得比较明确：使用 pnpm run dev 启动本地开发环境，使用 pnpm run test 运行测试。这说明项目采用 pnpm 作为包管理器，并配有测试脚本，源码中应存在可执行的测试用例或测试配置；但 README 没有给出 Node.js 版本、依赖安装细节、构建命令或部署方式。实际搭建环境时，建议先查看 package.json 中的 scripts、依赖和 engines 字段（若存在），并参考锁文件选择包管理器版本。由于线上版本已经存在，本地运行主要用于阅读、调试和修改，而不是按照完整教程从零搭建。

项目在类型上最值得关注的是“麻将接龙 + Roguelike”的组合。麻将接龙本身涉及牌面布局、可选牌判定、配对消除和清空条件；Roguelike 则可能带来单局重置、难度变化或随机要素。需要强调的是，README 没有具体说明 Whatajong 的牌局规则、随机机制、关卡数量、计分方式或成长系统，因此这些内容不能凭类型标签臆测。阅读源码时，可以把重点放在游戏状态管理、牌面数据表示、可用操作判定、界面反馈和测试覆盖上：这些是此类游戏能否稳定运行的关键，也是比单纯复刻外观更有学习价值的部分。若源码中的测试覆盖了核心规则，还可以借助 pnpm run test 理解作者如何验证牌局逻辑。

技术要点

运行平台方面，README 只提供了线上地址 whatajong.com 和本地 pnpm 命令，没有声明 Windows、Linux 或 macOS 的官方支持情况，也没有提供安装包、压缩包或发布版本。因此可以确认的是它作为网页游戏可在线访问，本地开发则需要在具备 Node.js 与 pnpm 的环境中执行命令；具体操作系统兼容性、浏览器要求和构建产物形态均待核验。对国内开发者而言，首次安装依赖可能受 npm/pnpm 源与网络条件影响，可考虑配置镜像；线上试玩和 GitHub 访问速度也取决于网络环境，具体体验需自行验证。

总体来看，Whatajong 适合已经具备 TypeScript 与前端开发基础、希望研究网页游戏组织方式和麻将接龙类玩法的开发者阅读。它不是那种附带长篇教程的入门示例，README 的简短意味着学习者需要主动从 /src/renderer、package.json 和测试文件中还原项目结构；但正因如此，它更接近真实线上项目的代码形态。若目标是学习“如何把传统牌类玩法做成可运行、可测试的网页游戏”，这个仓库提供了可核验的起点；若目标是寻找完整规则文档或开箱即用的二次开发模板，则需要先投入时间做源码梳理。