docs(huoshan): 添加资源归档区与梳理清单
Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
@@ -14,6 +14,13 @@
|
||||
| [core/04_implementation.md](./core/04_implementation.md) | 实现状态、Yarn 命令、波形定义、配置清单 | 技术实现改动 |
|
||||
| [core/05_resources.md](./core/05_resources.md) | 实现资源映射(Yarn/脚本/场景路径) | 路径变动时 |
|
||||
|
||||
## 归档与梳理 `_archived/`
|
||||
|
||||
| 文件 | 说明 |
|
||||
|------|------|
|
||||
| [_archived/README.md](./_archived/README.md) | 归档流程与状态定义 |
|
||||
| [_archived/资源梳理清单.md](./_archived/资源梳理清单.md) | 待确认/待归档项清单 |
|
||||
|
||||
## 探索分支 `_branches/`
|
||||
|
||||
非既定设计、待验证或备选方向的内容放在 `_branches/` 下,**不与 core 冲突**。
|
||||
@@ -32,3 +39,4 @@
|
||||
2. **探索/实验** → 放入 `_branches/`,文件名带 `[探索]` 或 `_建议` 等标注。
|
||||
3. **流程变更** → 只改 `02_flow.md`,其他文档引用步骤编号,不复制流程表。
|
||||
4. **实现变更** → 只改 `04_implementation.md`,保持 Yarn 命令、波形 ID 等与代码一致。
|
||||
5. **资源归档** → 对照 `_archived/资源梳理清单.md` 确认;归档后更新 `05_resources` 的已归档表。
|
||||
|
||||
@@ -0,0 +1,17 @@
|
||||
# 归档区
|
||||
|
||||
本目录存放**已归档资源的记录**,不存放实际资源。实际资源仍在 Unity 工程中,仅在此标注状态。
|
||||
|
||||
## 梳理流程
|
||||
|
||||
1. 对照 [资源梳理清单.md](./资源梳理清单.md) 逐项确认
|
||||
2. 确认「待归档」后,在 `05_resources.md` 中移至「已归档」表
|
||||
3. 若要从工程物理删除,需另走流程(注意引用关系)
|
||||
|
||||
## 状态定义
|
||||
|
||||
| 状态 | 含义 |
|
||||
|------|------|
|
||||
| 在用 | 当前第一次维修流程直接使用 |
|
||||
| 待确认 | 需人工确认是否仍需要 |
|
||||
| 已归档 | 不再维护,仅作参考;资源可保留在工程 |
|
||||
@@ -0,0 +1,69 @@
|
||||
# 火山资源梳理清单
|
||||
|
||||
按项确认,打 `✓` 表示已确认,`归档` 表示可归档。
|
||||
|
||||
---
|
||||
|
||||
## 场景
|
||||
|
||||
| 场景 | 状态 | 备注 | 操作 |
|
||||
|------|------|------|------|
|
||||
| HuoShanFixScene | 在用 | 主维修场景 | — |
|
||||
| HuoShanExpressionTest | 在用 | Stage6 粒子小游戏 | — |
|
||||
| HuoShanEmoSceneTest | 待确认 | Emo 系统;Emo 文件夹仍在,是否并入主流程? | [ ] |
|
||||
| languageTest | 待确认 | 早期粒子测试,可能被 ExpressionTest 取代? | [ ] |
|
||||
| ExpressFixScene | **非火山专属** | 石头 Day1/Day2 使用,从火山资源表移除 | 移除 |
|
||||
|
||||
---
|
||||
|
||||
## Yarn
|
||||
|
||||
| 工程 | 状态 | 备注 | 操作 |
|
||||
|------|------|------|------|
|
||||
| Test_Huoshan | 在用 | 主流程 | — |
|
||||
| Fiction_Huoshan1 | 待确认 | 叙事版,3 个 Stage;与 Test 关系?已并入主线 or 独立支线? | [ ] |
|
||||
|
||||
---
|
||||
|
||||
## 脚本
|
||||
|
||||
| 目录 | 状态 | 备注 | 操作 |
|
||||
|------|------|------|------|
|
||||
| Waveform | 在用 | 波形系统 | — |
|
||||
| Language | 在用 | 粒子语言 | — |
|
||||
| SalesSystem | 在用 | 销售模块 | — |
|
||||
| Emo | 待确认 | 情绪模块(湖/网格等);与主流程关联? | [ ] |
|
||||
| AnalysisSystem_Archived | **已归档** | 目录名已标 Archived | 记录到归档表 |
|
||||
|
||||
---
|
||||
|
||||
## 美术
|
||||
|
||||
| 资源 | 状态 | 备注 | 操作 |
|
||||
|------|------|------|------|
|
||||
| Huoshan/SellSystem | 在用 | 步进模式 | — |
|
||||
| 火山.psb | 在用 | 主角色 | — |
|
||||
| 火山.prefab | 在用 | 立绘 | — |
|
||||
| 地铁火山 | 待确认 | 主线/序章用? | [ ] |
|
||||
| 地铁火山暗 | 待确认 | 同上 | [ ] |
|
||||
| 酒吧火山 | 待确认 | Day1 夜酒吧? | [ ] |
|
||||
| chapter7_huoshan | 在用 | 章节图 | — |
|
||||
|
||||
---
|
||||
|
||||
## ScriptableObjects
|
||||
|
||||
| 资产 | 状态 | 备注 | 操作 |
|
||||
|------|------|------|------|
|
||||
| Test_HuoShan | 在用 | 测试入口 | — |
|
||||
| HuoshanDay1 | 待确认 | Day1 火山线入口,主线在用? | [ ] |
|
||||
| Day2_FIRST_HS1 | 待确认 | Day2 首次进火山,主线在用? | [ ] |
|
||||
|
||||
---
|
||||
|
||||
## Web 原型
|
||||
|
||||
| 文件 | 状态 | 备注 | 操作 |
|
||||
|------|------|------|------|
|
||||
| stage3-filter-check | 待确认 | 波形/滤波原型,功能已实现? | [ ] |
|
||||
| emotion-lab | 待确认 | 情绪模块原型 | [ ] |
|
||||
@@ -1,20 +1,88 @@
|
||||
# 火山第一次维修 - 实现资源映射
|
||||
|
||||
路径变动时更新本文件。
|
||||
路径变动时更新本文件。梳理状态见 `_archived/资源梳理清单.md`。
|
||||
|
||||
## 场景(火山相关)
|
||||
|
||||
| 场景 | 路径 | 用途 |
|
||||
|------|------|------|
|
||||
| 主维修场景 | `Assets/Scenes/HuoShanFixScene.unity` | 第一次维修完整流程 |
|
||||
| 粒子语言测试 | `Assets/Scenes/HuoShanExpressionTest.unity` | Stage6 粒子小游戏测试 |
|
||||
| 情绪模块测试 | `Assets/Scenes/HuoShanEmoSceneTest.unity` | Emo 系统测试 |
|
||||
| 语言粒子测试 | `Assets/Scenes/languageTest.unity` | 语言粒子基础测试 |
|
||||
|
||||
*注:ExpressFixScene 为石头线复用,非火山专属。*
|
||||
|
||||
## Yarn
|
||||
|
||||
- **主流程**:`Assets/Resources/Yarn/Test_Huoshan/`
|
||||
- Stage1–7.yarn, EventNode.yarn, Center.yarn
|
||||
- Test_Huoshan.yarnproject
|
||||
| 工程 | 路径 | 说明 |
|
||||
|------|------|------|
|
||||
| 主流程(Test) | `Assets/Resources/Yarn/Test_Huoshan/` | Stage1–8, EventNode, Center |
|
||||
| 叙事版 | `Assets/Resources/Yarn/Fiction_Huoshan1/` | Stage1_开头、Stage2_检查、Stage3_结束 |
|
||||
|
||||
## 脚本
|
||||
|
||||
- 波形:`Assets/Scripts/MiniGame/HuoShan/Waveform/`
|
||||
- 销售/情绪:`Assets/Scripts/MiniGame/HuoShan/SalesSystem/`、`Emo/`
|
||||
- 维修框架:`Assets/Scripts/FixSystemNew/`
|
||||
| 系统 | 路径 |
|
||||
|------|------|
|
||||
| 波形 | `Assets/Scripts/MiniGame/HuoShan/Waveform/` |
|
||||
| 销售 | `Assets/Scripts/MiniGame/HuoShan/SalesSystem/` |
|
||||
| 情绪 | `Assets/Scripts/MiniGame/HuoShan/Emo/` |
|
||||
| 语言粒子 | `Assets/Scripts/MiniGame/HuoShan/Language/` |
|
||||
| 维修框架 | `Assets/Scripts/FixSystemNew/` |
|
||||
|
||||
## 场景
|
||||
## 美术资源
|
||||
|
||||
- 主场景:`Assets/Scenes/HuoShanFixScene.unity`
|
||||
- 粒子语言测试:`Assets/Scenes/HuoShanExpressionTest.unity`
|
||||
### 维修专用
|
||||
|
||||
| 资源 | 路径 |
|
||||
|------|------|
|
||||
| 销售模块/步进 | `Assets/Resources/Art/Fix/Huoshan/SellSystem/`(步进模式.psb 等)|
|
||||
| 线框图(复用)| `Assets/Resources/Art/Fix/线框图/`(Emo, Logic, Speak 等)|
|
||||
|
||||
### 角色与立绘
|
||||
|
||||
| 资源 | 路径 |
|
||||
|------|------|
|
||||
| 火山主资源 | `Assets/RawResources/Art/火山.psb` |
|
||||
| 火山立绘预制体 | `Assets/Resources/SpriteGroup/火山.prefab` |
|
||||
| 地铁火山 | `Assets/RawResources/Actor/地铁人物/地铁火山/` |
|
||||
| 地铁火山暗 | `Assets/RawResources/Actor/地铁人物/地铁火山暗/` |
|
||||
| 酒吧火山 | `Assets/RawResources/Art/酒吧素材/酒吧内角色动画/酒吧火山.*` |
|
||||
| 酒吧火山 | `Assets/RawResources/Actor/酒吧人物/酒吧火山.*` |
|
||||
|
||||
### 章节与 UI
|
||||
|
||||
| 资源 | 路径 |
|
||||
|------|------|
|
||||
| 第七章图 | `Assets/RawResources/Art/Chapter/chapter7_huoshan.png` |
|
||||
|
||||
## ScriptableObjects / 配置
|
||||
|
||||
| 资产 | 路径 | 说明 |
|
||||
|------|------|------|
|
||||
| 测试入口 | `Assets/ScriptableObjects/SceneSO/Test_HuoShan.asset` | firstScene: HuoShanFixScene |
|
||||
| Day1 入口 | `Assets/ScriptableObjects/SceneSO/HuoshanDay1.asset` | firstScene: HuoShanFixScene |
|
||||
| Day2 首进 | `Assets/ScriptableObjects/SceneSO/Day2_FIRST_HS1.asset` | firstScene: HuoShanFixScene |
|
||||
|
||||
## 本地化
|
||||
|
||||
| 工程 | 路径 |
|
||||
|------|------|
|
||||
| Test_Huoshan | `Assets/Language/Dialog/Test_Huoshan/` |
|
||||
| Fiction_Huoshan1 | `Assets/Language/Dialog/Fiction_Huoshan1/` |
|
||||
|
||||
## 其他
|
||||
|
||||
| 类型 | 说明 |
|
||||
|------|------|
|
||||
| 角色配置 | `Assets/StreamingAssets/Config/character.csv` 中 `hs,火山,Huoshan` |
|
||||
| Tag | `HuoshanScreen`(波形/粒子渲染层)|
|
||||
| Web 原型 | `web-prototype/stage3-filter-check.html`、`emotion-lab.html` |
|
||||
|
||||
---
|
||||
|
||||
## 已归档(不再维护,仅作参考)
|
||||
|
||||
| 资源 | 路径 | 归档原因 |
|
||||
|------|------|----------|
|
||||
| AnalysisSystem | `Assets/Scripts/MiniGame/HuoShan/AnalysisSystem_Archived/` | 目录已标 Archived |
|
||||
|
||||
Reference in New Issue
Block a user