[ide-config] chore(配置): 移除 .claude 配置文件
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -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/` 下对应索引,避免与设计偏离**
|
||||
@@ -1,7 +0,0 @@
|
||||
{
|
||||
"permissions": {
|
||||
"allow": [
|
||||
"Bash(git add:*)"
|
||||
]
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user