XiHan.Framework.Kernel 5.0.0-rc.2

Prefix Reserved

This is a prerelease version of XiHan.Framework.Kernel.

dotnet add package XiHan.Framework.Kernel --version 5.0.0-rc.2

NuGet\Install-Package XiHan.Framework.Kernel -Version 5.0.0-rc.2

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="XiHan.Framework.Kernel" Version="5.0.0-rc.2" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="XiHan.Framework.Kernel" Version="5.0.0-rc.2" />
                    

                            Directory.Packages.props

<PackageReference Include="XiHan.Framework.Kernel" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add XiHan.Framework.Kernel --version 5.0.0-rc.2

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: XiHan.Framework.Kernel, 5.0.0-rc.2"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package XiHan.Framework.Kernel@5.0.0-rc.2

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=XiHan.Framework.Kernel&version=5.0.0-rc.2&prerelease
                    

                            Install as a Cake Addin

#tool nuget:?package=XiHan.Framework.Kernel&version=5.0.0-rc.2&prerelease
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

XiHan.Framework.Kernel

关于

XiHan.Framework.Kernel 是框架的微内核：应用构建、能力图谱求解、执行管道与内置中间件、操作契约与调用器、安全原语、健康与插件抽象。所有应用都经它装配；它不处理 HTTP，不含具体的子系统实现。

主要特性

AddXiHan 收集特性、求解能力图谱，并按拓扑顺序装配
带阶段与次序约束的执行管道，内置观测、截止时间、弹性（熔断、限流、并发）与契约校验中间件
操作契约 [Operation] 与 IOperationInvoker，协议适配器按登记表发布
Principal、TenantContext、权限登记与出站地址策略等安全原语
健康快照与 IHealthContributor；失败结果只带消息键，按调用方区域翻译

如何使用

安装

dotnet add package XiHan.Framework.Kernel --prerelease

使用

通常经 Hosting.AspNetCore 或 Hosting.CommandLine 间接使用。在通用宿主上直接使用内核：

var builder = Host.CreateApplicationBuilder(args);
builder.AddXiHan(xihan => xihan.UseFeature<WorkerFeature>());   // WorkerFeature 是应用自己的特性
await builder.Build().RunAsync();

常用配置节：XiHan:Kernel（启动与停止超时、失败策略）、XiHan:Kernel:Resilience（按操作的限制）、XiHan:Kernel:Banner（启动 Banner）、XiHan:Providers（指定能力提供者）。

宿主启动时先打印启动 Banner：字符画 Logo、框架版本、应用、环境、运行时与操作系统，写到标准输出，没有重定向的控制台上 Logo 带颜色（设置 NO_COLOR 可去掉）。XiHan:Kernel:Banner:Enabled=false 关闭；要改写入目标，在 AddXiHan 之前登记自己的 StartupBannerOptions。命令行宿主缺省不打印。

主要类型

此库提供的主要类型：

AppBuilder、App：装配入口与运行中的应用
KernelOptions、StartupBannerOptions：内核选项与启动 Banner 的选项
IFeature、IHostedFeature、FeatureContext：特性与它的装配入口
PipelineBuilder、IPipelineMiddleware、PipelineStage：执行管道
OperationAttribute、IOperation<TRequest, TResponse>、IOperationInvoker：操作契约与调用
SecurityContext、Principal、PermissionRegistry：安全上下文与权限登记

反馈与贡献

XiHan.Framework.Kernel 以 MIT 许可证开源。欢迎到 GitHub 仓库提交问题和贡献。

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.14)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Diagnostics.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.14)
- Microsoft.Extensions.Options (>= 10.0.14)
- System.Threading.RateLimiting (>= 10.0.14)
- XiHan.Framework.Primitives (>= 5.0.0-rc.2)

NuGet packages (26)

Showing the top 5 NuGet packages that depend on XiHan.Framework.Kernel:

Package	Downloads
XiHan.Framework.MultiTenancy.Abstractions 曦寒框架多租户抽象包	15.5K
XiHan.Framework.Localization.Abstractions 曦寒框架本地化抽象包	14.3K
XiHan.Framework.AI.Abstractions 曦寒框架 AI 抽象包	6.9K
XiHan.Framework.Workflow.Abstractions 曦寒框架工作流抽象包	5.4K
XiHan.Framework.Caching.Abstractions 曦寒框架缓存抽象包	777