Skymly.DesignPatterns 0.2.0-preview3

DesignPatterns

面向 .NET 的设计模式工具库：提供可组合的运行时 primitives，并通过 Roslyn 源生成器在编译期减少样板代码、发现误用。

项目状态（早期阶段）

本仓库已开源（MIT），但处于早期开发阶段。

• 公共 API 尚未稳定：类型、特性、源生成器产出、诊断 ID（DP###）及命名规则可能在任意版本变更，不保证语义化版本下的向后兼容。
• NuGet 发布：元包 Skymly.DesignPatterns 0.2.0-preview3 发布至 nuget.org 与 GitHub Packages；亦支持本地 ./build.ps1 --target CiPack。C# 命名空间仍为 DesignPatterns.*；旧 GitHub 包 ID DesignPatterns（preview1/2）已弃用。
• 生产环境：建议仅在可接受 API 变动的实验、内部工具或学习场景使用；在 API 稳定前请固定 commit 或 fork，并关注 ROADMAP 与 breaking changes。

English: This project is open source under the MIT license and in an early preview. Public APIs, generated code shapes, and diagnostics are not stable yet. Do not assume SemVer compatibility until a stability announcement.

反馈与贡献见 CONTRIBUTING.md（Issue / PR 建议使用英语，见仓库协作约定）。

目标

• 以技术探索为目的，发挥本库在「运行时 primitives + 编译期源生成 / 诊断」协同上的最大技术潜能——即使与现有库（MediatR / Polly / Microsoft.Extensions.* 等）能力重叠也无所谓，重叠不是拒绝实现的理由
• 帮助开发者在真实项目中更快、更一致地应用设计模式
• 组合优于继承：轻量接口与扩展，而非厚重基类体系
• 编译期与运行时协同：特性标记 + 源生成 + 诊断，而非魔法框架
• 语言：C# 优先；后续再考虑 .NET 生态其他语言
• 模式范围：包含 GoF 但不局限于 GoF（并发 / 反应式 / 函数式等模式均可纳入）

已实现的模式

DI 集成

引用对应扩展项目/包时，源生成器自动输出 RegisterDi（MSDI）或 RegisterAutofac（Autofac）方法，从容器解析实例。

• MSDI：引用 DesignPatterns.Extensions.DependencyInjection（自动导入 build/*.targets）
• Autofac：引用 DesignPatterns.Extensions.Autofac（自动导入 build/*.targets）

当前元包 Skymly.DesignPatterns 不包含 DI 扩展；独立 NuGet 发布策略待 API 与发版流程稳定后再确定。

仓库结构

DesignPatterns.slnx
├── DesignPatterns/                              # 运行时核心（netstandard2.0 + net8.0）
├── DesignPatterns.Diagnostics/                  # DP### 诊断 ID 常量
├── DesignPatterns.SourceGenerators/             # 增量源生成器
├── DesignPatterns.Analyzers/                    # DP006、DP023、DP024、DP025、DP033、DP036 Analyzer
├── DesignPatterns.CodeFixes/                    # CodeFix
├── DesignPatterns.Extensions.DependencyInjection/  # MSDI 扩展 + DI 生成器 targets
├── DesignPatterns.Extensions.Autofac/            # Autofac 扩展 + Autofac 生成器 targets
├── DesignPatterns.Package/                      # NuGet 元包（PackageId=Skymly.DesignPatterns）
├── tests/                                       # 单元 / 生成器 Verify / Analyzer / DI / Autofac 测试
└── docs/                                        # 设计与开发文档

生态仓库

本地工作区建议并列克隆：DesignPatterns/、DesignPatterns.Samples/、DesignPatterns.Docs/。

文档

快速开始

NuGet（预览，Skymly.DesignPatterns 0.2.0-preview3）

<PackageReference Include="Skymly.DesignPatterns" Version="0.2.0-preview3" />

默认从 nuget.org 还原。GitHub Packages 镜像（可选）：

<packageSources>
  <add key="github" value="https://nuget.pkg.github.com/Skymly/index.json" />
</packageSources>

源码

git clone https://github.com/Skymly/DesignPatterns.git
cd DesignPatterns

# 与 CI 相同（Nuke）
./build.ps1 --target Ci --configuration Release

打包并校验 NuGet 元包（输出到 artifacts/package/）：

./build.ps1 --target CiPack --configuration Release

示例程序

可运行示例在独立仓库 DesignPatterns.Samples（默认 sibling 引用 ../DesignPatterns）：

git clone https://github.com/Skymly/DesignPatterns.git
git clone https://github.com/Skymly/DesignPatterns.Samples.git
cd DesignPatterns.Samples
./build.ps1 --target Ci --configuration Release

详见 DesignPatterns.Docs — Samples。

规划中的能力

见 docs/ROADMAP.md（可选增强项与 CompletionProvider 等）。