1

docs/technical/PUZZLE_FAILURE_EXTENSION_AND_SAVE_ARCHIVE_2026-05-01.md

@@ -14,8 +14,8 @@
 
 1. 限定时间内未完成时弹出失败面板。
 2. 失败面板提供两个选择：
-   - `重新开始`：重新开启当前拼图关卡，不扣光点。
-   - `继续1分钟`：先弹出确认窗口，确认后消耗 `1` 光点，并把当前失败关卡恢复为 `playing`，剩余时间固定为 `60000ms`。
+   - `重新开始`：重新开启当前拼图关卡，不扣泥点。
+   - `继续1分钟`：先弹出确认窗口，确认后消耗 `1` 泥点，并把当前失败关卡恢复为 `playing`，剩余时间固定为 `60000ms`。
 3. 进入拼图作品后立即写入 `profile_save_archive`，存档页显示拼图存档。
 4. 每次进入下一关后更新同一条拼图存档，使存档恢复时指向最新可继续的关卡。
 
@@ -26,7 +26,7 @@
 `PuzzleRuntimePropKind` 增加 `extendTime`，沿用现有道具确认与扣费接口：
 
 1. 前端只在 `runtimeStatus = failed` 时开放 `继续1分钟`。
-2. 点击后打开独立确认弹窗，文案只显示短标题和 `消耗 1 光点`。
+2. 点击后打开独立确认弹窗，文案只显示短标题和 `消耗 1 泥点`。
 3. 正式 run 继续走 `POST /api/runtime/puzzle/runs/:runId/props`。
 4. `api-server` 将 `extendTime` 映射为账单 `asset_kind = puzzle_prop_extend_time`。
 5. SpacetimeDB 侧只允许失败关卡续时；续时成功后：
@@ -37,7 +37,7 @@
    - 清空暂停与冻结生效点
    - 调整 `paused_accumulated_ms`，保证从确认成功那一刻开始完整倒计时 `60` 秒
 
-本地调试 run 没有真实钱包，沿用本地道具兜底：仍弹确认窗，但不扣真实光点。
+本地调试 run 没有真实钱包，沿用本地道具兜底：仍弹确认窗，但不扣真实泥点。
 
 ### 重新开始
 
@@ -91,7 +91,7 @@ SpacetimeDB 拼图运行态每次持久化 run 时同步刷新存档：
 
 1. 倒计时归零后失败弹窗有 `重新开始` 和 `继续1分钟`。
 2. 点击 `继续1分钟` 后先出现扣费确认，确认成功后失败弹窗关闭并恢复 `60` 秒倒计时。
-3. 光点余额不足时确认弹窗保留，并展示错误。
+3. 泥点余额不足时确认弹窗保留，并展示错误。
 4. 点击 `重新开始` 后当前关卡重新打乱并重置倒计时。
 5. 进入拼图作品后，存档页出现 `worldType = PUZZLE` 的拼图存档。
 6. 通过一关后，只要后端确认同作品下一关存在，同一条存档立即更新到新关卡；没有同作品下一关时保留已完成关卡，等待玩家选择相似作品。