# 《茧中黎明》(暂定名) — 第一章《茧房》完整开发脚本
# 版本: v1.0 | 用途: 直接交给 Codex 实现序章 Demo
# 游戏类型: 现实部分 = 2D 叙事RPG序章 / 虚拟世界部分 = 类银河恶魔城(本章不涉及)

================================================================
【0. 项目概述】
================================================================

## 0.1 游戏简介
女主角 Yan(美丽温柔、AI智能体方向研究员) 与男友 Don(天才少年、Complacent公司
DY智能体开发者) 相恋于名校。同事 Qin(脑机接口项目负责人) 因幼时脸上大片黑斑
遭歧视，性格阴暗要强。在一次脑机接口实验中，Qin 篡改数据，将三人困入虚拟世界。
第一章为全部的现实世界剧情：从甜蜜日常到坠入陷阱。

## 0.2 第一章核心目标(玩家视角)
- 建立对 Yan & Don 的情感投入(全章重点)
- 拼凑出 Qin 的危险性(信息收集，不直接告诉玩家)
- 在不知情的情况下亲手走进陷阱(悲剧反讽)

## 0.3 本章技术参数
- 视角: 俯视角 2D RPG
- 基准分辨率: 480x270，整数倍放大渲染
- 色板(现实世界): 暖黄 #F5C56B / 米白 #F2E9DC / 灰蓝 #7A93AC / 阴影 #3B3B4D
- 预计时长: 30~45 分钟
- 引擎: Unity 或 Godot(由 Codex 根据现有工程决定)

================================================================
【1. 角色卡】
================================================================

## Yan(玩家操控)
- 身份: AI 智能体方向研究员，Don 的女友
- 外观: 长发，米色针织衫，别着星形发卡(关键道具)
- 性格弧线(本章内): 温柔从容 -> 隐隐不安 -> 被迫坚强(章末)
- 行走图: 4方向 x 3帧; 立绘表情差分: 微笑 / 严肃 / 痛苦 / 流泪

## Don
- 身份: Complacent 公司 DY 智能体项目负责人，天才少年
- 外观: 白衬衫挽袖，戴细框眼镜，胸前工牌
- 立绘表情差分: 阳光笑 / 专注 / 温柔 / 口型"一会儿见"(章末特写)

## Qin
- 身份: 脑机接口项目博士，本章主要 NPC
- 外观: 深色高领实验服，右脸有大片黑斑(剧情核心，美术需表现但避免猎奇)
- 立绘表情差分: 面无表情 / 阴沉 / 一闪而过的动摇
- 台词风格: 短句、礼貌、暗藏锋利

## DY(仅本章末出声)
- 形态: 屏幕中的发光小精灵，话痨、忠诚
- 功能: 本章末首次发声，虚拟世界篇全程陪伴角色

## NPC(4名，均为线索载体)
- receptionist  前台小姐
- senior        老员工(休息区)
- junior        年轻员工(休息区)
- cleaner       清洁工(走廊)

================================================================
【2. 全局变量 / 旗标(Flag)定义】
================================================================
# Codex 请在存档系统中实现以下变量，本章内生效，部分继承到后续章节

FLAG 变量名                类型    初值   说明
---------------------------------------------------------------
plot_chapter               int     1      当前章节(本章恒为1，结束时置2)
item_hairpin               bool    false  星形发卡(场景1必得，但用变量显式记录)
item_photo_home            bool    false  冰箱合照(已调查)
item_paper_thesis          bool    false  电脑论文(已调查)
item_msg_phone             bool    false  Don的留言(已调查)
item_mirror_looked         bool    false  照过镜子(可选)
rel_don                    int     0      与Don关系值(场景3选择+1)
yan_rational               int     0      理性路线值(场景3选择+1)
frag_application           int     0      阴谋碎片收集数(本章最多1，全游戏3)
qin_hospitable             int     0      Qin好感/敌意(场景4选择: 友好-1 戒备+1)
final_difficulty_modifier  int     0      继承到后续章节: qin_hospitable 映射
scene1_done                bool    false  场景1完成
scene2_done                bool    false  场景2完成
scene3_done                bool    false  场景3完成
scene4_done                bool    false  场景4完成
scene5_done                bool    false  场景5完成(本章结束)
---------------------------------------------------------------
# 存档要求: 对话树节点状态、已触发的调查点、变量值均需序列化。

