feat: 项目初始化 + 3D方块世界原型 + AI助搭系统

初始化 monorepo: Go后端(7微服务) + Unity客户端(9模块) + 启动器 HTML5原型: Three.js 3D体素世界, Perlin噪声地形, 原版材质, 22种方块 Minecraft创造模式背包: 双栏布局, 拖拽移动物品, 方向性元件引脚 AI助搭策划文档 + 客户端/服务端骨架 + Docker Compose + CI
2026-08-08 14:07:56 +08:00
parent 9500c4c80a
commit f70b061d1a
1972 changed files with 159760 additions and 6 deletions
@@ -0,0 +1,109 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Text;
+using System.Threading;
+using System.Threading.Tasks;
+using PCL.Core.Logging;
+
+namespace PCL.Core.App.IoC;
+
+partial class Lifecycle
+{
+    private static ILifecycleLogService? _logService;
+    private static readonly List<LifecycleLogItem> _PendingLogs = [];
+
+    private static void _PushLog(LifecycleLogItem item, ILifecycleLogService service)
+    {
+        service.OnLog(item);
+    }
+
+    public static string PendingLogDirectory { get; set; } = @"PCL\Log";
+    public static string PendingLogFileName { get; set; } = "LastPending.log";
+
+    /// <summary>
+    /// 日志服务启动状态
+    /// </summary>
+    public static bool IsLogServiceStarted => _logService is not null;
+
+    private static void _SavePendingLogs()
+    {
+        if (_PendingLogs.Count == 0)
+        {
+            Console.WriteLine("[Lifecycle] No pending logs");
+            return;
+        }
+        try
+        {
+            // 直接写入剩余未输出日志到程序目录
+            var path = Path.Combine(PendingLogDirectory, PendingLogFileName);
+            if (!Path.IsPathRooted(path)) path = Path.Combine(Basics.ExecutableDirectory, path);
+            Directory.CreateDirectory(Basics.GetParentPathOrDefault(path));
+            using var stream = new FileStream(path, FileMode.Create, FileAccess.Write, FileShare.Read);
+            using var writer = new StreamWriter(stream, Encoding.UTF8);
+            foreach (var item in _PendingLogs) writer.WriteLine(item.ComposeMessage());
+            Console.WriteLine($"[Lifecycle] Pending logs saved to {path}");
+        }
+        catch (Exception ex)
+        {
+            Console.WriteLine(ex);
+            Console.WriteLine("[Lifecycle] Error saving pending logs, writing to stdout...");
+            foreach (var item in _PendingLogs) Console.WriteLine(item.ComposeMessage());
+        }
+    }
+}
+
+/// <summary>
+/// 生命周期日志项
+/// </summary>
+/// <param name="Source">日志来源</param>
+/// <param name="Message">日志内容</param>
+/// <param name="Exception">相关异常</param>
+/// <param name="Level">日志等级</param>
+/// <param name="ActionLevel">行为等级</param>
+public readonly record struct LifecycleLogItem(
+    ILifecycleService? Source,
+    string Message,
+    Exception? Exception,
+    LogLevel Level,
+    ActionLevel ActionLevel)
+{
+    /// <summary>
+    /// 创建该日志项的时间
+    /// </summary>
+    public DateTime Time { get; } = DateTime.Now;
+
+    /// <summary>
+    /// 创建该日志项的 Task ID 或线程名
+    /// </summary>
+    public string ContextName { get; } =
+        (Task.CurrentId is { } id ? $"TSK#{id}" : null)
+        ?? Thread.CurrentThread.Name
+        ?? $"#{Environment.CurrentManagedThreadId}";
+
+    public override string ToString()
+    {
+        var source = (Source is null) ? "" : $" [{Source.Name}|{Source.Identifier}]";
+        var basic = $"[{Time:HH:mm:ss.fff}]{source}";
+        return Exception is null ? $"{basic} {Message}" : $"{basic} ({Message}) {Exception.GetType().FullName}: {Exception.Message}";
+    }
+
+    public string ComposeMessage()
+    {
+        var source = (Source is null) ? "" : $" [{Source.Name}|{Source.Identifier}]";
+        var result = $"[{Time:HH:mm:ss.fff}] [{Level.RealLevel().PrintName()}] [{ContextName}]{source} {Message}";
+        if (Exception is not null) result += $"\n{Exception}";
+        return result;
+    }
+}
+
+/// <summary>
+/// 日志服务专用接口。整个生命周期只能有一个日志服务，若出现第二个将会报错。
+/// </summary>
+public interface ILifecycleLogService : ILifecycleService
+{
+    /// <summary>
+    /// 记录日志的事件
+    /// </summary>
+    public void OnLog(LifecycleLogItem item);
+}