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,86 @@
+using System.Collections.Concurrent;
+using System.Diagnostics.CodeAnalysis;
+
+namespace PCL.Core.App.Configuration;
+
+public struct ConfigValueCache<TValue>()
+{
+    private TValue? _cachedValue;
+    private bool _hasCachedValue = false;
+
+    private readonly ConcurrentDictionary<object, TValue> _cacheWithContext = [];
+
+    /// <summary>
+    /// 检查指定上下文参数的缓存是否存在。
+    /// </summary>
+    /// <param name="argument">上下文参数</param>
+    public bool Exists(object? argument = null)
+    {
+        return (argument is null) ? _hasCachedValue : _cacheWithContext.ContainsKey(argument);
+    }
+
+    /// <summary>
+    /// 尝试读取缓存值。
+    /// </summary>
+    /// <param name="value">若已缓存则为输出值，否则为默认值</param>
+    /// <param name="argument">上下文参数</param>
+    /// <returns>若已缓存则为 <c>true</c>，否则为 <c>false</c></returns>
+    public bool TryRead(
+        [NotNullWhen(true)] out TValue? value,
+        object? argument = null)
+    {
+        bool result;
+        if (argument is not null) result = _cacheWithContext.TryGetValue(argument, out value);
+        else
+        {
+            if (_hasCachedValue)
+            {
+                value = _cachedValue!;
+                result = true;
+            }
+            else
+            {
+                value = default;
+                result = false;
+            }
+        }
+        return result;
+    }
+
+    /// <summary>
+    /// 写入缓存值。
+    /// </summary>
+    /// <param name="value">输入值</param>
+    /// <param name="argument">上下文参数</param>
+    public void Write(TValue value, object? argument = null)
+    {
+        if (argument is not null)
+        {
+            _cacheWithContext[argument] = value;
+            return;
+        }
+        _hasCachedValue = true;
+        _cachedValue = value;
+    }
+
+    /// <summary>
+    /// 清除缓存值。<br/>
+    /// 若缓存存在则清除并返回 <c>true</c>，否则返回 <c>false</c>。
+    /// </summary>
+    /// <param name="argument">上下文参数</param>
+    public bool Invalidate(object? argument)
+    {
+        if (argument is not null) return _cacheWithContext.TryRemove(argument, out _);
+        if (!_hasCachedValue) return false;
+        _cachedValue = default;
+        _hasCachedValue = false;
+        return true;
+    }
+
+    public void InvalidateAll()
+    {
+        _cacheWithContext.Clear();
+        _cachedValue = default;
+        _hasCachedValue = false;
+    }
+}