================================================================
【3. 场景脚本】
================================================================

---------------------------------------------------------------
场景1: Yan的公寓 · 早晨
地图: APT_HOME (室内 20x15 格)
初始玩家位置: (10, 12) 卧室床边
---------------------------------------------------------------

### 开场演出(自动播放，不可跳过但可快进文本)
[画面: 黑屏 -> 淡入，晨光从窗帘缝照进来，像素粒子光效]
[音效: 鸟鸣、远处车流、轻钢琴BGM《Morning of Us》渐入]

YAN(独白/内心, 无立绘, 屏幕底部斜体字):
    今天是我和 Don 认识的第 1473 天。
    他说，要给我看一个"会做梦的孩子"。

[演出: Yan 从床上起身，玩家获得控制权]

### 可调查点(交互教学)

[调查点 1-1] 床头柜 · 星形发卡
  位置: (8, 10)
  交互结果:
    [音效: 清脆的"叮"]
    获得物品: 星形发卡 (item_hairpin = true)
    Yan(独白): Don 送的第一份礼物。他说，这是"找到我的坐标"。
    [发卡图标出现在 HUD 左上角，此后永久显示]

[调查点 1-2] 冰箱 · 合照
  位置: (4, 4)
  条件: 无 | 效果: item_photo_home = true
  Yan(独白): 毕业典礼那天，他把学士帽扣在我头上，说——
  Don(回忆气泡, 无立绘): 等我造出一个会保护人的 AI，就换它保护你。
  Yan(独白): ……傻瓜，AI 怎么会做梦呢。
  [伏笔注: 此句后期由 DY 亲口回答]

[调查点 1-3] 电脑 · 论文
  位置: (16, 4)
  条件: 无 | 效果: item_paper_thesis = true
  [画面: 屏幕亮起，显示论文标题]
  屏幕文字: 《论智能体的记忆连续性 —— 以情感锚点为核心的数据存续方案》
  Yan(独白): 锚点越牢固，记忆越不会丢失。
    如果人也一样……就好了。
  [伏笔注: 复活机制的理论依据]

[调查点 1-4] 手机 · Don的留言
  位置: (12, 6)
  条件: 无 | 效果: item_msg_phone = true
  [画面: 手机屏幕亮起]
  Don(短信): 「醒了没？今天要给你看个好东西。下午来公司找我。
              ——PS 顺便带杯咖啡，我们部门那台又坏了 :)」
  Yan(独白): 他又把咖啡机弄坏了……算了，正好去看看他。

[调查点 1-5] 镜子(可选)
  位置: (14, 10)
  条件: 无 | 效果: item_mirror_looked = true
  [演出: Yan 对镜微笑，发卡反光一闪]
  Yan(独白): 嗯，状态不错。
  [伏笔注: 虚拟世界篇该镜子会碎裂]

### 场景出口与条件
[出口] 公寓门 (10, 0)
  条件: item_msg_phone == true
  不满足时交互: Yan(独白): 先看一下手机吧，他肯定又发消息了。
  满足时: [BGM 渐弱] 切场景 -> APT_HOME_EXIT 过场

### 过场 APT_HOME_EXIT(自动)
[画面: Yan 出门，门在身后关上，画面转黑，字幕浮现]
字幕: Complacent 科技 · 下午 2:17
[切场景 -> 场景2]

---------------------------------------------------------------
场景2: Complacent公司大厅
地图: LOBBY (大厅 30x20 格，含前台、休息区、荣誉墙走廊)
初始玩家位置: (15, 18) 大门入口处
---------------------------------------------------------------

[入场演出]
[画面: 大门滑开，明亮大厅，BGM《Glass Atrium》(明亮轻快)]
YAN(独白): 不管来多少次，还是觉得这里大得像另一个世界。

### NPC对话

