29 lines
2.3 KiB
Markdown
29 lines
2.3 KiB
Markdown
# AGENTS.md
|
||
|
||
## 项目规则
|
||
|
||
1. 不要盲目顺从用户观点；如果用户判断和源码证据不一致，以源码证据为准并直接说明。
|
||
2. 不要猜测。任何组件、布局、资源、相机、坐标、交互、状态、业务逻辑，都优先查原 Cocos 源码。
|
||
3. 本项目目标是把 QQ 农场小游戏按原 Cocos 源码重构到 Cocos Creator 3.8，不做重新设计，不做近似实现。
|
||
4. 所有组件和逻辑都参考原 Cocos 源码：scene、prefab、compact json、配置表、资源 manifest、SpriteFrame 元数据、Spine 元数据、序列化组件字段、运行时代码。
|
||
5. 不用 Godot 输出、截图、旧生成数据、视觉猜测来决定位置、大小、锚点、缩放、相机、层级、active 状态或交互逻辑。截图只用于观察问题，不作为改动依据。
|
||
6. 能直接复用原 Cocos 组件结构和运行逻辑时，直接复用；不要为了方便重写成另一套坐标系或交互模型。
|
||
7. 修改完成后默认不做构建、截图、ROI 或自动化验证，以节省开发效率。只有用户明确要求验证、准备发布、或需要排查具体运行问题时才执行验证。
|
||
8. 现有本地改动无需询问，继续基于当前工作区修改；不要回滚用户或其他流程留下的改动。
|
||
9. mock 数据必须和源码布局分离。mock 只能改变运行状态，不能改变原始组件布局规则。
|
||
|
||
## 源码位置
|
||
|
||
- 原始提取包：`/Users/hy/Documents/dev/qq_farm_godot_rebuild_20260616`
|
||
- 原小游戏源码：`/Users/hy/Documents/dev/qq_farm_godot_rebuild_20260616/source_raw/6A3BB7D3D4349E2050E7B701AAD51600_726750140f8084ebcbe5190fe9c198c9`
|
||
- 原始远程资源：`/Users/hy/Documents/dev/qq_farm_godot_rebuild_20260616/downloads/raw`
|
||
- 转换 PNG 资源：`/Users/hy/Documents/dev/qq_farm_godot_rebuild_20260616/downloads/converted_png`
|
||
- SpriteFrame 提取数据：`/Users/hy/Documents/dev/qq_farm_godot_rebuild_20260616/downloads/spriteframes`
|
||
- Spine 区域图：`/Users/hy/Documents/dev/qq_farm_godot_rebuild_20260616/downloads/spine_regions`
|
||
|
||
## 当前项目方向
|
||
|
||
- Cocos Creator 项目在 `CocosFarm/`。
|
||
- 当前重构以 Cocos Creator 3.8 为目标。
|
||
- 当前阶段不再用脚本覆盖生成整个场景；优先在 `CocosFarm/assets` 内按原 Cocos 源码证据直接调整组件、层级、资源和逻辑。
|