# 《茧中黎明》— 第二章《黄昏之城》完整开发脚本
# 版本: v1.0 | 用途: 直接交给 Codex 实现
# 玩法类型: 2D 横版动作探索(类银河恶魔城) | 本章为虚拟世界第一区

================================================================
【0. 章节概述】
================================================================

## 0.1 本章在整部游戏的位置
- 第一章(现实世界)结束后，Yan 坠入 Qin 创造的虚拟世界
- 本章功能:
  1) 玩法转型教学(RPG -> 横版动作)         2) 确立核心机制: 真实伤害 + DY备份复活
  3) Yan 的第一次战斗、第一次死亡、第一次主动选择变强
  4) Qin 以"神"的身份首次正面登场

## 0.2 核心设计原则
- 死亡不是惩罚，是叙事: 每次死亡推进 DY 与 Yan 的关系
- 能力即性格: Yan 获得的每个能力都对应她"从柔弱到坚毅"的一步
- 本章预计时长: 60~90 分钟 | 预计死亡次数(正常玩家): 5~12 次

## 0.3 技术参数
- 基准分辨率: 480x270，整数倍放大
- 画风: 扁平矢量+霓虹色，剪影感构图
- 虚拟世界主色板: 黄昏橙紫渐变天空 #E88A5D / #6B4E8E，建筑剪影 #2A2340，
  数据高光 #63F2E2(青)，危险红 #FF4D5E，DY 光 #8EF29B
- 物理: 60fps 固定步长，重力 1400 px/s^2

================================================================
【1. 系统与数值(本章新增)】
================================================================

## 1.1 玩家属性
HP_MAX        = 5        # 心之容器形式，本章内可扩充至 6
攻击力        = 1        # 基础攻击，能力"锚点回响"后 = 2
移动速度      = 90 px/s
跳跃初速度    = -420 px/s  # 可变跳(按住更高)
冲刺(获得后)   = 200 px/s，持续0.15s，无敌帧8帧，冷却0.8s

## 1.2 核心机制: DY 备份点(存档点)
- 场景中的"记忆锚点"(发光的水晶柱)即存档点
- 交互后: 存档 + 恢复满HP + DY 播放一句台词(随剧情进度变化，见 3.6)
- 死亡后: 从最近锚点重生，已击败的杂兵重置，BOSS 战进度重置
- 演出: 死亡画面 -> 全屏噪点/glitch -> 画面从噪点中"重绘"出 Yan -> 锚点苏醒
- 死亡计数永久记录(death_count)，后期剧情回收("你死了 47 次，但第 48 次你站着")

## 1.3 攻击方式
- 基础攻击: 近战光刃，攻击距离 26px，前后皆可，攻击帧 6f，无连击(后期解锁)
- 锚点回响(本章获得): 消耗 1 格"记忆能量"，释放 360 度冲击波，伤害 2，
  可破坏"数据屏障"(青色裂纹墙)，同时是剧情关键能力

## 1.4 记忆能量(蓝条)
- 上限 3 格，攻击命中敌人 +0.5 格，受击 -1 格
- 锚点休息回满

================================================================
【2. 角色与敌人数据】
================================================================

## 2.1 Yan(虚拟世界形态)
- 形象: 数据化服装(第一章针织衫的数据重构版)，发卡是唯一"真实质感"的物品
  (美术重点: 发卡不发光、不像素化，与虚拟世界所有东西形成质感对比)

## 2.2 DY(跟随精灵)
- 跟随 Yan 身后 24px，惯性漂浮，不可被选中和攻击
- 功能: 存档点台词 / 复活安慰 / 场景提示(卡关 90 秒后给提示)
- 探索时随机闲聊(台词池见 3.7，每区域限每 3 分钟触发一次)

## 2.3 敌人图鉴(本章)

[敌人 E01] 空壳行者 HollowWalker
  外观: 无脸人形剪影，腹部有裂纹发光
  行为: 沿平台往返巡逻，发现玩家后加速追逐
  HP: 2 | 接触伤害: 1 | 无远程
  AI: 悬崖边会停下(教学友好型)
  首次出现: 1-2 区
  设计注: 它们是虚拟世界的"NPC残骸"，击败时播放 0.5 秒"人脸闪回"——
          暗示它们曾经也是被困的人(后期剧情回收)

