U R Chinese?!游戏制作手记

把工作区接到
你的电脑上。

Unity 6000.6.6f1。Codex 打开工作区根，Unity 打开 game/。

先装 Codex，之后交给它。

使用自己的账号。登录、授权、协议、许可资格与激活由本人完成；不共享凭据或登录态，不改全局安全设置。

Mac

从官方桌面入口下载，确认是否支持你的系统和芯片。安装后用自己的账号登录，进入 Codex，打开本机选定的工作区根目录。

官方桌面下载与入门 ↗

Windows

从官方 Windows 页面进入安装入口。使用本地 Windows 工作目录与 PowerShell，先把 Unity 工程放在本机磁盘上。

官方 Windows 下载说明 ↗

已有 Codex 直接复用；桌面不支持本机时，可按官方 Codex CLI接入。所需模型组合不可用时，说明并等待选择，不静默替代。

一条接入路径，五个检查点。

  1. 给定入口

    仓库地址、访问权限、工作目录。没有地址，先检查环境。

  2. 同步工程

    检查已有改动和分支，再 clone 或快进更新；读取根规则。

  3. 安装 Unity

    安装或复用 Hub 与 Unity 6000.6.6f1，按本机芯片与任务选择模块，不自动升级工程。

  4. 跑起灰盒

    编译、进入 Play、移动、进出终端、approve / ban、检查中文。

  5. 交接结果

    列出完成项、实测项和缺项，再领取一项明确的开发任务。

接入完成的标准：在你的电脑上，用正确 Unity 版本实际打开并操作灰盒。安装包下载完成、工具连接成功，都只是中间步骤。

每位伙伴在自己的机器走一遍。当前本机灰盒记录不代表新电脑已通过。Windows、中文字体显示与本机权限都需分别验证。

给 Codex 的第一句话。

把方括号中的工作区路径换成自己的目录，再复制给本机的 Codex。

共享项目，工具各自安装。

伙伴拿到的是完整、可重建的项目源文件，包括资源、代码与设置。

随项目同步

  • 游戏内容：代码、场景、Prefab、模型、贴图、材质、动画、声音和剧情；每份资源及目录保留对应 .meta。可编辑的模型、绘画与音频源文件也要交接。
  • 工程设置：ProjectSettings/、Packages/manifest.json、Packages/packages-lock.json，以及项目自有包源码。
  • 协作材料：自研工具和测试、设计文档、任务、Agent 规则、共享配置模板与 Git / LFS 规则。

留在自己的电脑

  • 公共工具：Unity、Hub、Codex、Git、SDK、IDE 的安装目录与安装包。每人安装或复用同一要求的版本。
  • 自动生成：Library/、PackageCache、Temp/、日志、编译中间文件和普通本地构建；拉取后在本机恢复依赖、重新导入。
  • 个人资料：登录态、密钥、个人配置与路径、编辑器布局、开发存档、onboarding/local/ 本机检查记录。

几个容易混淆的地方：Tools/ 中我们写的脚本要同步，里面的 Hub 安装包不传；Packages/ 中的清单、锁文件和项目自有包要同步，公共包缓存不传。大资产按仓库约定走 Git LFS，拿到真实文件才算齐全。

工程必需的第三方插件按团队许可共享或各自取得；正式试玩包、发行包走单独交付，普通构建不混进源码。

提交前看文件清单，不能原样打包整个文件夹。忽略规则不会自动移除已经进入 Git 的文件。详细检查见 执行规则第 0A 节。

共享工程，各自配置。

工作区根  ← Codex 打开这里
├─ AGENTS.md  · 内部规则入口
├─ 游戏开发的核心灵感.md
├─ 01_创作工作区/  · 设计、任务与接入说明
└─ game/      ← Unity 打开这里
   ├─ Assets/ + .meta
   ├─ Packages/
   │  ├─ manifest.json
   │  └─ packages-lock.json
   ├─ ProjectSettings/
   └─ Tools/ + Tests/ · 自研源码

每天开工，先对齐。

  1. 保存场景、退出 Play；更新 Unity 文件前关闭本工程。
  2. 检查未提交修改、当前分支与它的已确认上游；只在工作树干净且可快进时更新，不自动切回 main。
  3. 遇到改动、冲突或历史分叉，保留现场；不自动覆盖、reset、clean、stash、强推或改写历史。
  4. 在任务分支交付改动；同一场景与 Prefab 约定一个编辑负责人。

检查本机

把接入信息模板保存为 01_创作工作区/04_开发协作/01_伙伴接入/local/setup.json，填写本机路径。环境检查工具只读，不代替实际 Play 验收。

python3 01_创作工作区/04_开发协作/01_伙伴接入/doctor.py --workspace "<WORKSPACE>" --config 01_创作工作区/04_开发协作/01_伙伴接入/local/setup.json

把 <WORKSPACE> 换成本机工作区绝对路径。检查结果和本机配置留在 local/，不提交凭据、个人路径或本机报告。

协作与权限

Baihuzi-Air/UareChinese 保持 private。各自使用自己的 GitHub 账号；新增访问由制作人本人指定准确用户名后授权，不自动邀请或公开仓库。

pull、merge、push，包括 fetch、Git LFS 拉取与 PR 合并，统一交给同一个 GPT-6-luna / max 专职 agent。开发与接入使用 GPT-6.1-sol / ultra，不并发修改 Git 状态，不复制制作人的会话 ID。