TapTap制造缺陷反馈报告

前天 11:1019 浏览BUG反馈疑似 AI 合成内容

Maker MCP 本地/云端 workspace 素材不同步，且云端构建可能删除本地资产

严重级别：高（存在用户数据丢失风险 + 破坏双端开发工作流）

一、环境

本地：TapTap Maker 本地 MCP 项目（git 版本 4091b70/5dc5bea 附近），项目《王国余烬：破碎王冠》

云端：Maker 云端 workspace（项目 ID m_da1f，v1.0.2），经 Game Development Assistant 会话访问

二、事件经过

1、本地开发中新增 6 组敌方单位立绘（教廷修女 / 祝祷神父 / 教会信徒 / 军阵旗使 / 苍鹰猎手 / 殉道圣徒，共 19 张 PNG），并同步完成了本地 Config.UNIT_SPRITES 的接线。本地文件数 137。

2、同期这些单位的玩法定义（Config.ENEMIES）已经同步到了云端，但图片素材与 UNIT_SPRITES 接线没有到达云端（云端文件数 117）。表现为：云端预览看不到新单位立绘。

3、本地会话报告：在此状态下"再跑云端构建会删除本地资产"（该行为由本地端观察到，本报告提交人未独立复现，建议官方按此线索排查反向同步逻辑）。

4、临时绕行方案：用户将 19 张 PNG 通过对话附件手动上传到云端 workspace，由云端会话负责重命名归位到 assets/image/units/、生成 .meta uuid、补写 Config.UNIT_SPRITES 接线并重新构建。云端预览恢复。

三、核实过的证据（云端侧）

云端 assets/image/units/ 最后更新时间停在素材产生之前（10-14 16:03），新立绘文件与接线均缺失；而 Config.ENEMIES 里六单位定义已存在——即代码同步成功、资源同步失败，双端出现不一致的分叉状态。

手动补传后构建成功，19 张素材正常进入 dist/1.0.2 产物清单。

四、影响

【数据风险】若"云端构建删除本地资产"属实，用户可能丢失仅存在于本地的素材文件，只能依赖 git 恢复；未做版本管理的用户将永久丢失。

【效率】每一批新素材都需要人工"打包搬运"，双端并行开发时反复出现"本地有、云端没有"的假故障，排查成本高（本次排查确认了素材、打包、预下载、渲染代码全部无问题后才定位为同步缺失）。

【一致性】代码与资源以不同速率同步，造成两端 Config 分叉，后续任何一端构建都可能放大偏差。

五、期望的改进

1、可靠的双向同步：本地新增资源应能完整同步到云端（至少提供一键正向推送）；同步失败时给出明确报错，而不是静默缺文件。

2、非破坏性原则：任何方向的同步/构建都不得删除对端独有文件；确有冲突时保留双方并提示用户裁决（类似 git 的 ours/theirs），或至少写入可恢复的回收目录。

3、同步状态可见：在两端提供文件清单 diff / 同步状态指示，让用户能立刻看出"本地 137 / 云端 117"这类缺口。

4、素材上传 API/CLI：允许 Agent 以编程方式把本地素材推送到云端 workspace，免去人工搬运。

六、复现步骤（建议官方验证第 3 点）

1、本地新增若干 assets 图片（不提交 git）；

2、确认对应代码改动已同步至云端；

3、在云端触发一次构建；

4、检查本地 assets 目录中新图片是否被删除/丢失。

9.8