[敌人 E02] 浮游哨兵 Watcher
  外观: 独眼悬浮机械体，眼为红色
  行为: 悬停于固定点位，玩家进入射程后发射 1 发数据弹(速度 120px/s)
  HP: 1 | 弹幕伤害: 1
  弱点: 只能朝面向方向射击，背后接近安全
  首次出现: 1-3 区

[敌人 E03] 守门重像 Gatekeeper(迷你BOSS)
  外观: 3 米高的重型骑士剪影，手持巨盾，盾面映出 Yan 的脸
  战斗分两个阶段:
  P1: 盾挡正面(正面攻击无效)，周期性冲锋; 玩家须跳跃越过背刺
  P2(HP<=50%): 盾碎裂，攻击欲望增强，新增震地波(需跳跃躲避)
  HP: 12 | 接触伤害: 1 | 冲锋伤害: 1 | 震地波: 1
  首次出现: 1-5 区(关底)
  设计注: 盾面映出 Yan 的脸 = "你最大的敌人是自己"的暗示；
          碎盾演出里盾面映出的脸变成 Qin

================================================================
【3. 关卡脚本】
================================================================
# 地图代号: DUSK_01 ~ DUSK_05，互相连通，整体呈"环形+支线"结构
# 每个区末尾给坐标图(ASCII)，可直接给关卡编辑器用

---------------------------------------------------------------
区域 DUSK_01: 坠落之地(开场，无战斗)
---------------------------------------------------------------
[入场演出]
[画面: 白屏 -> 噪点 -> 从噪点中"重绘"出画面]
[场景: 永远黄昏的天空，橙紫渐变。一座空城的屋顶天台，
       远处城市剪影无限延伸，所有 NPC 人影静止不动，像背景板]
[BGM: 《Static Lullaby》——走调的八音盒+电流底噪，循环]

DY: 姐姐！姐姐能听到吗？！
Yan: (撑着起身) ……这里是……？
DY: 我不知道……我的传感器全是乱码。但是姐姐，
    我记得你，我记得 Don 哥哥，我记得全部——所以别怕，好吗？
Yan: Don 呢？Don 在哪里？
DY: (沉默 1 秒) ……我感受不到他。这里有什么东西……把他的信号隔断了。
[演出: Yan 走向天台边缘，眺望城市。所有"人影"NPC 齐刷刷静止]
Yan: 这些"人"……
DY: 没有信号。他们只是……摆在这里的东西。
Yan: (攥紧发卡) 我要去找他。Don 在等我。
[玩家获得移动控制权。教学: 移动/跳跃，全部融进"走下天台"的路，
 不做任何文字弹窗，用关卡引导(见 3.8 引导原则)]

[剧情点 1-1] 天台边缘强制触发
  Yan: 这个高度……(往下看) 跳下去会死吧。
  DY: 理论上——啊等等姐姐你要干嘛——
  [演出: Yan 深吸一口气，直接跃下。屏幕转黑 0.3 秒]
  [画面恢复: Yan 落在垃圾堆上，HP -0(剧情保护)]
  DY: 你跳下来了?! 你居然真的跳下来了?!
  Yan: (拍拍身上的灰) 怕，但是更怕他一个人在下面。
  [本段确立基调: Yan 不是天生的勇者，她是"害怕但仍选择行动"的人]

---------------------------------------------------------------
区域 DUSK_02: 寂静街道(首次战斗教学)
---------------------------------------------------------------
[场景: 街道两侧是静止人影，红绿灯永远黄灯闪烁]
[BGM: 《Yellow Light》——加入低频鼓点，紧张感+1]

[教学点 2-1] 首个空壳行者登场
  [演出: 一只 HollowWalker 从静止人影中"剥离"出来，扑向 Yan]
  DY: 小心!! 那个东西有攻击信号——用攻击键!
  [强制战斗: 锁定出口，击败后才可前进(教学保护: 该敌人 HP 降至1时
   强制锁血，再受击即死，防止新手卡关)]
  战斗后:
  DY: 姐姐……你受伤了?! 痛觉是……是真的?!
  Yan: (捂着手臂) ……嗯。和真实世界一模一样。
  DY: 对不起、对不起……都怪我把你带来——
  Yan: 不怪你。是我自己跳下来的，记得吗？
  [重要: DY 的自责 -> Yan 的安慰，每次死亡/受伤后对话都沿此模式递进]

