# ZJPB v2.3.0 快速部署指南

> 3步完成部署，5分钟上线

---

## 📦 版本信息

- **版本**: v2.3.0
- **日期**: 2025-12-31
- **核心**: 新闻准确性优化

---

## ⚡ 快速部署（3步）

### 第1步：拉取代码

```bash
cd /opt/1panel/apps/zjpb
./manage.sh stop
git pull origin master
```

### 第2步：数据库迁移

```bash
source venv/bin/activate
python migrate_news_keywords.py
```

### 第3步：重启应用

```bash
./manage.sh restart
./manage.sh status
```

✅ **部署完成！**

---

## ✅ 快速验证

### 1. 后台验证（1分钟）

```
1. 访问：http://your-domain.com/admin/login
2. 进入：网站管理 → 编辑任意网站
3. 检查：是否有"新闻关键词"字段
```

### 2. 前台验证（1分钟）

```
1. 访问：http://your-domain.com/site/xxxxxxxx
2. 滚动：到"相关新闻"模块
3. 检查：是否有"获取最新资讯"按钮
```

---

## 🎯 核心功能

### 1. 新闻关键词设置

**后台操作**：
```
网站管理 → 编辑 → 新闻关键词 → 输入"ChatGPT" → 保存
```

**效果**：
- 搜索更精准
- 避免名称混淆
- 提高相关性

### 2. 前台手动刷新

**用户操作**：
```
详情页 → 相关新闻 → 点击"获取最新资讯" → 等待刷新
```

**效果**：
- 获取最新5条新闻
- 自动去重
- 1-2秒完成

---

## 🔧 关键词设置技巧

### 推荐设置

| 网站名称 | 推荐关键词 | 说明 |
|---------|-----------|------|
| ChatGPT | `ChatGPT` | 官方品牌名 |
| GitHub Copilot | `GitHub Copilot` | 完整产品名 |
| Claude | `Claude AI` | 添加AI避免混淆 |
| 文心一言 | `文心一言` | 中文全称 |

### 避免设置

❌ `AI`、`工具`、`助手` - 过于宽泛
❌ `聊天机器人` - 不够精准
❌ `GPT` - 会匹配所有GPT相关

---

## 🐛 问题速查

### 问题1：后台没有新字段

```bash
# 检查代码
grep "news_keywords" app.py

# 清缓存重启
./manage.sh restart
```

### 问题2：刷新按钮不显示

```bash
# 检查模板
grep "refresh-news-btn" templates/detail_new.html

# 强制刷新浏览器（Ctrl + F5）
```

### 问题3：刷新失败

```bash
# 检查API配置
grep "BOCHA_API_KEY" .env

# 如未配置，添加：
echo "BOCHA_API_KEY=sk-your-key" >> .env
./manage.sh restart
```

---

## 📊 变更文件

| 文件 | 说明 |
|------|------|
| `models.py` | 添加字段 |
| `migrate_news_keywords.py` | 迁移脚本 |
| `app.py` | 后台+API |
| `utils/news_searcher.py` | 搜索逻辑 |
| `templates/detail_new.html` | 刷新按钮 |

---

## 🔄 回滚（如需要）

```bash
cd /opt/1panel/apps/zjpb
./manage.sh stop
git reset --hard HEAD~1  # 回到上一版本
./manage.sh start
```

---

## 📚 完整文档

详细信息请查看：`DEPLOY_v2.3.0.md`

---

**快速指南版本**: v1.0
**部署时间**: 约5分钟
**难度**: ⭐ 简单
