diff --git a/项目文档.md b/项目文档.md
index a4100a9..1698fd4 100644
--- a/项目文档.md
+++ b/项目文档.md
@@ -107,10 +107,12 @@
 在 **`default`** 那条池子上更新 **`profit_amount`**：
 
 - **付费局**：本局贡献 `+= (本局总中奖 win_coin) - (本局付费 paid_amount)`，其中 `paid_amount = ante × 100`。  
-- **免费局**：`+= win_coin`（无票价成本）。
+- **免费局**：`+= win_coin`（无票价成本，`paid_amount = 0`）。
 
 该累计值与 **`safety_line`、 `kill_enabled`** 共同决定下一局付费是否进入 **killScore** 档位权重（见 4.2）。
 
+> 注意：仓库中部分数据库迁移脚本对 `profit_amount` 的注释可能仍沿用旧口径（例如按 `100-real_ev` 解释）。当前线上行为应以 `PlayStartLogic` 中对 `profit_amount` 的实际累加逻辑为准。
+
 ---
 
 ## 5. 数据与配置要点（实现侧）