ChildHood/CLAUDE.md

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、角色映射、标签定义）

---

Git 规范

详见 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。该通道为协作模式：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 检索；操作需用显式路径。