Imizuki.UniversalApi

面向 .NET 10 与 ASP.NET Core 的通用 API 组件。

• 包名：Imizuki.UniversalApi
• 版本：1.0.1
• 作者：Imizuki
• Copyright © 2026 Imizuki

功能与命名空间

生成器输出使用 Imizuki.UniversalApi.Generated 命名空间。当前项目将生成器与运行时组件编译在同一程序集内，NuGet 包尚未配置自动加载源生成器的 analyzer 布局。

MVC 配置示例

using Imizuki.UniversalApi.Core;
using Imizuki.UniversalApi.Unify;
using Imizuki.UniversalApi.Utils;

var builder = WebApplication.CreateBuilder(args);
builder.AddApplicationCore();
builder.Services.AddControllers()
    .AddNewtonsoftJson(options => options.UseMvcJsonOptions())
    .AddInjectWithUnifyResult();

var app = builder.Build();
app.UseApplicationCore();
app.MapControllers();
app.Run();

构建与打包

dotnet build Imizuki.UniversalApi.slnx -c Release
dotnet pack Imizuki.UniversalApi/Imizuki.UniversalApi.csproj -c Release -o artifacts

代码规范与验证

项目通过 .editorconfig 统一代码格式，类、方法和关键处理步骤使用中文注释。

dotnet format whitespace Imizuki.UniversalApi.slnx --verify-no-changes
dotnet format style Imizuki.UniversalApi.slnx --verify-no-changes
dotnet run --project tests/Imizuki.UniversalApi.GeneratorChecks -c Release

检查程序直接运行 Roslyn 生成器，并在没有隐式命名空间导入的消费者源码上编译输出，覆盖四种 HTTP 方法、跳过包装特性、关键字方法名称和路由字符转义。同时验证 MVC 与 Minimal API 过滤器均识别 Attributes.NonUnifyAttribute 和原有 Unify.NonUnify 标记。

尚未指定开源许可证、项目主页或源码仓库地址；发布前应按实际情况补充相应 NuGet 元数据。