[NPC 2-1] 前台小姐 receptionist — 位置 (15, 8)，可重复对话
第一次对话:
  RECEPTIONIST: 你好，有预约吗？
  Yan: 我来找 Don，AI 应用部的。
  RECEPTIONIST: 哦——找 Don 呀！他可是我们部门的宝贝，
                连 Qin 博士都常常跑去看他的代码呢。
  Yan(独白): Qin 博士……脑机接口那个项目组的？
  [对话后解锁 NPC 2-2 的主动搭话]
重复对话:
  RECEPTIONIST: Don 的工位往左走，电梯旁第二间就是。

[NPC 2-2] 老员工 senior — 休息区 (6, 14)，可重复对话
第一次对话(需先与 2-1 对话后激活):
  SENIOR: (压低声音) 小姑娘，你男朋友是那个做智能体的 Don？
  Yan: 是的，请问您是？
  SENIOR: 我在公司二十年了。听我一句劝，
          别让他们俩走太近——我是说，Don 和 Qin 博士。
  Yan: 为什么？
  SENIOR: Qin 博士那个脑机接口项目……三年前出过事故。
          一只实验猴，脑死亡。公司花钱压下来了。
  Yan(独白): (……三年前的脑死亡事故？)
  SENIOR: 行了行了，就当我老头子在嚼舌根。别说是我说的。
重复对话:
  SENIOR: (假装看报纸) ……我不知道你在说什么。

[NPC 2-3] 年轻员工 junior — 休息区 (8, 16)
第一次对话:
  JUNIOR: 你也是等男朋友下班的？这边坐。
  Yan: 谢谢。诶，那边荣誉墙上……
  JUNIOR: 哦你说那张合照？Don 博士和 Qin 博士的，去年年度项目奖。
          两人差一票平票，最后给了 Don。
  Yan: 平票……？
  JUNIOR: 对啊，Qin 博士那张脸嘛……(突然意识到什么)啊，抱歉，
          我不是那个意思。就是、就是公司里风言风语的，
          说他小时候被人叫"墨鬼"，性格才变得那么……怪。
  Yan(独白): (墨鬼……这些人嘴上没把门的。)
  [注: 此处不评判任何人，让玩家自己不适，是设计意图]
重复对话:
  JUNIOR: 反正啊，B3 那个实验室，没事别靠近。

[NPC 2-4] 清洁工 cleaner — 荣誉墙走廊 (26, 10)
第一次对话:
  CLEANER: (自言自语) 奇怪，昨晚灯又没关……
  Yan: 您好，昨晚发生什么事了吗？
  CLEANER: 哦，小姑娘。也没什么——就是昨晚加班，
           看到 Qin 博士一个人在 B3，对着那几个大罐子说话。
  Yan: 大罐子？
  CLEANER: 营养缸嘛。他还对着缸笑了一下。
           我干这行十年，没见过谁对着缸笑的。怪吓人的。
  Yan(独白): (……对着营养缸说话？)
重复对话:
  CLEANER: 小姑娘，B3 在地下，没事别下去啊。

### 可调查点

[调查点 2-1] 荣誉墙合照
  位置: (24, 8)
  [演出: 画面缓慢推近照片，Don 笑得灿烂，Qin 站在他旁边，
         面无表情。镜头在 Qin 脸上停留 1.5 秒，配一个不和谐的低音]
  Yan(独白): 这张合照……Don 提过，是平票的那次。
  [伏笔注: 章末场景5前，此照片可再次调查，台词变化]

[调查点 2-2] 揉皱的实验申请单(隐藏)
  位置: (28, 4) 走廊尽头绿植后，需绕到绿植背面才可见
  [演出: 纸团在发光提示，捡起后展开]
  纸张文字: 「脑机接口-人类受试者实验申请(第4次提交)
             申请人: Q----(签名被狠狠划烂)
             审批状态: 驳回(附注: 伦理风险过高)」
  获得: 阴谋碎片 (frag_application = 1)
  Yan(独白): 被驳回过四次……他到底想做什么？
  [注: 全游戏共3张，集齐解锁后期揭露公司黑幕的支线]

### 场景推进条件
- 与 receptionist 对话后，场景3(电梯)解锁
- 场景2无强制完成项，场景3随时可进入，但玩家大概率会逛完(信息钩设计)

