aibis-dream/Docs/HuoShan/core/05_resources.md

火山第一次维修 - 实现资源映射

路径变动时更新本文件。梳理状态见 _archived/资源梳理清单.md。

场景（火山相关）

场景	路径	用途
主维修场景	Assets/Scenes/HuoShanFixScene.unity	第一次维修完整流程

Yarn

工程	路径	说明
主流程（Test）	Assets/Resources/Yarn/Test_Huoshan/	Stage1–8, EventNode, Center

Stage ↔ 系统使用

Stage	主要系统	用途
Stage1	Clinic	诊室开场
Stage2	BodyModule, EmotionWave	后脑检查（表达→销售→逻辑→情绪）
Stage3	Sales, EmotionWave	销售模块深入、波形步进、modify（EmotionWave 替代 Waveform）
Stage4	BodyModule	表达 RAM 报错表现（短暂过渡）
Stage5	Clinic	理解问题后诊室对话
Stage6	Expression	释放 RAM、log 小游戏（表达粒子）
Stage7	BodyModule	后脑检查过渡
Stage8	Clinic	诊室最终谈话

脚本

系统	路径
波形	Assets/Scripts/MiniGame/HuoShan/Waveform/
销售	Assets/Scripts/MiniGame/HuoShan/SalesSystem/
表达/语言粒子	Assets/Scripts/MiniGame/HuoShan/Language/
情绪波形	Assets/Scripts/MiniGame/HuoShan/EmotionWave/
维修框架	Assets/Scripts/FixSystemNew/

各系统概述与 Yarn 接口

维修框架（FixSystemNew）

组件	路径	概述
FixSystemCenter	FixSystemCenter.cs	全局入口，管理 FixState 与 SystemDic
FixStateMachine	FixStateMachine.cs	状态机，支持 Clinic/BodyModule/Sales/Expression 等
ClinicSystem	Clinic/	诊室视图、角色立绘
BodyModuleSystem	BodyModule/	后脑模块、插线、热力图
ScreenSystem	Screen System/	任务面板、完成标记
ShockSystem	Open/	转场闪光、震动效果

Yarn 命令（FixSystem）

命令	说明
<<switch_fix_system_to "State" "Arg">>	切换维修状态，如 Sales / BodyModule / Clinic / Expression；Arg 如 Head 表示后脑
<<play_clinic_cut>>	播放诊室转场切镜

Yarn 命令（Clinic）

命令	说明
<<init_character "火山">>	初始化角色立绘
<<switch_character_state "状态">>	切换角色表情/姿态
<<hide_character 1>>	隐藏角色（淡出）
<<show_character 1>>	显示角色（淡入）
<<quit_clinic_new 1>>	退出诊室

Yarn 命令（BodyModule）

命令	说明
<<Reset_Plug>>	重置插线状态
<<DropCable>> / <<RetractCable>>	放下/收起线缆
<<ShowHeatMap>> / <<HideHeatMap>>	显示/隐藏热力图

Yarn 命令（Screen）

命令	说明
<<show_task_panel>>	显示任务面板
<<complete_task "line:xxx">>	完成指定任务
<<clear_screen>>	清空屏幕文字
<<clear_tasks>>	清空任务列表

---

销售系统（SalesSystem）

概述：销售模块深入，发条(Crank)-滑片(Slider)驱动波形进度；支持处理器深入模式（旋钮+辉光管）。

核心组件：SalesManager、CrankController、SliderController、KnobController、ProcessorLightController、GlowTubeEffect

Yarn 命令

命令	说明
<<reset_crank>>	重置发条
<<rotate_crank 180 0.5>>	旋转发条到角度、时长
<<wait_crank_complete>>	等待发条完成一轮
<<reset_slider>>	重置滑片
<<slide_to_position 0.5 1>>	滑片移到标准化位置
<<slide_to_segment 3 1>>	滑片移到指定段
<<slide_to_anomaly 3 1>>	滑片移到异常段
<<wait_slider_at 0.5>>	等待滑片到达位置
<<activate_processor 3>>	激活指定处理器灯
<<deactivate_all_processors>>	关闭所有处理器灯
<<show_anomaly_processor 3>>	显示异常处理器（闪烁）
<<update_processor_from_slider>>	按滑片位置更新处理器灯
<<enter_step_mode>>	进入步进模式
<<enter_processor_mode>>	进入处理器深入模式（面板放大、旋钮/辉光管）
<<exit_processor_mode>>	退出处理器深入模式
<<complete_crank_cycle>>	完成发条-滑片一轮
<<wait_step_node 3>>	等待步进节点完成
<<reset_crank_cycle>>	重置发条-滑片循环
<<adjust_power 50>>	旋钮调节功率（KnobController）
<<reset_knob>>	重置旋钮（保留尝试次数，用于重试）
<<lock_knob>>	锁定旋钮（第二次失败后由 Yarn 调用）

