# 项目引导

本文档给后续开发者和 AI 使用。进入本项目时，优先阅读 `README.md`、本文档和 `docs/工程蓝图.md`。

## 工作边界

- 本项目所有新内容都写入 `G:\致博世界\致博的小屋物语\`。
- `G:\致博世界\致博石斧冒险\` 只作为经验参考，不直接复制其混合式单页结构。
- 原始架构稿 `致博庄园世界架构.md` 只作为背景材料；落地开发以 `docs/` 下的拆分文档为准。
- 不修改父目录 `.gitlab-ci.yml`，除非用户明确要求为本项目接入发布流水线。

## 开发原则

- 先打通可运行主链路，再逐步丰富系统。
- 前端只负责展示、输入、动画和临时 UI 状态。
- 后端负责账号、存档、经济、掉落、事件和权威结果。
- 所有可长期扩展的内容优先配置化，包括物品、掉落、事件、价格、成长数值。
- 每次新增玩法，都要同时考虑测试、存档兼容和后续数据调整方式。

## 初期优先级

1. 首页登录页：账号密码登录、注册入口、唯美视觉、加载条。
2. 世界入口：加载提示词、进入全屏 2D 开放世界。
3. 最小世界：角色移动、地图边界、镜头跟随、基础 UI。
4. 第一批系统：物品、背包、采集、存档。
5. 后端接入：账号、存档、配置、事件权威逻辑。

## 与旧项目的关系

旧项目 `致博石斧冒险` 中的经验可以参考：

- 资源、种植、商店、仓库网络、塔防路线等玩法经验。
- 本地验证脚本和回归测试习惯。
- GitLab、共享 nginx、静态站点发布经验。

但本项目目标更偏商业级工程化，需要从一开始保持前后端分层和目录清晰。