Add review reports for Chapter 1, Chapter 2, and Chapter 2-Side; include image assets and logic checks

- Created Chapter1-review.md with syntax, character definitions, and dialogue checks. - Created Chapter2-review.md with syntax, missing images, and logic errors. - Created Chapter2-Side-review.md addressing syntax, character definitions, and dialogue issues. - Added SUMMARY.md to summarize review findings and highlight critical issues. - Included new image assets for xiaowei and backup files. - Identified and documented several logic errors and suggestions for code cleanup across chapters.
2026-04-26 13:32:11 +08:00
parent eb38af6045
commit 6c65eafa32
23 changed files with 1040 additions and 9 deletions
--- a/review/Chapter1-review.md
+++ b/review/Chapter1-review.md
@@ -0,0 +1,131 @@
+# Chapter1.rpy 审阅报告
+
+## 文件信息
+- 文件路径: `game/Chapters/Chapter1.rpy`
+- 行数: 429
+- 包含场景: Chapter1_Scene1 ~ Chapter1_Scene4
+- 跳转终点: Chapter2_Scene1（位于 Chapter2.rpy）
+
+---
+
+## 语法错误
+
+**无严重语法错误**。Ren'Py 基本语法正常，`scene`/`show`/`hide`/`jump` 语句格式正确，`$` Python 赋值语句语法正常。
+
+---
+
+## 角色定义检查
+
+| 角色 | 定义位置 | 使用情况 | 状态 |
+|------|----------|----------|------|
+| `me` | script.rpy:4 | 正常 | ✓ |
+| `system_` | script.rpy:11 | 正常 | ✓ |
+| `xingyu` | script.rpy:5 | 正常 | ✓ |
+| `lhy` | script.rpy:6 | 正常 | ✓ |
+| `lzx` | script.rpy:7 | 仅旁白引用，未使用 Character 发言 | ✓ |
+| `tongxue` | script.rpy:16 | 正常 | ✓ |
+| `yutong` | script.rpy:13 | 正常 | ✓ |
+| `ganshi` | script.rpy:17 | 正常 | ✓ |
+| `xiaowei` | script.rpy:9 | 正常 | ✓ |
+| `xiaowei_w` | script.rpy:10 | 正常 | ✓ |
+| `me_w` | script.rpy:15 | 正常 | ✓ |
+| `mom` | script.rpy:12 | 正常 | ✓ |
+| `yh` | script.rpy:14 | 正常 | ✓ |
+| `"便利店主"` | 行343（字符串字面量） | ⚠️ 见下方说明 | ✓ |
+
+### 关于"便利店主"角色（行 343）
+
+```renpy
+"便利店主" "小任，新品。尝尝，你们年轻人喜欢这个。"
+```
+
+此角色未在 script.rpy 中定义为 Character 对象，使用了内联字符串作为说话人。Ren'Py **允许**此写法，会自动生成临时角色。但建议统一在 script.rpy 中定义，便于管理颜色、语速等属性。
+
+---
+
+## 图像引用检查
+
+所有 `show` 命令引用的图像均在 `game/images/` 目录中找到对应文件：
+
+| 引用 | 文件 |
+|------|------|
+| `aunt normal` | `aunt normal.png` ✓ |
+| `xingyu thinking/laughing/laughing big/laughing 2` | 对应 png 均存在 ✓ |
+| `ryt dialogue normal/hit/embarrass pocket/embarrass pocket2/normal spec` | 对应 png 均存在 ✓ |
+| `lhy dialogue normal` | `lhy dialogue normal.png` ✓ |
+| `yh camerabag` | `yh camerabag.png` ✓ |
+| `xiaowei` / `xiaowei embarrass` | 对应 png 均存在 ✓ |
+
+所有背景图像文件均存在 ✓
+
+---
+
+## Flag 和变量检查
+
+### 统计变量修改
+
+| 变量 | 修改位置 | 累计修改值 |
+|------|----------|-----------|
+| `lhy_stats["affection"]` | 行85, 153, 323 | +3, +5, +3 = **+11** |
+| `lhy_stats["trust"]` | 行86, 154 | +2, +5 = **+7** |
+| `lhy_stats["empathy"]` | 行155 | **+3** |
+| `xingyu_stats["affection"]` | 行87, 320 | +3, +5 = **+8** |
+| `xingyu_stats["cooperation"]` | 行88, 321 | +2, +5 = **+7** |
+| `xingyu_stats["helpfulness"]` | 行322 | **+3** |
+| `tao_stats["humorSense"]` | 行89 | **+2** |
+| `tao_stats["selfAcceptance"]` | 行156, 326, 380 | +1, +2, +1 = **+4** |
+| `tao_stats["studyStress"]` | 行157, 381 | +2, +1 = **+3** |
+| `lzx_stats["infoOpenness"]` | 行90 | **+1** |
+| `yutong_stats["affection"]` | 行193, 378, 397 | +3, +2, +3 = **+8** |
+| `yutong_stats["attention"]` | 行194, 379, 398 | +5, +3, +4 = **+12** |
+| `yutong_stats["h_academicSupport"]` | 行195 | **+1** |
+| `xiaowei_stats["affection"]` | 行233, 412 | +4, +3 = **+7** |
+| `xiaowei_stats["interactionFrequency"]` | 行234, 413 | +2, +3 = **+5** |
+| `xiaowei_stats["is_xiaowei_w"]` | 行235 | 设为 False |
+| `yh_stats["affection"]` | 行324 | **+3** |
+| `yh_stats["understanding"]` | 行325 | **+2** |
+
+所有修改的 stat key 均在 script.rpy 中定义 ✓
+
+### 其他变量
+
+- `gallery_photo4_unlocked = True` (行73): 定义在 script.rpy:90 ✓
+- `game_day` / `game_period`: 正常赋值 ✓
+
+---
+
+## 逻辑错误
+
+### ⚠️ 1. `hide ryt` 冗余调用（行 128）
+
+```renpy
+# 行125: #show ryt hit at center with dissolve    ← 已被注释
+# 行126: scene bg playground with dissolve        ← scene 清空所有图像
+# 行127: me "深吸一口气..."                        ← me 无 sprite 也能说话
+# 行128: hide ryt with dissolve                   ← ryt 已不存在，无操作
+```
+
+`show ryt` 已被注释，且 `scene` 语句已清空场景，`hide ryt` 为无效操作。不会导致运行时错误，但可删除。
+
+### ⚠️ 2. `$ xiaowei_stats["is_xiaowei_w"] = False` 冗余（行 235）
+
+`is_xiaowei_w` 默认值已为 `False`（script.rpy:46），此处重新赋值无实际效果。虽不致命，但如果意图是"在特定剧情点重置该 flag"，应确认逻辑正确性。
+
+---
+
+## 奇怪/不当的对话
+
+### 无明显问题
+Chapter1 的对话整体符合角色设定，叙事流畅，不存在明显不当内容。
+
+### 小建议
+- 行58: `me "你们先打，下次我一定来 {cps=3} {cps=20}——前提是我妈能接受她儿子在篮球场上挥洒青春而不是在车里背单词。"` 中 `{cps=3}` 后跟空格再 `{cps=20}`，在空格处会以 cps=20 显示，即瞬间且无声停顿后正常语速。符合预期停顿效果。
+
+---
+
+## 清理建议
+
+1. 删除无效注释行（如行61 的 `#stop music fadeout 1.0`、行125 的 `#show ryt hit...` 等）
+2. 删除元数据注释（行71, 78, 165, 177, 182, 218, 243 中的 `.lzx` 标注属于作者审阅标记，不应留在正式脚本中）
+3. 将 `"便利店主"` 统一定义为 Character 对象
+4. 删除行128 的冗余 `hide ryt`
--- a/review/Chapter2-Side-review.md
+++ b/review/Chapter2-Side-review.md
@@ -0,0 +1,110 @@
+# Chapter2-Side.rpy 审阅报告
+
+## 文件信息
+- 文件路径: `game/Chapters/Chapter2/Chapter2-Side.rpy`
+- 行数: 126
+- 包含场景: C2Side1, C2Side1S1, C2Side1S2, C2Side1S3
+- 入口: 仅从 Chapter2_Scene1 菜单"邀请刘泓予"跳入
+
+---
+
+## 语法错误
+
+**无语法错误**。
+
+---
+
+## 角色定义检查
+
+| 角色 | 定义位置 | 使用情况 | 状态 |
+|------|----------|----------|------|
+| `me` | script.rpy:4 | 正常 | ✓ |
+| `lhy` | script.rpy:6 | 正常 | ✓ |
+| `tongxue` | script.rpy:16 | 正常 | ✓ |
+
+---
+
+## 图像引用检查
+
+- `bg rooftop`: `bg rooftop.png` 存在（untracked）✓
+- `lhy dialogue normal`: 存在 ✓
+- `ryt dialogue normal` / `ryt dialogue embarrass pocket` / `ryt dialogue embarrass pocket2`: 存在 ✓
+
+---
+
+## Flag 和变量检查
+
+| 变量/Flag | 设置位置 | 值 | 读取位置 |
+|-----------|----------|-----|----------|
+| `flag["C4"]` | 行75 | 1 | **未读取** |
+| `flag["competition_note"]` | 行75 | True | Chapter2.rpy:237 |
+| `lhy_stats["trust"]` | 行77, 100 | +2 / +1 | — |
+| `lhy_stats["empathy"]` | 行79, 101, 123 | +1 each | — |
+| `tao_stats["humorSense"]` | 行78, 101, 122 | +1 each | — |
+| `lhy_stats["affection"]` | 行38, 41, 44 | +3/+2/+1 (按选择) | — |
+
+### 未使用的 Flag
+`flag["C4"]` (行75): 在 C2Side1S1 分支中设为 1，但代码库中未读取。推测为第4章的预留 flag，建议加注释说明。
+
+---
+
+## 逻辑错误
+
+### 🔴 严重: `return` 导致游戏直接结束 (行 6-7)
+
+```renpy
+label C2Side1:
+    if lhy_stats["affection"] < 11:
+        return
+```
+
+**问题**: 进入 C2Side1 的方式是通过 `jump C2Side1`（Chapter2.rpy:45），没有 `call` 调用栈。当 `return` 被执行时，Ren'Py 会**返回主菜单**，而非继续游戏。
+
+**触发条件**: `lhy_stats["affection"] < 11`。实际上 Chapter1 结束时 lhy affection = 11（3+5+3），加上 Chapter2_Scene1 选择"邀请刘泓予"后 +5 = 16，所以当前数据下该条件永远为 False。但：
+- 若有其他路径进入 C2Side1 且 affection 不足，游戏会异常退出
+- 代码意图是"好感度不够时跳过支线"
+
+**修复**:
+```renpy
+if lhy_stats["affection"] < 11:
+    jump C2S2
+```
+
+---
+
+## 奇怪/不当的对话
+
+### 🔴 严重: 行89 — 极度不当的辱骂
+
+```renpy
+me "你妈死了刘泓予!"
+```
+
+这是 C2Side1S2（选择"怕什么，我可以一打三"）分支中的主角台词。上下文：
+
+```
+lhy "你的自信心从何而来我一直很好奇。但这确实有一定作用。"
+me "你妈死了刘泓予!"          ← 突兀的辱骂
+```
+
+**问题严重**:
+1. 与前后文**完全脱节**——刘泓予刚说完一句中性偏正面的话，主角毫无理由地突然辱骂
+2. 与主角**人设严重冲突**——任懿涛是使用幽默应对压力的高中生，不是毫无理由口出恶言的人
+3. 在校园题材视觉小说中加入此类粗口极为不协调
+
+**建议**: 立刻替换为符合角色性格的台词。例如：
+```renpy
+me "你说话怎么跟我妈似的..."
+```
+或:
+```renpy
+me "行行行，你说得对。但我就是自信，天生的。"
+```
+
+---
+
+## 清理建议
+
+1. **立即修改行89的辱骂台词**（最高优先级）
+2. 修复行7的 `return` → `jump C2S2`
+3. 为 `flag["C4"]` 添加用途注释
--- a/review/Chapter2-review.md
+++ b/review/Chapter2-review.md
@@ -0,0 +1,160 @@
+# Chapter2.rpy 审阅报告
+
+## 文件信息
+- 文件路径: `game/Chapters/Chapter2/Chapter2.rpy`
+- 行数: 440
+- 包含场景: Chapter2_Scene1, C2S2 ~ C2S7 + C2S5_end
+- 新增角色定义: `zhuchi` (主持人), `yang` (杨义涵)
+
+---
+
+## 语法错误
+
+**无语法错误**。`menu` 语句、条件跳转、`if`/`else` 结构基本正确（详见下方逻辑错误部分）。
+
+---
+
+## 角色定义检查
+
+| 角色 | 定义位置 | 使用情况 | 状态 |
+|------|----------|----------|------|
+| `me` | script.rpy:4 | 正常 | ✓ |
+| `system_` | script.rpy:11 | 正常 | ✓ |
+| `xingyu` | script.rpy:5 | 正常 | ✓ |
+| `lhy` | script.rpy:6 | 正常 | ✓ |
+| `yh` | script.rpy:14 | 正常 | ✓ |
+| `xiaowei` | script.rpy:9 | 正常 | ✓ |
+| `xiaowei_w` | script.rpy:10 | 正常 | ✓ |
+| `me_w` | script.rpy:15 | 正常 | ✓ |
+| `yutong` | script.rpy:13 | 正常 | ✓ |
+| `zhuchi` | Chapter2.rpy:2 | 正常 | ✓ |
+| `yang` | Chapter2.rpy:3 | 正常 | ✓ |
+| `tongxue` | script.rpy:16 | 未在 Chapter2 使用 | — |
+
+### yutong 角色使用
+`yutong` 在 C2S3 (行194) 中被 `show` 显示为 sprite，但 `game/images/` 中**不存在 `yutong.png`**，游戏运行到此时会报错。详见下方"缺失资源"。
+
+---
+
+## 图像引用检查
+
+### 🔴 缺失的图像文件
+
+| 引用位置 | 图像名 | 文件 | 状态 |
+|----------|--------|------|------|
+| 行58 | `bg computer lab` | — | **缺失！** |
+| 行130 | `bg computer lab door` | — | **缺失！** |
+| 行194 | `yutong` (sprite) | — | **缺失！** |
+| 行337 | `bg schoolgate evening` | — | **缺失！** |
+| 行406 | `bg ryt room night` | — | **缺失！** |
+
+### 已存在但未跟踪的资源
+| 引用 | 文件 | Git 状态 |
+|------|------|-----------|
+| `bg auditorium` (行233) | `bg auditorium.png` | untracked |
+| `bg rooftop` | `bg rooftop.png` | untracked |
+| `bg xiaowei room night` | `bg xiaowei room night.png` | untracked |
+
+---
+
+## Flag 和变量检查
+
+### Flag 字典
+
+| Flag | 设置位置 | 读取位置 | 状态 |
+|------|----------|----------|------|
+| `flag["lhy_team"]` | 行44 (True) / 行48 (False) | 未读取 | ⚠️ 只写未读 |
+| `flag["C2S1_think"]` | 行51 (False) | 未读取 | ⚠️ 只写未读 |
+| `flag["competition_note"]` | C2Side1.rpy:75 (True) | 行237 `.get(...)` | ✓ |
+
+### 统计变量修改
+
+| 变量 | 修改位置 | 值 |
+|------|----------|-----|
+| `lhy_stats["affection"]` | 行43, 318 | +5, +1 |
+| `xingyu_stats["affection"]` | 行47 | -5 (惩罚分支) |
+| `yh_stats["affection"]` | 行175, 314 | +2, +1 |
+| `yh_stats["understanding"]` | 行176 | +2 |
+| `xiaowei_stats["affection"]` | 行173, 281, 367-378 | 根据选择 +1~3 |
+| `xiaowei_stats["interactionFrequency"]` | 行174, 282, 398 | +2 × 2 |
+| `xiaowei_stats["synergy"]` | 行397 | +3 |
+| `xiaowei_stats["is_xiaowei_w"]` | 行283 | True |
+| `yutong_stats["affection"]` | 行224, 429 | +2 × 2 |
+| `yutong_stats["attention"]` | 行225, 430 | +2 × 2 |
+| `tao_stats["humorSense"]` | 行330 | +2 |
+| `tao_stats["selfAcceptance"]` | 行432 | +2 |
+| `lzx_stats["infoOpenness"]` | 行431 | +1 |
+
+所有 key 均在 script.rpy 中定义 ✓
+
+---
+
+## 逻辑错误
+
+### 🔴 严重: C2S3 条件跳转无效 (行 178-181)
+
+```renpy
+if yutong_stats["affection"] >= 8 and yutong_stats["attention"] >= 12:
+    jump C2S3
+
+label C2S3:
+```
+
+**问题**: `if` 语句没有 `else` 分支。条件为 False 时，代码将"掉入"下一行——而下一行正好是 `label C2S3:`。意味着 **无论条件真假，C2S3 都会执行**，条件形同虚设。
+
+实际上，Chapter1 结束时 `yutong_stats["affection"]` = 8, `attention` = 12（恰好等于阈值），所以当前数据下条件始终为 True。但:
+1. 如果后续修改 Chapter1 的数值，bug 就会暴露
+2. 代码意图显然是"条件满足才进入 C2S3"
+
+**修复**: 添加 else 跳转:
+```renpy
+if yutong_stats["affection"] >= 8 and yutong_stats["attention"] >= 12:
+    jump C2S3
+else:
+    jump C2S4
+```
+
+### ⚠️ 2. `flag["lhy_team"]` 和 `flag["C2S1_think"]` 只写未读
+
+- `flag["lhy_team"]` 在行44/48 被设置，但整个代码库中从未读取。如果未来章节需要使用，建议添加注释说明用途。
+- `flag["C2S1_think"]` 同样只设置未使用。
+
+---
+
+## 奇怪/不当的对话
+
+### 🔴 行63: 不当用词
+
+```renpy
+me "训练赛，对手是颜涵和杨天赐。一个音游龙👃，一个不知道是男娘还是男同的玩意儿。"
+```
+
+- emoji `👃` 在 Ren'Py 中可能无法正确渲染
+- "男娘"和"男同"属于对同学不尊重的称呼，与主角"用幽默掩饰不自信"的人设不完全吻合。建议修改为更符合高中生日常表达的方式。
+
+### ⚠️ 行301: 疑似错别字
+
+```renpy
+yang "我要和仁懿涛——"
+```
+
+"任懿涛"写成了"仁懿涛"。若是刻意设计（体现角色口误），建议加注释；否则应修正。
+
+### ⚠️ 行326: 注释中的存疑台词
+
+```renpy
+# me "最终事件平息。比赛继续。但我鼻子里残留着韭菜盒子的味道，还有满场的笑声没散。"
+```
+
+这段被注释掉了。如果决定不用，建议直接删除而非保留注释。
+
+---
+
+## 清理建议
+
+1. **补充 5 个缺失的图像文件**（见上方清单）
+2. 修复 C2S3 条件跳转逻辑（行178-181）
+3. 修改行63的不当用词
+4. 确认行301的"仁懿涛"是否为刻意
+5. 删除行325-326的注释代码
+6. 为只写未读的 flag 添加注释说明用途，或标记为 `# TODO: 第X章使用`
--- a/review/SUMMARY.md
+++ b/review/SUMMARY.md
@@ -0,0 +1,59 @@
+# 审阅总览
+
+> 审阅日期: 2026-04-26 | 项目版本: dev0.0.8.5
+
+## 审阅范围
+
+| 文件 | 行数 | 场景数 | 报告 |
+|------|------|--------|------|
+| `game/Chapters/Chapter1.rpy` | 429 | 4 (Scene1~4) | [Chapter1-review.md](Chapter1-review.md) |
+| `game/Chapters/Chapter2/Chapter2.rpy` | 440 | 7 (Scene1, C2S2~S7) | [Chapter2-review.md](Chapter2-review.md) |
+| `game/Chapters/Chapter2/Chapter2-Side.rpy` | 126 | 4 (C2Side1, S1~S3) | [Chapter2-Side-review.md](Chapter2-Side-review.md) |
+
+---
+
+## 问题汇总（按严重程度排序）
+
+### 🔴 严重 — 必须修复
+
+| # | 文件 | 位置 | 问题 |
+|---|------|------|------|
+| 1 | Chapter2-Side.rpy | 行89 | **极度不当台词**：`me "你妈死了刘泓予!"` — 突兀辱骂，与角色人设完全不符 |
+| 2 | Chapter2-Side.rpy | 行7 | **`return` 导致游戏退出**：好感不足时应 `jump C2S2` 而非 `return` |
+| 3 | Chapter2.rpy | 行178-181 | **C2S3 条件跳转无效**：缺少 `else`，条件形同虚设 |
+| 4 | Chapter2.rpy | — | **5 个图像文件缺失**：`bg computer lab`, `bg computer lab door`, `yutong` (sprite), `bg schoolgate evening`, `bg ryt room night` |
+
+### ⚠️ 警告 — 建议修复
+
+| # | 文件 | 位置 | 问题 |
+|---|------|------|------|
+| 5 | Chapter2.rpy | 行63 | 不当用词（"男娘"/"男同" 称呼同学） |
+| 6 | Chapter2.rpy | 行301 | "仁懿涛"疑为"任懿涛"错别字 |
+| 7 | Chapter2.rpy | 行44,48,51 | `flag["lhy_team"]` / `flag["C2S1_think"]` 只写未读 |
+| 8 | Chapter2-Side.rpy | 行75 | `flag["C4"]` 只写未读 |
+| 9 | Chapter1.rpy | 行128 | `hide ryt` 无效操作（scene 已清空，show 已被注释） |
+| 10 | Chapter1.rpy | 行235 | `is_xiaowei_w = False` 冗余（默认已是 False） |
+
+### 💡 建议 — 清理优化
+
+| # | 文件 | 位置 | 问题 |
+|---|------|------|------|
+| 11 | Chapter1.rpy | 多处 | 删除元数据注释（`.lzx` 标注、注释掉的废弃代码） |
+| 12 | Chapter1.rpy | 行343 | `"便利店主"` 建议定义为 Character 对象 |
+| 13 | Chapter2.rpy | 行325-326 | 删除废弃的注释代码 |
+
+---
+
+## 各角色 stats 定义完整性
+
+全部通过。所有在 Chapters 中使用的 stat key 均在 `script.rpy` 中正确定义，无拼写错误。
+
+## 跳转目标完整性
+
+| 跳转 | 目标标签 | 所在文件 | 状态 |
+|------|----------|----------|------|
+| `jump Chapter1_Scene2/3/4` | 同文件 | Chapter1.rpy | ✓ |
+| `jump Chapter2_Scene1` | Chapter2_Scene1 | Chapter2.rpy:5 | ✓ |
+| `jump C2Side1` | C2Side1 | Chapter2-Side.rpy:4 | ✓ |
+| `jump C2S2~S7` | 同文件 | Chapter2.rpy | ✓ |
+| `jump C2Side1S1/S2/S3` | 同文件 | Chapter2-Side.rpy | ✓ |