[出口] 电梯 (2, 8)
  交互: [电梯门开音效] 切场景 -> 场景3

---------------------------------------------------------------
场景3: Don的实验室
地图: LAB_DON (室内 24x16 格)
初始玩家位置: (4, 8) 门口
---------------------------------------------------------------

[入场演出]
[BGM 切换: 《His Workshop》(温暖钢琴+轻电子)]
[演出: Don 背对门口在调试屏幕，屏幕上 DY 在转圈]
Don: 心率数据正常……唔，情感模块这里再改改——
Yan: 在改什么呢，Don 博士？
[Don 猛地回头，眼镜都滑下来了]
Don: Yan?! 你怎么这么早就——(看表)……好吧也没多早。
     等等，你带咖啡了吗？
  -> 若玩家此前在场景1调查过手机(item_msg_phone): 
     Yan: 带了。某人短信里"顺便"两个字写得可真大。
     Don: 嘿嘿。
  -> 若未调查手机(理论上不可能，容错处理):
     Don: 唉，就知道你没看短信。

### 事件 3-A: 毕业回忆(自动演出，重要)
[演出: 屏幕白光一闪，画面转为 sepia 色调的像素小动画，
       二人大学毕业那天的剪影]
Don(年轻): 我以后要造一个 AI，会保护人的那种。
Yan(年轻): AI 怎么会保护人呀，它又没有心。
Don(年轻): 那就从"记住你们"开始学起。
     记住一个人，保护一个人——一步一步来。
[演出结束，画面回到实验室]
Yan(独白): 那天阳光很好。我以为来日方长。

### 事件 3-B: DY 首次登场
[演出: 屏幕里的小精灵飘到屏幕最上方，凑近"看"Yan]
DY: (电子音，活泼) 检测到陌生人类！姐姐你好呀姐姐！
Don: 它管所有女性都叫姐姐，我改不过来。
DY: 才不是"所有女性"！是 Yan 姐姐的话，
    我查了 0.03 秒就决定用"姐姐"这个词了！
Don: ……你看，它会做梦的证据之一，它会拍马屁。

  -> 对话选择点(本章唯一重要分支)
  [选项1] 「它真可爱，像你的孩子。」
      Don: (挠头) 是我们的孩子。
      [rel_don +1]
      DY: "我们的孩子"！存档成功！永久保存！
  [选项2] 「它能记住多少东西？」
      Yan: 我是说……如果数据被清空，它会怎么样？
      Don: (认真起来) 这正是我最近在攻克的。
           给它造了"情感锚点"备份机制——只要锚点还在，
           哪怕记忆被清空，也能一点点找回来。
      [yan_rational +1]
      DY: 听不懂但是感觉自己很厉害！
  [两选项后续剧情一致，仅影响后续章节细节呈现]

### 事件 3-C: 咖啡机小游戏
[演出: 咖啡机冒烟]
Don: 对了！就是这台叛徒——帮帮我嘛 Yan 老师，你电路比我好。
[小游戏: 线路连接。3x3 节点，拖动导线使电流从电池连通到加热管，
       限时无要求，接错只会冒烟重来，无惩罚]
完成后:
Don: 太好了！Yan 老师万岁！
Yan: 少来。在公司就叫全名，被人听见多不好。
Don: 这里没人——哦对，除了 DY。
DY: 我什么都没听见！我只是一个 0.8TB 的小内存！

### 事件 3-D: 实验邀请(剧情关键)
[演出: Don 的手机响了，他看了一眼，表情微变]
Don: (收起手机) ……下午公司要测新的脑机接口 demo。
     Qin 博士负责，找我去当受试者。
Yan: 脑机？就是前台说的那个——
Don: 没事的，就是躺进营养缸睡一会儿，设备我都看过了。
     (顿了顿) 你……想来看看吗？看着我躺也行，顺便验收下他们项目。
  -> 对话选择点(影响章末演出细节)
  [选项1] 「好啊，我陪你。」
      final_choice = "agree"
      Don: 那说好了。……其实有你在，我躺进去也安心点。
  [选项2] 「……脑机实验，安全吗？」
      final_choice = "hesitate"
      Don: (拉过她的手) 我保证。而且你不来看着，
           我睡着了谁给我递咖啡？
      Yan: (笑) ……好吧，陪你。
      [注: 此选项使 Yan 章末的自责独白更强烈]
  [此变量存入存档，继承至后续章节 Yan 的心理描写]

