Skip to the content.

组件源码复制与本地包消费

可复用项目位于根 src 或各模块的 src;模块的 docs、src、test 与独立解决方案集中在同一目录。samples 中的业务模型、Host 和适配示例不属于共享组件依赖闭包。 使用 .NET SDK(版本由 global.json 固定)、Git 和 PowerShell 7 执行以下命令。

导出源码

在仓库根目录执行:

./build/export-modules.ps1 -Modules MS.Microservice.Messaging.SelfManaged.EFCore,MS.Microservice.Messaging.RabbitMQ -OutputDirectory ../message-components

输出目录必须不存在。脚本遍历 ProjectReference,复制选中组件及其依赖的受版本管理文件, 并带上 SDK、构建属性、中央包版本和公开 NuGet 源配置。它不会复制 samples、密钥、bin、obj。 module-manifest.json 记录源提交、文件 SHA-256 和项目闭包。

在导出目录独立构建:

Set-Location ../message-components
dotnet restore modules.slnx --configfile nuget.config
dotnet build modules.slnx -c Release --no-restore

宿主随后引用导出目录中的项目。自行维护 DbContext、模型映射、迁移和 Secret。 不需要原仓库的解决方案、Lab 或隐藏的父目录配置。

打本地包

./build/pack-modules.ps1 -Modules MS.Microservice.Messaging.SelfManaged.EFCore,MS.Microservice.Messaging.RabbitMQ -OutputDirectory ../local-feed -Version 1.0.0-local.1

脚本按依赖顺序打包整个闭包,并生成 packages.sha256.json。每轮使用新版本,避免本地 NuGet 缓存 复用同版本旧包。消费项目在自己的 nuget.config 中配置此目录和 nuget.org,然后引用包。 运行时不需要源码目录。

独立消费验证

./build/validate-module-consumption.ps1

默认验证全部共享组件。脚本在系统临时目录创建独立源码副本和包消费项目,完成构建、打包、 程序集类型加载。如果闭包包含 SelfManaged,还在两个独立业务 DbContext 中实际验证:

闭包包含对应组件时,消费项目还直接调用本轮包中的公共 API,验证以下行为:

CI 使用以下四个入口及其依赖闭包;消费控制台只使用本轮版本的 PackageReference,不通过项目引用访问仓库源码。NuGet source mapping 将本轮闭包的包 ID 精确限定到临时本地源,其他依赖仍使用 nuget.org,保留默认漏洞检查:

./build/validate-module-consumption.ps1 -Modules @('MS.Microservice.Threading', 'MS.Microservice.Caching', 'MS.Microservice.Http.Resilience', 'MS.Microservice.Messaging.SelfManaged.EFCore')

导出前会检查选定项目闭包内未跟踪的编译、资源和打包输入,发现遗漏时列出路径并失败。先审查并纳入版本管理再重试;脚本不会自动暂存或把未知源码带入导出。消费验证程序由脚本明确复制,不属于组件源码导出。

此验证使用 SQLite,不访问 Broker,也不替代 PostgreSQL/RabbitMQ 故障验收。消费宿主显式引用仓库 Directory.Packages.props 中既有版本的 Microsoft.EntityFrameworkCore.Sqlite 与 SQLitePCLRaw.bundle_e_sqlite3,实际版本记录在报告;它不导入中央版本文件,也不改变被测库包。此结果不代表其他 SQLite 原生组合已经验证。 报告默认保存在 artifacts/validation/module-consumption.json,记录 SDK、源提交、实际验证项和生成包的 SHA-256;临时源码、包和消费项目保留供检查。 使用 -Modules 可选择子集,使用 -ReportPath 指定报告位置。 已执行的 Windows 验证记录列出了源版本和范围。

公共 API 的基线比较与破坏性变更检测见 API 兼容性校验。包消费验证检查实际调用行为,两项门禁分别执行。

接入边界

组件 宿主需要负责的内容
Messaging.Abstractions 注册稳定消息名称/版本,定义 Handler,使用最外层工作单元
Messaging.SelfManaged.EFCore 业务 DbContext、AddSelfManagedMessaging 模型、迁移、后台生命周期
Messaging.RabbitMQ Secret、Broker 拓扑显式初始化、连接和确认超时
Messaging.Wolverine 独立具体 DbContext、原生存储初始化、原生恢复配置
Persistence.EFCore / SqlSugar 数据库 Provider、业务映射、事务入口、数据库结构
AspNetCore / Logging / Observability 身份 Authority/Audience、权限、日志后端、遥测导出器
Http.Resilience 为选定的命名或类型化客户端设置目标地址、总超时与调用容量;明确哪些业务请求允许重试
Idempotency.EFCore 在业务 DbContext 注册模型并应用迁移;由同一工作单元提交业务和响应记录,安排过期清理
AI.* Provider 凭据、模型能力、超时、配额与成本报告
Audio / Excel / EventSourcing 平台限制、输入文件、资源所有权;事件溯源存储示例在 Lab
Media / Media.Inference FFmpeg、原生库、字体及可选本地模型;输入权限、并发预算与结果发布
Documents PDF 输入密码与输出保护、文件大小和并发;目标平台 PDFium/Skia 运行时
Notifications SMTP 地址和凭据、发送任务与投递反馈;站内通知的私有目录、所属用户授权与历史保留期
Tasks / Tasks.EFCore / Tasks.Coravel 注册宿主 scoped DbContext、AddTaskCenter 模型和迁移;明确 Scope、稳定 JobId 和处理器版本;独立提交与现有事务内 Stage 分开使用,复用宿主 Coravel Scheduler;首版限单执行实例
Tasks.Dashboard 已有 IJobStore、认证、可信 Scope 回调和操作权限;用观察入口记录 Coravel 注册计划,页面资源内嵌;不注册数据库或调度器
Search 可信本地索引目录、从身份构造 Scope、稳定文档标识与递增版本;宿主提取正文并显式发布,初次大导入后按需 Optimize;首版单写者,索引明文保存

教育图像场景的源码复制需包含 samples/AI 中的场景类库及其共享依赖; 它不是 AI.Core 的默认功能。QuestionGeneration Harness 可以单独引用。