用途:以统一的设备配置文件(profile)为单一数据源,协调服务器开通与部署流程,配合 admin-infra-(基础设施)和 admin-app-(应用)系列技能使用。服务器不存放在独立清单文件中,而是记录在 profile.servers[] 内。
主要能力:
- 配置文件加载与导出。PowerShell:. scripts/Load-Profile.ps1 、Load-AdminProfile -Export;Bash:source scripts/load-profile.sh 、load_admin_profile。
- 服务器查询与筛选:Get-AdminServer / get_admin_server,支持按 role、provider、id 过滤,例如 get_admin_server role "coolify"、get_admin_server provider "contabo"、get_admin_server id "cool-two"。
- SSH 连接:配置含 keyPath、port、username、host,可用 ssh -i $server.keyPath -p $server.port "$($server.username)@$($server.host)" 或辅助函数 ssh_to_server "cool-two"。
- 新增服务器与新增部署:向 $AdminProfile.servers 与 $AdminProfile.deployments 追加条目,再用 ConvertTo-Json -Depth 10 | Set-Content 保存到 $AdminProfile.paths.deviceProfile。
- 部署配置加载:Load-AdminProfile -Deployment "vibeskills-oci" -Export(PowerShell)或 load_deployment "vibeskills-oci"(Bash)。
使用方式:整体流程为选择 provider(OCI/Hetzner/Contabo/DigitalOcean/Vultr/Linode,分别路由到 admin-infra-oci、admin-infra-hetzner 等)、从 templates/env-template.env 复制生成 .env.local 并填入凭据、注册 deployment、运行对应基础设施技能、最后把服务器信息加入 profile 并关联到 deployment,状态置为 active。应用层则用 admin-app-coolify(需带 Docker 的服务器)或 admin-app-kasm 部署;Windows、WSL 任务分别路由 admin-windows、admin-wsl。状态更新通过 FindIndex 定位服务器条目后修改 status 与 lastConnected 并保存。
限制:资料未说明具体收费、价格、性能表现或平台限制;命令均依赖本地 profile 文件与 .env.local 中的凭据,需自行准备;详细步骤与常见问题见 references/DEPLOYMENT_WORKFLOWS.md 与 references/TROUBLESHOOTING.md。