### 事件 3-E: 发卡 + 离别前
[演出: Don 被一通电话叫走前，伸手把 Yan 发间发卡扶正]
Don: 别弄丢了。这是我找到你的坐标。
Yan: 都说了这种话好肉麻——
Don: 那肉麻的话存档了。DY，记住这句。
DY: 已记住！"这是我找到你的坐标"，关联对象: 星形发卡，优先级: 最高。
[Don 走出门口，回头]
Don: 一会儿大厅见。B3 集合，别迟到哦。
[BGM 渐弱，切场景 -> 场景4]

---------------------------------------------------------------
场景4: 大厅 · 异变
地图: 复用 LOBBY，但启用变体光照 LOBBY_DUSK
(全局光照 -40%，NPC 全部移除，仅保留 receptionist，站在前台不动)
---------------------------------------------------------------

[入场演出]
[音效: 广播提示音 "叮咚——"]
广播: 请参加脑机接口体验的人员，前往 B3 实验室。
[演出: Yan 独自走过空荡大厅，脚步声被放大]
Yan(独白): 下午还好好的大厅……人呢？
[走近前台，receptionist 机械地说话]
RECEPTIONIST: (不抬头) B3，请走地下通道。祝体验愉快。
Yan(独白): (她的语气……像在念稿子。)

[演出: Yan 走向地下通道入口 (15, 0)，途中强制触发荣誉墙特写]
[镜头: 再次推近那张合照，这次的停顿更久，配低音]
Yan(独白): 平票。差一票。
[切场景 -> 场景5]

---------------------------------------------------------------
场景5: 脑机接口实验室 · 结局
地图: LAB_B3 (室内 26x18 格，三台营养缸并排靠墙，中央操作台)
---------------------------------------------------------------

[入场演出]
[BGM: 无。只有低频嗡鸣和环境冷气声]
[画面: 三个营养缸并排。左缸空着(留给Yan)，中缸 Don 已在其中，
       隔着玻璃冲 Yan 笑；右缸 Qin 未入缸，站在操作台前]
Don: 来了？比我想象的淡定嘛。
Yan: 你到底躺了多久了？
Don: 才五分钟。这个缸意外地舒服，像回到……
     (顿了一下，笑) 算了，说出来就不浪漫了。

[NPC 5-1] Qin — 操作台前 (13, 6)
Qin: (不回头) 你就是 Yan。
     Don 提过你。很多次。
Yan: 您好，Qin 博士。Don 承蒙您照顾了。
Qin: (停下手上的动作，转过头。第一次正脸特写)
     ……很配你。
Yan: ……什么？
Qin: 发卡。星星的。
[演出: Qin 的目光从发卡移到 Yan 脸上，再移向玻璃缸里的 Don。
       镜头给 Qin 插在口袋里的手——攥紧，指节发白。1 秒。]
Don: Qin 博士，设备都好了吗？
Qin: (转回操作台，声音恢复平静) 好了。请 Yan 小姐进缸吧。

  -> 对话选择点(最终选择，影响后续章节难度)
  [选项1] 「Qin 博士的项目，听起来很厉害。」(友好)
      Qin: (手指停顿了半秒)
      Qin: ……是吗。你是第一个这么说的人。
      [qin_hospitable -1]
      [注: Qin 此刻动摇，下手仍实施但后期 boss 战台词带迟疑]
  [选项2] 「这个实验……安全吗？」(戒备)
      Qin: (转过脸，阴影里的表情看不清)
      Qin: 很安全。我保证。
      [qin_hospitable +1]
      [注: Qin 被激怒，下手更狠，后期 final_difficulty_modifier +1]

