SuperAPI AI 工具集

aspire-init

部署与运维

查看项目

更新于 10-15 20:34

技能介绍

用途:Aspire Init 是仅用于首次接入的工作流技能,负责在尚无 Aspire AppHost 的仓库中放置骨架并选择模板;骨架就位后交由 aspireify 完成实际资源接线。

前置条件:需要 .NET 10.0 SDK;Aspire CLI 可用 curl 安装器 curl -sSL https://aspire.dev/install.sh | bash,或使用 NativeAOT 全局工具 dotnet tool install -g Aspire.Cli(需 .NET 10)。可用 aspire doctor 诊断缺失的前置条件。

检测与激活:仅当工作区尚无 Aspire 时激活,需确认无含 Aspire.AppHost.Sdk 的 .csproj、无 apphost.cs、无 apphost.ts、无 aspire.config.json,且用户明确要求添加 Aspire。若已存在 AppHost,不要运行 aspire init,应转 aspireify 或 aspire-orchestration。

命令选择:空目录或全新项目用 aspire new <template>;已有服务需建模的仓库用 aspire init。示例:aspire new aspire-starter --name MyApp --output ./MyApp --non-interactive;aspire init --language csharp --non-interactive 或 --language typescript --non-interactive。

aspire init 会生成 AppHost 骨架(apphost.cs 或 apphost.ts 及 .aspire/modules/)、AppHost 配置,并安装 aspireify 技能;它本身不接线资源、项目或集成。之后交由 aspireify 接线,再用 aspire start 验证。

限制与错误处理:非交互模式未指定 --language 会失败,需重跑并指定语言;aspire new 的 --output 路径须为空;命令未找到需安装 CLI;缺少 .NET 10 需先安装 SDK;若未安装 aspireify 技能,可运行 aspire agent init。项目本地技能(.agents/skills/aspire-init/SKILL.md 或项目内 aspireify)优先于插件版本,应警告并遵从。