用途：在创建新的 Umbraco 后台扩展项目后，把该扩展作为项目引用加入主 Umbraco 实例的 .csproj，否则运行站点时扩展不会被加载；若存在 .sln，还可将扩展加入解决方案以获得 IDE 支持。
主要能力：动态定位主 Umbraco 项目（用 Glob 查找 **/*.csproj，再用 Grep 匹配 Umbraco.Cms 包引用，主项目通常为 Microsoft.NET.Sdk.Web）；读取项目文件结构；计算从主项目目录到扩展 .csproj 的相对路径（使用正斜杠 /）；在已有或新建的 ItemGroup 中添加 <ProjectReference Include="..." />；查找 .sln 并用 dotnet sln <path-to-solution.sln> add <path-to-extension.csproj> 添加扩展。
使用时机：用 dotnet new umbraco-extension 创建扩展后、移动或复制扩展项目到解决方案后、或从 umbraco-backoffice 蓝图搭建新扩展后。
限制与注意：解决方案步骤可选，无 .sln 时跳过；存在多个 .sln 或多个含 Umbraco.Cms 的项目时需询问用户选择；扩展已在解决方案中时 dotnet sln add 会提示已添加，可忽略。完成后建议用 dotnet build 构建、dotnet run 运行并检查后台是否加载扩展；若扩展未加载，可检查扩展是否已构建（cd ExtensionName/Client && npm run build）以及 wwwroot 下是否存在 umbraco-package.json。