Zeek.Core

Zeek.Core 是 ZeekFramework 的桌面模块运行时内核，负责 ZeekRuntime、模块依赖图、DI、Configuration、Logging、IHostedService 接线和生命周期编排。

Core 同时唯一拥有用户级主配置文件：应用项目中的源码 appsettings.json 会自动作为 embedded seed，首次运行时写入 LocalApplicationData/<ApplicationName>/appsettings.json，之后不覆盖用户文件，也不复制到构建或发布输出。

适用场景

• 需要直接使用 ZeekRuntime 构建非 Avalonia 或测试级运行时。
• 编写官方或业务模块，需要实现 IZeekModule 并参与服务注册和生命周期。
• 需要理解模块依赖、启动、停止、回滚和 IHostedService 接线顺序。

安装 / 引用

普通 Avalonia 应用通常通过 Zeek.Avalonia 间接获得 Core。只有直接使用 ZeekRuntime、IZeekModule 或 Core public API 时才需要显式引用。

<PackageReference Include="Zeek.Core" />

快速开始

推荐普通桌面应用从 Zeek.Avalonia 启动；低层或测试场景可通过 ZeekRuntime.Build<TRootModule>(...) 构建运行时。

普通应用不需要配置文件路径；只有测试、迁移工具或固定外部路径宿主才调用一次 builder.UseConfigurationFile(path)。

完整示例见正式文档。

AOT / Trim

• AOT 支持等级：Required。
• Trim 策略：显式模块依赖和显式服务注册，不依赖运行时程序集扫描。
• 反射策略：Core 主路径不以反射发现模块；DI 只构造已注册服务。

Sample

• ../../samples/Zeek.MinimalApp/
• ../../samples/Zeek.AvaloniaHostSample/

完整文档

• ../../docs/modules/Zeek.Core.md
• ../../docs/topics/Zeek.Core 企业级桌面重构方案.md

当前限制

• Core 不负责 Avalonia UI、窗口、Navigation、Dialogs、Settings 写回、Serilog 管线或业务语义。
• Core 不提供服务端 Host 平台、插件热加载、分布式能力或自动程序集扫描。