📄 文书档案 · 乱世生存驱动层定义

驱动层定义完成 - 2026-06-24 20:30

目标

将项目架构从"整图+热区"升级为"驱动层+图层叠加"，支持时间、状态、身份等多维度动态内容。

---

完成的工作

1. 驱动层配置文件

文件: `_build/data/driver_config.json` (8055 字节)

内容:

- 时间参数系统: 阶段、季节、时辰、光效映射

- 角色状态系统: identity/health/hunger/fatigue 阈值规则

- 互助层状态规则: 声望→状态映射，一次性下降

- NPC 规则: 称呼映射、出现条件、状态变体

- 季节滤镜配置: 4 季色调参数、前景效果

关键映射:

health < 50  → 禁用 climb/sneak/fight/run
health < 20  → 触发 dying 事件
hunger < 30  → 对话出现"肚子叫"
hunger < 10  → 场景被 starving_event 覆盖
fatigue ≥ 50 → 对话缩短 30%
fatigue ≥ 80 → 对话缩短 60%

2. 整合数据文件

文件: `_build/data/story_v3.json` (14651 字节)

架构:

player_state
  ├── time (时间参数)
  ├── character (角色状态)
  ├── world (世界状态: 声望/互助层)
  └── marks (标记位)

scenes
  ├── scene_001 ~ scene_008 (8 个场景)
  ├── npc_slots (NPC 插槽配置)
  ├── choices (选项 + condition 字段)
  └── template (场景模板引用)

scene_templates (模板定义)

新增字段:

`condition.identity`: 身份过滤
`condition.health.min`: 健康阈值
`condition.inventory_contains`: 物品检查
`npc_slots[].appear_rule`: NPC 出现条件
`mark_changes.identity`: 身份变更

3. 引擎重写

文件: `_build/js/engine_v3.js` (12886 字节)

核心方法:

| 方法 | 功能 |

|------|------|

| `applyTimeEffects()` | 时间→光效 |

| `applySeasonFilter()` | 季节→滤镜 |

| `filterOptionsByCharacterState()` | 角色状态→选项过滤 |

| `checkHealthLimitation()` | health→移动限制 |

| `getHungerStatus()` | hunger→饥饿状态 |

| `adjustDialogByFatigue()` | fatigue→对话缩短 |

| `getNPCTitle()` | identity→NPC 称呼 |

| `calculateSolidarity()` | 声望→互助层状态 |

| `shouldNPCAppear()` | 综合判断 NPC 是否出现 |

| `generateNPCDialog()` | 根据状态生成 NPC 对话 |

图层叠加渲染:

背景层 (background-layer)
  ↓
+ 时间光效 (CSS filter)
  ↓
+ NPC 热区层 (SVG hotzone-layer)
  ↓
+ 前景层 (foreground-layer)

4. 样式升级

文件: `_build/css/style_v3.css` (7993 字节)

新增:

CSS 变量: `--light-color`, `--light-intensity`
图层叠加架构: `.background-layer`, `.foreground-layer`
NPC 类型差异化呼吸动画: 6 种 NPC 对应不同呼吸节奏
时间/季节预设类: `.time-dusk`, `.season-autumn`
状态信息显示: `#debug-info`

5. 测试页面

文件: `_build/index_v3.html` (5733 字节)

测试功能:

切换时间 (morning/noon/dusk/night)
切换身份 (refugee/recruit/deserter/merchant/lord/hermit)
切换互助层状态 (ACTIVE/STRAINED/BROKEN/INSTITUTIONALIZED)
实时显示驱动层参数

---

架构变化对比

旧架构 (v2)

story.json (场景驱动)
  ├── scenes[].npcs[] (固定 NPC)
  └── scenes[].choices[] (硬编码选项)

engine.js
  └── 直接渲染场景内容

新架构 (v3)

driver_config.json (规则层)
story_v3.json (数据层)
  ├── player_state (驱动层)
  └── scenes (场景层)

engine_v3.js (引擎层)
  ├── 读取驱动层
  ├── 应用规则
  └── 动态生成内容

---

验证清单

第一层验证：时间参数

[ ] 改 `time_of_day` → 光效变化
[ ] 改 `season` → 滤镜变化

第二层验证：角色状态

[ ] 改 `health` < 50 → 选项减少
[ ] 改 `identity` → 选项完全不同
[ ] 改 `fatigue` → 对话长度变化

第三层验证：互助层

[ ] 改 `local_reputation` → 互助层状态变化
[ ] 互助层 = BROKEN → 老妇/小孩不出现
[ ] 互助层 = INSTITUTIONALIZED → NPC 对话变化

第四层验证：NPC 称呼

[ ] identity = refugee → 守兵称"喂，排队！"
[ ] identity = lord → 守兵称"大人"

---

待验证项

1. 图层叠加效果: 需要生成对应的背景图和滤镜素材

2. NPC 称呼插入: 当前仅返回称呼文本，未实际插入对话

3. 饥饿事件覆盖: `starving_event` 场景未定义

4. 健康限制: 选项的 `requires_health` 字段未在 story_v3.json 中定义

---

文件清单

| 文件 | 状态 | 说明 |

|------|------|------|

| `driver_config.json` | ✅ 已写入 | 驱动层配置 |

| `story_v3.json` | ✅ 已写入 | 整合数据文件 |

| `engine_v3.js` | ✅ 已写入 | 状态驱动引擎 |

| `style_v3.css` | ✅ 已写入 | 图层叠加样式 |

| `index_v3.html` | ✅ 已写入 | 测试页面 |

---

下一步

1. 用户测试: 打开 `index_v3.html`，点击测试按钮验证驱动层生效

2. 素材补充: 生成背景图、滤镜图、NPC 图、前景图

3. 坐标定义: 使用现有整图作为参照，标注各元素的坐标区域

4. 对话模板: 实现身份→称呼的实际插入逻辑

---

设计决策记录

为什么 driver_config.json 和 story_v3.json 分离？

原因: 关注点分离

`driver_config.json` = 规则层（跨场景通用）
`story_v3.json` = 数据层（场景具体内容）

好处:

修改规则不需改动场景数据
可以为不同阶段使用不同的规则配置
便于 AI 独立生成场景数据

为什么使用 condition 字段而不是硬编码选项？

原因: 同一场景适配不同身份

流民看到"排队入城""绕城""帮老妇""城外生存"
新兵看到"直接回军营""问粮饷"
逃兵看到"避开守卫""伪装""逃亡"

好处:

一个场景文件支持多种身份
减少重复场景定义
状态变化后自动切换可用选项

为什么 NPC 使用 appear_rule 而不是固定列表？

原因: NPC 动态出现

老妇在互助层 BROKEN 时不出现
小孩在夜间不出现
守兵对逃兵显示，但对话不同

好处:

同一场景在不同状态下呈现不同的 NPC 组合
支持时间/声望/身份多重条件

---

完成时间: 2026-06-24 20:30 GMT+8

—— 人与AI协作记录 ——