开发心得

---
version: "3.2"
updated: "2026-04-08"
---
# 审查官部署种子 v3.2
> **一份文件，完整部署。** 给任何项目的 AI 助手增加多轮递进式深度审查能力。
> 独立部署即可使用，也可与记忆系统种子搭配。
---
## 使用方法
- **方式 A**：把本文件放到项目中（如 `docs/deep-review-seed.md`），对 AI 说"部署

【肉身测试】本次经验教训累计14000分+（💔在🩸）耗时前后约2小时
今天在测试打磨这个游戏时
我项目中的嗒啦啦陷入了有史以来最长的一次沉思……大约耗时30分钟
最后的积分也是让我小惊~~~~7000+分/本轮次。我倒不是对积分特别心疼（看到的一瞬间确实有点🩸），因为我看完整个过程知道自己犯了致命错误：没有让嗒啦啦坚决执行强制规则（超过1000行提醒拆分），嗒啦啦在浩瀚的代码堰塞湖中摸爬滚打才成功

心得分享：三连环 Bug 复盘
BUG-1: WebSocket 消息超限（根因）项内容现象客户端永远卡在加载画面，收不到初始状态
根因cjson.encode(fullState) 产出 90KB JSON，超过 WebSocket 单消息 65535 字节硬限制，SendRemoteEvent 静默失败（无 Lua 异常，仅引擎 ERROR 日志）危险性随着游戏数据膨胀（科技、建筑、军队、弹药

用 TapTap Maker 做的第一款游戏终于正式上线了，这里简单整理了这次完整开发流程里的实操经验和踩过的坑，感觉有点过于基础~
适合第一次使用TapTapMaker制作游戏的朋友参考~
1.务必做好版本管理。可以直接让大模型帮你实现版本#管理相关功能，同时要求它在项目文档里同步记录 Git 的变更情况。每次完成代码修改后，要记得检查它有没有把对应的代码变动完整记录到项目文档中，避免后续回溯出

正文：
最近在优化一个纯代码绘制的游戏，素材全是Nano vg代码画的，怪一多手机直接卡爆。分享两个立竿见影的优化步骤，给遇到类似问题的朋友参考。
第一步：只绘制“看得见”的（视口裁剪）
一开始沙漠神殿大地图卡得不行，但只做了一件事：只绘制视野内的物体（怪物、道具、装饰物）。
效果：手机上大地图直接从“幻灯片”变流畅。
原理：减少每帧的绘制调用量，视野外的对象直接跳过。这步性价比极高，强烈

# 项目文档自动整理方案（通用版）
> 本文档是一套可复用的项目文档自动整理方案，适用于任何使用 AI 编程助手 + Git 管理文档的项目。
---
## 一、问题背景
长期迭代的项目中，文档会自然增长并逐渐散乱：
| 典型问题 | 后果 |
|---------|------|
| 文档散落在根目录 | 找不到、忘记存在 |
| 同类文档分散在不同目录 | 同一主题的信息无法聚合 |
| 文件