docs: 按 Godot 规范优化全部 GDScript 注释

- 类/信号/方法添加 ## 文档注释与 @param 标签
- 清理 pass 占位残留
This commit is contained in:
2026-08-03 22:25:43 +08:00
parent 19f81ceeec
commit 782b1f1701
8 changed files with 115 additions and 23 deletions
+9 -1
View File
@@ -1,15 +1,21 @@
## 全局游戏状态(Autoload 单例)。
## 负责场景间参数传递与会话状态管理,不持有游戏内数据。
extends Node
## 进入游戏的方式。
enum GameMode { NEW_GAME, LOAD_GAME }
## 当前进入游戏的方式。
var mode: GameMode = GameMode.NEW_GAME
## 要加载的存档 ID(仅 LOAD_GAME 时有效)。
var save_id: String = ""
# 游戏内时间(12 月 × 30 天 = 360 天/年)
# 游戏内时间(12 月 × 30 天 = 360 天/年),实际推进由 TimeSystem 负责
var year: int = 1
var month: int = 1
var day: int = 1
## 请求开始新游戏:重置模式与时间。
func request_new_game() -> void:
mode = GameMode.NEW_GAME
save_id = ""
@@ -17,6 +23,8 @@ func request_new_game() -> void:
month = 1
day = 1
## 请求加载指定存档。
## @param id: 存档 ID
func request_load_game(id: String) -> void:
mode = GameMode.LOAD_GAME
save_id = id