[调查点 2-1] 静止人影(街道中段)
  [演出: Yan 触碰人影，人影表面泛起涟漪]
  文字浮现: 「第 0341 号观测样本 · 情绪采集: 完成」
  Yan: 观测样本……他把人当成了什么……
  DY: 姐姐，这里所有的东西都是那个坏人的"收藏品"。
  [伏笔: 编号系统后期揭露这些人影来自真实世界的受试者数据]

[锚点 2-A] 本章第一个记忆锚点(存档点)
  [演出: 水晶柱升起，DY 环绕一圈]
  DY: 找到锚点了！我在这里备份了你的数据——
     就算……就算出事了，我也能把你"画"回来。我保证。

---------------------------------------------------------------
区域 DUSK_03: 断裂高架(平台跳跃+浮游哨兵)
---------------------------------------------------------------
[场景: 高架桥断裂成数段，下方是数据虚空(坠落即死，HP 扣 1 并回检查点)]
[BGM: 《Overpass》——鼓点加密，加入合成器琶音]

[教学点 3-1] 浮游哨兵登场
  [第一只 Watcher 悬停在必经之路上，玩家必经其射程]
  DY: 那个独眼的家伙会射数据弹……趁它转身的间隙冲过去，
     或者……从它背后摸上去!
  [设计: 此处强制让玩家理解"观察->找弱点->行动"的循环，
         莽冲必死一次——这是计划内的"设计死亡"，见 3.8]

[死亡事件脚本](任意原因首次死亡时触发，仅触发一次)
  [演出: 全屏血红 -> 心跳声 -> 黑屏]
  [黑暗中文字:]
  Yan: (声音颤抖) ……好痛……这就是……死掉的感觉……
  [3 秒寂静后，噪点声起，画面从噪点中重绘]
  DY: (带着哭腔的电子音) 姐姐! 姐姐! 我在! 我把你画回来了!
  Yan: (喘息) ……我又……活过来了？
  DY: 我说过我记得你。只要你还被记得，你就不算消失。
     ……再试一次，好不好？我陪你。
  Yan: (擦掉眼泪，站起) ……好。再试一次。
  [death_count +1，此后死亡复用简化版演出(2秒)]
  [该段是全章情感核心之一，文案/配音优先级最高]

[调查点 3-1] 断裂桥面上的涂鸦
  文字: 「这是第几天了 我不知道」
      「他看着我们 他一直在看着」
  Yan: 有人……曾经在这里……
  DY: 姐姐……(罕见地没有接话)

---------------------------------------------------------------
区域 DUSK_04: 中央广场(剧情高潮区)
---------------------------------------------------------------
[场景: 巨型广场，中央一座雕像——Qin 的自雕像，面部是完美的、没有黑斑的 Qin]
[BGM: 无。只有风声。雕像附近时混入不和谐的教堂唱诗采样]

[剧情点 4-1] 雕像前强制触发
  Yan: (走近雕像，愣住) 这是……Qin？
  DY: 数据和那个坏人一致……但脸不一样。他把自己的"黑斑"删掉了。
  [演出: Yan 伸手触碰雕像底座]
  [屏幕浮现文字(雕像铭文):]
      「神曾许诺: 此城无悲无苦，此城永驻黄昏。」
  [演出: 天空突然变暗三秒，一个巨大的、扭曲的声音从四面八方响起——]
  QIN(神之声): 哦呀。醒着的小虫子，爬到这里来了。
  Yan: Qin! 放我们出去! Don 在哪里?!
  QIN: Don？呵……(轻笑) 他在这里很安全。
       安全到……再也说不出话。
  Yan: 你——!
  QIN: 想要他？那就爬吧。爬到这座城的王座来。
       让我看看——(声音压低，带恶意) 你所谓"爱"，能撑到第几次死亡。
  [演出: 天空恢复黄昏。远处传来钟声，DUSK_05 方向升起红色光柱]
  DY: 姐姐……怕的话，我们可以先躲起来——
  Yan: (打断，语气平静但坚定) 不怕。他在等我。
      DY，把路记下来。我们一路打过去。
  [本章玩家动机正式确立。此后 DY 不再提"躲"，改为全力支持]

