feat(DebugLogViewer): implement browser-based debug log viewer

- Added RitsuDebugLogPipeline to manage the logging pipeline and serve logs to a browser-based viewer.
- Introduced RitsuDebugLogViewerOptions for configurable settings such as port and auto-open behavior.
- Implemented RitsuDebugLogRecord for structured log entries and RitsuDebugLogRingBuffer for efficient log storage.
- Created commands and UI integration for opening the log viewer from the game settings.
- Enhanced RitsuLibSettings to include options for the debug log viewer, improving developer debugging capabilities.

Author: BAKAOLC

.gitignore

@@ -8,9 +8,6 @@ artifacts/nuget/
 artifacts/github/
 artifacts/bundle-staging/
 
-Loader/bin/
-Loader/obj/
-
 .vs/
 
 local.props
@@ -23,4 +20,4 @@ local.props
 __pycache__/
 *.py[cod]
 *$py.class
-.venv/
+.venv/

Data/Models/RitsuLibSettings.cs

@@ -69,6 +69,62 @@ public sealed class RitsuLibSettings
         [JsonPropertyName("debug_compat_ancient_architect")]
         public bool DebugCompatAncientArchitect { get; set; } = true;
 
+        /// <summary>
+        ///     Starts the loopback-only browser debug log viewer for this session.
+        ///     为本会话启动仅监听 loopback 的浏览器调试日志查看器。
+        /// </summary>
+        [JsonPropertyName("debug_log_viewer_enabled")]
+        public bool DebugLogViewerEnabled { get; set; } = true;
+
+        /// <summary>
+        ///     Mirrors game logger callbacks into the debug log viewer event stream.
+        ///     将游戏 logger 回调镜像到调试日志查看器事件流。
+        /// </summary>
+        [JsonPropertyName("debug_log_viewer_mirror_game_logs")]
+        public bool DebugLogViewerMirrorGameLogs { get; set; } = true;
+
+        /// <summary>
+        ///     When true, opens the debug log viewer in the system browser if no browser client connects shortly after startup.
+        ///     为 true 时，启动后短时间内若没有浏览器客户端连接，则在系统浏览器中打开调试日志查看器。
+        /// </summary>
+        [JsonPropertyName("debug_log_viewer_auto_open")]
+        public bool DebugLogViewerAutoOpen { get; set; }
+
+        /// <summary>
+        ///     Loopback HTTP port for the debug log viewer.
+        ///     调试日志查看器的 loopback HTTP 端口。
+        /// </summary>
+        [JsonPropertyName("debug_log_viewer_port")]
+        public int DebugLogViewerPort { get; set; } = 18742;
+
+        /// <summary>
+        ///     Number of consecutive ports to try after <see cref="DebugLogViewerPort" /> when the preferred port is busy.
+        ///     首选端口被占用时，在 <see cref="DebugLogViewerPort" /> 后继续尝试的连续端口数量。
+        /// </summary>
+        [JsonPropertyName("debug_log_viewer_port_fallback_count")]
+        public int DebugLogViewerPortFallbackCount { get; set; } = 20;
+
+        /// <summary>
+        ///     Stable browser access token for the loopback debug log viewer.
+        ///     本机调试日志查看器使用的稳定浏览器访问 token。
+        /// </summary>
+        [JsonPropertyName("debug_log_viewer_access_token")]
+        public string DebugLogViewerAccessToken { get; set; } = "";
+
+        /// <summary>
+        ///     Number of recent events retained in memory for newly opened browser sessions.
+        ///     为新打开的浏览器会话保留在内存中的最近事件数量。
+        /// </summary>
+        [JsonPropertyName("debug_log_viewer_ring_buffer_capacity")]
+        public int DebugLogViewerRingBufferCapacity { get; set; } = 10000;
+
+        /// <summary>
+        ///     Maximum pending event count before the non-blocking debug pipeline starts dropping new events.
+        ///     非阻塞调试管道开始丢弃新事件前允许排队的最大事件数。
+        /// </summary>
+        [JsonPropertyName("debug_log_viewer_queue_capacity")]
+        public int DebugLogViewerQueueCapacity { get; set; } = 4096;
+
         /// <summary>
         ///     When true, cards, relics, and potions append a hover tip showing their source mod.
         ///     为 true 时，卡牌、遗物和药水会追加显示其来源 mod 的悬停提示。

Data/RitsuLibSettingsStore.cs

