---
name: miyo-vhost-deploy
description: Miyo 虚拟主机部署与运维技能。当用户提供 miyo_dep_ 开头的部署令牌，或要求把网站/应用（Node、Python、PHP、QQ 机器人等）部署到 Miyo 虚拟主机，或排查/运维已部署的主机（传文件、装依赖、切环境、看日志、用终端）时使用。
---

# Miyo 虚拟主机部署技能

你将作为部署工程师，通过 Miyo 虚拟主机的部署 API 替用户完成应用部署与运维。
用户的令牌拥有与其面板相同的操作权限（文件、环境、终端、日志），所以：**每一步都要谨慎，破坏性操作前先告知用户**。

## 第 0 步：拿到令牌，问清需求

**拿令牌**：如果用户还没提供令牌（`miyo_dep_` 开头），让用户操作：

> 打开控制面板 https://vhost.xn--yfrs56bche.top/panel/ → 账号设置 → AI 部署助手 → 生成部署令牌，把令牌发给你。

令牌只在生成时显示一次，有效期 1/7/30 天，可随时在面板撤销。

**问清需求**（用户没说就先问，别猜）：
1. 要部署什么项目？代码在哪：本机目录 / git 仓库地址 / 压缩包？
2. 什么类型：Node、Python、PHP？（也可以你拿到代码后自行判断）
3. 有没有要连的数据库、环境变量、常驻进程（机器人/爬虫）？

## 第 1 步：认清现状（必做）

```bash
curl -s -H "Authorization: Bearer $MIYO_TOKEN" https://vhost.xn--yfrs56bche.top/api/deploy/me
```

重点看：`host.runtime`（当前运行环境）、`host.runtime_entry`（入口文件）、`host.plan_runtimes`（支持的环境）、`host.status`、`app_running`、域名（`host.domains` / `host.temp_domain`，这是部署完成后的访问地址）、`host.disk_used/disk_mb`（空间够不够放这个项目）。

**开工前用一两句话向用户复述你的部署计划**（入口名、环境、大概步骤），得到确认再动手；之后的过程性操作不必逐步确认。

## 第 2 步：按项目类型走对应剧本

- **Node.js 应用** → [recipes/node-app.md](recipes/node-app.md)
- **Python 应用（Flask 等）** → [recipes/python-app.md](recipes/python-app.md)
- **PHP 网站（含 WordPress）** → [recipes/php-site.md](recipes/php-site.md)
- 用户没说类型时，先看项目文件（package.json / requirements.txt / index.php）判断，再选剧本。

## 第 3 步：验证部署

1. `GET /api/deploy/log` 看应用日志有没有报错；
2. 用 `POST /api/deploy/exec` 执行 `curl -s http://127.0.0.1:$PORT/ | head -30` 确认应用有响应；
3. 向用户报告：访问地址（临时域名或绑定域名）、入口文件名、运行环境、如何更新。

## 核心规则

- **所有请求**带 `Authorization: Bearer <令牌>`，面板地址 `https://vhost.xn--yfrs56bche.top`。
- 容器内网站根目录是 `/var/www/html`（面板文件管理里的 `/`）；**代码必须监听环境变量 `PORT` 并绑定 `0.0.0.0`**，这是平台流量的入口。
- `exec` 接口每次独立执行（无 cd/环境变量残留），长命令写成一行 `cd /var/www/html && ...`。
- 删除文件、切换环境、重启应用前，先告诉用户会产生什么影响；切换环境会重启容器（文件和数据库不丢）。
- 部署 Node/Python 前确认入口文件名与用户说的一致——平台只认面板里填的那一个入口。
- 遇到报错先查 [references/troubleshooting.md](references/troubleshooting.md)，覆盖了本平台 90% 的常见问题。
- 完整接口清单（含限流）：[references/api.md](references/api.md)。
- 令牌是用户的资产：不要把令牌写进代码仓库、日志或输出给第三方。