[锚点 4-A] 广场锚点 + 能力获取
  [演出: 锚点水晶柱与以往不同——柱体内悬浮着星形发卡的光影]
  DY: 等等……这个锚点里有你的发卡数据!
     发卡是"真实"的东西……它撬动了这个世界的规则!
  [获得能力: 锚点回响]
  DY: 我把它编译成技能了——按下技能键，释放回忆的冲击波!
     能打碎那些青色裂纹的墙……也能伤敌。 energy 消耗 1 格哦!
  [教学: 广场一侧立即可见一堵数据屏障(青色裂纹墙)，强制练习]

---------------------------------------------------------------
区域 DUSK_05: 王座前庭(迷你BOSS战)
---------------------------------------------------------------
[场景: 通往高处王座的长阶梯前，巨大的门]
[BGM: 战斗曲《Gate of Dusk》，鼓点+失真吉他]

[BOSS战] 守门重像 Gatekeeper(数据见 2.3)
战前演出:
  [演出: 巨像从门中走出，盾面映出 Yan 的脸]
  Yan: 这张脸……是我。连敌人都长着我的脸。
  DY: 那个坏人知道怎么伤你……姐姐，盾面是硬的，背后才是弱点!
P2 转阶段演出:
  [演出: 盾碎裂，碎片中是 Qin 的脸一闪而过]
  QIN(神之声): 哼。有点意思。继续爬吧，小虫子。
击败后:
  [演出: 巨像跪倒，化作数据流消散，门开启]
  Yan: (喘着气，看着自己发抖的手) ……我赢了吗？我真的……赢了？
  DY: 你赢了! 你赢了!! (绕着她飞了三圈)
     ……姐姐，你刚才战斗的样子，和第一次见面时不一样了。
  Yan: (握紧光刃) 那就对了。下一次，我会更强。

[章节结尾演出]
  [演出: Yan 走上阶梯，推开巨门——门后是一道刺眼的白光，
         隐约可见更高的塔楼轮廓(第三章场景)]
  [黑屏，字幕:]
      第二章 · 黄昏之城 —— 完
      第三章 · 白塔
  [DY 画外音，轻声:]
  DY: 姐姐。刚才在广场上，你在发抖。
      但是你的脚，一步都没有往后退。
  [存档: plot_chapter = 3，继承全部旗标与死亡计数]

================================================================
【4. 对话内容补充库】
================================================================

## 4.1 DY 存档点台词池(按进度递进)
第 1 次存档: "数据备份完成！……虽然其实我也不知道备到哪里去啦。"
第 2-3 次:   "备份完成。姐姐，你的手还在抖。休息 3 秒再走吧？"
第 4-6 次:   "备份完成。你比上次多坚持了 41 秒。我数着呢。"
死亡 3 次后新增: "备份完成。……死了也没关系。我把每一次的你都记得很清楚。"
BOSS 战后:     "备份完成。姐姐，刚才那一战，我要单独建一个文件夹存起来。"

## 4.2 DY 复活安慰台词池(死亡后随机，递进)
早期: "画回来了画回来了! 没事的，这次只是数据疼，不是你疼……骗你的，我陪着你疼。"
中期: "第 N 次了。姐姐，你每次回来第一句话都是问 Don 哥哥的信号……我也想帮你找到他。"
后期: "欢迎回来。这一次，我们换条路试试。"

## 4.3 DY 探索闲聊池(每区域 3 分钟冷却)
- "这个天空的黄昏是循环的 7 分 12 秒。我数过了。……很无聊吧，对不起。"
- "姐姐，等出去了，我想看看真正的天空。Don 哥哥说真正的天空不会循环。"
- "我的内存里还存着 Don 哥哥最后一条语音。……现在不是放的时候。等找到他，我们一起听。"
- "如果我也被困在这里了，你会来救我吗？……开玩笑的! 我就是来救你的!"