事件回调：$salesTurnIndex 每轮转动完成后更新；$knobFailCount 旋钮失败次数（双次尝试）。EventNode 中 销售模块转动完成 按 $salesTurnIndex 分支（1=语义合成、2=语言审查、3=语气调整+enter_processor_mode）。旋钮第一次失败跳 处理器单次调节失败（reset_knob 重试），第二次失败跳 处理器功率调节失败。

---

波形系统（Waveform）

概述：波形检测器、扫描锁定、时间戳、波形显示与效果。Stage2/Stage3 已改用 EmotionWave 替代；Waveform 仍可用于 Stage7 等场景。

核心组件：WaveformDetector

Yarn 命令

命令	说明
<<show_waveform_detector>>	显示检测器
<<hide_waveform_detector 0.3>>	隐藏检测器
<<connect_waveform_detector "模块ID">>	连接到模块（如 滤波器）
<<disconnect_waveform_detector>>	断开连接
<<enable_scan_logic "标签">>	启用逻辑扫描（可锁定）
<<enable_scan_emotion "标签">>	启用情绪扫描（找不到）
<<stop_scan_mode>>	停止扫描
<<wait_scan_locked>>	等待扫描锁定
<<wait_scan_not_found>>	等待扫描未找到
<<show_timestamp_waveform>>	显示锁定时间戳的波形
<<show_waveform "emotion" 1.5>>	显示波形类型（emotion/logic/joke/filter_output）
<<hide_waveform 0.3>>	隐藏波形
<<transform_waveform "from" "to" 1>>	波形类型变换
<<modify_waveform "emotion" "joke" 2.5>>	波形被篡改变换
<<show_waveform_result "msg" true>>	显示检测结果
<<hide_waveform_result>>	隐藏结果
<<check_waveform 3>>	波形检测效果（闪烁）
<<check_waveform_sweep 2 0.25>>	横扫效果
<<check_waveform_range 2 0.12>>	限幅检测效果
<<check_waveform_pass>>	通过效果（绿）
<<check_waveform_fail>>	失败效果（红）
<<show_error_flood 5 0.3>>	报错 flooding（Stage4 用）
<<clear_errors>>	清除报错

Yarn 函数

函数	说明
is_scan_locked()	是否已锁定
is_scan_not_found()	是否扫描未找到
is_fully_covered()	是否全覆盖
get_locked_timestamp()	获取锁定时间戳

---

表达系统（Language/Expression）

概述：表达模块的「焦虑短句→目标句子」粒子小游戏，用于 log 梳理（Stage6）。

核心组件：ExpressionManager

Yarn 命令

命令	说明
<<open_expression>>	打开表达视图（背景+粒子容器）
<<start_expression "短句1|短句2" "目标句" "完成节点">>	启动粒子系统，完成时跳节点
<<close_expression>>	关闭表达系统
<<reset_expression>>	重置（可选不播放入场动画 false）

---

情绪波形系统（EmotionWave）

概述：后脑检查与销售模块深入时显示的情绪波形条，支持预设切换；可与滑片同步。已替代 Stage2/Stage3 中的 Waveform。

核心组件：EmotionWaveManager、EmotionWaveConfig

Yarn 命令

命令	说明
<<show_emotion_wave 0.8>>	显示情绪波形
<<hide_emotion_wave 0.5>>	隐藏情绪波形
<<emotion_wave_to 0.5 2>>	动画到进度 0.5，2 秒
<<set_emotion_wave 0.5>>	立即设置进度
<<switch_emotion_wave_config "preset">>	切换波形预设：normal（正常情绪）/ predicted（红色毛刺预测）/ modified_joke（被篡改笑话）
<<enable_emotion_wave_slider_sync>>	启用滑片同步
<<disable_emotion_wave_slider_sync>>	禁用滑片同步

Yarn 函数

函数	说明
is_emotion_wave_shown()	是否已显示
get_emotion_wave_progress()	当前进度
get_emotion_wave_target()	目标进度

---

其他 Yarn 命令（全局/UI）

命令	说明
<<open_warning_window "消息">>	打开报错/警告窗口（BaseYarnCommand）
<<fade_in 1>> / <<fade_out 1>>	屏幕淡入/淡出
<<hide_dialog>>	隐藏对话

美术资源

维修专用

角色与立绘

资源	路径
火山主资源	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

本地化

工程	路径
Test_Huoshan	Assets/Language/Dialog/Test_Huoshan/

其他

类型	说明
角色配置	Assets/StreamingAssets/Config/character.csv 中 hs,火山,Huoshan
Tag	HuoshanScreen（波形/粒子渲染层）

---