diff --git a/Assets/Resources/Yarn/Test_Huoshan/功能需求文档.md.meta b/Assets/Resources/Yarn/Test_Huoshan/功能需求文档.md.meta
deleted file mode 100644
index 9228a2aa0..000000000
--- a/Assets/Resources/Yarn/Test_Huoshan/功能需求文档.md.meta
+++ /dev/null
@@ -1,7 +0,0 @@
-fileFormatVersion: 2
-guid: deccc044f2fc5b14195ea2495e9b7619
-TextScriptImporter:
-  externalObjects: {}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
diff --git a/Assets/Resources/Yarn/Test_Huoshan/设计优化文档.md.meta b/Assets/Resources/Yarn/Test_Huoshan/设计优化文档.md.meta
deleted file mode 100644
index 1e12e93ff..000000000
--- a/Assets/Resources/Yarn/Test_Huoshan/设计优化文档.md.meta
+++ /dev/null
@@ -1,7 +0,0 @@
-fileFormatVersion: 2
-guid: 83ede71a94a95e14991e081f6cfc6be3
-TextScriptImporter:
-  externalObjects: {}
-  userData: 
-  assetBundleName: 
-  assetBundleVariant: 
diff --git a/Docs/HuoShan/README.md b/Docs/HuoShan/README.md
index bc125d474..bdc4bb37c 100644
--- a/Docs/HuoShan/README.md
+++ b/Docs/HuoShan/README.md
@@ -1,28 +1,32 @@
 # 火山（HuoShan）维修场景 - 文档索引
 
-本目录存放火山相关维修场景的设计文档和参考资料。
+本目录集中存放火山相关**全部文档**：设计、需求、优化。Yarn 目录只保留对话脚本，不存放文档。
 
 ## 目录结构
 
 ```
 Docs/HuoShan/
 ├── README.md                    # 本索引文件
-├── 火山第一次维修_设计文档.md    # 第一次维修 - 故事梗概、流程、设定
+├── 火山第一次维修_设计文档.md    # 故事梗概、流程、设定（叙事层）
+├── 功能需求文档.md              # 波形/治疗记录/RAM 等功能的实现需求
+├── 设计优化文档.md              # 波形探测、粒子语言的玩法优化
 └── (未来可扩展)
     └── 火山第二次维修_设计文档.md
 ```
 
 ## 文档清单
 
-| 文档 | 说明 | 对应实现 |
-|------|------|----------|
-| [火山第一次维修_设计文档.md](./火山第一次维修_设计文档.md) | 第一次维修完整设计：用笑话包装悲伤、RAM 堆积、释放表达 | 见下映射 |
+| 文档 | 说明 | 层级 |
+|------|------|------|
+| [火山第一次维修_设计文档.md](./火山第一次维修_设计文档.md) | 第一次维修完整设计：用笑话包装悲伤、RAM 堆积、释放表达 | 叙事 |
+| [功能需求文档.md](./功能需求文档.md) | 波形、治疗记录、RAM 报错、步进 UI 等技术需求与 Yarn 命令 | 实现 |
+| [设计优化文档.md](./设计优化文档.md) | 波形探测、粒子语言的玩法优化与情感曲线 | 玩法 |
 
 ## 实现资源映射
 
 火山第一次维修的实现分布在以下位置：
 
-### Yarn 对话
+### Yarn 对话（仅 .yarn 与 .yarnproject）
 
 - **主流程**：`Assets/Resources/Yarn/Test_Huoshan/`
   - `Stage1.yarn` - 诊室开场
@@ -34,9 +38,6 @@ Docs/HuoShan/
   - `Stage7.yarn` - 最终谈话
   - `EventNode.yarn` / `Center.yarn` - 流程控制
 
-- **功能需求**：`Assets/Resources/Yarn/Test_Huoshan/功能需求文档.md`
-- **设计优化**：`Assets/Resources/Yarn/Test_Huoshan/设计优化文档.md`
-
 ### 脚本与系统
 
 - **波形系统**：`Assets/Scripts/MiniGame/HuoShan/Waveform/`
diff --git a/Assets/Resources/Yarn/Test_Huoshan/功能需求文档.md b/Docs/HuoShan/功能需求文档.md
similarity index 99%
rename from Assets/Resources/Yarn/Test_Huoshan/功能需求文档.md
rename to Docs/HuoShan/功能需求文档.md
index 8da81ca63..75ec983b2 100644
--- a/Assets/Resources/Yarn/Test_Huoshan/功能需求文档.md
+++ b/Docs/HuoShan/功能需求文档.md
@@ -50,7 +50,7 @@ public static IEnumerator CompareWaveforms(string waveform1, string waveform2)
 | `waveform_filter_normal` | 滤波器输出 - 正常混合 | Stage7-最终检查 |
 | `waveform_step1_input` | 步进查看-情绪输入 | Stage3-步进查看 |
 | `waveform_step2_input` | 步进查看-逻辑输入 | Stage3-步进查看 |
-| `waveform_step5_modified` | 步进查看-波形被修改 | Stage3-步进查看 |
+| `waveform_step5_modified` | 步进查看-波形被修改 | Stage3-modify执行 |
 | `waveform_transform_anim` | 波形变换动画 | Stage3-modify执行 |
 
 ---
diff --git a/Assets/Resources/Yarn/Test_Huoshan/设计优化文档.md b/Docs/HuoShan/设计优化文档.md
similarity index 100%
rename from Assets/Resources/Yarn/Test_Huoshan/设计优化文档.md
rename to Docs/HuoShan/设计优化文档.md