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,52 @@
+using System;
+using System.Globalization;
+using System.IO;
+
+namespace PCL.Core.IO;
+
+public class ByteStream(Stream stream)
+{
+    private static readonly string[] _Units = ["B", "KiB", "MiB", "GiB", "TiB", "PiB", "EiB", "ZiB", "YiB"];
+    public long Length => stream.Length;
+
+    public string GetReadableLength()
+    {
+        return GetReadableLength(Length);
+    }
+
+    /// <summary>
+    ///     格式化大小
+    /// </summary>
+    /// <param name="length">字节</param>
+    /// <param name="startUnit">开始单位</param>
+    /// <param name="provider">格式化区域提供程序，默认使用 <see cref="CultureInfo.InvariantCulture" /></param>
+    /// <returns></returns>
+    /// <exception cref="ArgumentOutOfRangeException"></exception>
+    public static string GetReadableLength(long length, int startUnit = 0, IFormatProvider? provider = null)
+    {
+        ArgumentOutOfRangeException.ThrowIfGreaterThanOrEqual(startUnit, _Units.Length);
+        ArgumentOutOfRangeException.ThrowIfLessThan(startUnit, 0);
+
+        var isNegative = length < 0;
+        decimal absBytes = isNegative ? -length : length;
+
+        if (absBytes == 0)
+            return "0 B";
+
+        var unitIndex = startUnit;
+        var value = absBytes;
+
+        while (value >= 1024 && unitIndex < _Units.Length - 1)
+        {
+            value /= 1024;
+            unitIndex++;
+        }
+
+        if (unitIndex >= _Units.Length)
+            throw new ArgumentOutOfRangeException(nameof(length),
+                "Value too large for predefined units.");
+
+        var sign = isNegative ? "-" : "";
+        return $"{sign}{value.ToString("0.##", provider ?? CultureInfo.InvariantCulture)} {_Units[unitIndex]}";
+    }
+}