Perigon.templates

Perigon.templates是基于Aspire,ASP.NET Core和Entity Framework Core的快速开发模板，提供一个设计良好的项目工程结构。

模板已被集成在Perigon.CLI代码辅助工具中，建议使用该命令行工具来创建解决方案，以获得更好的体验。

要求

• .NET 10.0 SDK 或更高版本
• Aspire 13.0 或更高版本

文档

关于模板详细的说明和使用方法，请查阅使用文档！

安装

使用源代码安装

• 拉取源代码
• 执行install.ps1脚本安装。

使用Nuget安装

模板已经发布到nuget上，请根据你的项目版本下载对应的模板。

dotnet new --install Perigon.templates 

模板说明

当前仓库提供两套可选模板：

• MiniApi：面向轻量接口服务，优先采用 Minimal API、NativeAOT、Request Delegate Generator 与 Perigon.PostgreSQL，适合高性能、低资源开销、对 AI 工具友好的后端服务。
• ApiStandard：面向传统 Web API 场景，基于 ASP.NET Core Web API、EF Core 与 Aspire，适合需要标准 MVC/Web API 生态、模块化组织和更传统开发方式的项目。

MiniApi 模板的作用与使用场景

MiniApi 模板适合以下场景：

• 需要构建轻量级 API 服务，启动快、内存占用低。
• 希望优先使用 Minimal API 与 NativeAOT，获得更好的发布性能和运行效率。
• 需要与 AI/代码生成工具配合时，代码结构更直接、层次更清晰。
• 适用于网关、微服务、数据接口、内部系统接口等对性能和部署成本敏感的项目。

创建项目

下面给出两套模板的创建命令示例：

创建 MiniApi 模板

dotnet new perigon-minapi -n MyMiniApi

创建 ApiStandard 模板

dotnet new perigon-webapi -n MyWebApi

如果你想指定模板名称并直接生成到当前目录，也可以这样：

dotnet new perigon-minapi -n <projectname>
dotnet new perigon-webapi -n <projectname>

数据库

模板默认支持PostgreSQL和SqlServer，你可以在AppHost项目的appsettings.json中进行选择。

数据迁移

可直接运行scripts\EFMigrations.ps1脚本生成迁移内容，程序在启动时会执行迁移。

cd scripts
.\EFMigrations.ps1

该脚本提供一个参数，指定迁移生成时的名称，如.\EFMigrations.ps1 Init .

运行项目

直接运行AppHost项目即可。

默认管理账号：admin@default.com/Perigon.2026.