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

src/Character/Disciple.gd

@@ -20,7 +20,7 @@ const REALM_NAMES: Array[String] = ["练气", "筑基", "金丹", "元婴", "化
 var id: int = 0                # 唯一编号（DiscipleManager 分配）
 var name: String = ""
 var age: int = 0
-var aptitude: Aptitude = Aptitude.ORDINARY
+var aptitude: Aptitude = Aptitude.ORDINARY   # 资质（入宗分流结果）
 var roots: Array[SpiritRoot] = []   # 普通弟子 1~5 根；天灵根固定 1 根
 var is_heavenly: bool = false       # 天灵根标记（仅天骄资质，概率见配置）
 var join_year: int = 0              # 入宗年份（0 = 未入宗/候选），accept 时快照
@@ -35,6 +35,7 @@ var hunger_days: int = 0            # 断粮累计天数（≥阈值离宗，方
 func get_aptitude_name() -> String:
 	return APTITUDE_NAMES[aptitude]
 
+## 灵根显示文本，如 "金、木"。
 func get_roots_text() -> String:
 	var names: Array[String] = []
 	for root in roots:
@@ -49,6 +50,7 @@ func get_root_count_capacity() -> float:
 		return 0.0
 	return 1.0 / roots.size()
 
+## 境界显示文本，如 "练气5层"、"筑基初期"。
 func get_realm_text() -> String:
 	if realm_index == 0:
 		return "%s%d层" % [REALM_NAMES[realm_index], sub_realm_index + 1]