用途:管理 Aspire AppHost 生命周期,避免代理在 Aspire 项目中因误操作造成文件锁、孤儿进程和用户困扰。适用于 C# AppHost、基于文件的 C# AppHost、TypeScript AppHost,以及存在 aspire.config.json、.aspire/ 目录等信号的项目。
主要能力:启动与停止应用、等待资源就绪、查看资源状态、执行资源命令、创建或初始化项目、添加集成、更新 CLI 与项目引用、恢复生成文件、环境维护与诊断,并支持 --format Json 机器可读输出。
必要用法:启动用 aspire start(代理场景,后台优先),人类前台运行用 aspire run;交互资源前先 aspire wait <resource>;用 aspire describe 或 aspire ps 检查状态;任务完成用 aspire stop。在 git worktree 中用 aspire start --isolated;代理运行所有命令加 --non-interactive。安装 Aspire CLI 可用 curl -sSL https://aspire.dev/install.sh | bash 或 dotnet tool install -g Aspire.Cli。
限制与注意:不要对 AppHost 直接 dotnet run;不要用 curl 轮询等待资源;不要用 pkill 或删除 bin/obj 处理文件锁,应先 aspire stop。遇到 MSB3491、CS2012 等锁错误,先 aspire stop 再重建或重启。aspire wait 使用 displayName 而非 name;aspire ps 挂起可能因 AppHost 断点。Docker 不可用时容器资源无法启动。AppHost 代码编辑、部署、监控等分别交由 aspireify、aspire-deployment、aspire-monitoring 等技能处理,本技能不编辑 AppHost 代码。