aicms-renderengine-core

跨项目命名、契约和持久化规则统一遵循 AiCMS 工程编码规范，其中的 Naming Convention 章节是全系统命名正文真源。

共享渲染核心，向 TMaker 和 Console 提供稳定的模板渲染语义、模板角色和作者诊断契约。

Packages

本仓库是唯一源码真源，并发布三个版本化包：

• AiCms.RenderEngine：运行时渲染能力。
• AiCms.TemplateRoles：无渲染依赖的 canonical 模板角色 registry、模型与 manifest preflight。
• AiCms.TemplateAuthoring：模板诊断、格式化和契约校验。

消费者默认通过固定版本的 NuGet 包引用，不使用 RenderEngine Git submodule。 允许的跨包版本组合必须在中央 package provenance 记录中明确批准。

Local Development

需要调试 RenderEngine 源码时，将 AICMS_RENDERENGINE_ROOT 指向同级仓库，并显式开启本地源码模式：

AICMS_RENDERENGINE_ROOT=/path/to/aicms-renderengine-core \
dotnet build -p:UseLocalRenderEngine=true

需要使用本地打包结果验证 NuGet 模式时，先将三个包输出到 artifacts/，再执行：

VERSION=0.0.20260805.1-local
dotnet pack src/AiCms.RenderEngine/AiCms.RenderEngine.csproj --configuration Release \
  --output artifacts -p:AiCmsRenderEngineVersion="$VERSION"
dotnet pack src/AiCms.TemplateRoles/AiCms.TemplateRoles.csproj --configuration Release \
  --output artifacts -p:AiCmsRenderEngineVersion="$VERSION"
dotnet pack src/AiCms.TemplateAuthoring/AiCms.TemplateAuthoring.csproj --configuration Release \
  --output artifacts -p:AiCmsRenderEngineVersion="$VERSION"

# Run from TemplateStarter. This remains a PackageReference verification: it
# explicitly disables the local ProjectReference mode and pins both packages.
AICMS_RENDERENGINE_ROOT=/path/to/aicms-renderengine-core \
dotnet restore TMaker.UnitTests/TMaker.UnitTests.csproj --force-evaluate --no-cache \
  -p:UseLocalRenderEngine=false \
  -p:UseLocalRenderEnginePackages=true \
  -p:AiCmsRenderEngineVersion="$VERSION" \
  -p:AiCmsTemplateAuthoringVersion="$VERSION"
AICMS_RENDERENGINE_ROOT=/path/to/aicms-renderengine-core \
dotnet test TMaker.UnitTests/TMaker.UnitTests.csproj --no-restore \
  -p:UseLocalRenderEngine=false \
  -p:UseLocalRenderEnginePackages=true \
  -p:AiCmsRenderEngineVersion="$VERSION" \
  -p:AiCmsTemplateAuthoringVersion="$VERSION"

正式 CI 和部署构建不得依赖本地源码路径或 Git submodule。