Files
ChildHood/CLAUDE.md
T

43 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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](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 检索;操作需用显式路径。