fix(Localization): update Chinese comments for clarity and consistency

Author: BAKAOLC

Audio/AudioAdaptiveMusicDirector.cs

@@ -4,7 +4,7 @@ namespace STS2RitsuLib.Audio
 {
     /// <summary>
     ///     Coordinates adaptive room/combat/victory music playback in response to game lifecycle transitions.
-    ///     中文说明：Coordinates adaptive room/combat/victory music playback in response to game lifecycle transitions.
+    ///     根据游戏生命周期转换，协调自适应房间/战斗/胜利音乐播放。
     /// </summary>
     public sealed class AudioAdaptiveMusicDirector : IDisposable
     {
@@ -33,13 +33,13 @@ private AudioAdaptiveMusicDirector()
 
         /// <summary>
         ///     Shared singleton director.
-        ///     中文说明：Shared singleton director.
+        ///     共享的单例 director。
         /// </summary>
         public static AudioAdaptiveMusicDirector Shared { get; } = new();
 
         /// <summary>
         ///     Disposes framework lifecycle subscriptions owned by this director.
-        ///     Disposes framework lifecycle subscriptions owned 通过 this director.
+        ///     释放此 director 拥有的框架生命周期订阅。
         /// </summary>
         public void Dispose()
         {
@@ -54,7 +54,7 @@ public void Dispose()
 
         /// <summary>
         ///     Starts following the supplied adaptive music plan and returns a handle for later shutdown.
-        ///     Starts following the supplied adaptive music plan 和 返回 a handle 用于 later shutdown.
+        ///     开始跟随提供的自适应音乐计划，并返回用于稍后关闭的句柄。
         /// </summary>
         public AudioAdaptiveMusicHandle Attach(AudioAdaptiveMusicPlan plan)
         {
@@ -66,7 +66,7 @@ public AudioAdaptiveMusicHandle Attach(AudioAdaptiveMusicPlan plan)
 
         /// <summary>
         ///     Removes a previously attached adaptive music handle from lifecycle tracking.
-        ///     Removes a previously attached adaptive music handle 从 lifecycle tracking.
+        ///     从生命周期跟踪中移除先前附加的自适应音乐句柄。
         /// </summary>
         public void Detach(AudioAdaptiveMusicHandle handle)
         {

Audio/AudioAdaptiveMusicHandle.cs

@@ -2,7 +2,7 @@ namespace STS2RitsuLib.Audio
 {
     /// <summary>
     ///     Represents an active adaptive music binding that can switch tracks and restore vanilla state when stopped.
-    ///     Represents an active adaptive music binding that can switch tracks 和 restore 原版 state 当 stopped.
+    ///     表示一个活动的自适应音乐绑定，可切换曲目，并在停止时恢复原版状态。
     /// </summary>
     public sealed class AudioAdaptiveMusicHandle : IDisposable
     {
@@ -17,7 +17,7 @@ internal AudioAdaptiveMusicHandle(AudioAdaptiveMusicPlan plan)
 
         /// <summary>
         ///     Stops adaptive playback and unregisters this handle from the shared director.
-        ///     Stops adaptive playback 和 unregisters this handle 从 the shared director.
+        ///     停止自适应播放，并从共享 director 注销此句柄。
         /// </summary>
         public void Dispose()
         {
@@ -42,7 +42,7 @@ internal void RefreshVolume(float volume)
 
         /// <summary>
         ///     Stops the current adaptive override and optionally restores vanilla run music.
-        ///     Stops the current adaptive override 和 可选ly restores 原版 跑局 music.
+        ///     停止当前自适应覆盖，并可选择恢复原版跑局音乐。
         /// </summary>
         public void Stop(bool restoreVanillaMusic = true)
         {

Audio/AudioAdaptiveMusicPlan.cs

@@ -2,61 +2,61 @@ namespace STS2RitsuLib.Audio
 {
     /// <summary>
     ///     Declares room/combat/victory music sources that should follow the game's lifecycle transitions.
-    ///     中文说明：Declares room/combat/victory music sources that should follow the game's lifecycle transitions.
+    ///     声明应跟随游戏生命周期转换的房间/战斗/胜利音乐源。
     /// </summary>
     public sealed class AudioAdaptiveMusicPlan
     {
         /// <summary>
         ///     Music source to use while the player is in a room outside combat.
-        ///     Music source to 使用 while the player is in a room outside combat.
+        ///     玩家处于非战斗房间时使用的音乐源。
         /// </summary>
         public AudioSource? RoomSource { get; init; }
 
         /// <summary>
         ///     Music source to use while combat is active.
-        ///     Music source to 使用 while combat is active.
+        ///     战斗进行时使用的音乐源。
         /// </summary>
         public AudioSource? CombatSource { get; init; }
 
         /// <summary>
         ///     Music source to use after combat victory, when provided.
-        ///     Music source to 使用 之后 combat victory, 当 provided.
+        ///     提供后，在战斗胜利后使用的音乐源。
         /// </summary>
         public AudioSource? VictorySource { get; init; }
 
         /// <summary>
         ///     Restores vanilla run music when the adaptive handle is stopped.
-        ///     Restores 原版 跑局 music 当 the adaptive handle is stopped.
+        ///     自适应句柄停止时恢复原版跑局音乐。
         /// </summary>
         public bool RestoreVanillaMusicOnStop { get; init; } = true;
 
         /// <summary>
         ///     Restores vanilla run music after combat ends instead of returning to the room override.
-        ///     Restores 原版 跑局 music 之后 combat ends instead of 返回ing to the room override.
+        ///     战斗结束后恢复原版跑局音乐，而不是返回房间覆盖。
         /// </summary>
         public bool RestoreVanillaMusicOnCombatEnd { get; init; } = true;
 
         /// <summary>
         ///     Refreshes vanilla room track and ambience when entering a room with no room override.
-        ///     Refreshes 原版 room track 和 ambience 当 entering a room 带有 no room override.
+        ///     进入没有房间覆盖的房间时刷新原版房间曲目和环境音。
         /// </summary>
         public bool RefreshVanillaRoomStateOnRoomEnter { get; init; } = true;
 
         /// <summary>
         ///     Playback options applied when starting room music.
-        ///     Playback options applied 当 starting room music.
+        ///     启动房间音乐时应用的播放选项。
         /// </summary>
         public AudioPlaybackOptions RoomOptions { get; init; } = new() { Scope = AudioLifecycleScope.Room };
 
         /// <summary>
         ///     Playback options applied when starting combat music.
-        ///     Playback options applied 当 starting combat music.
+        ///     启动战斗音乐时应用的播放选项。
         /// </summary>
         public AudioPlaybackOptions CombatOptions { get; init; } = new() { Scope = AudioLifecycleScope.Combat };
 
         /// <summary>
         ///     Playback options applied when starting victory music.
-        ///     Playback options applied 当 starting victory music.
+        ///     启动胜利音乐时应用的播放选项。
         /// </summary>
         public AudioPlaybackOptions VictoryOptions { get; init; } = new() { Scope = AudioLifecycleScope.Combat };
     }

Audio/AudioAdaptivePlans.cs

@@ -2,13 +2,13 @@ namespace STS2RitsuLib.Audio
 {
     /// <summary>
     ///     Convenience builders for common adaptive music override patterns.
-    ///     Convenience builders 用于 common adaptive music override patterns.
+    ///     常见自适应音乐覆盖模式的便捷构建器。
     /// </summary>
     public static class AudioAdaptivePlans
     {
         /// <summary>
         ///     Builds a plan that overrides combat music and optionally room and victory transitions.
-        ///     Builds a plan that overrides combat music 和 可选ly room 和 victory transitions.
+        ///     构建覆盖战斗音乐，并可选择处理房间和胜利转换的计划。
         /// </summary>
         public static AudioAdaptiveMusicPlan CombatOverride(
             AudioSource combatSource,
@@ -31,9 +31,8 @@ public static AudioAdaptiveMusicPlan CombatOverride(
 
         /// <summary>
         ///     Builds a plan that supplies room and combat overrides for the full run without restoring vanilla music after
-        ///     Builds a plan that supplies room 和 combat overrides 用于 the full 跑局 带有out restoring 原版 music 之后
         ///     combat.
-        ///     中文说明：combat.
+        ///     构建在整个跑局中提供房间和战斗覆盖，且战斗后不恢复原版音乐的计划。
         /// </summary>
         public static AudioAdaptiveMusicPlan FullRunOverride(
             AudioSource roomSource,

Audio/AudioChannelMode.cs

@@ -2,19 +2,19 @@ namespace STS2RitsuLib.Audio
 {
     /// <summary>
     ///     How a named channel should behave when new playback arrives.
-    ///     How a named channel should behave 当 new playback arrives.
+    ///     命名通道在新播放到达时应如何处理。
     /// </summary>
     public enum AudioChannelMode
     {
         /// <summary>
         ///     Keep the existing playback and ignore the new request.
-        ///     Keep the existing playback 和 ignore the new request.
+        ///     保留现有播放并忽略新请求。
         /// </summary>
         KeepExisting = 0,
 
         /// <summary>
         ///     Stop the existing playback and replace it with the new one.
-        ///     Stop the existing playback 和 replace it 带有 the new one.
+        ///     停止现有播放并用新播放替换。
         /// </summary>
         ReplaceExisting = 1,
     }

Audio/AudioChannelRegistry.cs

@@ -5,7 +5,7 @@ namespace STS2RitsuLib.Audio
 {
     /// <summary>
     ///     Tracks named channels and tagged playback groups for higher-level replacement and bulk stop semantics.
-    ///     Tracks named channels 和 tagged playback groups 用于 higher-level replacement 和 bulk stop semantics.
+    ///     跟踪命名通道和带标签的播放组，用于更高层的替换和批量停止语义。
     /// </summary>
     public sealed class AudioChannelRegistry
     {
@@ -20,13 +20,13 @@ private AudioChannelRegistry()
 
         /// <summary>
         ///     Shared singleton registry.
-        ///     Shared singleton 注册表.
+        ///     共享的单例注册表。
         /// </summary>
         public static AudioChannelRegistry Shared { get; } = new();
 
         /// <summary>
         ///     Claims a named channel for a handle, optionally replacing the currently attached playback.
-        ///     Claims a named channel 用于 a handle, 可选ly replacing the currently attached playback.
+        ///     为句柄占用命名通道，并可选择替换当前附加的播放。
         /// </summary>
         public bool TryClaimChannel(string channel, IAudioHandle handle, AudioChannelMode mode, bool allowFadeOut)
         {
@@ -55,7 +55,7 @@ public bool TryClaimChannel(string channel, IAudioHandle handle, AudioChannelMod
 
         /// <summary>
         ///     Removes a handle from any named channel it currently owns.
-        ///     Removes a handle 从 any named channel it currently owns.
+        ///     从句柄当前拥有的任何命名通道中移除该句柄。
         /// </summary>
         public void ReleaseChannel(IAudioHandle handle)
         {
@@ -66,7 +66,7 @@ public void ReleaseChannel(IAudioHandle handle)
 
         /// <summary>
         ///     Attaches a handle to a tag group for later bulk stop operations.
-        ///     Attaches a handle to a tag group 用于 later bulk stop operations.
+        ///     将句柄附加到标签组，以便稍后执行批量停止操作。
         /// </summary>
         public void AttachTag(string tag, IAudioHandle handle)
         {
@@ -76,7 +76,7 @@ public void AttachTag(string tag, IAudioHandle handle)
 
         /// <summary>
         ///     Removes a handle from all tracked channels and tag groups.
-        ///     Removes a handle 从 all tracked channels 和 tag groups.
+        ///     从所有已跟踪通道和标签组中移除句柄。
         /// </summary>
         public void Detach(IAudioHandle handle)
         {
@@ -87,7 +87,7 @@ public void Detach(IAudioHandle handle)
 
         /// <summary>
         ///     Stops and releases every handle attached to a tag group.
-        ///     Stops 和 releases every handle attached to a tag group.
+        ///     停止并释放附加到标签组的每个句柄。
         /// </summary>
         public bool StopTag(string tag, bool allowFadeOut = true)
         {
@@ -108,7 +108,7 @@ public bool StopTag(string tag, bool allowFadeOut = true)
 
         /// <summary>
         ///     Stops and releases the handle currently attached to a named channel.
-        ///     Stops 和 releases the handle currently attached to a named channel.
+        ///     停止并释放当前附加到命名通道的句柄。
         /// </summary>
         public bool StopChannel(string channel, bool allowFadeOut = true)
         {

Audio/AudioEventHandle.cs

@@ -4,13 +4,13 @@ namespace STS2RitsuLib.Audio
 {
     /// <summary>
     ///     Typed handle for FMOD Studio event instances.
-    ///     Typed handle 用于 FMOD Studio 事件 instances.
+    ///     FMOD Studio 事件实例的类型化句柄。
     /// </summary>
     public sealed class AudioEventHandle : AudioHandleBase
     {
         /// <summary>
         ///     Initializes a typed handle for an FMOD Studio event instance.
-        ///     初始化 a typed handle for an FMOD Studio event instance。
+        ///     为 FMOD Studio 事件实例初始化类型化句柄。
         /// </summary>
         public AudioEventHandle(AudioSource source, AudioLifecycleScope scope, GodotObject? rawInstance)
             : base(source, scope, rawInstance)

Audio/AudioFileHandle.cs

@@ -4,13 +4,13 @@ namespace STS2RitsuLib.Audio
 {
     /// <summary>
     ///     Typed handle for loose file and streaming-backed audio instances.
-    ///     Typed handle 用于 loose file 和 streaming-backed audio instances.
+    ///     松散文件和流式音频实例的类型化句柄。
     /// </summary>
     public sealed class AudioFileHandle : AudioHandleBase
     {
         /// <summary>
         ///     Initializes a typed handle for a loose file or streaming audio instance.
-        ///     初始化 a typed handle for a loose file or streaming audio instance。
+        ///     为松散文件或流式音频实例初始化类型化句柄。
         /// </summary>
         public AudioFileHandle(AudioSource source, AudioLifecycleScope scope, GodotObject? rawInstance)
             : base(source, scope, rawInstance)

Audio/AudioLifecycleRegistry.cs

@@ -4,7 +4,7 @@ namespace STS2RitsuLib.Audio
 {
     /// <summary>
     ///     Central registry that stops scoped handles when framework lifecycle events fire.
-    ///     Central 注册表 that stops scoped handles 当 framework lifecycle 事件s fire.
+    ///     中央注册表，在框架生命周期事件触发时停止带作用域的句柄。
     /// </summary>
     public sealed class AudioLifecycleRegistry : IDisposable
     {
@@ -30,13 +30,13 @@ private AudioLifecycleRegistry()
 
         /// <summary>
         ///     Shared singleton registry.
-        ///     Shared singleton 注册表.
+        ///     共享的单例注册表。
         /// </summary>
         public static AudioLifecycleRegistry Shared { get; } = new();
 
         /// <summary>
         ///     Disposes framework lifecycle subscriptions owned by this registry.
-        ///     Disposes framework lifecycle subscriptions owned 通过 this 注册表.
+        ///     释放此注册表拥有的框架生命周期订阅。
         /// </summary>
         public void Dispose()
         {
@@ -47,7 +47,7 @@ public void Dispose()
 
         /// <summary>
         ///     Attaches a handle to either a manual token or a built-in scope.
-        ///     Attaches a handle to either a manual token 或 a built-in scope.
+        ///     将句柄附加到手动 token 或内置作用域。
         /// </summary>
         public void Attach(IAudioHandle handle, AudioPlaybackOptions? options)
         {
@@ -65,7 +65,7 @@ public void Attach(IAudioHandle handle, AudioPlaybackOptions? options)
 
         /// <summary>
         ///     Removes a handle from all tracked scopes and tokens.
-        ///     Removes a handle 从 all tracked scopes 和 tokens.
+        ///     从所有已跟踪作用域和 token 中移除句柄。
         /// </summary>
         public void Detach(IAudioHandle handle)
         {
@@ -78,7 +78,7 @@ public void Detach(IAudioHandle handle)
 
         /// <summary>
         ///     Stops and releases every handle attached to a built-in scope.
-        ///     Stops 和 releases every handle attached to a built-in scope.
+        ///     停止并释放附加到内置作用域的每个句柄。
         /// </summary>
         public bool StopScope(AudioLifecycleScope scope, bool allowFadeOut = true)
         {
@@ -99,7 +99,7 @@ public bool StopScope(AudioLifecycleScope scope, bool allowFadeOut = true)
 
         /// <summary>
         ///     Stops and releases every handle attached to a manual token.
-        ///     Stops 和 releases every handle attached to a manual token.
+        ///     停止并释放附加到手动 token 的每个句柄。
         /// </summary>
         public bool StopScope(AudioScopeToken token, bool allowFadeOut = true)
         {

Audio/AudioLifecycleScope.cs

@@ -2,37 +2,37 @@ namespace STS2RitsuLib.Audio
 {
     /// <summary>
     ///     Built-in lifecycle buckets for automatic audio cleanup.
-    ///     Built-in lifecycle buckets 用于 automatic audio cleanup.
+    ///     用于自动音频清理的内置生命周期分组。
     /// </summary>
     public enum AudioLifecycleScope
     {
         /// <summary>
         ///     Caller-managed only.
-        ///     中文说明：Caller-managed only.
+        ///     仅由调用方管理。
         /// </summary>
         Manual = 0,
 
         /// <summary>
         ///     Stops when combat ends.
-        ///     Stops 当 combat ends.
+        ///     战斗结束时停止。
         /// </summary>
         Combat = 1,
 
         /// <summary>
         ///     Stops when the current room is exited.
-        ///     Stops 当 the current room is exited.
+        ///     离开当前房间时停止。
         /// </summary>
         Room = 2,
 
         /// <summary>
         ///     Stops when the run ends.
-        ///     Stops 当 the 跑局 ends.
+        ///     跑局结束时停止。
         /// </summary>
         Run = 3,
 
         /// <summary>
         ///     Reserved for screen-scoped flows.
-        ///     Reserved 用于 screen-scoped flows.
+        ///     保留给屏幕作用域流程。
         /// </summary>
         Screen = 4,
     }