# ChildHood（我的童年）

> 千禧年前后城郊结合区童年生活模拟 · UE5.7.4 · 3D Lowpoly · 单人独立开发

## 项目概况

- **引擎**: Unreal Engine 5.7.4
- **引擎安装路径**: `E:\Program Files\Epic Games\UE_5.7`（**本项目必须使用此 5.7 引擎**；本机另有 5.6 在 `E:/MiceCola/work/UE_5_6`，切勿误用——5.6 的 UBT 不认项目 Target.cs 中的 5.7 专属枚举，会直接 RulesError）
- **美术风格**: 3D Lowpoly，温暖色调，怀旧氛围
- **核心玩法**: 模拟千禧年前后城郊结合区儿童的日常生活（探索、小游戏互动、收集、剧情叙事）
- **灵感来源**: NDS《放学后少年》自由探索 + PS《我的暑假》日常叙事节奏 +《深夏时光》玩法
- **时代背景**: 2000年前后，城市边缘的城郊结合区（如南京迈皋桥），兼顾乡村情节
- **开发者**: starmen1265（单人独立开发）

---

## 项目管理

- **工具**: Gitea（Issues + Milestones）
- **进度查询**: Pipeline Tracker（Meta Issue，仅记录当前阶段和阶段历史）
- **配置文件**: `.claude/skills/gitea-pm/gitea-config.json`（含连接信息、Token、角色映射、标签定义）
- **问题管理**: 改 bug / 排查复杂问题走 `problem-solving` skill（问题分析 + 工作记录挂 Gitea issue，经验沉淀进 `docs/knowledge/`）；详见 [`docs/knowledge/README.md`](docs/knowledge/README.md)

---

## Git 规范

详见 [docs/common/GIT-GUIDE.md](docs/common/GIT-GUIDE.md)。核心要点：

- `main` 永远可玩可编译
- 分支: `develop/`
- 提交: `<type>(<scope>): <中文描述>`，subject ≤ 50 字符
- UE5: 蓝图与 C++ 分开提交；.uasset/.umap commit message 必须写清内容

---

## AI 生图

- **默认走 Codex 通道**（ChatGPT Plus 订阅额度，不按张计费），完整流程见 [`ai-art-research/codex生图工作规范.md`](ai-art-research/codex生图工作规范.md)。该通道为**协作模式**：`codex exec` 由**用户在终端执行**，Claude 负责组装 prompt 与捞图/命名/写 meta 收尾——Claude Code 的安全分类器会硬拦 `codex exec --dangerously-bypass-approvals-and-sandbox`（“Create Unsafe Agents”，不可配置放行），无法自动跑。
- **apiyi 兜底**（`tools/image_gen.py`，按张计费）：撞 ~40–50 张/3h 限额 / 需真透明背景 / 需 Claude 全自动批量时使用；这条通道 Claude 可全自动跑。
- **必须复用现有资产**：`ai-art-research/prompts/*.txt`、`tools/image_gen.py` 的 `STYLE_SEED_EN` 风格种子、`生成结果/` 命名规则（`<时间戳>_gpt-image-2_<模式>.png` + 同名 `.meta.json`，新增 `backend: codex|apiyi` 字段）。
- codex 不在默认 PATH，执行路径：`~/.codex/packages/standalone/current/bin/codex.exe`（命令模板：`codex exec --enable image_generation --dangerously-bypass-approvals-and-sandbox -C ai-art-research -o <lastmsg> "<prompt>"`，prompt 内须明示“用内置 image_gen 工具、不要写脚本/不要用 API key”）。
- ⚠️ `ai-art-research/` 被项目 `.ignore` 屏蔽，不进 ripgrep/Glob 检索；操作需用显式路径。