From 69a7d746fef1fae035843fca4d6b90d0dbc1b8f0 Mon Sep 17 00:00:00 2001 From: bottlefish <781230111@qq.com> Date: Wed, 25 Feb 2026 14:40:12 +0800 Subject: [PATCH] =?UTF-8?q?[ide-config]=20chore(=E9=85=8D=E7=BD=AE):=20?= =?UTF-8?q?=E7=A7=BB=E9=99=A4=20.claude=20=E9=85=8D=E7=BD=AE=E6=96=87?= =?UTF-8?q?=E4=BB=B6?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Cursor --- .claude/CLAUDE.md | 136 ------------------------------------ .claude/settings.local.json | 7 -- 2 files changed, 143 deletions(-) delete mode 100644 .claude/CLAUDE.md delete mode 100644 .claude/settings.local.json diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md deleted file mode 100644 index eb6ff74bf..000000000 --- a/.claude/CLAUDE.md +++ /dev/null @@ -1,136 +0,0 @@ -# CLAUDE.md - -Claude Code 与 Cursor 的项目上下文,对话开始时自动加载。 - -## 项目概览 - -AIBIS Dream(又名 AllOurBrokenParts)是一款基于 Unity 的叙事冒险游戏,带有调查元素。使用 Yarn Spinner 管理对话,采用自定义模块化框架,包含多个小游戏(核心之一是火山 HuoShan 的语言粒子系统)。 - -**Unity 版本:** Unity 2022.3.x LTS(Universal Render Pipeline) - -## 架构 - -### 核心框架(Assets/Scripts/Framework/) - -- **ActionKit**:动作序列与命令模式 -- **AudioKit**:音频管理与音效 -- **Config**:配置与设置 -- **Core**:核心系统与工具 -- **EventSystemKit**:解耦事件系统 -- **PoolKit**:对象池 -- **ResourceKit**:资源加载 -- **SingletonKit**:单例基类 -- **StateMachineKit**:状态机 -- **TimelineKit**:Timeline 事件序列 - -### 主要游戏系统 - -- **Dialog System**(Assets/Scripts/Dialog System/):Yarn Spinner 对话 -- **Clue System**(Assets/Scripts/Clue/):调查与证据收集 -- **MiniGame System**(Assets/Scripts/MiniGame/):小游戏框架 - - **HuoShan(火山)**:语言粒子系统,用于情绪表达玩法 -- **SceneManagement**:场景与流程 -- **FixSystem**:互动维修/解谜 - -### Web 原型 - -位于 `web-prototype/` 与 `WebPrototype/`,用于在 Unity 实现前验证玩法。 - -### 设计文档(Docs) - -**任何开发工作,按需阅读对应的设计文档。** 文档采用单源真相,定义只维护一份。 - -| 索引 | 说明 | -|------|------| -| `Docs/HuoShan/INDEX.md` | 火山文档入口 | - -## 常用开发命令 - - -``` - -## 关键依赖 - -### Unity 包 - -- Yarn Spinner、TextMesh Pro、URP、2D Animation、Cinemachine、Timeline、Localization - -### 第三方资源 - -- FMOD、DOTween、Shapes - -## 开发规范 - -### 代码组织 - -1. 各系统放在 `Assets/Scripts/` 下独立文件夹 -2. 可复用工具以 Kit 后缀放在 `Framework/` -3. 组件优先于继承 - -### 场景结构 - -- 场景在 `Assets/Scenes/` -- 主场景命名:`{角色}_{Day}{时间}`(如 `Fiction_Day1_begin`) -- 小游戏场景:`HuoShan*`、`languageTest*` 等 -- 需加入 EditorBuildSettings - -### Yarn 对话文件 - -- 位于 `Assets/Resources/Yarn/`,按角色与日期组织 -- 文件命名:`{角色}_{阶段}.yarn` -- 使用 UTF-8 - -### 资源命名 - -- **脚本**:PascalCase,带用途(如 `DialogController.cs`) -- **Prefab**:PascalCase 加类型后缀 -- **场景**:Snake_Case -- **Resources**:按系统/类型分组 - -## 配置要点 - -### 编辑器 - -- 文本编码:UTF-8(尤其中文) -- 行尾:C# 使用 Windows (CRLF),保持一致 - - -### Git - -- LFS:大文件(.unity、贴图、音频) -- 忽略:Library/、Temp/、Logs/、Build/、*.csproj.user - -## 测试与迭代 - -### 小游戏独立测试 - -- 火山语言游戏:`Assets/Scenes/languageTest.unity` -- 火山维修:`Assets/Scenes/HuoShanFixScene.unity` -- 表情测试:`Assets/Scenes/HuoShanExpressionTest.unity` - -### Web 原型 - -1. 在 `web-prototype/` 建 HTML/JS 原型 -2. 逻辑与 Unity 实现保持一致 -3. 浏览器快速验证 - -## 常见任务 - -### 新增小游戏 - -1. 建文件夹 `Assets/Scripts/MiniGame/{名称}/` -2. 用 Framework 实现逻辑 -3. 建测试场景 `{名称}Test.unity` -4. 资源放 `Assets/Resources/{名称}/` -5. 在 `README_{名称}.md` 中记录 - -### 添加 Yarn 对话 - -1. 在 `Assets/Resources/Yarn/{角色}/` 建 `.yarn` -2. 通过 Resources.Load 加载 -3. 挂到场景的 DialogueRunner -4. 用 DialogueController 测试 - - -## 重要提醒 -- **开发前按需读 `Docs/` 下对应索引,避免与设计偏离** diff --git a/.claude/settings.local.json b/.claude/settings.local.json deleted file mode 100644 index 5707c58ad..000000000 --- a/.claude/settings.local.json +++ /dev/null @@ -1,7 +0,0 @@ -{ - "permissions": { - "allow": [ - "Bash(git add:*)" - ] - } -}