# 《雾灯残页》完整开发过程记录

> 这份文档忠实还原了从零到完成的全过程：每一次对话、每一个决策背后的思考、每一次犯错与修正。
> 它不仅是技术日志，更是两个人如何协作打磨一个哥特视觉小说的完整叙事。

---

## 目录

1. [项目起源：从骨架到世界观](#一项目起源从骨架到世界观)
2. [分支设计：四选一到六选一的演进](#二分支设计四选一到六选一的演进)
3. [试玩方案：终端版与引擎版并行](#三试玩方案终端版与引擎版并行)
4. [文风定调：坡与勃朗特的融合](#四文风定调坡与勃朗特的融合)
5. [第一轮文风清洗：57处违规](#五第一轮文风清洗57处违规)
6. [第二轮文风清洗：破折号与AI腔](#六第二轮文风清洗破折号与ai腔)
7. [命运丝线：从机械骰子到氛围叙述](#七命运丝线从机械骰子到氛围叙述)
8. [四线变丝线：用户的一声怒吼](#八四线变丝线用户的一声怒吼)
9. [破折号大清洗：从657到17](#九破折号大清洗从657到17)
10. [PowerShell编码灾难：一个惨痛的教训](#十powershell编码灾难一个惨痛的教训)
11. [对话格式修复：100处损坏的马拉松](#十一对话格式修复100处损坏的马拉松)
12. [最终状态与待修复事项](#十二最终状态与待修复事项)
13. [核心设计理念](#十三核心设计理念)

---

## 一、项目起源：从骨架到世界观

### 对话实录

用户最初提供了一份骨架大纲 `skeleton.txt`，描述了一个被困在时间裂隙中的意识体——叙述者，他以第三人称视角跟随勇者米迦经历五次轮回。每次轮回以黎明苏醒开始，黄昏刺杀事件结束。叙述者的真实身份是魔王，但他自己并不知道。

### 我的思考过程

收到骨架后，我做的第一件事是确定技术栈。视觉小说有几种主流选择：

- **Ren'Py**：Python 语法，社区成熟，内置存读档/CG回顾/选项分支，跨平台发布
- **TyranoBuilder**：可视化编辑器，但脚本语言封闭
- **自研引擎**：灵活但开发周期长

选择了 Ren'Py，因为它最适合"先写故事，后加美术"的开发流程。项目不需要精美立绘就能跑起来，这对原型阶段至关重要。

### 核心设定确立

在骨架基础上，我完善了以下设定：

**属性系统**设计了五个维度——警觉、执念、同步、权能、meta_awareness。前四个是传统TRPG属性，第五个是这个项目独有的：叙述者对自身"被书写"状态的认知程度。这个属性是通往隐藏结局（飞升结局）的钥匙。

**暗骰机制**的灵感来自桌游中的DM暗骰：当玩家的 meta_awareness 累积到 2 以上时，每次判定会额外暗投一枚 d20。若暗骰命中 20，触发叙述者突破第四面墙的隐藏结局。玩家看不到暗骰的数值，只能感受到"有什么东西变了"。

**两个关键NPC**：
- **米迦**：紫发，嬉皮笑脸，武器是一把缺口严重的锈剑。每次轮回都死于黄昏刺杀。他的笑容下面藏着什么，叙述者五次轮回都没能看清。
- **塞西尔**：刺客之一，金发，冷峻疲惫。他的家族曾看守旧神殿。在第四次轮回被招募进队伍，成为连接"过去"与"现在"的桥梁。

### 项目文件结构

```
my-vn/
├── game/
│   ├── script.rpy          # 主游戏脚本（Ren'Py格式）
│   ├── screens.rpy          # UI界面定义
│   ├── options.rpy          # 项目配置
│   └── gui.rpy              # GUI样式
├── text_runner.py           # 终端文字版（用于快速测试叙事）
├── story_text.txt           # 纯文本版故事内容
├── branch_tree.html         # 可视化分支树（浏览器打开）
└── skeleton.txt             # 原始骨架大纲
```

四文件并行维护的架构从一开始就确立了——script.rpy 是正式引擎版，text_runner.py 用于终端快速测试叙事节奏，story_text.txt 是纯文本参考，branch_tree.html 是浏览器可视化分支图。任何叙事修改都必须同步到四个文件。这个决策后来证明是正确的，但也大大增加了每次修改的工作量。

---

## 二、分支设计：四选一到六选一的演进

### 初始设计：每轮回四选一

最初设计了 5 个轮回，每轮回 4 个选项，共 20 条路径，导向 6 个结局。

### 用户的扩展要求

用户看了初始方案后，要求将每个轮回的选项扩展到 5-6 个。理由是：4 个选项太"整齐"，缺少那种"我不知道该选什么"的焦虑感。

### 我的思考过程

扩展选项不仅仅是加一行文字。每个新选项需要：
1. **叙事合理性**：它必须在当前轮回的情境下说得通
2. **属性差异化**：它赋予的属性组合必须和已有选项不同
3. **叙事独创性**：它导向的文本不能和已有路径重复

我为每个轮回设计了新选项的核心理念：

- **Loop 1 新增"捡起水壶递过去"**：这个选项的灵感来自"最小的善意"。在哥特暗黑的氛围中，一个递水壶的动作比任何豪言壮语都更有力量。它给予同步属性和米迦的信任。
- **Loop 2 新增"你剑上的锈——不是普通的锈"**：引入铁匠铺/旧神殿的伏线。叙述者通过观察锈迹，暗示他拥有超越轮回的记忆碎片。
- **Loop 3 新增"你做过梦吗？"和"翻进铁匠铺搜查"**：前者是情感线（通过梦境暗示轮回），后者是探索线（直接搜查获得权能）。
- **Loop 4 新增"你还记得那条黑水河吗？"和"检查铁匠铺地窖"**：黑水河是叙述者与米迦前世的共同记忆，地窖藏着旧神殿的秘密。
- **Loop 5 新增"你还记得那个河对面的人吗？"和"带塞西尔一起去旧神殿"**：前者是身份揭示的终极选项，后者引入塞西尔的家族记忆线。

### 最终数据

| 轮回 | 选项数 | 主题 | DC | 判定属性 |
|------|--------|------|-----|---------|
| Loop 1 | 5 | 初遇 | DC12 | 警觉 |
| Loop 2 | 5 | 重逢 | DC12 | 执念 |
| Loop 3 | 6 | 觉醒 | DC12 | 同步 |
| Loop 4 | 6 | 沉沦 | DC12 | 执念+同步 |
| Loop 5 | 6 | 终局 | DC12 | 执念+同步 |

总计 **28 条路径**，导向 **6 个结局**。

### 六结局设计

| 结局 | 触发条件 | 核心意象 |
|------|---------|----------|
| 黎明 (DAWN) | 最终判定成功，mika_knows_me = False | 两个陌生人在晨光中并肩 |
| 相知 (KNOWING) | 最终判定成功，mika_knows_me = True | 身份揭示，真相被接受 |
| 飞升 (ASCENDING) | 暗骰命中20 | 叙述者突破第四面墙 |
| 铁锈 (RUST) | 最终判定失败，mika_trust < 2 | 米迦独自面对命运 |
| 裂痕 (FRACTURE) | 最终判定失败，loop_count ≥ 3 | 意识碎裂，轮回永续 |
| 余烬 (EMBER) | 最终判定大失败(d20=1) | 废墟中等待第六次轮回 |

---

## 三、试玩方案：终端版与引擎版并行

### 用户的请求

用户说："现在我要试玩一下，给我试玩方案。"

### 我的思考过程

Ren'Py 引擎版需要完整的引擎环境（用户需要下载 Ren'Py SDK），而且每次修改脚本都需要重启引擎。对于叙事密集型的原型阶段，这太慢了。

我提出了两个方案：

**方案一：终端文字版 (text_runner.py)**
- 用纯 Python 实现，不需要任何额外依赖
- 在终端/PowerShell 中直接运行 `python text_runner.py`
- 通过 `input()` 实现选项选择，`time.sleep()` 控制叙事节奏
- 适合快速迭代叙事内容

**方案二：Ren'Py 引擎版**
- 需要下载 Ren'Py SDK（用户后来放在了 `D:\renpy\renpy-8.5.2-sdk\`）
- 通过 Ren'Py 启动器运行
- 有完整的 GUI、存读档、CG回顾
- 适合最终发布

用户两个都要。于是我先完成了 text_runner.py 的全部叙事内容，再同步到 script.rpy。

### text_runner.py 的设计

封装了三个核心输出函数：

```python
def narrator(text):
    """叙事者文本——无名字"""
    print(f"\n  {text}")
    time.sleep(0.3)

def say(speaker, text):
    """角色对话——带名字"""
    print(f"\n  [{speaker}] {text}")
    time.sleep(0.3)

def press_enter():
    """暂停等待玩家输入"""
    input("\n  按回车继续...")
```

骰子系统用 Python 的 `random.randint(1, 20)` 实现，和 Ren'Py 版的 `renpy.random.randint(1, 20)` 逻辑完全一致。

---

## 四、文风定调：坡与勃朗特的融合

### 用户的核心要求

用户对文风有极其明确的定位：**爱伦·坡的心理恐怖** 加上 **艾米莉·勃朗特的野性浪漫**。

这不是简单的"黑暗风格"。用户要求的是一种特定的文学质感：

**坡的贡献**：
- 紧张/惊骇时刻切换为断奏节奏（短句、碎句、感叹号）
- 通过重复模拟执着与痴迷
- 不可靠叙述者的偏执视角

**勃朗特的贡献**：
- 场景铺垫和内心独白使用绵长盘旋的句子
- 模仿荒原上呼啸的风声
- 氛围浓烈，情感暴烈到近乎暴力

### 用户原话（大意）

> "叙述者对米迦的感情不是温柔的守护，而是一种暴力的、寄生的、无法拔除的执念。每次描写米迦死亡的场景，要让读者感受到叙述者的皮肤在灼烧、骨头在断裂。"

### 我的思考过程

这个文风要求意味着我不能用普通的"网文腔"或"轻小说腔"来写。我需要：

1. **句式错落**：长短交替，不能每句都是"主谓宾"的平铺
2. **感官过载**：每个抽象概念都必须附着在一个具体的感官细节上——不是"他很悲伤"，而是"他的指甲嵌进了掌心，血珠沿着掌纹渗出来，像一条蜿蜒的红色河流"
3. **欧化中文**：模仿19世纪翻译文学的语法结构，从句套从句，修饰语层层叠叠
4. **不可靠叙述**：叙述者看到的不一定是真实的，他的感知被轮回和执念扭曲

### 选定的风格参考

用户明确提到了一个风格锚点："模仿 DeepSeek 2025 年初的写作风格"——即那种冷峻、克制、偶尔爆发的中文文学质感。

---

## 五、第一轮文风清洗：57处违规

### 用户的禁令清单

用户给出了一份极其详细的禁令清单，分为**禁用句式**和**禁用词汇**两类：

**禁用句式**（完整列表）：
- "不是……而是……"
- "在……的过程中"
- "总而言之""综上所述"
- "不仅……更……"
- "不是……是……是……"
- "不是……不是……是……"
- "是……的基石/关键/必修课"
- 排比句、对偶句、反复等修辞性排叠结构
- "不x，不y，不z，就"格式
- "这就够了"
- "很…，但很…"
- 总-分-总结构

**禁用词汇**：兜住、接住、稳、守、极其

**替换原则**：每个违规句必须替换为一个具体的感官画面，而不是换一个同义词。

### 我的思考过程

我逐文件扫描了所有文本，用正则表达式匹配禁用句式，然后手动审查每一个匹配项。关键的挑战在于：替换不能只是"换个说法"，而必须是一个全新的感官画面。

**举例**：

原文：
> "他不是害怕，而是愤怒。"

替换为：
> "他的手指在颤抖。不是恐惧的那种颤抖——是琴弦绷到极限时发出的那种嗡鸣，从指尖传到手腕，传到肘关节，传到肩胛骨。"

原文：
> "在战斗的过程中，他逐渐明白了真相。"

替换为：
> "剑刃劈开空气的声音在他耳边炸开。第一下。第二下。第三下。每一次金属碰撞都在他的颅骨内侧留下一道刻痕，直到那些刻痕连成了一句话。"

### 修复统计

| 文件 | 违规处数 | 修复方式 |
|------|---------|---------|
| script.rpy | 20处 | 全部替换为感官画面 |
| text_runner.py | 17处 | 同步替换 |
| story_text.txt | 20处 | 同步替换 |
| **合计** | **57处** | |

---

## 六、第二轮文风清洗：破折号与AI腔

### 用户的第二轮要求

在第一轮修复完成后，用户提出了更严格的要求：

> "——这种AI文风明显的符号在所有的文本里3000字内最多出现1次。同时检查禁用词汇频率。"

### 我的思考过程

这个要求让我意识到一个问题：破折号（——）是AI生成中文文本时最明显的"指纹"之一。人类写作者很少在一段文字中密集使用破折号，但AI模型（包括我自己）倾向于用破折号来插入补充说明、制造戏剧性停顿。

我统计了各文件的破折号数量：
- script.rpy: **255个**
- text_runner.py: **156个**
- story_text.txt: **249个**
- branch_tree.html: **37个**
- **总计: 697个**

这个数字触目惊心。按照3000字1个的标准，22000字的script.rpy最多只能有7个破折号。

### 第二轮新增禁令

- 破折号（——）3000字内最多出现1次
- 禁止无意义的精确数字（"零点二秒"、"两毫米"——这种数字暗示了一种虚假的精确感）
- 每500字内"不是"不超过3次
- 避免高频使用"首先、其次、然后、最后"等程式化连接词
- 减少重复说法和同义句堆叠

### 修复策略

对于破折号的处理，不能简单地删除。每个破折号都有其叙事功能——停顿、转折、补充说明。我需要为每个破折号找到替代方案：

- **补充说明型破折号** → 改用从句或括号性插入语
- **戏剧停顿型破折号** → 改用句号断句或换行
- **转折型破折号** → 改用"但""然而"或直接用新段落

### 第一轮文风修复后的统计

修复了约57处禁用句式违规后，进入了破折号专项清洗阶段（详见第九节）。

---

## 七、命运丝线：从机械骰子到氛围叙述

### 用户的请求

用户看了骰子判定的显示效果后说：

> "如果有暗骰，显示为命运的四线在此刻波动之类的句子，要有逼格。"

### 我的思考过程

原来的骰子显示是这样的：
```
【d20=14 + 警觉(3) = 17 ≥ DC12】
```

这是标准的TRPG格式，准确、清晰，但完全破坏了哥特暗黑的氛围。在一轮沉浸式的心理恐怖叙事中，突然跳出一行机械数据——就像在看恐怖电影时屏幕下方弹出一行Excel表格。

我设计了**命运丝线**隐喻：骰子不是冰冷的随机数，而是命运织机上颤动的丝线。每次判定都是丝线的一次颤动——收紧、松弛、绷紧、断裂。

### 命运丝线的五种状态

**成功**：
> 「命运的丝线在此刻微微收紧，像琴弦被拨动了一下。」

**失败**：
> 「命运的丝线微微松弛。方向偏了。」

**暴击（d20=20）**：
> 「命运的丝线在此刻骤然绷紧，发出一声无人听见的嗡鸣。」

**大失败（d20=1）**：
> 「命运的丝线骤然断裂。碎裂的声音从很远的地方传来，像冰面下的河水突然涌出。」

**暗骰触发**：
> 「……有什么东西变了。一道裂缝。在那片虚无的最深处，出现了一道不该存在的裂缝。」

### 技术实现

**Ren'Py 版**：创建了 `fate_notify` screen，显示在屏幕顶部（yalign 0.08），3秒后自动消失。使用斜体、低饱和度颜色（#8a7a6a），确保它像一个幽灵般的提示而非弹窗。

```renpy
screen fate_notify(message, roll_text=""):
    zorder 200
    timer 3.0 action Hide("fate_notify")
    frame:
        xalign 0.5
        yalign 0.08
        xpadding 24
        ypadding 12
        background None
        vbox:
            spacing 4
            xalign 0.5
            text message size 16 color "#8a7a6a" xalign 0.5 italic True
            if roll_text:
                text roll_text size 12 color "#5a4a3a" xalign 0.5
```

**text_runner.py 版**：直接用 `narrator()` 输出氛围文字，在输出前加 0.8 秒延迟模拟"命运的凝视"。

**story_text.txt 版**：用 `[命运的丝线...]` 标记替代原有的 `[DICE]` 标记。

### 原始骰子代码

```python
init python:
    def roll_check(stat_name, stat_value, difficulty):
        dice = renpy.random.randint(1, 20)
        total = dice + stat_value
        if dice == 20:
            return (dice, stat_value, total, True, "critical_success")
        elif dice == 1:
            return (dice, stat_value, total, False, "critical_failure")
        success = total >= difficulty
        result_type = "success" if success else "failure"
        return (dice, stat_value, total, success, result_type)

    def meta_roll():
        return renpy.random.randint(1, 20)
```

骰子判定的结果类型（critical_success / critical_failure / success / failure）决定显示哪条命运丝线描述，同时决定走向哪个叙事分支。

---

## 八、四线变丝线：用户的一声怒吼

### 事件经过

在替换骰子标记时，我犯了一个低级错误：把"命运的丝线"写成了"命运的四线"。

用户原话：

> "也同步到 text_runner.py 的终端版，都同步，成功 ：「命运的四线在此刻微微收紧，像琴弦被拨动了一下。」四线是什么鬼，是命运的丝线！"

### 我的反思

这是一个典型的"打字错误在多文件同步中被放大"的问题。"丝"和"四"在拼音输入法中容易混淆（si vs si），而且在四文件同步的架构中，一个错误会被复制四次。

修复过程：
1. 全局搜索"四线"，替换为"丝线"
2. 检查所有相关上下文确保语义正确
3. 同步到四个文件

---

## 九、破折号大清洗：从657到17

### 用户的要求

> "继续调整文本，——这种AI文风明显的符号在所有的文本里3000字内最多出现1次。"

### 我的策略

编写了一个智能评分脚本 `reduce_dashes.py`，对每个破折号进行评分：

**评分维度**：
- **叙事权重**：在高潮段落中的破折号得分更高
- **句式多样性**：如果前后文已经有其他标点变化，该破折号得分更低
- **不可替代性**：如果删除后句意会改变，得分更高
- **密度惩罚**：3000字内已有破折号的区域，后续破折号得分递减

保留得分最高的几个破折号，其余全部替换。

### 修复统计

| 文件 | 原始数量 | 修复后 | 密度 |
|------|---------|--------|------|
| script.rpy | 255 | 7 | 1/3,210 |
| text_runner.py | 156 | 6 | 1/3,347 |
| story_text.txt | 249 | 4 | 1/4,813 |
| branch_tree.html | 37 | 9 | 1/3,559 |
| **总计** | **697** | **26** | |

从697个破折号削减到26个——削减率 96.3%。

---

## 十、PowerShell编码灾难：一个惨痛的教训

### 事故经过

在修复"四线"→"丝线"的过程中，我使用了 PowerShell 的 `-replace` 操作符配合 `-NoNewline` 参数来批量替换文件内容。这是一个致命的错误。

### 根因分析

PowerShell 的 `Set-Content` 和 `-replace` 操作符**默认使用系统编码**（在中文 Windows 上是 GBK/CP936），而不是 UTF-8。当它写入一个 UTF-8 编码的文件时：

1. 读取阶段：PowerShell 以 GBK 编码读取 UTF-8 文件，部分多字节 UTF-8 序列被错误解析
2. 写入阶段：PowerShell 以 GBK 编码写回，进一步损坏已错误解析的字符
3. 具体损坏：
   - 所有 `"` (U+201D) 右弯引号被剥离（GBK 编码中不存在此字符）
   - `"他" "` 对话格式损坏为 `"。 "`（引号丢失后，残余字符重新组合）
   - 大量中文字符被替换为 `�` 乱码
   - 文件从约 975 行膨胀到 1985 行（每行后多出空行）

### 损坏范围

- **script.rpy**：100+ 处对话格式损坏，文件末尾（第1105-1112行）出现严重乱码
- **text_runner.py**：文件末尾（第585行之后）出现乱码
- **story_text.txt**：文件末尾（第660行之后）出现乱码
- **branch_tree.html**：损坏最轻，大部分内容完好

### 修复过程

编写了多个 Python 修复脚本，按顺序执行：

1. **fix_quotes.py** — 恢复缺失的闭合引号
2. **fix_speaker.py** — 修复损坏的说话人标签（`"。 "` → `"他" "`）
3. **fix_all.py** — 综合修复脚本
4. **repair.py** — 引号匹配修复
5. **fix_dialogue.py** — 批量修复100处损坏的对话格式
6. **fix_blanks.py** — 清理多余空行

### 修复的思考过程

最棘手的问题是：损坏的文本中，哪些字符是"原文"，哪些是"乱码"？没有版本控制的历史记录，我只能：

1. 对比四个文件中同一段落的上下文
2. 根据 Ren'Py 语法结构推断正确的标签格式
3. 根据叙事逻辑重建被损坏的段落

例如，`"。 "text"` 这种格式显然是 `"他" "text"` 的损坏——因为 `"。 "` 不是任何合法的 Ren'Py 说话人标签。通过正则匹配 `"。 "` 并结合上下文判断说话人，批量修复了 100 处。

### 教训

**永远不要用 PowerShell 的原生 cmdlet 操作 UTF-8 中文文件。** 所有后续的文件操作都改用 Python 脚本完成。

用户保留了所有修复脚本，放在项目根目录下，作为"事故现场"的证据。

---

## 十一、对话格式修复：100处损坏的马拉松

### 损坏模式

PowerShell 编码事故造成的对话损坏有以下几种模式：

**模式一：说话人标签损坏**
```
# 原文
"他" "你还记得吗？那些夜晚。"
# 损坏后
"。 "你还记得吗？那些夜晚。"
```

**模式二：引号丢失**
```
# 原文
"我" "我不知道你在说什么。"
# 损坏后
"我" "我不知道你在说什么。（缺少闭合引号）
```

**模式三：中文字符乱码**
```
# 原文
narrator("他的目光穿过了我的皮肤。")
# 损坏后
narrator("他的目光穿过了我的皮�?。")
```

### 修复策略

编写了 `fix_dialogue.py`，核心逻辑：

```python
import re

def fix_dialogue(filepath):
    with open(filepath, 'r', encoding='utf-8') as f:
        content = f.read()

    # 修复模式一：". " → 合理的说话人
    # 通过上下文推断说话人（他/我/塞西尔）
    pattern = r'"。 "(.*)"'
    # ... 根据前后文判断说话人

    # 修复模式二：补充闭合引号
    # ...

    # 修复模式三：替换乱码字符
    # ...

    with open(filepath, 'w', encoding='utf-8') as f:
        f.write(content)
```

### 修复历程

| 轮次 | 剩余损坏处 | 修复方式 |
|------|-----------|---------|
| 初始 | 100+ | Python 批量脚本 |
| 第二轮 | 17 | 手动 SearchReplace |
| 第三轮 | 0 | 最终确认 |

---

## 十二、最终状态与待修复事项

### 文件规模

| 文件 | 字符数 | 破折号数 | 密度 |
|------|--------|---------|------|
| script.rpy | 22,476 | 7 | 1/3,210 |
| text_runner.py | 20,086 | 6 | 1/3,347 |
| story_text.txt | 19,252 | 4 | 1/4,813 |
| branch_tree.html | 32,032 | 9 | 1/3,559 |

### 文风合规状态

- "不是"频率: 全部文件每500字不超过3次 ✅
- 禁用词汇(兜住/接住/稳/守/极其): 0处 ✅
- 禁用句式: 0处 ✅
- 命运丝线氛围叙述替代机械骰子标记 ✅
- 破折号密度 ≤ 1/3000 ✅

### 暗骰机制状态

- RNG: `renpy.random.randint(1, 20)` / `random.randint(1, 20)` ✅
- 暴击/大失败独立路径 ✅
- meta_roll 暗骰独立于主骰 ✅
- 命运丝线氛围叙述替代机械标记 ✅
- fate_notify screen 实现（3秒自动消失） ✅

### 待修复事项

以下三个文件的末尾存在 PowerShell 编码事故造成的乱码，需要用 branch_tree.html（损坏最轻的版本）中的原始文本重建：

1. **script.rpy 第1105-1112行**：ASCENDING结局、DAWN结局、meta_awareness尾声的叙事文本被乱码覆盖
2. **text_runner.py 第585行之后**：同一段叙事的终端版被乱码覆盖
3. **story_text.txt 第660行之后**：同一段叙事的纯文本版被乱码覆盖

---

## 十三、核心设计理念

### 1. 不可靠叙述者

玩家扮演的"我"是魔王，但他的记忆被五次轮回碾碎。他不确定自己的感知是否真实——他看到的米迦是真的米迦，还是他执念的投影？他感受到的温暖是真的温暖，还是深渊在伪装？

这种不可靠性不仅体现在叙事文本中，也体现在骰子系统中：同一个选项，不同掷骰结果会导向截然不同的叙事，而叙述者会为每一种结果找到"合理"的解释。

### 2. 寄生式情感

叙述者对米迦的感情不是温柔的守护，而是一种暴力的、寄生的、无法拔除的执念。每一次描写米迦死亡的场景，叙述者的身体都会有物理反应——皮肤灼烧、骨头断裂、指甲嵌进掌心。这不是"悲伤"，这是一种寄生虫在宿主体内翻滚的痛感。

### 3. 感官优先

每个抽象概念都必须通过具体的感官细节传达。禁用"悲伤""恐惧""愤怒"等抽象情感词，取而代之的是：

- 悲伤 → "他的指甲嵌进了掌心，血珠沿着掌纹渗出来"
- 恐惧 → "他的脊椎像一根被冻住的琴弦，从尾椎到颈椎都在发出细微的嗡鸣"
- 愤怒 → "他的手指在颤抖。不是恐惧的那种颤抖——是琴弦绷到极限时发出的那种嗡鸣"

### 4. 命运的丝线

骰子不是冰冷的数字，而是命运织机上颤动的丝线。这个隐喻贯穿整个游戏：每次判定都是丝线的一次颤动，暴击是丝线骤然绷紧，大失败是丝线断裂。暗骰触发时，玩家看不到数值，只能感受到"有什么东西变了"。

### 5. 渐进揭示

玩家（叙述者）对自身身份的认知随轮回加深：

- **Loop 1-2**：旁观者——"我在看一个人的命运"
- **Loop 3-4**：参与者——"我在改变一个人的命运"
- **Loop 5**：被书写者——"我发现自己的命运也被书写着"
- **ASCENDING结局**：书写者——"我突破了纸页，看到了正在写这个故事的你"

---

## 附录：开发时间线

| 时间 | 事件 | 关键决策 |
|------|------|---------|
| 5/9 晚 | 项目创建 | 选择 Ren'Py 引擎，确立四文件并行架构 |
| 5/9 深夜 | 核心世界观设定 | 五属性系统、暗骰机制、两个关键NPC |
| 5/9 深夜 | 初始分支设计 | 5轮回×4选项，6结局 |
| 5/10 上午 | 分支扩展 | 每轮回扩展到5-6选项，共28条路径 |
| 5/10 上午 | text_runner.py 完成 | 终端版可运行，支持完整叙事流程 |
| 5/10 下午 | 第一轮文风清洗 | 57处禁用句式违规全部修复 |
| 5/10 下午 | 命运丝线系统设计 | 五种丝线状态，fate_notify screen |
| 5/10 傍晚 | "四线"→"丝线"修复 | 用户纠正用词错误 |
| 5/10 傍晚 | 第二轮文风清洗 | 破折号禁令、数字禁令、频率限制 |
| 5/10 晚间 | 破折号大清洗 | 从697个削减到26个（-96.3%） |
| 5/10 晚间 | PowerShell编码灾难 | 三个文件严重损坏 |
| 5/10 晚间 | 编码修复马拉松 | 多个Python修复脚本，100处对话修复 |
| 5/10 晚间 | 最终验证 | 文风合规、暗骰机制、四文件同步确认 |

---

## 附录：项目文件清单

### 核心文件
- `game/script.rpy` — Ren'Py 主游戏脚本（~1113行）
- `game/screens.rpy` — UI界面定义（含fate_notify screen）
- `game/options.rpy` — 项目配置
- `game/gui.rpy` — GUI样式
- `text_runner.py` — 终端文字版（~614+行）
- `story_text.txt` — 纯文本版故事（~679+行）
- `branch_tree.html` — 可视化分支树（~580+行）
- `skeleton.txt` — 原始骨架大纲

### 修复脚本（保留作为开发记录）
- `fix_dialogue.py` — 批量修复100处对话格式损坏
- `fix_last.py` — 修复最后残留的损坏
- `reduce_dashes.py` — 智能削减破折号（评分系统）
- `fix_blanks.py` — 清理多余空行
- `sync_all.py` — 多文件同步脚本

---

## 十四、2026-05-11 同步修订：角色重构与四文件回归

### 本次目标

1. 将 `story_text.txt` 的结局段与新版 `script.rpy` 逐段对齐  
2. 保留塞西尔并更新外观为“黑发紫眼”  
3. 新增角色卡修斯（红发蓝眼，旅行法师，高傲冷淡）  
4. 修复/重建 `branch_tree.html`，恢复四文件同步基线  
5. 全量备份关键文件，防止二次事故

### 备份记录

已在 `backups/` 目录创建以下时间戳备份（`20260511_0029`）：

- `backups/script.rpy.20260511_0029.bak`
- `backups/text_runner.py.20260511_0029.bak`
- `backups/story_text.txt.20260511_0029.bak`
- `backups/DEVELOPMENT_LOG.md.20260511_0029.bak`

### 实际修改

- `game/script.rpy`
  - 角色拆分：`塞西尔`（原刺客法师）与新增 `卡修斯`（旅行法师）
  - 关键叙事文案同步：ASCENSION / AUTHOR 结局中加入卡修斯存在
  - 主线文本统一为“米迦 + 塞西尔 + 卡修斯”协同结构

- `text_runner.py`
  - 与 `script.rpy` 同步角色与叙事
  - 角色标签、线索提示、结局文本统一
  - 新增卡修斯出场描述（红发蓝眼，旅行法师，高傲冷淡）

- `story_text.txt`
  - 重写为“当前版本的同步叙事文本”
  - 六结局逐段对齐 `script.rpy`
  - 角色设定区明确区分塞西尔与卡修斯

- `branch_tree.html`
  - 从缺失/损坏状态重建为可阅读结构化页面
  - 含角色卡片、周目流程、结局触发表
  - 明确纳入新增卡修斯角色

### 状态结论

- 四文件同步恢复：`script.rpy` / `text_runner.py` / `story_text.txt` / `branch_tree.html` ✅
- 塞西尔人设保留并修正外观：黑发紫眼 ✅
- 新角色卡修斯新增完成：红发蓝眼、旅行法师、高傲冷淡 ✅

---

## 十五、2026-05-11 深夜：Branch Tree 视觉重制与冗余清理

### 本轮新增要求

用户要求对 `branch_tree.html` 进行 UI 重制，风格参考 Dark Academia：  
暗木背景、羊皮纸内容卡、克制交互、长文阅读导向，强调“旧书房中的沉浸阅读感”。

### Branch Tree UI 重制结果

已将 `branch_tree.html` 改为单页“书页式”结构：

- 背景改为深棕木纹层叠 + 低频颗粒纹理
- 主内容采用米黄羊皮纸卡片，保留轻微边缘色差与压纹阴影
- 交互仅保留轻微提亮、细线下划线与小幅抬升
- 角色区、周目区、结局区采用“阅读卡”组织，减少现代仪表盘感
- 保留并同步当前剧情信息：塞西尔（黑发紫眼）+ 新增卡修斯（红发蓝眼）

### 冗余文件清理

根据“临时修复脚本”性质，删除以下明显冗余文件：

- `tmp_rebuild_html.py`
- `tmp_fix_tail.py`
- `tmp_fix_html_step1.py`
- `fix_html2.py`

### 当前结论

- `branch_tree.html` 已从“修复占位页”升级为可交付的风格化阅读页 ✅
- 项目根目录临时 HTML 修复脚本已清理，目录可读性提升 ✅

---

## 十六、2026-05-11 角色口径修正：塞西尔设定重写

### 变更内容

- 塞西尔与卡修斯继续保持为两个独立角色
- 塞西尔去掉“精灵”种族设定
- 塞西尔性格调整为：温柔亲和、总是微笑（经典弓箭手气质）
- 卡修斯保持原设：红发蓝眼、旅行法师、高傲冷淡

### 同步文件

- `game/script.rpy`
- `text_runner.py`
- `story_text.txt`
- `角色设定集.md`
- `世界观设定集.md`
- `branch_tree.html`

---

## 十七、2026-05-11 终稿同步：文风分层与分支代价机制

### 本轮目标

- 设定文档回到“简洁、克制、明了”的策划口径
- 玩家可见叙事文本保持华丽哥特质感，语气靠近《密教模拟器》
- 结局分支改为“收益与代价并行”表达，结构参照《苏丹的游戏》的取舍感
- 同步更新 `branch_tree.html` 与日志记录

### 已完成内容

- 设定集三拆分文件重写为简洁版：
  - `角色设定集.md`
  - `世界观设定集.md`
  - `系统策划案.md`

- `story_text.txt` 全篇重写为互动叙事版：
  - 保留五周目与六结局
  - 文风转向冷感、诗性、具象细节驱动
  - 保持最新角色口径（塞西尔弓手、卡修斯旅行法师）

- `branch_tree.html` 继续同步更新：
  - 结局卡片已明确标注每条分支代价
  - 新增“分支原则 / Trade-off Rule”节点，定义关系/人身/秩序三轴代价

### 日志同步说明

- 项目主日志 `DEVELOPMENT_LOG.md` 已记录本轮全部变更
- 运行时日志 `log.txt` 保持引擎原始输出，不做内容改写

---

## 十八、2026-05-11 深夜补充：新增医师角色卢西恩

### 新增角色

- 名称：卢西恩
- 外观：淡金色头发，雾蒙蒙的灰蓝色眼睛
- 身份：经典西幻冒险小队医师

### 文档更新

- `角色设定集.md` 已扩展为详细版：
  - 奈尔、米迦、塞西尔、卡修斯均补充了动作习惯、能力侧重、弱点代价
  - 新增卢西恩的医疗专长、战术价值、潜在线索、弱点代价
  - 关系摘要升级为五人协同关系网

- `branch_tree.html` 角色结构区已同步加入卢西恩

---

## 十九、2026-05-11 终夜补充：世界观扩写（经典西幻参考）

### 变更目标

- 在不破坏主线口径的前提下扩充世界观深度
- 引入经典西幻常见结构：古王道、边境诸城、遗迹文明、誓约法理、游历学团
- 保留本作核心：轮回裂隙与代价型结局

### 已完成内容

- `世界观设定集.md` 已重写为扩充版：
  - 新增地理板块、势力结构、信仰体系、魔法传统、历史分期
  - 明确“施术代价”与“冒险队医师位”的系统意义
  - 统一角色口径为五人（含卢西恩）

---

## 二十、2026-05-11 深夜联调：暗骰与隐藏丝线值

### 联调目标

- 确认暗骰机制仍可正确触发
- 恢复并统一“命运的丝线”判词
- 新增隐藏数值分支，让结局由“显性属性 + 暗骰 + 隐线值”共同决定

### 已做改动

- `game/script.rpy`
  - 新增 `fate_message(result)`，统一四类丝线文案
  - 检定节点恢复 `fate_notify` 实际调用
  - 新增四个隐藏值：`thread_mercy` / `thread_obsession` / `thread_erosion` / `thread_revelation`
  - 各周目补充新选项，隐性增减隐藏值并通过叙事暗示反馈
  - 终局改为“隐藏值 + 暗骰 + 主检定”联合分流

- `text_runner.py`
  - 丝线判词与 Ren'Py 版同词条
  - 同步新增隐藏值及多选项隐性变化
  - 终局分流条件与 Ren'Py 版保持一致

- `story_text.txt`
  - 判定摘要段改为丝线同词条
  - 补充隐藏值说明与联合分流逻辑
  - 五周目选项列表新增“隐线分支”并附隐晦暗示

---

## 二十一、2026-05-11 深夜补充：开发速查与文学化角色片段

### 本轮新增

- `branch_tree.html` 新增“隐藏数值分支速查表（仅开发用）”
  - 记录五周目新增隐线选项与增减值
  - 记录 AUTHOR/THRONE/CANDLELIGHT/CYCLE 的隐线倾斜门槛

- `角色设定集.md` 新增“文学风格角色切片（开发参考）”
  - 场景：雨夜小旅馆大厅
  - 人物：卢西恩
  - 用于统一角色文案在高质感写法下的落地语气

---

## 二十二、2026-05-11 世界观方向升级：遗迹史诗感与隐秘组织感

### 调整意图

- 将世界观从“轻量背景说明”升级为“可扩展叙事底盘”
- 在保持原创名词体系的前提下，引入经典西幻常见层次：
  - 王道兴衰与纪元断裂
  - 边境城邦与遗迹管制
  - 隐秘组织与遗物流通
  - 位阶路径、誓约代价、命名级遗物

### 已更新文件

- `世界观设定集.md`
  - 新增历史分期、地理势力、神秘学法则、宗教仪轨、冒险者生态
  - 增强“表层秩序 + 深层秩序”双层结构
  - 明确与当前玩法系统（隐藏值、暗骰、代价分支）的映射关系

---

## 二十三、2026-05-11 名称升级与世界观词条回灌

### 调整目标

- 将项目主名从《轮回之渊》统一升级为《雾灯残页》
- 把设定集中的关键词条以低频方式植入主线文本，增强“在地感”

### 本轮改动

- 全局标题统一
  - `game/options.rpy`：`config.name` 改为 `雾灯残页`，窗口标题改为 `Mistlamp Fragments`
  - `game/screens.rpy`：主菜单中英标题同步更新
  - `branch_tree.html`、`story_text.txt`、三份设定集与本日志标题改为新名

- 剧情词条回灌（克制植入）
  - `game/script.rpy`
    - 开场加入“晦历第五年”“边境议会告示”
    - 第一轮加入“边境议会旧税印”“旧殿看守团巡铃”
    - 第二轮神殿场景加入“旧殿看守团残封条”
    - 第三轮卡修斯背景加入“游历学团”
    - 第四、五轮补入“七灯教义”与“卢西恩灯下处理”
  - `text_runner.py`
    - 与 Ren'Py 版同步上述词条，维持三端叙事口径一致

---

## 二十四、2026-05-11 终局扩容：七轮回结构与经句化文本

### 调整目标

- 增加轮回次数与结局数量，支持不同周目数进入不同终局
- 在不破坏原有暗骰与隐藏值体系前提下，加入经句化神秘文本

### 本轮改动

- `game/script.rpy`
  - 轮回结构从固定五轮扩容为“可在第5/6/7轮进入终局”
  - 新增 `loop_six`、`loop_seven`
  - 第五轮与第六轮新增“立即推门 / 延后推门”分歧
  - 新增隐藏标记 `scripture_mark`，用于承接经句化选择
  - `final_resolution` 新增基于周目数的分流条件（`loop_count`）
  - 新增三个结局：
    - `ending_pilgrim`（早推门倾向）
    - `ending_judgement`（七轮高启示倾向）
    - `ending_covenant`（七轮高仁慈倾向）
  - 植入多处“圣经中译语感”的低频句式（审判、定期、窄门、承受地土等）

---

## 二十五、2026-05-11 机制追加：每轮可触发提前结局

### 调整目标

- 让每一轮回都具备“提前收束”可能性
- 用“属性 + 隐藏值 + 暗骰”联合判定，而非仅在最终门前结算

### 本轮改动

- `game/script.rpy`
  - 新增公共判定标签 `early_resolution_check(stage)`
    - 输入当前轮次 `stage`
    - 使用暗骰值（`meta_roll`）作为触发门槛
    - 联合 `awareness/tenacity/sync/authority/meta_awareness` 与四条隐线值、`scripture_mark` 做分流
  - 在 `loop_one` 至 `loop_seven` 的尾部统一挂接：
    - 每轮 `loop_count += 1` 后调用 `call early_resolution_check(loop_count)`
    - 命中则直接跳入对应结局（提前结束）
    - 未命中则进入下一轮或常规 `final_resolution`

---

## 二十六、2026-05-11 文风统一：去口语化与神秘语气全程化

### 调整目标

- 删除出戏与轻佻口语，保持全程“神神叨叨”的一致气质
- 三端文本同步（Ren'Py / 终端试玩 / 文本稿）

### 本轮改动

- `game/script.rpy`
  - 删除“温柔的人有福了”句式，改为原创抄本语感句
  - 替换“兄弟/火锅/桌面/发疯/路费/高达五点”等口语化表达
  - 对关键对话进行神秘语气改写（旅人、卷页、夜色、誓约等词系）

- `text_runner.py`
  - 同步替换同批口语表达
  - 开场叙述由“主线支线梗”改为神谕化叙述
  - AUTHOR 结局“桌面”表述改写为“夜色”落点

- `story_text.txt`
  - 同步替换“兄弟/桌面”等词
  - 选项与终局描写改为同语系（账簿、夜色等）

---

## 二十七、2026-05-11 人设语气校准与分支图同步

### 调整目标

- 角色台词进一步贴合人设，不让语气偏离角色功能
- 将“台词校验规则”并入 `branch_tree.html`，用于剧情设计联查

### 本轮改动

- `game/script.rpy`
  - 塞西尔台词从直接喊杀改为“温和但锋利”的表达
  - 米迦在高压节点的措辞改为“草根感 + 末日压迫感”混合语气

- `text_runner.py`
  - 同步塞西尔关键台词改写，确保终端版口径一致

- `branch_tree.html`
  - 主流程更新为 1~7 周目并标注“每轮提前结局判定”
  - 结局图补齐 `PILGRIM` / `JUDGEMENT` / `COVENANT`
  - 隐藏值速查表加入 `scripture_mark` 与 Loop6/7 规则
  - 新增“角色台词口径检查（审稿用）”区块，供开发时快速校对

---

## 二十八、2026-05-11 凌晨补记：终端版与文本稿周目口径回归

### 调整目标

- 将 `text_runner.py` 与 `story_text.txt` 统一到 5/6/7 周目结构
- 避免“终端可玩内容”与“文本说明文档”再次漂移

### 本轮改动

- `text_runner.py`
  - 新增 `early_resolution_check(state, stage)`，把“每轮末提前结局判定”落地到终端版
  - 第五轮补充“今夜就推门 / 再观一轮风向”双分歧
  - 新增 `loop_six`、`loop_seven`，流程改为可在第 5/6/7 轮进入终局
  - 新增结局函数：`ending_pilgrim` / `ending_judgement` / `ending_covenant`
  - 状态新增：`scripture_mark`、`rush_to_final`
  - `main()` 重构为动态流程控制，不再固定仅五轮

- `story_text.txt`
  - 新增 `LOOP SIX`、`LOOP SEVEN` 结构说明
  - 第五轮选项补齐“立即推门 / 延后推门”口径
  - 结局文本补齐 `PILGRIM` / `JUDGEMENT` / `COVENANT`
  - 判定摘要增加 `scripture_mark` 与“每轮末提前结局判定”说明

### 状态结论

- 终端试玩流程与文本结构已统一为 5/6/7 周目口径 ✅
- 新增三结局与隐藏标记在“玩法实现”和“文档说明”两侧均完成对齐 ✅

---

## 二十九、2026-05-11 凌晨补记：终局分支哲学化口径（苏丹式）

### 调整目标

- 终局表达从“好坏结局”改为“哲学偏向结局”
- 强化“命运 / 个体 / 未知”三轴叙事，不做道德裁决

### 本轮改动

- `系统策划案.md`
  - 重写“终局分支原则”：
    - 不设置绝对优劣，只提供不同立场与后果
    - 每条分支必须同时给收益与可见代价
    - 文案禁用“正确/错误结局”表述，统一为“倾向/余波/后果”
  - 新增“三条哲学轴”定义：
    - 命运轴（接受/改写/反噬）
    - 个体轴（保全/交换/溶解）
    - 未知轴（拥抱/利用/拒绝）
  - 新增“分支呈现规则”：
    - 每个终局标注主要偏向轴与次要代价轴
    - 同时交代即时收益与延迟后果
  - 终局映射从“当前六结局”升级为“当前九结局”口径，纳入 `PILGRIM` / `JUDGEMENT` / `COVENANT`

### 状态结论

- 终局设计口径已从“价值判断”转为“立场选择 + 代价承担” ✅
- 文档层已与当前多结局结构保持一致，便于后续剧情与分支图同步 ✅

---

## 三十、2026-05-11 凌晨补记：Branch Tree 三轴同步与界面收敛

### 调整目标

- 将“哲学偏向三轴”落实到 `branch_tree.html` 的结局卡片文案
- 修复页面信息杂乱问题，统一阅读层级
- 补齐卢西恩在流程与终局中的结构性位置

### 本轮改动

- `branch_tree.html`
  - UI 重排：
    - 从“横向流程拼图”改为“分区式阅读布局”（主流程 / 规则 / 三轴 / 角色 / 结局 / 速查）
    - 移除“正向/失败”色彩语义，避免好坏暗示
    - 收敛视觉层级：统一纸卡样式、间距、标题线与结局卡信息密度
  - 三轴同步：
    - 顶部图例改为命运轴 / 个体轴 / 未知轴
    - 新增三轴说明卡，明确各轴的选择语义与代价方向
    - 九结局卡片全部改为“偏向 + 条件 + 代价”格式，并标注主导轴
  - 卢西恩补齐：
    - 角色区补强卢西恩定位：损耗托底与代价缓冲
    - 新增“卢西恩介入节点”卡片，明确 Loop5/Loop6/COVENANT 的介入职责
    - 将 COVENANT 的长期代价承接关系明确写入结局卡文案

### 状态结论

- `branch_tree.html` 已从“价值分类图”转为“哲学偏向图”，与策划口径一致 ✅
- UI 可读性与信息组织显著收敛，开发审阅与后续同步成本下降 ✅
- 卢西恩不再是角色列表挂名，已进入流程与终局的机制语义层 ✅

---

## 三十一、2026-05-11 凌晨补记：结局卡三轴筛选交互

### 调整目标

- 为 `branch_tree.html` 的九结局卡增加轻量筛选能力
- 在不破坏阅读连续性的前提下，提高审稿与策划联查效率

### 本轮改动

- `branch_tree.html`
  - 新增筛选工具条：`全部 / 命运轴 / 个体轴 / 未知轴`
  - 为九张结局卡增加 `data-axis` 标记（`fate` / `self` / `unknown`）
  - 新增轻量交互脚本：
    - 点击筛选按钮时切换 `is-active`
    - 非命中卡片添加 `is-hidden` 并从网格隐藏
  - 新增交互样式：
    - 筛选按钮 hover 与 active 态
    - 结局卡隐藏态样式，保持视觉干净

### 状态结论

- 结局图已支持按哲学三轴快速过滤，阅读与审稿效率提升 ✅
- 交互为前端静态增强，不影响现有剧情数据与同步基线 ✅

---

## 三十二、2026-05-11 凌晨补记：三轴筛选计数与九结局深写

### 调整目标

- 为结局筛选提供即时可见的小计数反馈（如“命运轴 3 / 9”）
- 深挖九个结局文本，强化“哲学偏向 + 代价余波”的终局质感
- 保持引擎版、终端版、文本稿三端叙事口径一致

### 本轮改动

- `branch_tree.html`
  - 在筛选工具条新增计数提示：`全部 9 / 9`，并随筛选实时更新
  - 新增计数脚本逻辑：按当前 axis 统计可见结局卡数量
  - 新增计数样式：不抢主视觉，保留阅读优先

- `game/script.rpy`
  - 九个结局段落均扩写为“当下结果 + 延迟后果”结构
  - 强化每条结局的哲学偏向：命运控制、个体交换、未知触碰三轴更明确
  - 新增结局余波句：避免“落幕即结束”的平面收束

- `text_runner.py`
  - 同步九结局扩写文本，保持终端试玩体验与引擎版一致
  - 保留现有触发逻辑，仅增强结局叙事密度

- `story_text.txt`
  - 九结局文本段同步扩写
  - 文本说明与可玩文本保持同一语义落点，降低后续漂移风险

### 状态结论

- 三轴筛选现在具备“可过滤 + 可计数”双反馈，审稿定位更快 ✅
- 九结局从“短描述”升级为“立场选择后的命运余波”，哲学取向更清晰 ✅
- 三端文本口径已再次对齐，后续可在同一基线上继续精修 ✅

---

## 三十三、2026-05-11 深夜补记：九结局三轴分组风格化 + 角色印象锚点优化

### 调整目标

- 将九结局按三轴做可视分组，并强化语言风格差异
  - 命运轴：冷峻、裁决感、流程感
  - 个体轴：肉身、触感、伤痛与呼吸
  - 未知轴：神谕、经文、启示与自白
- 给角色设定增加“可执行的记忆点设计方法”，提升辨识度与记忆留存

### 本轮改动

- `branch_tree.html`
  - 结局区由“九卡平铺”调整为“三轴分组展示”
  - 新增分组标题：`命运轴（冷峻）` / `个体轴（肉身）` / `未知轴（神谕）`
  - 筛选逻辑升级：筛选时自动隐藏空分组，并保留小计数显示

- `game/script.rpy`
  - 九结局二次深写，按三轴明确区分语言肌理
  - 命运轴结局强化“法令/归档/流程不可撤销”语义
  - 个体轴结局强化“脉搏/肋骨/呼吸/伤口”语义
  - 未知轴结局强化“经文/启示/自白/句子外”语义

- `text_runner.py`
  - 与引擎版同步九结局风格差异与关键意象

- `story_text.txt`
  - 九结局文本同步三轴语言分层，保持文档与可玩文本一致

- `角色设定集.md`
  - 新增“角色设定强化方案（印象锚点执行版）”
  - 给出四枚印象锚点方法：视觉锚点 / 行为锚点 / 语言锚点 / 代价锚点
  - 为五名核心角色补齐可执行优化项与“不可替代场景”定义
  - 新增写作落地模板，便于编剧在章节中稳定复用

### 状态结论

- 结局已实现“结构分组 + 文风分层 + 交互筛选”三位一体呈现 ✅
- 角色优化从“描述型设定”升级为“可写、可演、可复用”的执行标准 ✅

---

## 三十四、2026-05-11 深夜补记：五角色首登场30秒记忆镜头落地

### 调整目标

- 为五名核心角色补入“首次登场30秒记忆镜头”
- 让玩家在首轮接触时就建立稳定的角色记忆锚点
- 直接植入 `script.rpy` 首登场位置，便于即刻试玩验证

### 本轮改动

- `game/script.rpy`
  - 奈尔：开场村口段新增首镜头（退路优先观察 + 冷光眼神）
  - 米迦：Loop1 首见段新增首镜头（笑容缓压 + 锈剑护手 + 前顶动作）
  - 塞西尔：Loop1 黄昏出场段新增首镜头（温和语气 + 试弦前静场）
  - 卡修斯：Loop3 入场段新增首镜头（结论先行 + 代价后置）
  - 卢西恩：Loop4 首次提及段新增首镜头（先摸脉后说话 + 止血优先）

### 状态结论

- 五角色“首次30秒记忆镜头”已可直接从首轮流程中感知，不依赖后续补叙 ✅
- 角色辨识度提升路径从“设定文档”推进到“可玩文本首触点” ✅

---

## 三十五、2026-05-11 深夜补记：五角色小传与文学切片全量补齐

### 调整目标

- 为五名核心角色补齐“人物小传”，增强历史感与命运连续性
- 基于19世纪西方小说写法，为每个角色新增可复用的“外貌 + 神态 + 场景”切片
- 使设定集可直接服务编剧、宣发与台词迭代

### 本轮改动

- `角色设定集.md`
  - 新增 `人物小传（设定集补充）`：
    - 奈尔 / 米迦 / 塞西尔 / 卡修斯 / 卢西恩 各一段
    - 聚焦“出身脉络 + 当前矛盾 + 代价来源”
  - 重构 `文学风格角色切片（五人开发参考）`：
    - 每人一段独立切片，均包含外貌细节、动态神态、场景呼应
    - 语言层面区分角色气质：奈尔冷压、米迦外热、塞西尔温刃、卡修斯理锋、卢西恩稳缓
  - 移除原“仅卢西恩单段切片”结构，升级为五人齐备版本

### 状态结论

- 角色设定已从“参数描述”升级为“可直接用于正文生成”的文学化素材库 ✅
- 五角色在设定集内实现“能力信息 + 人物命运 + 文风切片”三层闭环 ✅

---

## 三十六、2026-05-11 深夜补记：性格决定命运规则化落地

### 调整目标

- 将“性格极大程度决定命运”从主题口号升级为设定与系统的硬规则
- 在人物设定与故事设定中同时建立可追溯链路

### 本轮改动

- `角色设定集.md`
  - 新增 `性格决定命运映射（角色级规则）`
  - 为五名角色补齐“性格 -> 决策偏好 -> 代价 -> 命运偏向”链路
  - 新增写作约束：每章必须出现性格驱动决策与代价回响

- `世界观设定集.md`
  - 新增 `性格-命运耦合法则（故事设定核心）`
  - 明确三条世界规则：
    - 选择惯性规则
    - 代价放大规则
    - 反性格突变规则
  - 建立与三轴终局的映射，确保“命运/个体/未知”可由性格反推

- `系统策划案.md`
  - 新增 `性格驱动命运（系统落地）`
  - 强化分支设计原则：关键选项需显式对应角色性格方向
  - 增加可回溯性要求：终局必须能从多轮选择习惯推断

### 状态结论

- “性格决定命运”已在人物层、世界层、系统层形成闭环，不再依赖临场文案发挥 ✅
- 后续写作与分支迭代可按同一规则检查一致性与可解释性 ✅

---

## 三十七、2026-05-11 凌晨补记：分支审稿清单与世界观精修（西幻基底）

### 调整目标

- 提供可直接执行的“分支审稿清单”（10条以内）
- 对世界观进行结构化精修，统一西幻主基底与神秘学叙事
- 吸收多部作品的长处到“规则层”，避免文本层同质化借用

### 本轮改动

- `系统策划案.md`
  - 新增 `分支审稿清单（9条）`
  - 覆盖审稿关键：性格驱动、变量变化、收益与代价、三轴归属、余波回响、可回溯性

- `世界观设定集.md`
  - 重写为单一版本，清理历史重复段与冲突口径
  - 新增 `风格参考提炼（用于把控语气，不用于照搬）`
  - 完整重构章节：世界总览、历史主线、地理版图、权力结构、信仰古语、位阶路径、遗物法则、誓约代价、医疗生态
  - 强化 `性格-命运耦合法则（核心）` 与三轴终局映射
  - 明确创作硬性要求：关键转折必须由性格驱动决策触发

### 状态结论

- 分支审稿已具备统一打勾标准，可用于后续每轮剧情评审 ✅
- 世界观从“信息汇总”升级为“可指导写作与系统实现”的规则底盘 ✅
- 西幻气质、神秘学机制、政治现实三条线已在同一文档内完成一致化 ✅

---

## 三十八、2026-05-11 凌晨补记：势力冲突年表与术语统一（锚点化）

### 调整目标

- 输出可直接喂给主线/支线的势力冲突事件池（10-12条）
- 将“印象钉”相关术语统一为“印象锚点”口径

### 本轮改动

- `世界观设定集.md`
  - 新增 `势力冲突年表（事件池 / 12条）`
  - 覆盖五大势力：议会 / 学团 / 看守团 / 商盟 / 雾灯会
  - 每条均含“冲突背景 + 主线可用 + 支线可用”三段，支持直接拆任务

- `角色设定集.md`
  - 术语统一：`印象钉` -> `印象锚点`
  - 同步替换子项：视觉/行为/语言/代价四类锚点
  - 写作模板口径同步为“锚点触发链”

- `系统策划案.md`
  - 审稿清单术语统一：`台词钉` -> `台词锚点`

- `DEVELOPMENT_LOG.md`
  - 历史条目术语同步改写为“印象锚点”版本

### 状态结论

- 势力冲突已形成可执行事件池，主支线素材可直接抽取 ✅
- 术语体系已统一为“锚点”口径，避免后续文档与沟通混用 ✅

---

## 三十九、2026-05-11 凌晨补记：事件池周目标注与禁令文本清理

### 调整目标

- 为 12 条势力事件补齐“周目建议 + 优先级”字段，便于直接排入 `script.rpy`
- 对三份设定文档执行禁令扫描与文本清理，移除违规句式与禁用词

### 本轮改动

- `世界观设定集.md`
  - 12 条事件均新增：
    - 周目建议（Loop1-7 区间）
    - 优先级标签（P1 / P2 与使用说明）
  - 事件池结构升级后可直接用于主线排程与支线分发
  - 同步清理禁令命中句式，调整为画面化、动作化表达

- `角色设定集.md`
  - 清理禁令命中表达（含对比否定句式与套话）
  - 维持原设定含义，改为可直接用于正文的自然叙述句

- `系统策划案.md`
  - 清理禁令命中表达，审稿清单语句改为正向执行描述

### 状态结论

- 事件池已具备“年份 + 冲突 + 周目 + 优先级 + 主支线用法”完整字段 ✅
- 三份设定文档禁令扫描结果已归零，后续可作为干净基线持续迭代 ✅

---

## 四十、2026-05-11 凌晨补记：势力事件周目接入可玩脚本

### 调整目标

- 将 12 条势力事件直接接入 `script.rpy` 周目流程
- 保持终端试玩版与文本稿、分支图同步，避免实现层与文档层偏离

### 本轮改动

- `game/script.rpy`
  - 在 Loop1-Loop7 起始段新增“势力事件窗口”叙事块
  - 按排程接入主事件与侧事件信息，覆盖五大势力矛盾链
  - 保持现有检定与分流逻辑不变，优先完成可玩层叙事接入

- `text_runner.py`
  - 同步新增 Loop1-Loop7 势力事件窗口叙事
  - 与引擎版保持同一事件顺序与信息密度

- `story_text.txt`
  - 每个周目新增“本轮势力事件窗口（建议排程）”
  - 明确主事件 / 侧事件与 P1/P2 标签

- `branch_tree.html`
  - 新增“势力事件周目排程（已接入）”区块
  - 展示 Loop1-Loop7 对应事件与优先级，便于快速审阅

### 状态结论

- 势力事件已进入可玩主流程，后续可直接扩写为任务分支 ✅
- 四端口径同步完成：引擎脚本 / 终端脚本 / 文本稿 / 分支图 ✅

## 四十一、终端存档系统与分支图细化

### 本次目标

- 给 `text_runner.py` 增加存档能力，支持：
  - 新游戏覆盖旧进度
  - 继续上次进度
  - 开启新周目并继承已见结局
- 将 `branch_tree.html` 补成“选项 -> 剧情节点 -> 结局倾向”的可读示意图

### 变更内容

- `text_runner.py`
  - 新增本地存档文件 `text_runner_save.json`
  - 新增状态工厂与存档方法：`build_new_state`、`save_progress`、`load_progress`、`delete_save`
  - 新增新周目继承逻辑：`start_new_cycle_from`
  - 新增开始菜单：`select_start_state`
  - 重构主流程为 `run_story(state)`，按 `loop_count` 自动续跑
  - 每轮结束自动写盘，提前终局与最终终局都会标记 `run_finished` 并保存
  - 新增跨轮统计字段：`completed_runs`、`ng_plus_count`

- `branch_tree.html`
  - 新增“分支示意图（选项 -> 剧情 -> 结局）”区块
  - 细化 Loop1-Loop7 的关键选择、对应剧情节点与目标终局池
  - 补充各轮关键变量流向提示，便于对照 `text_runner.py` 与 `script.rpy` 做分支审阅

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints` 检查：`text_runner.py`、`branch_tree.html` 无新增报错

## 四十二、分支图升级为连线图 + 人物差分落地

### 本次目标

- 将 `branch_tree.html` 升级为真正的节点化分支图，支持折叠查看每轮路径。
- 让 `角色设定集.md`、`game/script.rpy`、`text_runner.py` 的人物台词和行为体现出身、年龄、训练路径与过往经历差异。

### 变更内容

- `branch_tree.html`
  - 将原“文字列表式分支”替换为“节点 + 箭头”连线布局
  - 新增可折叠 `details` 路径块，按 Loop1-Loop7 展示双通道关键路线
  - 每条路径拆成四类节点：选项节点、剧情节点、数值节点、结局池节点
  - 增加移动端降级样式，窄屏自动改为纵向阅读

- `角色设定集.md`
  - 新增 `台词与表现差分规约（脚本直连版）`
  - 为奈尔/米迦/塞西尔/卡修斯/卢西恩分别定义词汇场、句式偏好、动作锚点与冲突目标顺序
  - 给出可执行清单，约束后续脚本写法不再混声

- `game/script.rpy`
  - 新增角色定义：`define lucien = Character("卢西恩")`
  - 强化米迦语气中的边境生存背景与贫地经历
  - 强化塞西尔“礼貌命令 + 控场术语”风格
  - 强化卡修斯“变量阈值 + 代价声明”风格
  - 新增卢西恩台词，体现医师流程感与年龄/旧伤风险判断

- `text_runner.py`
  - 同步 `script.rpy` 的角色语气分层，覆盖关键节点对白
  - 新增卢西恩对白，使终端版与引擎版口吻一致
  - 保留原分支数值逻辑，只改叙事表现层

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints` 检查：`branch_tree.html`、`game/script.rpy`、`text_runner.py`、`角色设定集.md` 无新增报错

## 四十三、台词改为含蓄传达 + 第二层差分全周目替换

### 本次目标

- 取消“直接用台词交代出身/年龄/家庭背景”的写法，改为含蓄传达。
- 在 `script.rpy` 做五人全周目台词二次替换，覆盖不止关键节点。
- 给五人补充“禁用词 + 句长范围 + 情绪触发词”硬约束，避免后续串味。

### 变更内容

- `game/script.rpy`
  - 对 Loop1-Loop7 与结局段内五人对白进行系统替换
  - 清理直白背景台词（如直接报年龄、受训体系、成长经历等）
  - 改为动作、词汇偏好、语气节奏传达信息：
    - 奈尔：短句指令、路径与代价导向
    - 米迦：生存语汇、先抬压后扛压
    - 塞西尔：礼貌壳 + 控场命令
    - 卡修斯：变量/阈值/代价表达
    - 卢西恩：医疗流程优先

- `text_runner.py`
  - 同步上述隐含式台词风格，避免终端版与引擎版口径漂移
  - 同步移除直白背景信息表达

- `角色设定集.md`
  - 新增 `第二层差分控制表（扩写硬约束）`
  - 为五人分别定义：禁用词、单句长度范围、情绪触发词
  - 新增执行规则：禁用词扫描、句长回调、场景触发词命中

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`script.rpy`、`text_runner.py`、`角色设定集.md`、`branch_tree.html` 无新增报错
- 关键直白词扫描：`script.rpy` / `text_runner.py` 均无残留（十六岁、二十三岁、边境长大、货栈、军校教范）

## 四十四、旁白污染分级接入 + 台词活人感复检

### 本次目标

- 让同一“门前事件”在不同陪同主导下改变旁白镜头（气味/触感/词汇入口变化）。
- 再做一轮台词活人感校准，避免平铺直叙。
- 每次改动继续同步日志。

### 变更内容

- `game/script.rpy`
  - 新增 `pick_companion_lens` 与 `tinted_gate_narration` 两个函数
  - 在 `loop_four` 到 `loop_seven`、`final_resolution` 接入污染旁白
  - 旁白镜头按五类主导切换：`neutral / mika / cecil / cassius / lucien`
  - 复检并改写多处对白，增加语气节奏与口语温度，保持角色设定边界

- `text_runner.py`
  - 同步新增 `pick_companion_lens`、`tinted_gate_narration`
  - 在 `loop_four` 到 `loop_seven` 与 `final_resolution` 接入同一旁白污染机制
  - 同步台词活人感修订，保证终端版与引擎版口径一致

- `角色设定集.md`
  - 新增 `旁白污染度分级（镜头层）`
  - 新增 `台词活人感校准` 规则，明确语气词、停顿、短命令句、条款句等使用边界

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`script.rpy`、`text_runner.py`、`角色设定集.md` 无新增报错
- 直白信息残留扫描：`script.rpy`、`text_runner.py` 无目标词残留

## 四十五、旁白污染强度改为周目内动态 L0/L1/L2

### 本次目标

- 将旁白污染从静态镜头切换升级为同一周目内动态强度切换。
- 满足“越接近终局，镜头污染越明显”。

### 变更内容

- `game/script.rpy`
  - 新增 `calc_lens_level(stage, ...)`，返回 `L0/L1/L2`
  - `tinted_gate_narration` 扩展参数：`(stage_key, lens, level, phase)`
  - 增加 `entry/post` 两段尾部强度文本，用于周目内前后对比
  - 在 `loop_four` 到 `loop_seven` 中，改为“菜单前取一次 + 菜单后再取一次”
  - 在 `final_resolution` 接入 `L2` 侧重计算，终局前镜头默认更易抬强

- `text_runner.py`
  - 同步新增 `calc_lens_level(stage, state)`
  - 同步扩展 `tinted_gate_narration(..., level, phase)`
  - 同步在 `loop_four` 到 `loop_seven` 做 entry/post 双采样
  - `final_resolution` 同步使用高阶段强度计算

### 动态规则摘要

- 基础强度随阶段上升：中段进入 `L1`，高轮次默认趋向 `L2`
- 强度再受隐线压力影响（元认知、启示、经句、侵蚀、权能）
- 同一周目内，玩家选择会改变数值并触发 post 镜头重算

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`script.rpy`、`text_runner.py`、`角色设定集.md`、`DEVELOPMENT_LOG.md` 无新增报错

## 四十六、branch_tree 增加污染预览层与可展开结局正文

### 本次目标

- 在 `branch_tree.html` 增加“污染强度预览层”（L0/L1/L2 按钮切换）。
- 为分支图增加可点击展开的“详细结局文本同步查看”。

### 变更内容

- `branch_tree.html`
  - 新增 `污染强度预览层（L0 / L1 / L2）` 卡片
  - 新增强度按钮、状态显示、四个镜头预览块（Loop4、Loop5、Loop6、Final）
  - 每个预览块配置 `data-l0 / data-l1 / data-l2` 文案，便于前端切换
  - 新增 `结局文本同步查看（可展开）` 卡片，覆盖九结局正文摘要
  - 每个结局使用 `details/summary` 折叠结构，支持点击展开阅读
  - 扩展前端脚本：加入 `applyLensLevel(level)` 与按钮交互逻辑

### 验证

- `ReadLints`：`branch_tree.html` 无新增报错

## 四十七、结局文本切换为摘要/全文模式 + story_text 文风修订

### 本次目标

- 将 `branch_tree.html` 的结局查看升级为“摘要版 / 脚本全文版”一键切换。
- 让分支图内“全文版”直接展示 `script.rpy` 当前版本的结局正文。
- 同步修订项目内 txt 文稿中的结局文本，降低模板化语感，增强文学氛围。

### 变更内容

- `branch_tree.html`
  - 在 `结局文本同步查看` 卡片中新增模式切换工具栏：
    - `摘要版`
    - `脚本全文版`
  - 每个结局条目新增两层正文：
    - `.summary-copy`（摘要）
    - `.full-copy`（全文，默认隐藏）
  - 前端脚本新增 `applyEndingMode(mode)`，实现模式切换与状态提示联动
  - 全文内容按 `script.rpy` 当前结局段对齐整理

- `story_text.txt`
  - 重写 `DAWN / CANDLELIGHT / THRONE / ASCENSION / CYCLE / AUTHOR / PILGRIM / JUDGEMENT / COVENANT`
  - 在保持分支含义不变的前提下，增强意象密度、呼吸节奏与情绪回响
  - 避免平铺说明句，改为“动作 + 感官 + 余波”叙述方式

### 验证

- `ReadLints`：`branch_tree.html`、`story_text.txt` 无新增报错

## 四十八、将重写结局同步进可玩脚本

### 本次目标

- 把 `story_text.txt` 中重写后的九结局文本同步到游戏可玩文件。
- 保证引擎版与终端版结局口径一致。

### 变更内容

- `game/script.rpy`
  - 同步更新九个结局段：
    - `ending_true`
    - `ending_sacrifice`
    - `ending_throne`
    - `ending_ascension`
    - `ending_eternal`
    - `ending_author`
    - `ending_pilgrim`
    - `ending_judgement`
    - `ending_covenant`
  - 统一为新版文案语气：更重画面、触感与余波，不改分支逻辑

- `text_runner.py`
  - 同步更新对应九个结局函数文案
  - 保留原有结局触发条件与状态写回，仅替换叙事文本

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`script.rpy`、`text_runner.py`、`story_text.txt` 无新增报错

## 四十九、按写作禁令回扫并清洗违禁句式

### 本次目标

- 对新近改写文本进行禁令对照回扫，清理违禁句式与高风险模板。
- 保证 `story_text.txt`、可玩脚本、分支图文案口径一致。

### 变更内容

- `story_text.txt`
  - 清理含 `不是……而是……` 结构的结局句
  - 替换为动作导向与画面导向表达，保留原分支含义

- `game/script.rpy`
  - 清理 `ending_pilgrim`、`ending_judgement` 中同类句式
  - 与 `story_text.txt` 保持同一语义口径

- `text_runner.py`
  - 同步清理对应结局函数中的同类句式
  - 保证终端版文案与引擎版一致

- `branch_tree.html`
  - 清理分支原则与角色定位区域内的违禁对比句
  - 清理“结局全文版”中残留的 `不是……而是……` 句式

### 验证

- 违禁模式扫描：`story_text.txt`、`script.rpy`、`text_runner.py`、`branch_tree.html` 未命中目标模式
- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：上述文件无新增报错

## 五十、固定化禁令回扫 + 自动执行 + 备份更新

### 本次目标

- 将“禁令回扫”固化为固定清单与自动检查流程。
- 每次改文案后自动触发扫描。
- 更新备份并再次同步新文本到 `text_runner.py`。

### 变更内容

- 新增固定清单：
  - `文案禁令回扫清单.md`
  - 约定了回扫、同步、备份、日志四步流程

- 新增自动检查脚本：
  - `tools/copy_guard_check.py`
  - 覆盖 `story_text.txt`、`game/script.rpy`、`text_runner.py`、`branch_tree.html`
  - 支持普通模式与 hook 模式（`--hook`）

- 新增项目 Hook：
  - `.cursor/hooks.json`
  - 事件：`afterFileEdit`
  - 命令：`python tools/copy_guard_check.py --hook`
  - 效果：每次文件编辑后自动跑一轮禁令扫描

- 备份更新（时间戳：`20260511_030305`）：
  - `archive/recovery/story_text_backup_20260511_030305.txt`
  - `archive/recovery/script_backup_20260511_030305.rpy`
  - `archive/recovery/text_runner_backup_20260511_030305.py`
  - `archive/recovery/branch_tree_backup_20260511_030305.html`

- `text_runner.py` 再同步：
  - 修正与新文案口径不一致的残留台词，保证与脚本文本一致

### 验证

- `python tools/copy_guard_check.py` 通过
- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py`、`.cursor/hooks.json`、`tools/copy_guard_check.py`、`文案禁令回扫清单.md` 无新增报错

## 五十一、丝线判词精修并三端同步

### 本次目标

- 精修丝线判词（暴击/大失败/成功/失败）文案质感。
- 保持 `story_text.txt`、`script.rpy`、`text_runner.py` 同词条一致。

### 变更内容

- `story_text.txt`
  - 更新判词四条，增强听觉与触感意象：
    - 暴击：细长金鸣
    - 大失败：封河冰裂
    - 成功：低哑弦响
    - 失败：偏斜风缝

- `game/script.rpy`
  - 更新 `fate_message(result)` 四个返回文案

- `text_runner.py`
  - 更新 `roll_check()` 中对应四条 `narrator` 文案

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`story_text.txt`、`script.rpy`、`text_runner.py` 无新增报错

## 五十二、暴击判词去AI腔再精修

### 本次目标

- 将“暴击”判词从偏雕饰表达回调到更自然、更现场化语气。

### 变更内容

- `story_text.txt`
  - 暴击判词改为：`命运的丝线一下拉紧，像有人在你耳边轻轻弹了下铁弦。`

- `game/script.rpy`
  - 同步 `fate_message("critical_success")`

- `text_runner.py`
  - 同步 `roll_check()` 中暴击反馈文本

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`story_text.txt`、`script.rpy`、`text_runner.py` 无新增报错

## 五十三、丝线判词按用户指定版本强制对齐

### 本次目标

- 将丝线判词按 `story_text.txt` 指定版本强制同步到可玩脚本。

### 变更内容

- `game/script.rpy`
  - `fate_message(result)` 改为：
    - 暴击：`命运的丝线一下拉紧，像有人在你耳边轻轻弹拨琴弦。`
    - 大失败：`命运的丝线当场崩断，碎响贴着后颈划过，冰凉。`
    - 成功：`命运的丝线缓缓收束，仿佛能听见一记低哑弦响。`

- `text_runner.py`
  - `roll_check()` 同步上述三条文案

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`story_text.txt`、`script.rpy`、`text_runner.py` 无新增报错

## 五十四、AUTHOR 结局重写（秘仪感版本）并四端同步

### 本次目标

- 按用户指定版本对齐 `story_text.txt` 的丝线判词（290-293）。
- 重写 `AUTHOR` 结局，语气向“秘仪抄录 / 异教仪式感”靠拢，并同步到可玩脚本与可视化页。

### 变更内容

- `story_text.txt`
  - `AUTHOR` 段落改写为“纸页翻身 / 影子裂写 / 墨迹生长”版本。
  - 判词保持为：
    - 暴击：`命运的丝线一下拉紧，像有人在耳边轻轻弹拨琴弦。`
    - 大失败：`命运的丝线当场崩断，碎响贴着后颈划过。`
    - 成功：`命运的丝线缓缓收束，仿佛能听见一记低哑弦响。`
    - 失败：`命运的丝线松开半寸，风从偏斜的缝里灌进来。`

- `game/script.rpy`
  - `label ending_author` 全段同步为新文案。
  - `fate_message(result)` 中暴击词条改为“在耳边”，大失败词条去掉“冰凉”。

- `text_runner.py`
  - `ending_author(state)` 全段同步为新文案。
  - `roll_check()` 中暴击词条改为“在耳边”，大失败词条去掉“冰凉”。

- `branch_tree.html`
  - `AUTHOR（未知轴）` 的摘要版与脚本全文版同步到新文本。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`story_text.txt`、`script.rpy`、`text_runner.py`、`branch_tree.html` 无新增报错

## 五十五、AUTHOR 文风二次重写（龙族气质融合）

### 本次目标

- 将 `AUTHOR` 结局改写为“对话 + 心理跳切 + 神话画面突降”的节奏。
- 保持分支逻辑与信息点不变，仅调整文风表达。

### 变更内容

- `story_text.txt`
  - `AUTHOR` 全段重写：加入口语化心理反应、短促对话、末段画面外延。

- `game/script.rpy`
  - `label ending_author` 全段同步新文案。
  - 保留角色台词节点：米迦提示“页边在收口”、玩家回应“别翻页”。

- `text_runner.py`
  - `ending_author(state)` 全段同步新文案。

- `branch_tree.html`
  - `AUTHOR（未知轴）` 摘要版与全文版同步到新稿。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `python g:\projects\my-vn\tools\copy_guard_check.py`

---

## 一百一十三、2026-05-13：全文本审查与贪心修复（死代码、逻辑断层、叙事衔接）

### 审查范围

通读 `text_runner.py` 全量文本（~3400 行），审查维度：死代码、分支逻辑断层、叙事衔接跳跃、文本修饰缺陷。

### 发现清单（10 项）

| # | 严重度 | 类型 | 位置 | 描述 |
|---|--------|------|------|------|
| 1 | 高 | 死代码 | `week1_first_contact_scene` | 初识场景函数已定义但从未被调用，角色初遇叙事完全断开 |
| 2 | 高 | 逻辑断层 | Loop 7 choice 4 | `_loop6_sided` 有 `"cassius"` / `"cecil"` 分支但无 `None`（未站边）的 else |
| 3 | 高 | 死代码 | `recruited_count` 字段 | `build_new_state` 初始化为 0，三处 `+= 1`，但终局分流从未读取该字段 |
| 4 | 中 | 叙事衔接 | Loop 4 塞西尔名册叙事 | 两段密集旁白在同一 `narrator` 调用内挤作一团，信息过载 |
| 5 | 中 | 铺垫缺失 | Loop 6 choice 4 文本 | "于圣所列像座前的誓石边，折断旧钥匙"——"旧钥匙"无前置提及 |
| 6 | 中 | 描写插入 | Loop 1 玩家外貌 | 银发红眼描写夹在米迦出场对话与玩家自述之间，时序模糊 |
| 7 | 中 | 叙事跳跃 | Loop 2 神殿门口 | 饭后直接跳到"夜里你在神殿门口等到了塞西尔"，无过渡 |
| 8 | 低 | 变量污染 | `dice, bonus, total` | Loop 2/3 用变量名与 `roll_check` 参数名重合，虽无 bug 但可读性差 |
| 9 | 低 | 剧透风险 | Loop 2 choice 1 文本 | "把黄昏刺杀直接摊开"过早暴露核心事件 |
| 10 | 低 | 叙事跳跃 | Loop 4 塞西尔登场 | 塞西尔突然现身大殿，缺进场前导 |

### 贪心修复（P0-P9，按影响降序）

**P0**：在 `run_week_dialogues` 日循环中对每个首次出现的未识认角色调用 `week1_first_contact_scene(speaker_key)`。  

**P1**：为 `loop_seven` choice 4 新增 `else` 分支——`_loop6_sided=None` 时输出中立旁白（门未偏向任何人）。  

**P2**：从 `build_new_state` 删除 `recruited_count: 0`，从 `loop_one`、`loop_two`、`loop_five` 各删一处 `recruited_count += 1`。  

**P3**：Loop 4 塞西尔名册段拆为两次 `narrator` 调用——第一段写肩背叠实与蜡绳，第二段写名册登记与斜印。  

**P4**：Loop 6 choice 4 文本改为 `"折断那枚从旧神殿门缝拾来的钥匙"`，与 Loop 4 门缝叙事形成呼应与前置。  

**P5**：Loop 1 外貌描写（银发贴颈侧、红眼似炉芯、从不先看人脸）从米迦出场与自述之间移至束发黑绳句后、米迦出场句前。  

**P6**：Loop 2 "夜里你在神殿门口等到了塞西尔"前补过渡句——饭后在走廊闲逛时想起塞西尔提过封条的事。  

**P7**：Loop 2/3 中 `dice, bonus, total, success, result = roll_check(...)` 改为 `_r, _stat, _total, success, result`，消除变量遮蔽。  

**P8**：Loop 2 choice 1 文本从 `"把黄昏刺杀直接摊开"` 改为 `"警告他黄昏别独自穿巷"`，降低剧透浓度。  

**P9**：Loop 4 塞西尔登场前补序幕句——"你记得上一轮这个时辰会有弓弦声从暗处传来——便先往暮色里迈步。"  

### 同步文件

- `text_runner.py`：全部 9 项修复落地
- `DEVELOPMENT_LOG.md`：本条

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过

---

## 一百一十四、2026-05-13：角色自报姓名规范化——"我是XX"统一口径

### 变更目标

- 米迦首句由 `"米迦。诶——旅人？"` 改为 `"我是米迦。诶——旅人？"`
- 奈尔开场旁白由 `"你叫奈尔，站在这里。"` 改为 `"你是奈尔，站在这里。"`
- 统一为角色自己口述姓名（或旁白以"是"代"叫"），使首次自报姓名更具呼吸感

### 同步文件

- `text_runner.py`：奈尔 L2273 + 米迦 L2282
- `story_text.txt`：米迦 L73 同步（奈尔段 story_text 结构不同，以 `"你站在村口"` 起头，无对应行）
- `DEVELOPMENT_LOG.md`：本条

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过

---

## 一百一十一、2026-05-13：禁令脚本 + 主角初登场外貌充实

### 脚本化

创建 `tools/ban_check.py`——独立文本禁令回扫脚本，每次生成后可运行自检。扫描项：被禁句式（"不是...而是..."、"在...的过程中"、"不仅...更..."、"很...但很..."、"这就够了"、"的基石/关键/必修课"）、禁用词（兜住/接住/极其）、破折号300字窗口密度。默认目标：`text_runner.py` + `story_text.txt`。支持 `--target` 指定文件。

### 主角初登场外貌

用户指令：禁用"是先声"式抽象概括，改正面侧面结合。

`loop_one`（text_runner.py L2273-2275）由1行扩为3行：
- 银发被晨风撩向颈侧，露苍冷皮肤如不见光石料
- 红眼暗沉似熬过长夜后炉芯，暗下去那一圈比亮着的更沉
- 从不先看人脸——先扫门缝、窗沿、撤退拐角，最后才落对方瞳仁
- 保留收束句："比这些更锋利的一条记性，是你记得自己在这条路上死过很多次"

同步：story_text.txt 叙事行 + 注释切换。角色设定集 2 处同修禁令句式。

### 四角色首登场同步充实（同轮追加）

按奈尔外貌改写口径，米迦/塞西尔/卢西恩/卡修斯首登场均由"发色眼色枚举"改为正面描写 + 侧面烘托 + 动作锚：

| 角色 | 原写法 | 新写法 |
|---|---|---|
| 米迦 | "米迦，棕发，绿眼" | 棕发黏额角汗痕/绿眼先遍扫你全身/圆脸钝角/笑拉嘴角→预热身体/锈剑护手磨亮 |
| 塞西尔 | 仅动作/战术描写 | 窄脸剪影/唇线微抿含判词/紫瞳薄冰映倒影/肩背如风蚀柱→弓梢点地极轻 |
| 卢西恩 | 仅苦橙+铜盘 | 过劳红浮颧骨/灰绿眼先落腕脉→升眉间口唇如翻册/袖口色差带/铜扣旧撞痕未修 |
| 卡修斯 | 已有动作但缺面容 | 红发如沉水铜矿/蓝眼苛刻/翻页用食指指腹顶纸角如拆机关 |

`py_compile` 通过。`tools/ban_check.py` 可独立执行。

---

## 一百一十二、2026-05-13：清除抽象概括名词组成的莫名其妙句子

回扫 `story_text.txt` + `text_runner.py` 结局文本，修复：

| 位置 | 原句 | 改后 |
|---|---|---|
| DAWN | "深层真相被装订成卷，先收进档柜" | 有关那扇门的记录誊成三份，各锁一处 |
| THRONE | "你握住了命运的柄" | "你签过城令的手再也伸不到人前" |
| THRONE | "秩序与权重"/"被懂得…违禁词" | "王座上永远有人，椅子上永远只有一个人" |
| ASCENSION | "代价不落在伤口上，而落在记忆里" | "代价不在伤口上——在舌根" |
| ASCENSION | "新人间的火种"/"给新世界命名" | "每一步都踩在还没干透的墨上"/风剥出发理由的壳 |
| COVENANT | "痛会复写，愈合也会复写" | "你们把同一张纸分成五份，谁也绕不开谁的手腕" |
| JUDGEMENT | "可读的真相镜"/"镜背里发冷的锡" | 名字刻进灯台石砖/被越摸越浅却没人擦掉 |
| 注释 | "外貌描写正面侧面结合" | → "外貌" |

原则：每句抽象概括替换为可感知的物象或动作。`py_compile` 通过。

---

## 一百零九、2026-05-13：新冲突轴引入（4项·叙事跌宕提升）

| # | 名称 | 位置 | 内容摘要 | 变量影响 |
|---|---|---|---|---|
| C1 | 卢西恩退队危机 | Loop5 末 | 兵变伤员潮→放弃轻伤员→米迦质问→止血带折四层→沉默 | lucien_bond/thread_mercy/thread_obsession +1 |
| C2 | 塞西尔vs卡修斯 | Loop6 选项前 | 钟楼下二人各执一词（坐标先拿vs读前须备）；选项②站塞西尔、③站卡修斯 | _loop6_sided 写入 |
| C3 | 米迦终止动议 | Loop6 选项后 | mika_bond>=2 → 「我们这次能赢吗」→奈尔咽回答案 | mika_knows_me=True |
| C4 | 全员后退一步 | Loop7 沉默推门后 | _loop6_sided→被站边角色后退弃武装→无台词 | 仅叙事 |

设计逻辑：text-test Q15「让对抗变成方法之争」——C1方法论、C2路径之争、C3情感逼问、C4沉默代价；每人至少参与一场冲突且无人变反派。  
新增变量：`_loop6_sided`（str/None）。  
同步文件：text_runner.py + story_text.txt + 系统策划案.md + 角色设定集.md + 本日志。  
备份：`archive/*.20260513_202202.bak`。`py_compile` 通过。

---

## 一百一十、2026-05-13：文本禁令全面检查与修复

回扫 `text_runner.py` + `story_text.txt`，修正：

| 违规类型 | 数量 | 涉及 |
|---|---|---|
| "不是...而是..." / "不是X是Y" 句式 | 9处（叙事）+14处（数据库）+3处（标注） | narrator/say/VOICE_LIBRARY |
| 句首"不是"否定 | 4处 | narrator块 |
| 禁词"接住" | 1处 | DAILY_MICRO_EVENT_RULES |
| 禁词同步 story_text | 4处 | 标注/叙事 |

残留"不是"：runner L3097 + story L445（"是不是"疑问结构，非被禁句式）。`py_compile` 通过。

---

## 一百零八、2026-05-13：叙事丰富度提升（6项·基于text-test框架）

| # | 名称 | 改了什么 | 涉及文件 |
|---|---|---|---|
| S1 | 逆写时刻 | L4 检定后 `thread_erosion>=2` → 奈尔漏嘴，米迦警觉"你第几次？"；`thread_revelation+1` | text_runner + story_text + 策划案 |
| S3 | 五角色悲剧轴埋线 | story_text 各 Loop 当夜相位后补悲剧轴注释；角色设定集新增跨Loop追踪表 | story_text + 角色设定集 |
| S5 | 跨Loop长线回声 | L1选项⑥加"日子久了自己也会磨平…"；L2醒后`thread_revelation>=1`→指腹先摸回浅槽 | text_runner + story_text |
| S4 | 沉默句嵌入 | L2 当夜相位删解释"像一句话分成了两段呼吸"→"塞西尔听完，没应——弓弦嗡了一声" | story_text |
| S6 | 呼吸口 | L3+L6各加3句纯环境叙事（风/狗/窗/影），无对白 | text_runner + story_text |
| S2 | 七Loop情绪锚 | 七Loop标题头部加情绪锚标签（初识·点燃→决绝·最后一口气） | story_text |

设计依据：text-test Q1（关系的解构与重构/Q2五种悲剧路径/Q2延迟后劲/Q21留白美学）。  
`py_compile` 通过。备份：`archive/*.20260513_200348.bak`。

---

## 一百零七、2026-05-13：策划案与代码逻辑对齐（3项）

| # | 问题 | 修复 |
|---|---|---|
| D1 | 策划案 L3/L5 变量表残留 `cecil_bond` | → `cassius_bond +1`，删 `clue_cecil` |
| D2 | 代码 `recruited`(bool) vs 策划案 `recruited_count`(int) | 代码4处改为 `recruited_count += 1`，`build_new_state` 初始化 `0` |
| D3 | 代码已写 `mika_knows_me` 但策划案未标注 | 策划案 L3 ch5/ch6、L5 ch1/ch3 补 `(且可写入 mika_knows_me)` |

`py_compile` 通过。

---

## 一百零二、2026-05-13：四角色羁绊变量全接入终局分流

### 变更

**新增变量**：
- `lucien_bond`：卢西恩羁绊，初始 0，赋值点在 Loop 4 choice 4（卢西恩诊脉 +1）和 Loop 6 choice 1（再查伤口 +1）

**四羁绊→终局联动规则**：

| 羁绊 | 主要联动的结局 | 门槛 |
|---|---|---|
| mika_trust | ASCENSION、DAWN、PILGRIM | ASCENSION>=2, DAWN>=1, PILGRIM>=1 |
| cecil_bond | CANDLELIGHT、COVENANT | CANDLELIGHT: lucien+cecil>=1, COVENANT>=1 |
| cassius_bond | JUDGEMENT、AUTHOR | JUDGEMENT>=2, AUTHOR>=1 |
| lucien_bond | COVENANT、CANDLELIGHT | COVENANT>=2, CANDLELIGHT: lucien+cecil>=1 |

**修改的代码区域**：
- `build_new_state`：新增 `lucien_bond: 0`
- `show_stats`：新增卢西恩羁绊显示
- Loop 4 choice 4：`lucien_bond += 1`（卢西恩诊脉）
- Loop 6 choice 1：`lucien_bond += 1`（再查伤口）
- `early_resolution_check`：全部 7 条分流判定接入四羁绊条件；ASCENSION/DAWN/CYCLE 三分支改为 mika_trust 相关
- `final_resolution`：AUTHOR、PILGRIM、JUDGEMENT、COVENANT、CANDLELIGHT 全部增补羁绊门槛

**规则设计理念**：四羁绊均偏低时 CYCLE 权重自动升高——这意味着与其他角色关系疏离的奈尔更可能滑入轮回，形成「孤独→轮回→更孤独」的隐性惩罚机制，与《系统策划案》「性格驱动命运」一致。

### 同步文件

- `text_runner.py`：代码层落地
- `story_text.txt`：变量表 + 分流提示全文重写
- `系统策划案.md`：状态变量表 + 提前分流节 + 九结局映射全部更新
- `DEVELOPMENT_LOG.md`：本条

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过

---

## 一百零五、2026-05-13：试玩体验优化（贪心遍历 11 项）

### 致命级

**#1 删除存档加确认框**：`select_start_state` 中选"删除存档"后追加 `[y/N]` 二次确认，防误触。
**#2 结局后解锁总览**：`main()` 结局后打印九结局清单（◆/◇），附未达成提示与 NG+ 指引。
**#3 Loop1 冷启动瘦身**：将 `loop_one` 前置叙事从 13 段压缩到 8 段（合并米迦体感与动作描写，删漆面/鸡笼/系带等非核心侧写）。

### 高痛级

**#4 骰子双层旁白合并**：`roll_check` 中【命运检定】与【丝线回响】从两次 `narrator` 合并为一行 `"…  …"`，减少 `slow_print` 调用次数。
**#5 show_stats 变化检测**：新增 `_prev_stats_snapshot`，属性/羁绊/线索无变化时只打印一行短标「命册如前」。
**#6 口授日内进度提示**：每日 `rpg_feedback` 后追加「（还剩 X 夜，门前的月色还在等你们把话说完。）」。
**#7 提前分流过渡句**：`early_resolution_check` 中 `EARLY_RESOLUTION_RESONANCE` 后追加「你们还没走到最后一扇门，灯却先亮了——这一轮提前收束。」

### 中痛级

**#8 NG+ 自动加速**：新增 `_print_speed` 全局变量；`slow_print` 改为 `delay=None` 默认取全局值；`main()` 中根据 `ng_plus_count` 每轮递降 0.002s（下限 0.003s）。
**#9 骰子尾部数值**：`roll_check` 新增一行 `[{✓/✗} d20={roll} + {stat}({val}) = {total} vs DC{dc}]`，方便 debug 与数值感知，沉浸流玩家可以略过。
**#10 口授日标题加角色名**：`choose` 标题从「口授七夜 ║ 询之N」改为「口授七夜 ║ 询之N · 米迦」，帮助玩家跟住当日说话人。

### 低痛级

**#11 Loop6-7 开局补齐体感**：Loop6 新增舌根铁锈味 + 影子稀薄描写；Loop7 新增脊椎轻响 + 鞋底冷灰描写。

### 备份与验证

- 备份：`archive/text_runner_opt.20260513_191902.bak`
- `py_compile` 通过

---

## 一百零四、2026-05-13：branch_tree.html 同步四羁绊规则与结局条件

### 变更

- **三律区新增羁绊显示规则**：`？？？羁绊` vs `（角色名）羁绊`，含四识认触发点
- **Loop3 流程节点修正**：`cecil_bond↑` → `cassius_bond↑`，删除 `clue_cecil`（看卡修斯法术书不应写暗影徽记）
- **Loop4 流程节点修正**：新增 `lucien_bond↑`（找塞西尔和旧书——卢西恩诊脉段）
- **九结局映射全部增补四羁绊条件**：DAWN +mika_bond≥1、CANDLELIGHT +(lucien+cecil)≥1、ASCENSION +mika_bond≥2、COVENANT +lucien≥2+cecil≥1、PILGRIM +mika_bond≥1、JUDGEMENT +cassius≥2+clue_elder、AUTHOR +cassius≥1
- **`mika_knows_me` 面板隐藏**：`show_stats` 删除「米迦记住了奈尔」显示行；`story_text.txt` 注明此为后台判定变量

### 同步文件

- `branch_tree.html`：7 处增删改
- `story_text.txt`：羁绊显示规则 + `mika_knows_me` 隐藏说明
- `DEVELOPMENT_LOG.md`：本条

### 验证

- `py_compile text_runner.py` 通过

---

## 一百零六、2026-05-13：story_text 语病修复（6处）

| # | 行 | 问题 | 修复 |
|---|---|---|---|
| A | L146 | 主语漂移——"指腹蹭过"施事从卡修斯跳成奈尔 | 加"你"→`你指腹蹭过` |
| B | L187 | "银针过境"→应为"过火" | `过境`→`过火` |
| C | L68 | "两只手的手腕"叠床架屋 | →`两人手腕` |
| D | L220 | "廊柱拐角酒橱尚半阖"缺施动者 | →`谁先从勺沿刮净…勺背便撞上` |
| E | L65 | "被点名的勇者"—谁点名？无交代 | →`被神谕圈了名的那一个`（依角色设定集米迦"被神明选中的勇者"） |
| F | L280 | 幔旌拂过鬓畔物理失真 | →`旗尾扫过石阶冷灰` |

同步：`text_runner.py` E项同修。`py_compile` 通过。

---

## 一百零三、2026-05-13：羁绊变量改名与识认显示规则

### 变更

- **`mika_trust` → `mika_bond`**（米迦信任 → 米迦羁绊）：统一五羁绊命名口径
- **四羁绊界面显示规则**：`show_stats` 中根据 `know_*` 判断——未识认角色显示为「？？？羁绊」，识认后显示为「（角色名）羁绊」
- 识认触发对齐：米迦（Loop1 村口）、塞西尔（Loop1 黄昏）、卢西恩（Loop2 北街）、卡修斯（Loop3 镇口）

### 同步文件

- `text_runner.py`：批量改名 + `show_stats` 重写
- `story_text.txt`：变量名 + 羁绊显示规则
- `系统策划案.md`：变量名 + 羁绊显示规则
- `DEVELOPMENT_LOG.md`：本条

### 验证

- `py_compile` 通过

---

## 一百零一、2026-05-13：剧情逻辑 Bug 修复

### 审查范围

通读 `text_runner.py` 全部 7 个 loop 函数、9 个结局函数、`early_resolution_check` 与 `final_resolution`，逐项对照《角色设定集》《系统策划案》。

### 发现与修复

**Bug 1（高）：卡修斯互动全部写入塞西尔变量**
- Loop 3 选"看卡修斯的法术书"写入了 `cecil_bond += 1` 和 `clue_cecil = True`
- Loop 5 选"先找卡修斯"写入了 `cecil_bond += 1`
- 修复：新增 `cassius_bond` 变量（与 `cecil_bond` 平级）；Loop 3/5 的卡修斯选项改为写 `cassius_bond`；Loop 3 choice 4 删除 `clue_cecil = True`（暗影徽记是塞西尔专属线索，不应从卡修斯处获取）

**Bug 2（中）：Loop 6 掷骰返回值被丢弃**
- `roll_check("坚韧与并肩", ...)` 的返回值未赋值，检定额外叙事后无事发生
- 修复：捕获返回值，暴击 → `mika_trust +1`，大失败 → `thread_erosion +1`，成功/失败各自补余波旁白

**Bug 3（中）：PILGRIM 被提前分流拦截**
- Loop 5 选"今夜就推门"后 `early_resolution_check` 可能先触发 THRONE 或 CANDLELIGHT，PILGRIM 不可达
- 修复：在 `early_resolution_check` 中 AUTHOR 之后插入 PILGRIM 判定（`stage <= 5 && scripture_mark >= 1 && meta >= 12`），置于所有隐线触发之前

**Bug 4（低）：Loop 3 choice 4 污染 clue_cecil**
- 修复：删除 `clue_cecil = True`

**Bug 5（低）：Loop 2 choice 5 米迦断句**
- "黑水河"→"木碗咸湿"之间无过渡
- 修复：补一句 narrator 过渡——"他喉结先动了一下，像那口冷麦糊忽然反刍到舌根"

**Bug 6（低）：clue_elder 不与任何终局联动**
- 修复：JUDGEMENT 入口新增 `clue_elder = True` 硬条件

**Bug 7（低）：Loop 7 禁章台词跨设定**
- 卡修斯读的"尘土仍归于尘；凡受赐气息者，仍将气息交还造物之手"逼近亚伯拉罕宗教文本
- 修复：改为"经折仍归于经折；凡被墨写下的，仍将气息交还抄写员之手"（架空世界观——经折、墨、抄写员）

### 同步文件

- `story_text.txt`：新增 `cassius_bond` 变量；更新分流提示（PILGRIM 提前入口 + `clue_elder` 联动）；附录加 Loop 6 检定分支与禁章架空要求
- `text_runner.py`：以上七项全部落地；BOM 字符已清理；`py_compile` 通过

### 备份

- `archive/story_text.txt.20260513_183956.bak`
- `archive/text_runner.py.20260513_183956.bak`
- `archive/DEVELOPMENT_LOG.md.20260513_183956.bak`

---

## 一百、2026-05-12：设定集对照审查与全端一致性确认

### 用户请求

对照《角色设定集》《世界观设定集》《系统策划案》三份设定文档，检查 `story_text.txt` 中：
1. COVENANT 结局是否缺失
2. 各 Loop 是否标注隐藏丝线变量
3. 塞西尔/卡修斯是否为两人且外貌正确
4. AUTHOR/PILGRIM/COVENANT 入口条件是否写明
5. `text_runner.py` 是否与 `story_text.txt` 对齐

### 核查结论

**story_text.txt**：
- COVENANT 结局 **已存在**
- 隐藏丝线变量标注 **已在附录中存在**，各 Loop 入口口与系统策划案变量表逐条对齐
- 塞西尔（黑发紫眼）与卡修斯（红发蓝眼）**外貌全部正确**，无混同
- AUTHOR/PILGRIM/COVENANT/JUDGEMENT 入口条件 **已在附录中列出**

**text_runner.py**：
- **状态：完全就绪**。已包含——
  - 7 个周目函数（`loop_one` 至 `loop_seven`）
  - 9 个结局函数（DAWN / CANDLELIGHT / THRONE / ASCENSION / CYCLE / AUTHOR / PILGRIM / JUDGEMENT / COVENANT）
  - 5 条隐藏丝线（`thread_mercy` / `thread_obsession` / `thread_erosion` / `thread_revelation` / `scripture_mark`）
  - 存档/读档系统、NG+ 继承、角色识认（`know_*`）、叙事镜头污染（`lens`）、门旁白系统（`tinted_gate_narration`）、口授七夜（`run_week_dialogues`）、小队反馈（`team_reaction_line`）
  - `final_resolution` 覆盖全部 9 结局的提前分流与主检定分流

**角色设定集**：
- 塞西尔：黑发紫眼弓手，约 24 岁，温柔亲和，旧看守团出身
- 卡修斯：红发蓝眼旅行法师，约 26 岁，高傲冷感，学团术式学系出身
- 卢西恩：淡金亚麻发灰蓝灰绿眼医师，约 26 岁，耐心亲切，北境修院出身

### 备份记录

- `archive/story_text_backup_20260512.txt`
- `archive/text_runner_backup_20260512.py`
- `archive/script_backup_20260512.rpy`

### 当前基线结论

四文件同步完整，九结局齐备，七周目流程可用，五角色设定严格参照设定集执笔。`text_runner.py` 为当前项目最全实现端，可作为试玩与调试主入口。 通过
- `ReadLints`：`story_text.txt`、`script.rpy`、`text_runner.py`、`branch_tree.html` 无新增报错

## 五十六、未知轴双结局同笔法重写（PILGRIM / JUDGEMENT）

### 本次目标

- 将 `PILGRIM` 与 `JUDGEMENT` 按 `AUTHOR` 已定稿笔法统一重写。
- 统一“未知轴三结局”在节奏、镜头推进和语言颗粒度上的系列感。

### 变更内容

- `story_text.txt`
  - `PILGRIM` 重写为“口语心理跳切 + 远行感官推进”版本。
  - `JUDGEMENT` 重写为“半开门压迫光感 + 肉身刻写审判”版本。

- `game/script.rpy`
  - `label ending_pilgrim` 全段同步新文案。
  - `label ending_judgement` 全段同步新文案（保留米迦提示台词节点）。

- `text_runner.py`
  - `ending_pilgrim(state)`、`ending_judgement(state)` 全段同步新文案。

- `branch_tree.html`
  - `PILGRIM（未知轴）` 与 `JUDGEMENT（未知轴）` 的摘要版、全文版同步新稿。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `python g:\projects\my-vn\tools\copy_guard_check.py` 通过
- `ReadLints`：`story_text.txt`、`script.rpy`、`text_runner.py`、`branch_tree.html` 无新增报错

## 五十七、系统策划案细化为可执行规格

### 本次目标

- 将 `系统策划案.md` 从概念版细化为可执行的系统规格文档。
- 对齐当前实现：7轮结构、提前分流、隐藏丝线值、镜头污染分级、双端同步流程。

### 变更内容

- `系统策划案.md`
  - 新增“设计边界”与“周目结构（7轮）”说明。
  - 新增“推进状态机”，明确每轮结算与终局落地顺序。
  - 补充隐藏变量与 `endings_found` 的数据层定义。
  - 细化“提前分流与终局结算”规则，并注明 `script.rpy` 为阈值真值源。
  - 新增“存档与周目继承”章节，写明 `text_runner_save.json` 与 New Game+ 继承项。
  - 新增“叙事镜头系统（污染分级）”与“台词差分控制（系统约束）”章节。
  - 新增“内容同步与验收”，固定文案回扫、语法校验和分支页一致性抽查。

### 验证

- `ReadLints`：`系统策划案.md` 无新增报错

## 五十八、系统策划案补充变量改动来源表

### 本次目标

- 为 `系统策划案.md` 增补“每个 Loop 的选项改动变量”索引表。
- 将变量改动来源从散落脚本整理为可直接查阅的策划文档结构。

### 变更内容

- `系统策划案.md`
  - 新增 `变量改动来源表（按 Loop）` 章节。
  - 覆盖 `Loop1` 到 `Loop7` 的菜单选项与变量增量关系。
  - 补充每轮固定推进项（`loop_count` / `recruited_count`）与检定后附加影响说明。
  - 增加 `Final` 终局段入口变量说明，标明 `AUTHOR`、`PILGRIM` 等分流关注项与 `endings_found` 写入规则。

### 验证

- `ReadLints`：`系统策划案.md` 无新增报错

## 五十九、文档与文本冗余清理（含同步备份）

### 本次目标

- 清理项目内冗余 `md/txt` 文件，保留单一可维护来源。
- 将可合并内容并入主策划文档，避免规则分散。
- 清理前先做时间戳备份，确保可回滚。

### 备份

- 新建备份目录：`archive/recovery/cleanup_backup_20260511_033045`
- 已备份文件：
  - `系统策划案.md`
  - `文案禁令回扫清单.md`
  - `skeleton.txt`
  - `archive/recovery/recovered_text_backup_20260510.txt`

### 合并与清理

- 合并：
  - 将 `文案禁令回扫清单.md` 的固定流程并入 `系统策划案.md` 新章节 `文案回扫固定清单`。
- 删除：
  - `文案禁令回扫清单.md`（已合并）
  - `skeleton.txt`（根目录冗余，归档副本已保留）
  - `archive/recovery/recovered_text_backup_20260510.txt`（与 `recovered_text.txt` 哈希一致，重复）

### 验证

- `ReadLints`：`系统策划案.md` 无新增报错
- 目录抽查结果：
  - 根目录 `md/txt` 已收敛为主文档 + `story_text.txt`
  - 清理目标文件均可在本轮备份目录中回滚

## 六十、text_runner 开场导入补回卢西恩存在线索

### 本次目标

- 修正 `text_runner.py` 开场导入文案里卢西恩缺位的问题。
- 在不改动分支与数值逻辑的前提下，补足角色在场感与时间线说明。

### 变更内容

- `text_runner.py`
  - `loop_one(state)` 开场段新增两句导入：
    - 交代卢西恩身份（修院医舍出身、医疗气质）
    - 交代其当下不在镇口的原因（北街止血缝伤，夜里回旧殿）

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过

## 六十一、双端开场导入统一为神秘口径并补卢西恩伏笔

### 本次目标

- 将 `script.rpy` 与 `text_runner.py` 的开场导入统一为同一语气层。
- 修正“点击试玩后首屏文案”过于平铺的问题，强化神秘氛围。
- 在 `script.rpy` `loop_one` 补齐卢西恩前置伏笔，和终端版保持一致。

### 变更内容

- `game/script.rpy`
  - `label start` 的导入文案改为“灯影批注 / 第七次门响 / 账页潮气”版本。
  - 开场同伴名单补齐为“米迦、塞西尔、卡修斯、卢西恩”。
  - `label loop_one` 新增两句卢西恩前置伏笔（北街缝伤、夜归旧殿外廊）。

- `text_runner.py`
  - `main()` 首屏导入文案改为同口径神秘版本。
  - 开场同伴名单补齐为“米迦、塞西尔、卡修斯、卢西恩”。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`game/script.rpy`、`text_runner.py` 无新增报错

## 六十二、story_text 首屏导入与双端统一

### 本次目标

- 将 `story_text.txt` 开头导入文案与 `script.rpy` / `text_runner.py` 对齐。
- 保持群像同口径与神秘学氛围，完成三端首屏一致。

### 变更内容

- `story_text.txt`
  - 替换原开场散列角色介绍段。
  - 同步为统一导入句组：
    - `灯影先落在你指节，像一行尚未干透的批注。`
    - `第七次门响之前，名字、誓言和代价都会被重写。`
    - `轮回把愿望折成账页。墨迹发冷，潮气沿纸边往上爬。`

### 验证

- `ReadLints`：`story_text.txt`、`DEVELOPMENT_LOG.md` 无新增报错

## 六十三、结局命名改为中英对照

### 本次目标

- 修正结局标题“纯英文”展示，统一为中文名 + 英文代号。
- 保留内部结局 ID（如 `AUTHOR`）不变，仅调整展示层文案。

### 变更内容

- `story_text.txt`
  - 九个结局标题改为中英对照：
    - `黎明 / DAWN`
    - `烛光 / CANDLELIGHT`
    - `王座 / THRONE`
    - `升华 / ASCENSION`
    - `轮回 / CYCLE`
    - `作者 / AUTHOR`
    - `朝圣者 / PILGRIM`
    - `审判 / JUDGEMENT`
    - `盟约 / COVENANT`

- `branch_tree.html`
  - 结局展开卡片 `<summary>` 统一改为中英对照命名（轴标签保留）。

- `text_runner.py`
  - 九个结局打印标题由 `ENDING: ...` 改为中英对照展示，如 `结局六 / 作者 AUTHOR`。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`story_text.txt`、`branch_tree.html`、`text_runner.py` 无新增报错

## 六十四、text_runner 状态区趣味化改版

### 本次目标

- 提升终端状态栏的游戏反馈感，避免“状态: 塞西尔线索”之类过于扁平——现以 **暗影徽记 / 缄卷裂真 / 七灯残阶 / 蜡誓遗册** 四枚叙事名打印（底层仍为 `clue_*`）。
- 保持数值逻辑不变，只优化展示层。

### 变更内容

- `text_runner.py`
  - 重写 `show_stats(state)` 状态输出结构：
    - 新增 `线索档案 x/4`（**暗影徽记 / 缄卷裂真 / 七灯残阶 / 蜡誓遗册**）锁定状态面板（对应 `clue_cecil / clue_truth / clue_shrine / clue_elder`）
    - 新增“状态播报”文案，针对 **`clue_cecil`（暗影徽记）** 给出阶段化反馈
      - 普通入卷
      - 羁绊≥2 时的深挖阶段
    - 原关系标签改为 `关系面板`，保留米迦信任、塞西尔羁绊、记忆状态

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 八十一、日志补记：八十条目末尾对齐

### 本次目标

- 解决 `## 八十、关系反馈再压一档（剧情旁白化）` 不在日志末尾、难以定位的问题。

### 变更内容

- `DEVELOPMENT_LOG.md`
  - 补记一条末尾记录，明确八十条目的核心变更：
    - `daily_rpg_feedback(...)` 的关系反馈改为剧情旁白口吻；
    - 去掉等级命名感，不显示“倾向阶位”类描述；
    - 保留内部强度分支，仅通过动作细节体现变化。

### 验证

- 末尾可见本条补记，后续按时间顺序阅读不再遗漏

## 八十、关系反馈再压一档（剧情旁白化）

### 本次目标

- 将七日系统中的“关系倾向句”进一步弱化为剧情旁白。
- 去除“等级命名感”，保留隐性状态反馈。

### 变更内容

- `text_runner.py`
  - 删除 `thread_tier(...)` 的直观阶位映射输出路径。
  - `daily_rpg_feedback(...)` 中四角色关系反馈改为场景动作句：
    - 米迦：从“倾向描述”改为“先看你一眼/转杯口”等行为旁白。
    - 塞西尔：从“站位倾向”改为“留空档/示意路线”等动作旁白。
    - 卡修斯：从“启示阶位”改为“注脚压墨/羽笔点线”。
    - 卢西恩：从“慈悯阶位”改为“收针叠布/挪灯降息”。
  - 反馈仍受内部预览值影响（不同强度对应不同旁白），但不再明示等级词。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 七十九、移除周内可视条（去系统面板感）

### 本次目标

- 去掉“本周暗线：并肩/追索/定调”这一行，减少系统播报感。

### 变更内容

- `text_runner.py`
  - 删除 `week_meter(...)` 函数。
  - `daily_rpg_feedback(...)` 中移除“本周暗线”可视条输出。
  - 保留自然叙事反馈与关系倾向描述。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 七十九、移除周内可视条（去系统面板感）

### 本次目标

- 去掉“本周暗线：并肩/追索/定调”这一行，减少系统播报感。

### 变更内容

- `text_runner.py`
  - 删除 `week_meter(...)` 函数。
  - `daily_rpg_feedback(...)` 中移除“本周暗线”可视条输出。
  - 保留自然叙事反馈与关系倾向描述。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 七十八、七日反馈去系统标签化（自然口径）

### 本次目标

- 解决日对话反馈“人机感”过重的问题。
- 去掉标签化播报，保留玩法信息但改成叙事口吻输出。

### 变更内容

- `text_runner.py`
  - `DAILY_AFTERMATH_LIBRARY`：
    - 去除 `【当日余波】` 前缀，改为直接旁白句。
  - `team_reaction_line(...)`：
    - 去除 `【同伴反应】` 前缀，直接返回同伴动作反馈句。
  - `daily_rpg_feedback(...)`：
    - 去除 `【轻RPG反馈】` 与 `【周内面板】` 标记；
    - 增益提示改为自然叙述句；
    - 面板文案改为 `本周暗线：并肩/追索/定调`；
    - 关系反馈改写为角色化叙述句，不再使用“关系波动”标签。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 六十五、状态面板数值口径改为层级描述

### 本次目标

- 弱化状态栏“纯数字”观感，提升叙事化与游戏氛围。
- 在不改变底层数值逻辑的前提下，改造展示文案。

### 变更内容

- `text_runner.py`
  - 新增 `stat_tier(stat_key, value)`：将五项属性映射为层级词（如觉察·闻隙、元认知·识环）。
  - 新增 `relation_tier(value)`：关系值映射为关系阶段词（如试探、并肩、共命）。
  - `show_stats(state)` 改版：
    - 顶部属性行由数字改为层级词展示
    - 线索统计由 `x/4` 改为 `◆◇` 进度条
    - 关系面板由数字改为阶段词
  - 线索锁定与状态播报逻辑保持不变。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 六十六、检定播报隐化数值 + 选项属性暗示

### 本次目标

- 将检定播报从“掷点+加值+总和”改为“明示结果、隐去具体数字”。
- 在每轮选项文本中增加属性倾向暗示，提升决策趣味与可读性。

### 变更内容

- `text_runner.py`
  - `roll_check(...)` 重写输出口径：
    - 不再直接展示 `roll/stat/total` 数字
    - 改为四类明示结果：
      - 暴击：命运明显向你倾斜
      - 大失败：命运从你掌心滑脱
      - 成功：门缝让出一线呼吸
      - 失败：门石仍旧紧闭
  - `Loop1-Loop7` 的全部 `choose(...)` 选项增加括号暗示：
    - 示例：`（偏同步）`、`（偏觉察/真相）`、`（偏元认知/侵蚀）`
    - 只提示方向，不暴露具体加点数值
  - `最后抉择` 两处菜单也补充倾向暗示（关系修复/牺牲/生存延续）。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 六十七、选项暗示改为朦胧口径

### 本次目标

- 将选项括号提示从“属性名直指型”改为“隐喻暗示型”。
- 保留玩家决策方向感，不暴露系统字段词汇。

### 变更内容

- `text_runner.py`
  - `Loop1-Loop7` 所有选项括号改写：
    - 删除全部 `偏觉察/偏同步/偏权能/偏元认知...` 直白词
    - 改为朦胧提示，如“气氛先松一寸”“把钟敲到最后一响”“让门先记住你”
  - `最后抉择` 两组选项暗示同步改写为隐喻口径：
    - “把手留给活人 / 把背影留给风 / 把问题留到下次”

### 验证

- `rg` 检查：`text_runner.py` 无 `（偏...）` 残留
- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 六十八、选项提示二次分化（角色口吻版）

### 本次目标

- 将 `text_runner.py` 的括号提示进一步改为角色口吻化暗示。
- 去掉所有“偏属性”字样，保持朦胧提示与人物设定一致。

### 变更内容

- `text_runner.py`
  - 全量替换 `Loop1-Loop7` 选项括号提示：
    - 米迦相关提示改为更口语、体感导向（如“先给一点热意”）。
    - 塞西尔相关提示改为控场与步距感（如“把话说进阴影里”）。
    - 卡修斯相关提示改为阈值/答案导向（如“把答案逼到台前”）。
    - 卢西恩相关提示改为医师流程感（如“先把人留在场上”）。
    - 奈尔相关提示改为代价与决断导向（如“把刀口朝向自己”）。
  - `最后抉择` 提示也改为意象化表达：
    - `把手留给活人` / `把背影留给风` / `把问题留到下次`

### 验证

- `rg`：`text_runner.py` 无 `偏xxx` 直白提示残留
- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 六十九、检定提示去“成功/失败”直报口径

### 本次目标

- 去掉检定播报中的“成功/失败/暴击/大失败”显式词。
- 保留判定结果可感知性，改为纯氛围反馈语句。

### 变更内容

- `text_runner.py`
  - `roll_check(...)` 的 `reveal_line` 改写为隐喻表达：
    - 门内亮响 / 锁舌拨开
    - 回声退远 / 潮水离岸
    - 石缝松气 / 冷风进半寸
    - 回声折返 / 退回黑处
  - 判定逻辑与返回值保持不变，仅变更显示文案。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py`、`DEVELOPMENT_LOG.md` 无新增报错

## 七十七、日志补记：连携提示去标签化（末尾对齐）

### 本次目标

- 避免连携提示过于系统化，保持叙事自然感。
- 将本次变更补记到日志末尾，便于按时间顺序查阅。

### 变更内容

- `text_runner.py`
  - 连携弱提示文案去除 `【气息变化】` 前缀。
  - 连续同倾向触发仍保留隐性收益与暗骰加成，不显示数值。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 七十六、连携弱提示去标签化

### 本次目标

- 进一步减弱系统感，把连携提示从“标签句”改成自然旁白句。

### 变更内容

- `text_runner.py`
  - `resolve_hidden_stance(...)` 中连续 2 天 / 3 天倾向提示文案去除 `【气息变化】` 前缀。
  - 保留隐性连携收益逻辑与暗骰加成，仅调整展示口径。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 七十五、周内连携“隐性触发”提示（弱提示版）

### 本次目标

- 增加“连续两天同倾向”带来的临时手感收益。
- 提示口径保持克制，不出现“技能触发”类直白文案。

### 变更内容

- `text_runner.py`
  - 新增 `resolve_hidden_stance(mood_key, streak_key, streak_len)`：
    - 追踪连续倾向；
    - 连续 2 天给轻度节奏收益，连续 3 天给更高收益；
    - 输出仅为氛围型提示：`【气息变化】...`
  - `hidden_week_gate(...)` 增加 `tempo_bonus` 参数：
    - 把连携节奏收益并入周内暗骰推进势能。
  - `run_week_dialogues(...)` 接入连携状态：
    - 新增 `streak_key / streak_len / tempo_bonus`；
    - 每日在轻RPG反馈后计算隐性连携并播放弱提示文案；
    - 暗骰判定使用连携收益，但不明示数值。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错
- 冒烟运行：`text_runner.main()` 正常推进并结束（`STANCE_SMOKE_OK`）

## 七十四、七日对话加入轻RPG可视反馈层

### 本次目标

- 让周内对话反馈更像轻RPG，避免“点完选项只出一句台词”的单薄体验。
- 每日选择后提供可感知的成长提示、进度提示、关系波动提示。

### 变更内容

- `text_runner.py`
  - 新增 `thread_tier(value)`：
    - 为启示/慈悯等隐线提供阶位名（微光/留痕/牵引/缠绕/刻印）。
  - 新增 `week_meter(value)`：
    - 以 `◆◇` 形式显示周内三类倾向槽进度。
  - 新增 `daily_rpg_feedback(...)`：
    - 每日输出 `【轻RPG反馈】`（协同/洞察/压场增益口径）；
    - 每日输出 `【周内面板】`（三槽进度可视化）；
    - 每日输出 `【关系波动】`（按当日角色显示关系或隐线倾向）。
  - `run_week_dialogues(...)` 接入：
    - 在“当日余波 + 同伴反应”后追加轻RPG反馈层，
    - 形成“回应 -> 余波 -> 反应 -> 面板”的日内闭环。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错
- 冒烟运行：`text_runner.main()` 正常推进并结束（`RPG_SMOKE_OK`）

## 七十三、七日对话日内反馈加厚（场景余波 + 同伴反应）

### 本次目标

- 解决“每个对话点选后文本过短、只有一句台词”的体验问题。
- 提升日内选择反馈密度，让每次选择都能看到即时叙事后果。

### 变更内容

- `text_runner.py`
  - 新增 `DAILY_AFTERMATH_LIBRARY`：
    - 按 `soft / probe / press` 提供“当日余波”叙事句，补足场景层反馈。
  - 新增 `TEAM_REACTION_LIBRARY`：
    - 为米迦、塞西尔、卡修斯、卢西恩配置三类情绪下的即时反应句。
  - 新增 `daily_aftermath_line(...)` 与 `team_reaction_line(...)`：
    - 根据周次、天数、当日倾向生成当日反馈文本。
  - `run_week_dialogues(...)` 每日流程加厚：
    - 保留“当日场景 + 角色回应”；
    - 新增“【当日余波】...”；
    - 新增“【同伴反应】...”；
    - 每次选择形成三段输出，互动体感更完整。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错
- 冒烟运行：`text_runner.main()` 可完整推进，进程正常退出（`SMOKE_OK`）

## 七十二、分支图同步七日系统 + 双文件备份

### 本次目标

- 将 `text_runner.py` 近两轮系统升级同步到 `branch_tree.html`。
- 按要求先做备份，再写入 `branch_tree.html` 与 `DEVELOPMENT_LOG.md`。

### 备份记录

- 备份目录：`g:\projects\my-vn\archive\recovery`
- 新增备份：
  - `branch_tree_backup_20260511_042745.html`
  - `DEVELOPMENT_LOG_backup_20260511_042745.md`

### 变更内容

- `branch_tree.html`
  - `交互分支连线图` 引导语更新：
    - 明确标注已接入「口授七夜节律」（旧称周内七日对话）+ **暗骰提前触发主事件** + **角色口吻约束层**。
  - 新增卡片：**命册节律 · 口授七夜**
    （本节条目初稿题为「周内七日对话系统（v2）」，现与 HTML 口径一致）。
    - 说明每周 7 天、每日 1 次分支、按周主题差分。
    - 说明四角色独立词库驱动每日对话。
    - 说明达到最早触发日后使用节律内暗骰决定主事件进入时机。
    - 说明周末按 soft/probe/press 倾向结算状态与关系。
  - `判定骨架` 新增两项：
    - `hidden_week_gate(state, loop_no, day, mood)`（主事件触发日判定）
    - `ROLE_DIALOGUE_CONSTRAINTS + constrained_voice_block()`（禁用词与句长阈值实时约束）

### 验证

- `rg` 检查：`branch_tree.html` 已包含 **命册节律 · 口授七夜** 卡片、`hidden_week_gate`、`ROLE_DIALOGUE_CONSTRAINTS`。
- 备份文件存在于 `archive/recovery`，命名与时间戳一致

## 七十三、角色禁用词与句长阈值实时约束

### 本次目标

- 为七日对话增加“角色禁用词 + 句长阈值”的运行时约束层。
- 在每日对话输出前自动净化文案，减少角色串味风险。

### 变更内容

- `text_runner.py`
  - 新增 `ROLE_DIALOGUE_CONSTRAINTS`：
    - 为 `mika/cecil/cassius/lucien` 定义
      - 角色禁用词列表
      - 替换词映射
      - 选项与台词句长范围（`option_len` / `reply_len`）
      - 补尾短句（`pad_tail`）与越界回退台词（`fallback`）
  - 新增 `apply_role_text_constraints(...)`：
    - 在运行时执行禁用词替换与句长裁剪/补齐。
    - 文案空值时自动回退到角色兜底语句。
  - 新增 `constrained_voice_block(...)`：
    - 对每日使用的选项文案与 soft/probe/press 回应统一套约束层。
  - `run_week_dialogues(...)`：
    - 发言块获取由 `get_voice_block(...)` 改为 `constrained_voice_block(...)`，
    - 确保每日对话选择与角色回应都经过实时风格约束。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 七十二、七日对话升级为角色词库 + 周主题 + 暗骰触发

### 本次目标

- 将七日对话从“固定模板”升级为“角色独立口吻词库”。
- 强化每周主题差分，让 49 次日对话在语气与场景上更分明。
- 加入通用暗骰门槛，用对话倾向与隐藏判定共同决定何时进入主事件。

### 变更内容

- `text_runner.py`
  - 原 `WEEK_PROMPTS` 替换为 `WEEK_DIALOGUE_PACKS`：
    - 按周配置 `theme`、`theme_line`、`min_entry_day`、`days`（含每日 `speaker` + `prompt`）。
    - 1-7 周形成不同叙事主题（余烬、暗线、镜纹、裂痕、回声、沉钟、门槛）。
  - 新增 `VOICE_LIBRARY`：
    - 为 `mika/cecil/cassius/lucien` 分别提供
      - 三条选项文案（含隐喻暗示）
      - 三类口吻回应（soft/probe/press）
    - 七日对话每日根据当日发言角色动态切换选项与回应。
  - 新增 `hidden_week_gate(...)`：
    - 每天在达到 `min_entry_day` 后执行暗骰门槛；
    - 依据周内对话倾向（soft/probe/press）与状态值计算推进势能；
    - 仅输出氛围反馈，不明示数字；
    - 判定通过即提前触发主事件。
  - 新增 `settle_week_dialogue_rewards(...)`：
    - 根据周内对话倾向结算属性（同步/觉察/权能）；
    - 根据提前触发天数给予坚韧回报；
    - 按角色互动倾向结算关系与丝线变量（米迦/塞西尔/卢西恩/卡修斯）。
  - `run_week_dialogues` 重构：
    - 签名改为 `run_week_dialogues(state, loop_no)`；
    - 返回主事件触发日（默认第 7 天，暗骰过门槛可提前）。
  - `loop_one` 至 `loop_seven`：
    - 全量切换到新签名调用，统一走新系统。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 七十、检定反馈增加【】标识分层

### 本次目标

- 让检定类文本与普通叙事行视觉上明确区分。

### 变更内容

- `text_runner.py`
  - 检定提示行改为：`【命运检定·属性】...`
  - 丝线反馈行改为：`【丝线回响】...`
  - 覆盖暴击/大失败/成功/失败四种丝线回响文本

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 七十一、结局停留修复 + 全周目七日对话接入

### 本次目标

- 修复 `text_runner.py` 打出结局后窗口直接关闭的问题。
- 为每个周目增加“七天 / 每天一次分支”的多轮对话层。

### 变更内容

- `text_runner.py`
  - 新增 `WEEK_PROMPTS`（1-7 周）：
    - 每周 7 条日程化对话触发语，形成“周内七日”节奏。
  - 新增 `run_week_dialogues(state, loop_no, speaker)`：
    - 每天提供 3 个对话分支（缓和倾听 / 深挖追问 / 先行定调）。
    - 每次选择累计为周内语气倾向，周末结算为本周余波：
      - 以“同拍”倾向强化队伍配合；
      - 以“深挖”倾向强化信息捕捉；
      - 以“定调”倾向强化门前控场。
  - 七日对话接入全部周目主流程：
    - `loop_one` ~ `loop_seven` 均在主事件前调用 `run_week_dialogues(...)`。
  - `main()` 末尾新增结局停留：
    - `run_story(state)` 后追加“终章幕布落下。按回车键离开。”并二次 `press_enter()`，
    - 保障双击运行场景下玩家有阅读与停留时间。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py`、`DEVELOPMENT_LOG.md` 无新增报错


## 七十七、日志补记：连携提示去标签化（末尾对齐）

### 本次目标

- 避免连携提示过于系统化，保持叙事自然感。
- 将本次变更补记到日志末尾，便于按时间顺序查阅。

### 变更内容

- `text_runner.py`
  - 连携弱提示文案去除 `【气息变化】` 前缀。
  - 连续同倾向触发仍保留隐性收益与暗骰加成，不显示数值。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 八十一、日志补记：八十条目末尾对齐

### 本次目标

- 解决 八十 条目不在日志末尾、难以定位的问题。

### 变更内容

- DEVELOPMENT_LOG.md
  - 在文件末尾补记本条，明确八十条目的核心改动：
    - 关系反馈改为剧情旁白口吻
    - 去掉等级命名感，不显示倾向阶位词
    - 保留内部强度分支，仅通过动作细节体现变化

### 验证

- 末尾可见本条补记，按时间顺序阅读不再遗漏

## 八十二、周内暗骰文案神秘化

### 本次目标

- 去掉周内暗骰与周末回收中的系统术语，改成纯叙事口径。

### 变更内容

- `text_runner.py`
  - 重写周内暗骰命中文案，去除“主事件/切入/触发”等直白词。
  - 重写未命中文案，保持神秘学气味与门前压迫感。
  - 周末回收句改为“第X天夜里，门先开口了”的叙事表达。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 八十三、七日收束到周目菜单的衔接优化

### 本次目标

- 解决“第X天夜里...”与周目选项菜单之间的硬切。
- 让切入更像一段连续镜头，而非系统跳转。

### 变更内容

- `text_runner.py`
  - 新增 `week_choice_bridge(loop_no, entry_day)`：
    - 为 1-7 周分别提供门前过桥旁白。
    - 统一口径：先落一层场景，再把说第一句话的权重交还给玩家。
  - `loop_one` ~ `loop_seven`：
    - `run_week_dialogues(...)` 改为接收 `entry_day`。
    - 在周目菜单前追加 `narrator(week_choice_bridge(...))`。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过
- `ReadLints`：`text_runner.py` 无新增报错

## 八十四、story_text 同步口授节律文案（周内旧称收口）

### 本次目标

- 将 text_runner 内新增的口授节律内暗骰与过桥旁白同步到 `story_text.txt`。
- 保证“文档稿/终端文本”口径一致。

### 变更内容

- `story_text.txt`
  - 新增章节：**口授七夜（与 text_runner 同步）**（旧稿条目名：**周内七日对话**）。
  - 收录节律内暗骰贴近/未贴近口径。
  - 收录 **口授收束**句：`第 X 天夜里，门先开口了...`。
  - 收录第一周至第七周菜单前过桥旁白。

### 验证

- `rg` 检查：`story_text.txt` 已包含上述同步段落。
- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过。
- `ReadLints`：`story_text.txt`、`DEVELOPMENT_LOG.md` 无新增报错。

## 八十五、结局文本扩写（story_text）

### 本次目标

- 提升九结局正文的信息密度与情绪层次。
- 保持既有结局走向不变，仅增强文本丰满度。

### 变更内容

- `story_text.txt`
  - 扩写 `DAWN / CANDLELIGHT / THRONE / ASCENSION / CYCLE / AUTHOR / PILGRIM / JUDGEMENT / COVENANT` 九条结局。
  - 新增队友动作细节、环境回声、后续余波段，强化“即时结果 + 延迟后果”的阅读体感。
  - 保持结局标题、分轴定位与判定摘要结构不变。

### 验证

- 人工回读：九结局均完成扩写，段落长度与画面层次提升。

## 八十六、story_text 优化（三律 + 去系统词 + 结局内核句）

- `story_text.txt`：篇首增加《世界底层三律》；Loop1–7 各补「当夜相位」关系速写；Loop6/7 选项与检定改纯叙事口径，策划变量移至文末附录；九结局各增一句内在悲剧收束。

## 八十七、story_text 附录中英表 + text_runner 与引擎检定对齐

- `story_text.txt`：新增《附录·字段名中英对照》（显性属性、隐藏丝线、线索开关、关系量；附第六周门前检定词条说明）；《判定摘要》主检定统一为 `roll_check("坚韧与并肩", …)`。
- `text_runner.py`：第六周目 `roll_check` 由「觉察加权能」改为「坚韧与并肩」（tenacity+sync，DC12）；第四周目与终局同类检定词条统一；`print_summary` 增加阶位行与底数字段名行。
- `game/script.rpy`：与上同口径，避免双端分叉。
- `branch_tree.html`：主检定代码示例同步为坚韧与并肩。
- `系统策划案.md`：主检定/变量表相关条目已随文档用词更新。
- `python -m py_compile text_runner.py` 通过。

## 八十八、text_runner 叙事对齐 story_text（关系口径 + 结局全文）

- `text_runner.py`
  - 各轮开场旁白、菜单标题（`LOOP N · …`）与选项措辞与 `story_text.txt` 对齐；状态区弱化「系统播报」口吻，改为「风里碎响」「同行微记」等关系速写式口径。
  - 第五轮「先找卡修斯」场景修正为蓝眼侧写（与角色设定一致）。
  - 九条结局正文拉齐至 `story_text.txt` 扩写版（黎明 / 烛光 / 王座 / 升华 / 轮回 / 作者 / 朝圣者 / 审判 / 盟约）。
  - 收束摘要处「本次完成周目」改为「本轮已走完章数」，与同轮 **`经折第 N 序`** 条幅与 `show_stats` 口吻一致。（旧稿参见「行旅第 N 章」——已收口，见本篇 **九十五条**。）

### 验证

- `python -m py_compile text_runner.py` 通过。

## 八十九、设定集融入 text_test 方法论 + story_text 叙事备忘 + text_runner 对齐

### 设定集

- `世界观设定集.md`：新增「文案方法论」节，把 `text_test/text-test-usage.md`（面试解析）中的悲剧内核、信息/代价规则、矛盾收编、延迟情感峰值等收编成埃尔西昂口径。
- `角色设定集.md`：新增「关系叙事取向」，写共振/并肩/宿敌距离与 Q2 五类悲剧路径的角色挂钩，不另开性别向剧情分轨。
- `系统策划案.md`：新增「文案与跨职能协同」；Loop4 变量说明与叙事选项统一为「找塞西尔和旧书」。

### 叙事文本

- `story_text.txt`：在三律与 LOOP 区块之间插入「叙事方法论备忘」，与上述设定及 `text_test/text-test-usage.md` 对齐。

### 终端剧本

- `text_runner.py`：文件头注明正文基线与设定出处；Loop4「把救人这件事摊开讲」分支对白与选项语义对齐。

### 验证

- `python -m py_compile text_runner.py` 通过。

## 九十、Ren’Py / branch_tree 与 story_text（三律、方法论、Loop4）对齐

- `game/script.rpy`：开场旁白补全「世界底层三律」与「叙事方法论备忘」条目；`show_stats` 与章首条幅为 **经折序言 + 命册五蕴**口径。Loop1–7 选项措辞与关键对白与 `story_text.txt`、`text_runner.py` 同源；Loop4 使用「找塞西尔和旧书」「把救人这件事摊开讲」及舌根/影子/当夜相位旁白顺序；Loop5–7 同步风声先到、括号选项与第七轮圣殿幔旌起句等。
- `branch_tree.html`：新增三律与方法论摘要卡片；Loop1 / Loop3 / Loop4 流程节点更新为现行选项名（含 Loop4 两条新主干）。
- `系统策划案.md`：变量改动来源表 Loop1–7 的选项名与 `story_text.txt` / `game/script.rpy` 菜单字符串对齐。
- `tools/copy_guard_check.py`：增加「固定词条」负向规则（如禁止「找卡修斯和旧书」「觉察加权能」）、`game/script.rpy` 必含子串校验；兜住/接住/极其 仅对叙事正文三文件扫描，避免误伤 `text_runner` 内 `banned_words` 配置。

### 验证

- `text_runner.py`：`python -m py_compile` 保持通过；Ren’Py DSL 未做 `py_compile`。
- `python tools/copy_guard_check.py` 通过。

## 九十一、2026-05-12 埃尔西昂口径落地：执印/旧庭、卡修斯声纹、双端对白

### 世界观与奈尔称谓

- `世界观设定集.md`：在「主线角色口径」下增补 **奈尔表层身份与他者称谓**（档案用语执印遗裔、旧庭线/旧庭要塞；民俗层仍可蔑称魔王，主干避免「魔王城」类标签）。
- `角色设定集.md`：奈尔条目与长段叙事改为 **执印遗裔** 表述；配套调整卡修斯卡条提要（学团出身、手记脚注与最坏假设、施法前把凶险说到头里）。
- Loop4/L5 **玩家侧选项**由「魔王/魔王城」改为 **「认下执印遗裔之名」「直接带线索去旧庭要塞」**；企划表与本分支图选项键同步。

### story_text.txt

- 选项与对白口径与设定集一致（执印、旧庭要塞）。
- **卡修斯**相关旁白与结局段：弱化「报告/公式/最优解」语汇，改用抄本落款、脚注、最坏走法、页边批等与《角色设定集》台词差分一致的意象（如 PILGRIM/COVENANT/DAWN 相关句）。

### text_runner.py 与 game/script.rpy

- 米迦对奈尔自白 **执印**：回应改为咬住执印、旧统、议会账面上的负担，仍为口语硬撑基调。
- **卡修斯**：周对话触发语、同伴声线库、门前染色镜头、`tinted_gate_narration` 中 cassius 行、Loop3～6 关键对白与上文设定对齐；去掉变量/阈值/参数/最优解一类工程腔，改用 **最坏、落款、脚注、注脚补强** 等条文式口语；坐标分支长句写明嗅觉代价口径。
- Loop4 收束后对玩家 **「别死在我眼前」** 类警告，收口为较轻版本：**真要补注脚的话，一次就够我受的了**（终端与 Ren’Py 一致）。
- 朝圣结局旁白人称呼 **与您 → 与你**。
- Python 嵌入在 `game/script.rpy` 内的的门镜头表与上文同改，避免脚本与 CLI 分叉。

### 其他文档

- `系统策划案.md`：两处选项条目键名与现行菜单字符串一致（认下执印遗裔之名 / 直接带线索去旧庭要塞）。
- `branch_tree.html`：Loop4/5 选项宽表与流程图选项节点已用新字符串。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py` 通过。

## 九十二、text_runner：隐去提前结局暗骰点值 + 七章条幅句式去重（口授节律）

### 动机

1. 「暗骰掷出 14」等台词会把隐藏随机数摊开给玩家。
2. **口授七夜节律**内与各 mood（软/追问/加压）复述同一套回声，读来像占位符不换章。

### 变更（`text_runner.py`）

- **提前结局** `early_resolution_check`：对白中移除 **数字化暗骰宣读**；改按已完成章节索引取用 **无端值的氛围句**，语义仍指向「裂痕/门框」但不报点。
- **`show_stats`**：副标题与 **`clue_cecil`（暗影徽记）**「风里碎响」按成章序号七言轮换。
- **`run_week_dialogues`**：`daily_aftermath_line`/`team_reaction_line` 用「章气味钩 × 日尾缀 × 分支」拼装；队内同调增益、隐秘姿态 streak、`hidden_week_gate` 命中失手、当周收束夜语均挂载 **七章 × 分支**独立文库，`resolve_hidden_stance`/`daily_rpg_feedback` 增加 `loop_no` 对齐当周。

### 说明

- **显性检定**（`roll_check`）不向玩家宣读原始骰面值，本条仅补强「提前结局路径」上对暗骰的泄漏。
- `python -m py_compile text_runner.py` 通过。

## 九十三、双端与文档同步：提前结局不报点 + copy_guard

### 变更

- **`game/script.rpy`**：`early_resolution_check` 与 `text_runner` 同源 `EARLY_RESOLUTION_RESONANCE` 八句，经 `early_resolution_whisper(loop_count)` 选用；`fate_notify` 裂隙副标由「暗骰：20」改为氛围短句（不报数值）。
- **`story_text.txt`**：补充成章后检定八句清单、裂缝 UI 副标口径；**口授七夜**节按成章词库以终端为准。
- **`branch_tree.html`** / **`系统策划案.md`**：各补一句玩家可见层不宣读暗骰点值的验收说明。
- **`tools/copy_guard_check.py`**：禁止叙事路径出现 `暗骰掷出` 与 `暗骰：数字` 式 UI；`script.rpy` 正向校验增加 `early_resolution_whisper` 与上述副标句。

### 验证

- `python g:\projects\my-vn\tools\copy_guard_check.py`
- `python -m py_compile g:\projects\my-vn\text_runner.py`

## 九十四、文档同步：Loop1 点名导入 + `VOICE_LIBRARY`「角色名｜」选项

### 动机

终端周第一周日程在第三日起切换为塞西尔等角色时，若无入户预告、选项又不标人名，玩家易产生「这人从哪冒出来」的割裂感。

### 变更

- **`game/script.rpy`** / **`text_runner.py`**：Loop1 入市口扩写卢西恩后，续写塞西尔／卡修斯可被预见的侧写；`run_week_dialogues(..., 1)` 内用一句短接引扣回**口授节律**（程序早已落地，本条为文档收口）。
- **`text_runner.py`**：`VOICE_LIBRARY` 四项 `options` 前缀 **`角色名｜`**；`ROLE_DIALOGUE_CONSTRAINTS.option_len` 放宽以适配前缀；卢西恩第三肢避免触发 `处置` 禁用替换。
- **`story_text.txt`**：LOOP ONE 预备条、**口授七夜**节补 **VOICE_LIBRARY 撰稿契约**说明。
- **`故事概览.md`** / **`系统策划案.md`**（Loop1 附注）/ **`角色设定集.md`**（执行清单）/ **`branch_tree.html`**（**命册节律 · 口授七夜**卡片）：写明入户顺序、`VOICE_LIBRARY` 前缀与约束入口。

### 验证

- `python g:\projects\my-vn\tools\copy_guard_check.py`
- `python -m py_compile g:\projects\my-vn\text_runner.py`

## 九十五、文档用语统一：经折 / 口授七夜 / 命册节律

### 动机

玩家在终端见到的条幅与口授菜单题头已收口为 **`经折第 X 序 ║ 口授七夜 ║ 「秘仪名」`**、**询之 N**、`show_stats` **命册五蕴** 等措辞；企划与设定稿中原「周内七日对话」「行旅第 N 章」等说法易与实现对读分叉。

### 用语约定（与设计稿互链时以此为准）

- **经折第 N 序**：成章序号条幅（对齐 `loop_count` 展示）；旧稿在周目／行旅章次语境下称「序」时对表本术语。
- **口授七夜**：每序固定七询向的对话节律（程序 `run_week_dialogues`）；单日菜单写作 `口授七夜 ║ 询之 k`。
- **命册五蕴**：显性五属性展示行（`show_stats`，觉察等）。
- **七秘仪名**：周次主题短名，`text_runner.WEEK_LECTORY_ARCANUM`（余烬权、缄影契、镜篆兆、裂契谶、回响钤、沉钟诰、阈扉仪）。
- **branch_tree** 卡片题：**命册节律 · 口授七夜**（条目曾作「周内七日对话系统」者仅保留于历史条目脚注）。

对白专名仍有 **「行旅银」** 等世界观词者保留，不与「经折」「口授」类系统 UI 混读。

### 变更文件一览

| 文件 | 调整摘要 |
|---|---|
| `故事概览.md` | 节题「口授七夜与门闸」；延伸阅读表与 `story_text` 互链用语 |
| `系统策划案.md` | Loop1 `text_runner` 附注：口授节律、互链 **`story_text`「口授七夜」** |
| `角色设定集.md` | 复发锚点：**经折序**；执行清单：**终端口授节律** |
| `story_text.txt` | 节题 **口授七夜**；预备条、收束／门闸／撰稿契约用词 |
| `DEVELOPMENT_LOG.md` | §七十二 / §八十四 / §九十 / §九十二～九十三 / §九十四 **口径脚注**与本条总录 |

### 验证

- `rg`：`故事概览.md`、`系统策划案.md`、`角色设定集.md`、`story_text.txt` 主叙述路径为 **口授七夜 / 口授节律 / 经折**；「周内七日对话」仅见于本条或历史条目脚注。
- `python g:\projects\my-vn\tools\copy_guard_check.py`
- `python -m py_compile g:\projects\my-vn\text_runner.py`

## 九十六、text_runner：`know_*` 初见观感 + 口授／反应题名门闸

### 动机

奈尔应在叙事上先记入同伴脸与声纹，口授 **`角色名｜`** 肢与队内反应题名才与各经折主线初见顺序对齐；《角色设定集》外貌量比在终端有一处可核验缩写。

### 变更

- **`text_runner.py`**：存档 `know_mika/know_cecil/know_cassius/know_lucien`；`repair_knowledge_flags`；`register_player_knowledge` 与观感段；`oral_teammates_known(state,…)`、`resolve_oral_voice`、`ORAL_STANDIN_PROMPTS`；首周口授七座日皆为米迦主声；`team_reaction_line(state,…)`。
- **`story_text.txt`**／**`branch_tree.html`**／**`game/script.rpy`**／**《角色设定集》**：识认节拍与「声线」类措辞对齐。

### 增补（措辞 / 节拍）

- 全局「嗓门」收口为「声线、声腔、声势」等；首周口授接引句同上。
- **卢西恩**初见前移至 **`loop_two` · `run_week_dialogues(...,2)`** 之前（北街针线侧）；旧存档 **`repair_knowledge_flags`**：`lc >= 2` 即 **`know_lucien`**，`lc >= 3` **`know_cassius`**。
- **`loop_four`**：已识卢西恩时用短再接，避免观感段复读。

### 验证

- `python -m py_compile g:\projects\my-vn\text_runner.py`
- `python g:\projects\my-vn\tools\copy_guard_check.py`

## 九十七、Ren'Py 发布版：`text_runner.run_week_dialogues` 运行时桥接 + 剧情块与终端对齐

### 动机

发布版须在每经折与终端走同一套「口授七夜」节律、主次答与神态起手式，避免 Ren'Py 仅保留主线而大段口头练习缺失；并让已写厚的对峙／阶前对白与终端同源。

### 变更

- 新增 **`game/zzz_oral_bridge.rpy`**：`sys.path` 注入项目父目录，`import text_runner`，以 `oral_register`/`oral_run_week`/`oral_week_bridge` 劫持 `text_runner.narrator`·`say`·`choose` 到 Ren'Py 的 `display_menu(Return(k))`，并在口授后对写回五蕴与 `know_*`·`rush_now`。
- **`game/script.rpy`**：`default know_*` 四枚；LOOP1–7 在各自主菜单前插入口授与日收束接引；LOOP1 刺杀线、LOOP2 街角／井沿神殿段、LOOP4–7 部分选项与检定余音用词与 **`text_runner.py`** 对齐。
- **`story_text.txt`** 顶注说明 Ren'Py 运行时依赖 **`text_runner.py`**；**`branch_tree.html`** 口授小节补一行 Ren'Py 同源说明。
- **`DEVELOPMENT_LOG.md`**（本条）。

### 验证

- `python g:\projects\my-vn\tools\copy_guard_check.py`
- （建议）Ren'Py 完整跑 LOOP1→2 目测口授菜单与接引句出现；未放置 `text_runner.py` 时验证单行跳过提示。

## 九十八、`DAILY_MICRO_EVENT_RULES` 与文档互链（日内小事件 · know_* 择句）

### 动机

日内旁白七章×七日须在叙事上与玩家当时 **`know_*`** 一致：已识认者可同台具名加深关系；未到识认则仅陌生人的碎语／谣传为照面预埋，并与口授题名门闸同源。

### 变更（文档）

- **`story_text.txt`**：顶注口授常量列表增补 **`DAILY_MICRO_EVENT_RULES`**；“口授七夜”条已述择句口径。
- **`故事概览.md`**：「口授七夜与门闸」增列 **日内小事件** 小节指 `story_text`。
- **`系统策划案.md`**：Loop1 **`text_runner.py`** 长附注增补 **`DAILY_MICRO_EVENT_RULES`** 插在 `第 N 天` 与 focal 之间的流程与 **`know_*` 子集优先级**。
- **`branch_tree.html`**：**命册节律 · 口授七夜** 卡片新增 **日内小事件** bullet。
- **`角色设定集.md`**：执行清单「终端口授节律」增补日内与 **`know_*`** 同步撰稿约束。
- **`DEVELOPMENT_LOG.md`**（本条）。

### 验证

- `python g:\projects\my-vn\tools\copy_guard_check.py`

## 九十九、LOOP3/4/6：去掉「检定／标题接上」玩家可见旁白 · 塞西尔观感卡去「五人比幅」

### 变更

- **`text_runner.py`** / **`game/script.rpy`**：Loop3 米迦合拍后接续雾港／灰原流言、Loop4 合议余波、Loop6 议事嚣响等处，重写为奈尔体感向旁白；**不出现**「同步检定过后」「远方的标题接上」「检定落稳」「咽不下的标题」「坚韧落定才接上……那一节」等元话术（底层 `roll_check` 及 **`【命运检定·…】`** 行文仍照旧）。
- **`text_runner.py`** **`_PLAYER_KNOWLEDGE_SNIPPET["cecil"]`**：删「五人中最……」一类全队比较句式，改写为巷道光影、腰身与肩背量距及目光落点。
- **`story_text.txt`**：LOOP THREE「世道／卡修斯脚注」两行与上锚点对齐措辞。

### 验证

- `python g:\projects\my-vn\tools\copy_guard_check.py`

## 九十九、LOOP3/4/6：去掉「检定／标题接上」玩家可见旁白 · 塞西尔观感卡去「五人比幅」

### 变更

- **`text_runner.py`** / **`game/script.rpy`**：Loop3 米迦合拍后接续雾港／灰原流言、Loop4 合议余波、Loop6 议事嚣响等处，重写为奈尔体内向旁白；**不出现**「同步检定过后」「远方的标题接上」「检定落稳」「咽不下的标题」「坚韧落定才接上……那一节」等元话术（系统层 `roll_check` 与 **`【命运检定·…】`** 提示仍照旧）。
- **`text_runner.py`** **`_PLAYER_KNOWLEDGE_SNIPPET["cecil"]`**：删「肩线臂展在五人中拉得最开」一类破坏当场沉浸的全队比较句，改写为巷道光影、腰身量距、鸢紫目光落点与站姿习惯。
- **`story_text.txt`**：LOOP THREE「世道／卡修斯脚注」两行与上锚点对齐措辞。

### 验证

- `python g:\projects\my-vn\tools\copy_guard_check.py`