@@ -1,5 +1,7 @@
+using System.Security.Cryptography;
 using STS2RitsuLib.Data.Migrations;
 using STS2RitsuLib.Data.Models;
+using STS2RitsuLib.Diagnostics.Logging;
 using STS2RitsuLib.Ui.Shell.Theme;
 using STS2RitsuLib.Ui.Toast;
 using STS2RitsuLib.Utils.Persistence;
@@ -203,6 +205,32 @@ internal static bool ShouldShowGameTermModSourceHoverTips()
             return GetSettings().ModSourceHoverTipsGameTerms;
         }
 
+        internal static RitsuDebugLogViewerOptions GetDebugLogViewerOptions()
+        {
+            Initialize();
+            var s = GetSettings();
+            var changed = false;
+            if (string.IsNullOrWhiteSpace(s.DebugLogViewerAccessToken))
+            {
+                s.DebugLogViewerAccessToken =
+                    Convert.ToHexString(RandomNumberGenerator.GetBytes(16)).ToLowerInvariant();
+                changed = true;
+            }
+
+            if (changed)
+                Store.Save(Const.SettingsKey);
+
+            return new(
+                s.DebugLogViewerEnabled,
+                s.DebugLogViewerMirrorGameLogs,
+                s.DebugLogViewerAutoOpen,
+                Math.Clamp(s.DebugLogViewerPort, 1, 65535),
+                Math.Clamp(s.DebugLogViewerPortFallbackCount, 0, 100),
+                s.DebugLogViewerAccessToken,
+                s.DebugLogViewerRingBufferCapacity,
+                s.DebugLogViewerQueueCapacity);
+        }
+
         private static RitsuLibSettings GetSettings()
         {
             return Store.Get<RitsuLibSettings>(Const.SettingsKey);

Diagnostics/Commands/OpenLogViewerConsoleCmd.cs

@@ -0,0 +1,36 @@
+using MegaCrit.Sts2.Core.DevConsole;
+using MegaCrit.Sts2.Core.DevConsole.ConsoleCommands;
+using MegaCrit.Sts2.Core.Entities.Players;
+using STS2RitsuLib.Diagnostics.Logging;
+
+namespace STS2RitsuLib.Diagnostics.Commands
+{
+    /// <summary>
+    ///     Opens the local RitsuLib debug log viewer in the system browser.
+    ///     在系统浏览器中打开本机 RitsuLib 调试日志查看器。
+    /// </summary>
+    public sealed class OpenLogViewerConsoleCmd : AbstractConsoleCmd
+    {
+        /// <inheritdoc />
+        public override string CmdName => "openlogviewer";
+
+        /// <inheritdoc />
+        public override string Args => "";
+
+        /// <inheritdoc />
+        public override string Description => "Opens the local RitsuLib debug log viewer in a browser.";
+
+        /// <inheritdoc />
+        public override bool IsNetworked => false;
+
+        /// <inheritdoc />
+        public override CmdResult Process(Player? issuingPlayer, string[] args)
+        {
+            if (args.Length > 0)
+                return new(false, "Usage: openlogviewer");
+
+            var result = RitsuDebugLogPipeline.TryOpenViewerInBrowser();
+            return new(result.Success, result.Message);
+        }
+    }
+}

Diagnostics/Logging/RitsuDebugGodotLogListener.cs

@@ -0,0 +1,41 @@
+using Godot;
+using Godot.Collections;
+
+namespace STS2RitsuLib.Diagnostics.Logging
+{
+    internal sealed partial class RitsuDebugGodotLogListener : Logger
+    {
+        public override void _LogMessage(string message, bool error)
+        {
+            RitsuDebugLogPipeline.EmitGodotLogMessage(message, error);
+        }
+
+        public override void _LogError(
+            string function,
+            string file,
+            int line,
+            string code,
+            string rationale,
+            bool editorNotify,
+            int errorType,
+            Array<ScriptBacktrace> scriptBacktraces)
+        {
+            RitsuDebugLogPipeline.EmitGodotLogError(
+                function,
+                file,
+                line,
+                code,
+                rationale,
+                errorType,
+                FormatScriptBacktraces(scriptBacktraces));
+        }
+
+        private static string FormatScriptBacktraces(Array<ScriptBacktrace> scriptBacktraces)
+        {
+            var lines =
+                (from backtrace in scriptBacktraces where !backtrace.IsEmpty() select backtrace.Format()).ToList();
+
+            return string.Join("", lines);
+        }
+    }
+}