# 📚 规则文档更新完成

## 🎯 更新总结

已完成所有规则文档的重写，**去除 PM2 管理，改为宝塔 API 优先**！

---

## ✅ 更新的文档

### 1. 统一Node项目管理规范.md

**主要改动**：
- ✅ 去除所有独立 PM2 管理内容
- ✅ 明确优先使用宝塔 API
- ✅ SSH 作为备选方案
- ✅ 添加端口分配表
- ✅ 添加实际问题和解决方案

**核心原则**：
```
优先级：宝塔 API > SSH > 宝塔界面（手动）

- 查询信息：宝塔 API
- 文件操作：宝塔 API
- 命令执行：SSH
- 添加项目：宝塔界面
```

### 2. node项目部署后无法访问的标准修复流程.md

**主要改动**：
- ✅ 去除所有 PM2 命令
- ✅ 改为宝塔界面操作
- ✅ 添加本次部署的5大实际问题：
  1. HTTPS 强制重定向
  2. DNS 被代理劫持（198.18.x.x）
  3. 端口只监听 IPv6
  4. 腾讯云轻量服务器网络特性
  5. 项目未构建

### 3. serverconnect.mdc

**主要改动**：
- ✅ 更新部署流程（宝塔 API 优先）
- ✅ 明确操作优先级表
- ✅ 添加实际部署经验
- ✅ 说明宝塔 API 的能力和限制

---

## 🔧 新的部署标准

### 操作优先级

| 操作 | 优先 | 备选 | 原因 |
|------|------|------|------|
| 查询服务器 | 宝塔 API | SSH | API 稳定 |
| 创建目录 | 宝塔 API | SSH | API 可用 |
| 读写文件 | 宝塔 API | SSH | API 支持 |
| 上传代码 | SSH | - | 大文件 |
| 安装依赖 | SSH | - | 需执行命令 |
| 构建项目 | SSH | - | 需执行命令 |
| 配置 Nginx | 宝塔 API | SSH | API 可读写 |
| 重载 Nginx | SSH | - | API 无接口 |
| 添加项目 | 宝塔界面 | - | API 不稳定 |
| 启动项目 | 宝塔界面 | - | API 不支持 |

---

## 📋 实际问题汇总

### 本次部署遇到并解决的问题

1. **HTTPS 强制重定向**
   - 现象：301 重定向但证书不可用
   - 解决：删除重定向或配置 SSL

2. **DNS 被代理劫持**
   - 现象：解析到 198.18.0.45
   - 原因：本地使用 Clash/V2Ray
   - 解决：关闭代理或修改 hosts

3. **宝塔和 PM2 冲突**
   - 现象：权限错误、状态不同步
   - 解决：只用宝塔界面管理

4. **端口冲突**
   - 现象：EADDRINUSE
   - 解决：检查端口分配表，清理冲突

5. **外部访问 Empty reply**
   - 现象：TCP 连接成功但无 HTTP 响应
   - 原因：腾讯云网络特性
   - 说明：服务器内部正常即为成功

---

## 🎊 Soul 项目最终状态

- ✅ **HTTP**: http://soul.quwanzhi.com
- ✅ **HTTPS**: https://soul.quwanzhi.com
- ✅ **最新代码**: 48个路由
- ✅ **SSL 证书**: 通配符证书
- ✅ **管理方式**: 宝塔界面
- ✅ **规范文档**: 已完善

---

## 📝 以后部署流程

1. ✅ 使用宝塔 API 查询和创建
2. ✅ 使用 SSH 上传、安装、构建
3. ✅ 使用宝塔 API 配置 Nginx
4. ✅ 使用 SSH 测试验证
5. ✅ 使用宝塔界面添加和启动项目

**避免使用独立 PM2，所有问题都已记录在规则中！**

---

**更新时间**: 2026-01-17 22:30  
**状态**: ✅ 完成
