docs: 全局脚本补充文档注释（14 个文件 29 处）

src/Core/GameConfig.gd

@@ -72,6 +72,7 @@ var aptitude_weights_by_difficulty: Dictionary = {
 }
 
 
+## 启动时加载配置文件。
 func _ready() -> void:
 	_load_config()
 

src/Core/GameState.gd

@@ -13,9 +13,9 @@ var profile_id: int = 0
 var save_slot: String = ""
 
 # 游戏内时间（12 月 × 30 天 = 360 天/年），实际推进由 TimeSystem 负责
-var year: int = 1
-var month: int = 1
-var day: int = 1
+var year: int = 1   # 年
+var month: int = 1  # 月（1-12）
+var day: int = 1    # 日（1-30）
 
 ## 请求开始新游戏。
 ## @param pid: 新存档组 ID（主菜单创建）

src/Core/MainGame.gd

@@ -2,6 +2,7 @@
 ## 进入游戏时根据 GameState 模式初始化，并连接顶部 HUD 信号。
 extends Node
 
+## 进入游戏世界：注册场景分组，按 GameState 模式初始化（新游戏/读档）。
 func _ready() -> void:
 	# 注册为游戏世界场景（供 TimeSystem 判断是否推进时间）
 	add_to_group("game_scene")

src/Core/SectManager.gd

@@ -10,40 +10,58 @@ var reputation := 0         # 声望
 var food := 0               # 灵米（食物资源，HUD 显示"灵米"）
 
 
+## 增加灵石并广播信号。
+## @param amount: 增加量
 func add_spirit_stones(amount: int) -> void:
 	spirit_stones += amount
 	emit_signal("spirit_stones_changed", spirit_stones, amount)
 
+## 减少灵石并广播信号。
+## @param amount: 减少量
 func remove_spirit_stones(amount: int) -> void:
 	spirit_stones -= amount
 	emit_signal("spirit_stones_changed", spirit_stones, -amount)
 
+## 增加声望并广播信号。
+## @param amount: 增加量
 func add_reputation(amount: int) -> void:
 	reputation += amount
 	emit_signal("reputation_changed", reputation, amount)
 
+## 减少声望并广播信号。
+## @param amount: 减少量
 func remove_reputation(amount: int) -> void:
 	reputation -= amount
 	emit_signal("reputation_changed", reputation, -amount)
 
+## 增加灵米并广播信号。
+## @param amount: 增加量
 func add_food(amount: int) -> void:
 	food += amount
 	emit_signal("food_changed", food, amount)
 
+## 减少灵米并广播信号。
+## @param amount: 减少量
 func remove_food(amount: int) -> void:
 	food -= amount
 	emit_signal("food_changed", food, -amount)
 
+## 直接设定灵石（读档/新游戏用，带信号 HUD 自动刷新）。
+## @param value: 目标值
 func set_spirit_stones(value: int) -> void:
 	var delta := value - spirit_stones
 	spirit_stones = value
 	spirit_stones_changed.emit(spirit_stones, delta)
 
+## 直接设定声望（读档/新游戏用，带信号 HUD 自动刷新）。
+## @param value: 目标值
 func set_reputation(value: int) -> void:
 	var delta := value - reputation
 	reputation = value
 	reputation_changed.emit(reputation, delta)
 
+## 直接设定灵米（读档/新游戏用，带信号 HUD 自动刷新）。
+## @param value: 目标值
 func set_food(value: int) -> void:
 	var delta := value - food
 	food = value

src/Core/TimeSystem.gd

@@ -41,6 +41,7 @@ var paused := false
 var _elapsed := 0.0
 
 
+## 每帧累积时间，满一天推进日期（仅游戏世界场景内）。
 func _process(delta: float) -> void:
 	if paused or not _is_in_game():
 		return