项目简介
情怀国际版源码面向英语界面和语言扩展需求，客户端登录页采用海岛、人物及车辆组合的美术风格，界面中安排Facebook、Google、手机及游客登录入口。已有按钮属于界面展示，真正接入外部账户时仍需单独配置对应SDK、回调和服务接口，并检查各平台的实际登录返回。
技术资料描述的结构包括Java与Node服务、RocketMQ消息组件、MySQL数据、MongoDB相关存储、Redis缓存以及PHP管理后台，客户端采用Cocos Creator。环境整理时应分别核对工程依赖与服务配置，不把这些组件的名称直接视为固定版本或已完成的运行部署。
语言资源
语言扩展应先从英语文案建立统一键值表，再整理按钮、提示、公告及错误信息的调用位置。文本与图片文字分别处理，避免只翻译主界面而遗漏弹窗和加载提示。不同语言的长度会影响布局，需检查字体字形、换行、缩放及按钮宽度。
外部登录
外部登录调试应分别记录客户端回调、服务器校验和用户资料返回。先验证游客入口与基础网络，再接入需要的账户平台。应用标识、回调地址和签名配置保持一致，真实凭据单独保管；不同平台失败时，按各自日志定位，避免把问题统一归为语言配置。
准备工作
在独立测试目录中保留原始资料，并另外建立修改副本。先检查说明文件、工程配置与资源引用，再决定工具环境和操作顺序。把大厅、子游戏、服务组件以及发布文件分区存放，避免同名文件互相覆盖。每轮修改记录日期、目标和变更位置，出现问题时能够回到明确的版本。
配置检查
建立配置清单，分别记录业务接口、资源下载和版本检测入口，不把不同地址混成一个配置项。修改后核对路径大小写、端口与目录层级，再检查响应内容是否符合预期。凭据和签名文件保留在私有环境；对外说明配置类别即可，不直接复制其他项目的账户或测试地址。
构建流程
客户端工程先完成资源导入与脚本检查，再选择目标平台生成构建产物。原生工程生成、编译及设备启动分别保留日志。若准备Android安装包，应核对SDK、NDK、包名和签名；若研究网页发布，则另行检查浏览器接口及资源路径。工具版本以工程依赖为准，不用一次成功结果替代跨端验证。
资源部署
热更新或远程资源先使用同一次构建输出，保持脚本、图片与描述文件版本对应。上传后核对文件能否访问、返回类型是否正确及缓存是否仍指向旧内容。先部署一个测试模块，再检查下载、解压、校验和加载结果，确认路径稳定后再扩大范围，不一次性替换所有模块而失去问题定位依据。
联调顺序
按启动、登录、大厅入口、模块下载与进入场景的顺序记录结果，再测试重启、断线与失败重试。每个环节保留请求路径和日志，区分客户端资源问题、服务接口问题和数据问题。一次只处理一组关联配置，修改后回到同一步骤复测，避免通过大量重复打包掩盖真正的错误。
二开方向
二次开发可先从品牌图片、按钮布局、文案及入口配置入手，再推进公共逻辑和模块扩展。视觉展示与程序功能分别验收，任何新入口都要有对应事件、资源和服务处理。交付时整理修改清单、构建说明与验证结果，明确工程和组件的实际范围，方便继续维护，也避免承诺未经验证的兼容性或性能。
版本管理
每轮构建建立独立版本记录，把工具环境、工程配置、产物目录与测试结果关联起来。修改公共脚本后，确认大厅和子游戏是否需要同步重新构建。发布资源不要直接覆盖唯一备份，应保留能够回退的文件。对比新旧版本时同时检查资源路径和配置变化，避免只关注界面外观而遗漏加载流程。
日志定位
排查先记录完整错误上下文，确认失败发生在导入、编译、请求还是加载阶段。工具报错需要检查依赖与配置；网络报错需要检查地址、响应和权限；资源异常则继续核对引用与文件内容。相同问题复现时保留同一组测试条件，先做最小修改再验证，避免大量无关变更让日志失去对比意义。
整理交付
完成调整后，按工程、资源、配置说明及构建产物组织目录，并写清各文件用途。公开说明不包含实际账户、签名和连接凭据。测试记录注明设备、环境与操作范围，便于下一轮维护复现结果。对于尚未处理的模块，列入后续工作清单，保持交付内容与能够确认的工程范围一致。