[演出: Yan 走入左缸，舱门合拢，液体漫过身体(像素表现: 水面线上升)]
[演出: 透过玻璃，Don 转过来正对 Yan，做口型——"一会儿见"]
[演出: 视野渐暗。画面右侧，Qin 在操作台按下回车]
[强制特写: 屏幕上一行红字闪过]
屏幕文字: 协议改写中……记忆隔离: 开启 | 时间流速: 1:∞
[演出: 黑屏。心跳声，一下，两下，然后停止]
Qin(画外音，很低，近乎耳语):
    为什么。
    明明我才是那个仰望星空的人。
    凭什么……你们什么都有。
[演出: 3 秒死寂]
[演出: 遥远的、像隔着水的声音——]
DY: 姐姐？姐姐！
    我感觉到你了……别怕，别怕。
    我记得你们。我都记得。
[演出: 强光。本章终]
[屏幕中央浮现:]
    第一章 · 茧房 —— 完
    第二章 · 黄昏之城
[存档: scene5_done = true, plot_chapter = 2, 写入全部旗标]

================================================================
【4. 演出/音频需求清单】
================================================================

BGM(现实部分共5首):
1. Morning of Us      — 场景1, 温暖钢琴, 循环
2. Glass Atrium       — 场景2白天, 明亮轻快, 循环
3. His Workshop       — 场景3, 温暖钢琴+轻电子, 循环
4. Hushed Corridor    — 场景4变体, 单音钢琴+底噪, 循环
5. Heartbeat Zero     — 场景5, 几乎无旋律, 低频脉冲, 单次

音效需求:
- 交互确认音(叮)、门开、电梯、脚步(大厅/走廊/实验室三种材质)
- 手机震动、屏幕打字音、咖啡机故障音、小游戏接错线时的短路音
- 舱门合拢/液体注入(闷响)、心跳声(近耳)、白噪音耳鸣(章末)

演出需求(引擎实现优先级排序):
P0: 场景光照变体切换(LOBBY -> LOBBY_DUSK)
P0: 黑屏字幕卡(时间地点)
P0: sepia 回忆滤镜 + 剪影动画(事件3-A)
P0: 屏幕特写叠加层(论文/短信/申请单/红字)
P1: 镜头推近演出(荣誉墙两次、Qin口袋里的手、发卡反光)
P2: 水面线上升像素演出(场景5入缸)

================================================================
【5. 实现提示(Codex 必读)】
================================================================
1. 对话系统: 支持说话人名着色(Yan白/Don暖橙/Qin暗蓝/DY青色/独白斜体灰)，
   打字机效果，可快进，可回看最近20条对话。
2. 对话树: 选项节点记录 final_choice / qin_hospitable 等旗标；
   选项显示过一次的，重看对话时不重复弹选项(用节点ID去重)。
3. 调查点: 统一用可交互物组件，状态(未调查/已调查)入存档；
   已调查的物体再次交互播简短复读文本。
4. NPC 激活逻辑: senior 需 receptionist 对话后激活；
   场景4强制移除所有 NPC 除 receptionist。
5. 条件出口: 场景1出口校验 item_msg_phone，不满足时播独白并留在场景。
6. 章节结束: 触发 scene5_done 后写存档并显示章节标题卡，
   为第二章(横版玩法)预留场景加载接口 load_chapter(2)。
7. 本章无战斗、无血量、无失败状态；小游戏(咖啡机)失败仅重试无惩罚。
8. 所有文本外置到 CSV/JSON，方便后续本地化与修改。

================================================================
【附录: 本章伏笔对照表(供 Codex 打注释用，不显示给玩家)】
================================================================
星形发卡        场景1获得 -> 虚拟世界复活演出核心视觉 -> 终局击败Qin关键道具
"会做梦的AI"    场景1冰箱/场景3回忆 -> DY牺牲前的最后台词
论文《记忆连续性》 场景1电脑 -> 复活机制的理论依据
镜子            场景1可选 -> 虚拟世界中段碎裂剧情点
平票合照        场景2 -> 揭示Qin自大学起一直输给Don
脑死亡事故      场景2老员工 -> 后续章节揭露真相支线
申请单碎片      场景2隐藏 -> 集齐3张解锁公司黑幕支线
qin_hospitable  场景4选择 -> 影响最终boss战Qin台词与难度
final_choice    场景3选择 -> 影响后续章节Yan心理独白
================================================================
# 文档结束