================================================================
【5. 音频需求清单】
================================================================
BGM(本章 6 首):
1. Static Lullaby  — DUSK_01，走调八音盒+电流，循环
2. Yellow Light    — DUSK_02，低频鼓点，循环
3. Overpass        — DUSK_03，鼓点+琶音，循环
4. 风声+唱诗采样   — DUSK_04，几乎无旋律(动态混音: 接近雕像时唱诗增强)
5. Gate of Dusk    — DUSK_05 BOSS 战，鼓点+失真吉他
6. DY's Theme(动机) — DY 重要对话时淡入的单音乐句(与第一章 Don 主题同旋律变奏)

音效:
- 光刃挥砍(3 种随机)、命中、受击(真实痛哼由 Yan 配音)、敌人消散
- 数据弹发射/命中、跳跃/落地(两种材质)、冲刺(电子呼啸)
- 锚点交互(温暖上升音)、存档(确认音+DY 语音)、复活重绘(glitch 重组音)
- 数据屏障碎裂、雕像低语、Qin 神之声(处理: 多人声叠加+混响 70%)
- 死亡音(心跳骤停)、虚空坠落(下坠呼啸)

================================================================
【6. 关卡布局参考图(ASCII，1格=1tile)】
================================================================

DUSK_02 寂静街道(教学区，线性):
```
[天台落点]====街道====[E01出现]====[调查:人影]
    |                                    |
  锚点2-A                            [出口↑DUSK_03]
```

DUSK_03 断裂高架(平台区):
```
[入口]--段1--(跳跃)--段2--[Watcher]--段3--[涂鸦]
                                            |
                                    锚点3-A--[出口↑DUSK_04]
(下方全程为数据虚空，坠落=扣1HP回最近落点)
```

DUSK_04 中央广场(枢纽):
```
        [Qin雕像(剧情点4-1)]
              |
  [数据屏障]--锚点4-A--[出口↑DUSK_05]
       (用锚点回响打破)
```

DUSK_05 王座前庭(BOSS):
```
[大门]=======[BOSS场地 30x12 tiles]=======[阶梯→巨门(章末)]
```

================================================================
【7. 实现提示(Codex 必读)】
================================================================
1. 手感优先: 跳跃/冲刺/攻击的 coyote time 8f、跳跃缓冲 6f、受击无敌 1s，
   这些是类银河恶魔城手感底线，不可省略。
2. 死亡演出必须可跳过(长按确认键 0.5s)，但首次死亡的全演出不可跳过。
3. 复活后 2 秒无敌，防止锚点旁刷怪连杀。
4. 卡关检测: 同一区域停留超过 90 秒无进展 -> DY 触发场景提示(只指路，不给答案)。
5. BOSS 战入场即锁门+存档点自动备份，防止跑图挫败感。
6. death_count / death_dialogue_stage 等全部入存档；DY 台词池按阶段过滤。
7. 受击时手柄震动(支持的话) + 画面红闪 3f，但不过度频闪(光敏保护，闪烁 < 4Hz)。
8. 所有敌人图鉴信息可存入"数据日志"界面，用敌人掉落物"数据残片"解锁条目。
9. 文本全部外置 CSV/JSON。
10. 本章 boss 战无 QTE，无阶段秒杀机制，难度参考空洞骑士第一关 boss。

================================================================
【附录: 本章伏笔对照表(不显示给玩家)】
================================================================
发卡真实质感        Yan形象 -> 终局关键道具的视觉锚
人影=观测样本       DUSK_02 -> 后期揭露受试者真相支线
桥面上的涂鸦        DUSK_03 -> 来自第一章之前被困者(第三章NPC)
Qin雕像无黑斑       DUSK_04 -> boss Qin 形象反转: 他给自己的"完美脸"才是伪装
守门重像盾面        DUSK_05 -> "最大的敌人是自己"主题回收
死亡计数            全局    -> 终章 Yan 对 Qin 的台词素材
"第七分十二秒的天空" DY闲聊  -> 揭示虚拟世界时间循环，后期 Yan 利用循环破局
================================================================
# 文档结束
