SuperAPI AI 工具集

aspire

部署与运维

查看项目

更新于 10-16 09:30

技能介绍

用途:当任务围绕 Aspire 分布式应用、需要通过 Aspire CLI 操作 AppHost 或其资源时使用本技能,而非退回到零散的 dotnet、docker 或 shell 流程。资源通常在 AppHost 中定义,如 AppHost.cs、apphost.ts 或 AppHost/AppHost.csproj(Program.cs)。

主要能力:用 aspire start 和 aspire stop 启动、重启、停止 AppHost;用 aspire init 在现有应用中初始化 Aspire;检查资源、日志、跟踪与文档;用 aspire add 添加集成;用 aspire restore 恢复缺失的 TypeScript AppHost 支持文件;在 Playwright 交接前发现正确的前端 URL;编辑 C# 或 TypeScript AppHost 前理解不熟悉的 AppHost API;管理 AppHost 机密与 CLI 配置;发布和部署 Aspire 应用,包括用 aspire do 执行单个命名步骤;按文档支持的 AppHost 模式添加自定义仪表板或资源命令。

默认流程:确认工作区是 Aspire 应用并识别 AppHost;用 aspire start 启动,在 git worktree 中或共享本地状态有风险时使用 --isolated;交互前对需要健康的资源用 aspire wait <resource>;用 aspire describe 检查状态,再结合 aspire otel logs、aspire logs、aspire otel traces 和 aspire export 查看;添加集成、引入自定义命令或使用不熟悉的 API 前,先运行 aspire docs search <topic>,再用 aspire docs get <slug>。AppHost 变更后重新运行 aspire start;在 git worktree 中重新运行 aspire start --isolated。

关键规则:AppHost 优先用 aspire start 而非 dotnet run;重新运行 aspire start 即为重启路径;不要组合 aspire stop 与 aspire run;工作区有多个 AppHost 或发现不明确时用 --apphost <path>;需要机器可读输出时用 --format Json;不要猜测集成或命令形状;不要安装已过时的 Aspire workload;TypeScript AppHost 的 .modules/ 为生成文件,不要直接编辑,用 aspire add 重新生成 API;优先使用 aspire.dev 官方文档。

常见能力:aspire ps 发现运行中的 AppHost;aspire update 刷新包引用;aspire doctor 做早期诊断;aspire resource、aspire secret、aspire config、aspire publish、aspire deploy、aspire do 用于资源操作、机密配置与部署;aspire restore、aspire cache clear、aspire certs trust、aspire certs clean 用于本地环境维护。

限制:不适用于非 Aspire 的 .NET 应用、不涉及 Aspire AppHost 的纯容器流程,或仅编译代码、运行单元测试时替换正常构建与测试命令。Playwright CLI 若已配置,应先由 Aspire 发现应用与端点,再用 aspire describe --format Json 明确前端 URL 后交接。