From 289a09b3761516efd3310bbe5ff36cc0787ac72d Mon Sep 17 00:00:00 2001
From: Jowe <123822645+Selei1983@users.noreply.github.com>
Date: Wed, 31 Dec 2025 11:03:04 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=B7=BB=E5=8A=A0v2.3.0=E9=83=A8?=
 =?UTF-8?q?=E7=BD=B2=E6=B8=85=E5=8D=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 DEPLOY_CHECKLIST_v2.3.md | 255 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 255 insertions(+)
 create mode 100644 DEPLOY_CHECKLIST_v2.3.md

diff --git a/DEPLOY_CHECKLIST_v2.3.md b/DEPLOY_CHECKLIST_v2.3.md
new file mode 100644
index 0000000..ec0eec3
--- /dev/null
+++ b/DEPLOY_CHECKLIST_v2.3.md
@@ -0,0 +1,255 @@
+# ZJPB v2.3.0 部署清单
+
+**当前状态**: ✅ 代码已提交到本地Git，等待推送
+
+---
+
+## 📋 本地准备完成
+
+✅ **代码修改**：
+- models.py - Site模型添加news_keywords字段
+- app.py - 后台表单、API路由、搜索逻辑
+- utils/news_searcher.py - 严格匹配搜索
+- templates/detail_new.html - 刷新按钮和UI
+
+✅ **新增文件**：
+- migrate_news_keywords.py - 数据库迁移脚本
+- DEPLOY_v2.3.0.md - 完整部署文档
+- DEPLOY_v2.3_QUICK.md - 快速部署指南
+
+✅ **本地测试**：
+- ✅ 数据库迁移成功（4个网站已设置默认关键词）
+- ✅ Flask服务运行正常
+- ✅ 后台管理可访问
+
+✅ **Git提交**：
+- Commit: `fdde699` - feat: v2.3.0 - 新闻获取准确性优化
+- Tag: `v2.3.0` - Release v2.3.0: 新闻获取准确性优化
+
+---
+
+## 🚀 下一步操作（需要你执行）
+
+### 第1步：推送代码到远程仓库
+
+```bash
+# 在本地项目目录执行
+cd D:\315mac\Code\zjpb
+
+# 推送代码（需要输入Git认证）
+git push origin master
+
+# 推送标签
+git push origin v2.3.0
+```
+
+### 第2步：SSH登录服务器部署
+
+```bash
+# SSH登录服务器
+ssh root@your-server
+
+# 进入项目目录
+cd /opt/1panel/apps/zjpb
+
+# 停止应用
+./manage.sh stop
+
+# 拉取最新代码
+git pull origin master
+
+# 查看当前版本（应该看到fdde699）
+git log --oneline -3
+
+# 激活虚拟环境
+source venv/bin/activate
+
+# 运行数据库迁移
+python migrate_news_keywords.py
+
+# 重启应用
+./manage.sh restart
+
+# 检查状态
+./manage.sh status
+
+# 查看日志
+./manage.sh logs
+```
+
+### 第3步：验证部署
+
+#### 后台验证
+```
+1. 访问：http://zjpb.net/admin/login
+2. 进入：网站管理
+3. 编辑任意网站
+4. 检查：是否有"新闻关键词"字段
+```
+
+#### 前台验证
+```
+1. 访问任意网站详情页
+2. 滚动到"相关新闻"模块
+3. 检查：是否有"获取最新资讯"按钮
+4. 点击测试刷新功能
+```
+
+---
+
+## 📊 部署变更摘要
+
+### 数据库变更
+
+```sql
+ALTER TABLE sites
+ADD COLUMN news_keywords VARCHAR(200)
+COMMENT '新闻获取关键词（用于精准匹配相关新闻）'
+AFTER features;
+```
+
+**影响**：
+- 新增1个字段
+- 约200字节/网站
+- 无性能影响
+
+### 代码变更
+
+| 文件 | 行数变化 | 说明 |
+|------|---------|------|
+| models.py | +2 | 添加news_keywords字段定义 |
+| app.py | +81 | 后台配置+新API路由 |
+| utils/news_searcher.py | +16 | 支持关键词参数 |
+| templates/detail_new.html | +125 | 刷新按钮+CSS+JS |
+| migrate_news_keywords.py | +114 | 新建迁移脚本 |
+
+**总计**：7个文件，+1009行，-8行
+
+### API变更
+
+**新增**：
+- `POST /api/refresh-site-news/<site_code>` - 前台刷新新闻
+
+**修改**：
+- `search_site_news()` - 新增news_keywords参数
+
+---
+
+## ⚠️ 重要提示
+
+### 1. 备份数据库
+
+部署前务必备份：
+```bash
+mysqldump -h localhost -u ai_nav -p ai_nav > backup_v2.3_$(date +%Y%m%d).sql
+```
+
+### 2. BOCHA_API_KEY配置
+
+确认服务器`.env`文件包含：
+```bash
+BOCHA_API_KEY=sk-76d0236a50d445ae92e75b634ed5313c
+BOCHA_BASE_URL=https://api.bocha.cn
+```
+
+### 3. 迁移脚本幂等性
+
+迁移脚本可以重复执行，会自动跳过已存在的字段。
+
+---
+
+## 🔍 常见问题
+
+### Q1: Git拉取后没有新文件？
+
+```bash
+# 检查当前commit
+git log --oneline -1
+
+# 应该显示：fdde699 feat: v2.3.0 - 新闻获取准确性优化
+
+# 如果不是，强制拉取
+git fetch origin
+git reset --hard origin/master
+```
+
+### Q2: 迁移脚本找不到？
+
+```bash
+# 确认文件存在
+ls -la migrate_news_keywords.py
+
+# 如果不存在，检查git状态
+git status
+
+# 拉取特定文件
+git checkout origin/master -- migrate_news_keywords.py
+```
+
+### Q3: 后台表单没有新字段？
+
+```bash
+# 重启应用清除缓存
+./manage.sh restart
+
+# 检查代码是否更新
+grep -n "news_keywords" app.py
+
+# 应该看到：1007:            'news_keywords': '新闻关键词',
+```
+
+---
+
+## 📈 性能监控
+
+部署后建议监控：
+
+1. **应用启动时间**：应在2-3秒内
+2. **数据库查询性能**：无明显变化
+3. **新闻刷新响应时间**：1-3秒（取决于博查API）
+4. **错误日志**：关注news相关错误
+
+```bash
+# 监控日志
+tail -f logs/gunicorn_error.log | grep -i "news\|error"
+```
+
+---
+
+## ✅ 部署完成检查清单
+
+**代码部署**：
+- [ ] Git push成功
+- [ ] 服务器Git pull成功
+- [ ] 当前commit是fdde699
+
+**数据库迁移**：
+- [ ] migrate_news_keywords.py执行成功
+- [ ] sites表有news_keywords字段
+- [ ] 现有网站已设置默认关键词
+
+**应用运行**：
+- [ ] manage.sh status显示运行中
+- [ ] 无错误日志
+- [ ] 前后台访问正常
+
+**功能验证**：
+- [ ] 后台可编辑新闻关键词
+- [ ] 前台显示刷新按钮
+- [ ] 刷新功能正常工作
+
+---
+
+## 📞 技术支持
+
+如遇问题：
+
+1. **查看日志**：`./manage.sh logs`
+2. **检查文档**：`DEPLOY_v2.3.0.md`（完整版）
+3. **快速参考**：`DEPLOY_v2.3_QUICK.md`（精简版）
+
+---
+
+**清单版本**: v1.0
+**创建时间**: 2025-12-31
+**预计部署时间**: 5-10分钟