官方模块

Perigon 官方模块由 Perigon.Modules 仓库维护。创建解决方案时可以选择官方模块；也可以在创建后查看清单并按需安装：

perigon module list
perigon module install Perigon.SystemMod AdminService

最新模板不会默认加入这些模块。每个模块都是以 Mod 结尾的独立程序集，业务实现和 DTO 位于 src/Modules/{Name}Mod，实体位于 src/Definition/Entity/{Name}Mod。

官方模块目录

模块	适用场景	主要能力
`Perigon.SystemMod`	后台管理和身份权限基础	用户、角色、菜单、系统配置与日志、数据权限范围和权限组成员管理。
`Perigon.CMSMod`	内容管理	文章分类、文章编辑和文章图片上传。
`Perigon.ResourceMod`	面向租户的通用资源管理	环境、分类、定义、动态属性、角色授权、个人资源审核和收藏。

每个模块的独立介绍包括其主要流程、管理页面、接口范围和使用边界。官方模块元数据以 Perigon.Modules/modules.json 为准。

官方模块包始终包含模块后端所需的实体、模块程序集、控制器和元数据。打包时若提供 --front-path，还会包含该前端模块目录及同级 share 目录，布局为：

Frontend/{module}/...
Frontend/share/...

安装带前端内容的包时，将 --front-path 指向目标前端的 modules 根目录；模块与 share 分别恢复到该目录下。模块文件会覆盖同名文件，而 share 中已有的同名文件会保留。

模块包不包含前端应用外壳、根依赖配置或 npm/pnpm 依赖，也不会修改目标服务的 Program.cs。前端打包的完整用法和限制见命令行文档。

CommonMod 是保留模块，用于承载多个模块可复用的基础功能；它不是官方模块清单中的可选业务模块。

In this article