CodeWF.Toolkit.Files 1.0.0.5

CodeWF.Toolkit

一组无 UI 依赖的 .NET 基础设施库合集：工具扩展、文件与图片处理、日志、事件总线与网络通信，均以 CodeWF.Toolkit.* 前缀发布。

A collection of UI-independent .NET infrastructure libraries: tool extensions, file/image processing, logging, event bus and network communication, published with the CodeWF.Toolkit.* prefix.

适用场景 / Typical scenarios

包一览 / Packages

所有包均面向 net10.0。「依赖」列中的本仓包由包依赖自动带入，无需单独安装。

快速开始 / Quick start

dotnet add package CodeWF.Toolkit.Core
dotnet add package CodeWF.Toolkit.EventBus
dotnet add package CodeWF.Toolkit.Logging

日志（CodeWF.Toolkit.Logging）

using CodeWF.Toolkit.Logging;

Logger.TryInitialize(new LoggerOptions
{
    MinimumLevel = LogLevel.Information,
    EnableConsole = true,
    File = new FileLogOptions
    {
        DirectoryPath = Path.Combine(AppContext.BaseDirectory, "logs"),
        MaxFileSizeBytes = 32 * 1024 * 1024,
        RetentionDays = 30,
    },
});

Logger.Info("服务已启动");
Logger.Error("处理失败", ex);
await Logger.ShutdownAsync();   // 退出前刷盘

需要把 MEL 生态的日志也收进来时，加装 CodeWF.Toolkit.Logging.Microsoft：builder.Logging.AddCodeWFLogger(options => { /* 同 LoggerOptions */ });

事件总线（CodeWF.Toolkit.EventBus）

using CodeWF.Toolkit.EventBus;

var bus = new EventBus();
bus.Subscribe<GreetCommand>(cmd => Console.WriteLine(cmd.Name));
await bus.PublishAsync(new GreetCommand("hi"));

var query = new TimeQuery();
bus.Subscribe(new TimeQueryHandler());   // 含 [EventHandler] 方法的处理器
bus.Query(query);

序列化往返（CodeWF.Toolkit.NetWeaver）

[NetHead(0x01, 1)]
public sealed class SamplePacket : INetObject
{
    [NetFieldOrder(0)] public int Id { get; set; }
    [NetFieldOrder(1)] public string Title { get; set; } = string.Empty;
}

var buffer = packet.Serialize(systemId: 0);
var restored = buffer.Deserialize<SamplePacket>();

TCP 收发（CodeWF.Toolkit.NetWrapper）

using CodeWF.Toolkit.NetWrapper.Helpers;

var server = new TcpSocketServer();
await server.StartAsync("demo-server", "127.0.0.1", 39561);

var client = new TcpSocketClient();
await client.ConnectAsync("demo-server", "127.0.0.1", 39561);
await client.SendCommandAsync(packet);

远程文件系统（浏览/上传/下载/断点续传）见 CodeWF.Toolkit.NetWrapper.FileSystem 的 TcpSocketClientFileSystemFeature。

文件与图片（CodeWF.Toolkit.Files / CodeWF.Toolkit.Image）

using CodeWF.Toolkit.Core.FileExtensions;   // SevenZipCompressor
using CodeWF.Toolkit.Files.Extensions;      // ToJson / ToYaml
using CodeWF.Toolkit.Image;                 // ImageHelper / QrCodeGenerator

var yaml = student.ToYaml(out var error);

var compressor = new SevenZipCompressor(httpClient);
compressor.Zip(sourceDirectory, "out.zip");
compressor.Decompress("out.zip", destinationDirectory);

await ImageHelper.MergeGenerateIcon("logo.png", "logo.ico", [24, 32, 48]);
QrCodeGenerator.GenerateQrCode("CodeWF", "https://codewf.com", "qr.png");

更新检查（CodeWF.Toolkit.Core）

using CodeWF.Toolkit.Core.UpdateChecking;

var checker = new UpdateChecker("dotnet9", "CodeWF.Toolkit");
var result = await checker.CheckAsync(new Version(1, 0, 0, 0));

与 CodeWF.Avalonia 的关系 / Relationship with CodeWF.Avalonia

• CodeWF.Avalonia.Log（日志查看控件与桌面通知）配套本仓的 CodeWF.Toolkit.Logging：控件订阅核心的 UI 日志事件流，日志回调在后台线程，界面侧自行调度到 UI 线程。
• 两个仓库各自带演示程序：本仓 demo/ 下是控制台演示与 Avalonia 图形演示台，CodeWF.Avalonia 仓的演示台展示的是控件与主题。
• UI 相关能力一律留在 CodeWF.Avalonia.*；本仓保持无 UI 依赖。

依赖与目标框架 / Dependencies and AOT

全部库项目面向 net10.0，Directory.Packages.props 集中管理版本。Native AOT/裁剪注意点：

CI 的 aot-smoke 作业会对控制台演示与 Avalonia 演示台做 PublishAot=true 发布并运行 --smoke。

包 → 源码 → 文档索引 / Source & docs index

演示 / Demos

新版原生首页提供真实事件流、Int32 字节编码和 JSON → YAML → ZIP → QR 流水线，默认使用 .NET 紫，并支持 AI 极光与暖陶配色。图形 Demo 通过 NuGet 引用 UI 库，只克隆本仓即可构建；功能映射、双语资源与 Windows x64 NativeAOT 验收见 原生演示台文档。

The native overview runs real event, serialization and file experiments. Building the GUI currently requires the sibling CodeWF.Avalonia source checkout; the console Demo and production libraries remain independently buildable.

# 控制台演示：依次跑日志、进程内总线、分布式总线、序列化，然后进入交互菜单
dotnet run --project demo/CodeWF.Toolkit.Demo
# 冒烟模式：跑完全部演示直接退出，退出码 0 表示通过（CI / AOT 冒烟使用）
dotnet run --project demo/CodeWF.Toolkit.Demo -- --smoke

# Avalonia 图形演示台：同款能力以界面方式逐页演示
dotnet run --project demo/CodeWF.Toolkit.Demo.Avalonia
# 冒烟模式：逐页构建后逐色板渲染一遍再退出，退出码 0 表示全部通过（CI / AOT 冒烟使用）
dotnet run --project demo/CodeWF.Toolkit.Demo.Avalonia -- --smoke

图形演示台的安装包由 GitHub Releases 提供（随 v* tag 构建）：Windows setup.exe / 便携 zip、Linux deb、macOS dmg，均附 .sha256 校验文件。控制台演示以源码运行，不作为安装包分发。

许可与贡献 / License and contributing

MIT。Issue 与 PR 都欢迎，提交前请确保 dotnet build CodeWF.Toolkit.slnx -c Release 与 dotnet test 通过。