AutoModeCodeGenerator

基于 Roslyn 的 C# 增量源生成器：在接口/类上标注特性，编译期生成 SqlSugar / Admin.NET 风格的 Entity / Dto / Create / Update / Detail / Search 等多产物类型（只生成数据形状，不生成 Service / Controller）。

当前版本：1.0.1.0

为何用： 一份接口规格驱动六套 CRUD 类型，按 mode 投影字段，mixin 复用横切；用预设 / Relation / Morph 消灭六模式与外键样板。亦支持 .entity.json 声明式生成。消费架构与 Agent 硬规则见 docs/AI_CONSUMER_GUIDE.md（§0）。

功能概览

相对 nuget.org 1.0.0.17，自 1.0.1.0 起一并提供：

双主入口： 特性（CRUD 预设等）与 .entity.json 并列；默认 ClassStyle Poco。ClassStyle.Record / Inpc 为样式选项。

文档导航

更多索引：docs/README.md。

安装

<PackageReference Include="AutoModeCodeGenerator.Analyzers" Version="1.0.1.0" PrivateAssets="all" />

可选约定包（无 SqlSugar 程序集依赖）：

<PackageReference Include="AutoModeCodeGenerator.Conventions.SqlSugar" Version="1.0.1.0" />

完整说明见 Analyzers/README.md（随 NuGet 发布）。

本地 ProjectReference

<ProjectReference Include="..\AutoModeCodeGenerator.Analyzers\AutoModeCodeGenerator.Analyzers.csproj"
                  OutputItemType="Analyzer"
                  ReferenceOutputAssembly="false" />

常用 MSBuild

<PropertyGroup>
  <EmitCompilerGeneratedFiles>true</EmitCompilerGeneratedFiles>
  <CompilerGeneratedFilesOutputPath>$(BaseIntermediateOutputPath)Generated</CompilerGeneratedFilesOutputPath>
  <AutoModeGenerateEntityFiles>false</AutoModeGenerateEntityFiles>
  <!-- Morph / InjectMarkerMembers 默认区间类型；Device 项目可改为 SearchRangeForStructValue<{0}> -->
  <AutoModeSearchRangeTemplate>SearchRangeForStructValue&lt;{0}&gt;</AutoModeSearchRangeTemplate>
</PropertyGroup>

最小示例

using AutoCodeGenerator;

[AutoCodeCrudModes(EntityInterfaceTypes = [typeof(IEntityMarker)])]
public interface Product : IHasLongId
{
    [AutoCodeProperty(ModeFlags = AutoCodeModeFlags.EntityDtoSearch)]
    [AutoCodeColumn(Length = 128)]
    string? Name { get; set; }

    [AutoCodeRelation(TargetName = nameof(Category), IncludeNavigate = false)]
    long Category { get; set; }
}

生成：ProductRecord、ProductDto、ProductCreateInput、ProductUpdateInput、ProductDetailOutput、ProductSearchInput。

项目结构

AutoModeCodeGenerator/
├── README.md / CHANGELOG.md / LICENSE
├── docs/                          # 消费方/AI/维护者文档（见 docs/README.md）
└── src/
    ├── AutoModeCodeGenerator.Analyzers/      # 源生成器 + 诊断/CodeFix（NuGet）
    │   ├── Extraction/ / Expansion/          # 管线：见 docs/ARCHITECTURE.md
    │   ├── CodeGeneration/ / EntityFiles/    # 共享 Emit / entity.json
    │   ├── Diagnostics/ / Templates/         # Mccj* / 嵌入公共 API
    ├── AutoModeCodeGenerator.Conventions.SqlSugar/
    ├── AutoModeCodeGenerator.Samples/
    └── AutoModeCodeGenerator.Tests/

公共 API 命名空间：AutoCodeGenerator。内部：AutoModeCodeGenerator.Internal。

开发与构建

dotnet build src/AutoModeCodeGenerator.slnx
dotnet test src/AutoModeCodeGenerator.Tests/AutoModeCodeGenerator.Tests.csproj
dotnet run --project src/AutoModeCodeGenerator.Samples/Samples.csproj
dotnet pack src/AutoModeCodeGenerator.Analyzers/AutoModeCodeGenerator.Analyzers.csproj -c Release

• 测试覆盖：Poco/Record/Inpc、CRUD/Relation/Morph、Column/Index、Inject、Mccj001–014、CodeFix、nupkg 内容。
• CI：.github/workflows/ci.yml；发包见 PACKAGING.md。

调试源生成器

在 AutoCodeGenerator.Initialize 开头临时 Debugger.Launch();，编译消费项目时附加；调试完移除。

1.0.1 破坏性变更（相对 1.0.0.17）

• ClassStyle.Record → 真正的 record class（init）
• Inpc 基类实现 INotifyPropertyChanged
• 内部命名空间改为 AutoModeCodeGenerator.Internal

详见 CHANGELOG.md。CRUD 默认 Poco 时升到 1.0.1.x 无破坏。

许可证

Apache License 2.0