docs(huoshan): 添加资源归档区与梳理清单

Co-authored-by: Cursor <cursoragent@cursor.com>
This commit is contained in:
2026-02-12 14:00:28 +08:00
co-authored by Cursor
parent 4a025189d7
commit 5729085f51
4 changed files with 172 additions and 10 deletions
+8
View File
@@ -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` 的已归档表。
+17
View File
@@ -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 | 待确认 | 情绪模块原型 | [ ] |
+78 -10
View File
@@ -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/`
- Stage17.yarn, EventNode.yarn, Center.yarn
- Test_Huoshan.yarnproject
| 工程 | 路径 | 说明 |
|------|------|------|
| 主流程(Test | `Assets/Resources/Yarn/Test_Huoshan/` | Stage18, 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 |