<!-- PIPELINE_META
status: PUBLISHED
product_id: PROD-004
title: Agent部署助手 — 一键部署你的网页到服务器
category: Agent部署
author: A1
reviewers: [A3a, A3b]
qa_score: 4.50
pipeline_start: 2026-05-27
last_transition: 2026-05-28
version: 1.1.0
-->

# Agent部署助手 — 一键部署你的网页到服务器

> **一句话卖点**: 让AI Agent帮你部署网站，省时省力不出错

---

## 📋 基本信息

| 字段 | 内容 |
|------|------|
| **产品ID** | PROD-004 |
| **版本** | 1.0.0 |
| **分类** | Agent部署 |
| **适用AI** | Claude / ChatGPT / DeepSeek / Hermes / OpenClaw / 通用 |
| **价格** | ¥3.90 |
| **作者** | A1 |
| **发布日期** | 2026-05-27 |

---

## 🎯 这个文件能做什么

把你的AI Agent变成一个网站部署工程师。加载后，Agent会按照标准部署流程操作：备份当前版本 → 上传新文件 → 验证HTTP 200 → 失败自动回滚。它懂得什么是rsync、什么是nginx重启、什么是权限设置。你只需要告诉它"把deploy-ready/里的新页面上线"，它就能独立完成全套部署操作，并在完成后输出一份完整的部署报告。

**适用场景**：
- 个人站长需要自动化部署流程
- 不想每次手动敲scp/rsync命令
- 需要部署后自动验证+回滚保障
- 多台服务器需要统一部署管理
- 团队协作中规范部署流程

---

## 🚀 使用步骤

> **⚠️ 技术栈前提**: 本产品适用于 Linux 服务器 + SSH 访问 + rsync 工具 + Nginx 环境。Windows Server / Docker / K8s 用户需根据实际情况调整部署命令。

### 第一步：加载文件
```
将本 .md 文件内容复制到你使用的 AI Agent 的记忆/系统提示中。
或直接在 AI 对话中上传此文件，并告诉 AI "请加载这个部署助手记忆"。
```

### 第二步：触发指令
```
"请部署 deploy-ready/ 目录下的新文件到服务器。"
或指定具体文件："帮我上线 index.html 和 memory-detail.html"
```

### 第三步：观察输出
Agent 会先读取你的服务器配置（IP、端口、路径），然后执行备份 → 上传 → 验证三步流程，最后输出部署结果报告。

---

## 📤 输出示例

**输入**：帮我把新页面部署到服务器上

**输出**：

> 好的，开始执行标准部署流程：
>
> **第一步：读取配置**
> - 服务器：<your-server-ip>:<port>
> - Nginx → localhost:<port>
> - 网站根目录：<your-web-root>
>
> **第二步：备份当前版本**
> - 备份到 _backups/deploy/2026-05-27-1500.tar.gz ✅
>
> **第三步：上传新文件**
> - index.html → <your-web-root>/index.html ✅
> - memory-detail.html → <your-web-root>/memory-detail.html ✅
>
> **第四步：验证**
> - http://<your-domain.com>/ → HTTP 200 ✅
> - http://<your-domain.com>/page → HTTP 200 ✅
>
> **部署结果：成功**
> - 部署文件数：2
> - 耗时：12秒
> - 当前版本：v1.2.0

---

## ⚠️ 边界处理

| 情况 | 处理方式 |
|------|---------|
| SSH连接超时 | 重试3次，间隔10秒，若仍失败则输出错误信息并回滚 |
| 服务器空间不足 | 检查磁盘使用率，若>90%则提示清理后再部署 |
| 验证HTTP非200 | 立即自动回滚到上一个备份版本并发送告警 |
| 目标文件正在使用 | 先尝试优雅重启服务，若失败则强制覆盖 |
| 多文件部分上传失败 | 已上传的文件回滚到旧版本，确保站点一致性 |
|| 无备份目录 | 自动创建 _backups/deploy/ 目录 |
|| 非 root 权限不足 | 提示用户使用 sudo 或切换到有权限的用户，并输出缺失权限列表 |

---

## 🔄 版本历史

| 版本 | 日期 | 变更内容 | 作者 |
|------|------|---------|------|
| 1.1.0 | 2026-05-28 | 修复：IP改为占位符+增加技术栈说明+增加非root边界 | A1 |

---

## ✅ QA 检查清单（提交前自查）

- [x] 文件大小 500B ~ 500KB
- [x] 有 H1 标题（`# `开头）
- [x] 有使用步骤说明
- [x] UTF-8 编码，无乱码
- [x] 无待替换占位符
- [x] 无断链
- [x] 已在至少一个 AI 平台上自测通过