diff --git a/Docs/HuoShan/INDEX.md b/Docs/HuoShan/INDEX.md index a3f1b417d..c246dc116 100644 --- a/Docs/HuoShan/INDEX.md +++ b/Docs/HuoShan/INDEX.md @@ -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` 的已归档表。 diff --git a/Docs/HuoShan/_archived/README.md b/Docs/HuoShan/_archived/README.md new file mode 100644 index 000000000..2280b8b94 --- /dev/null +++ b/Docs/HuoShan/_archived/README.md @@ -0,0 +1,17 @@ +# 归档区 + +本目录存放**已归档资源的记录**，不存放实际资源。实际资源仍在 Unity 工程中，仅在此标注状态。 + +## 梳理流程 + +1. 对照 [资源梳理清单.md](./资源梳理清单.md) 逐项确认 +2. 确认「待归档」后，在 `05_resources.md` 中移至「已归档」表 +3. 若要从工程物理删除，需另走流程（注意引用关系） + +## 状态定义 + +| 状态 | 含义 | +|------|------| +| 在用 | 当前第一次维修流程直接使用 | +| 待确认 | 需人工确认是否仍需要 | +| 已归档 | 不再维护，仅作参考；资源可保留在工程 | diff --git a/Docs/HuoShan/_archived/资源梳理清单.md b/Docs/HuoShan/_archived/资源梳理清单.md new file mode 100644 index 000000000..eb44b9d76 --- /dev/null +++ b/Docs/HuoShan/_archived/资源梳理清单.md @@ -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 | 待确认 | 情绪模块原型 | [ ] | diff --git a/Docs/HuoShan/core/05_resources.md b/Docs/HuoShan/core/05_resources.md index 86e0119ee..18c4cd8cf 100644 --- a/Docs/HuoShan/core/05_resources.md +++ b/Docs/HuoShan/core/05_resources.md @@ -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 |