docs: 添加v2.2.0快速部署指南和部署就绪报告
This commit is contained in:
Jowe
117
DEPLOY_READY_v2.2.txt
Normal file
117
DEPLOY_READY_v2.2.txt
Normal file
@@ -0,0 +1,117 @@
|
|||||||
|
================================================================================
|
||||||
|
ZJPB v2.2.0 生产环境部署包 - 准备完成
|
||||||
|
================================================================================
|
||||||
|
|
||||||
|
版本信息
|
||||||
|
--------
|
||||||
|
版本号: v2.2.0
|
||||||
|
发布日期: 2025-12-30
|
||||||
|
补丁大小: 56KB
|
||||||
|
预计部署时间: 10分钟
|
||||||
|
|
||||||
|
核心功能
|
||||||
|
--------
|
||||||
|
✅ 博查Web Search API集成
|
||||||
|
✅ 智能新闻更新机制（每日首次访问触发）
|
||||||
|
✅ 每个网站获取3条一周内新闻
|
||||||
|
✅ 新闻来源展示（名称+图标）
|
||||||
|
✅ 自动去重防止重复
|
||||||
|
✅ News表扩展（source_name, source_icon）
|
||||||
|
✅ 界面优化（新闻左侧，推荐右侧）
|
||||||
|
|
||||||
|
需要上传到服务器的文件（仅2个）
|
||||||
|
--------------------------------
|
||||||
|
📦 v2.2.0.patch (56KB)
|
||||||
|
📦 git_patch_deploy_v2.2.sh (2.6KB)
|
||||||
|
|
||||||
|
上传路径
|
||||||
|
--------
|
||||||
|
/opt/1panel/apps/zjpb/
|
||||||
|
|
||||||
|
部署文档（本地参考）
|
||||||
|
--------------------
|
||||||
|
📄 DEPLOY_v2.2_QUICK.md - 快速部署指南（推荐先看这个）
|
||||||
|
📄 DEPLOY_v2.2.0.md - 完整部署文档
|
||||||
|
📄 DEPLOY_v2.2_CHECKLIST.md - 部署检查清单
|
||||||
|
|
||||||
|
快速部署命令（3步）
|
||||||
|
--------------------
|
||||||
|
|
||||||
|
第1步：上传文件
|
||||||
|
使用1Panel文件管理器或SCP命令上传以下文件到服务器：
|
||||||
|
v2.2.0.patch
|
||||||
|
git_patch_deploy_v2.2.sh
|
||||||
|
|
||||||
|
第2步：执行部署
|
||||||
|
SSH登录服务器或使用1Panel终端：
|
||||||
|
cd /opt/1panel/apps/zjpb
|
||||||
|
chmod +x git_patch_deploy_v2.2.sh
|
||||||
|
./git_patch_deploy_v2.2.sh
|
||||||
|
|
||||||
|
第3步：配置API Key
|
||||||
|
编辑.env文件：
|
||||||
|
nano /opt/1panel/apps/zjpb/.env
|
||||||
|
|
||||||
|
添加以下配置：
|
||||||
|
BOCHA_API_KEY=sk-76d0236a50d445ae92e75b634ed5313c
|
||||||
|
BOCHA_BASE_URL=https://api.bocha.cn
|
||||||
|
|
||||||
|
重启应用：
|
||||||
|
./manage.sh restart
|
||||||
|
|
||||||
|
部署验证
|
||||||
|
--------
|
||||||
|
✓ 访问任意网站详情页，检查"相关新闻"模块
|
||||||
|
✓ 登录后台 /admin/newsadmin/ 查看新闻管理
|
||||||
|
✓ 运行测试脚本：python test_news_feature.py
|
||||||
|
|
||||||
|
Git提交历史（v2.2.0）
|
||||||
|
----------------------
|
||||||
|
2e9f634 docs: 添加v2.2.0部署文档和脚本
|
||||||
|
495248b feat: v2.2.0 智能新闻更新和布局优化
|
||||||
|
d7d21e1 release: v2.2.0 - 博查新闻搜索功能
|
||||||
|
|
||||||
|
技术支持
|
||||||
|
--------
|
||||||
|
如遇问题，请查看：
|
||||||
|
1. 应用日志: ./manage.sh logs
|
||||||
|
2. 完整文档: DEPLOY_v2.2.0.md
|
||||||
|
3. 测试脚本: python test_news_feature.py
|
||||||
|
|
||||||
|
回滚方案
|
||||||
|
--------
|
||||||
|
如需回滚到v2.1.0：
|
||||||
|
cd /opt/1panel/apps/zjpb
|
||||||
|
./manage.sh stop
|
||||||
|
git reset --hard HEAD~3
|
||||||
|
./manage.sh start
|
||||||
|
|
||||||
|
重要提示
|
||||||
|
--------
|
||||||
|
⚠️ 部署前请先备份生产数据库
|
||||||
|
⚠️ 确认服务器可以访问 api.bocha.cn
|
||||||
|
⚠️ 确认BOCHA_API_KEY已配置且有余额
|
||||||
|
|
||||||
|
成本估算
|
||||||
|
--------
|
||||||
|
假设每天100个网站被访问：
|
||||||
|
- 每天成本约 1元
|
||||||
|
- 每月成本约 30元
|
||||||
|
|
||||||
|
================================================================================
|
||||||
|
✅ 所有部署文件已准备就绪，可以开始部署！
|
||||||
|
================================================================================
|
||||||
|
|
||||||
|
下一步操作：
|
||||||
|
1. 使用1Panel文件管理器或SCP上传2个文件到服务器
|
||||||
|
2. SSH登录服务器执行部署脚本
|
||||||
|
3. 配置.env中的BOCHA_API_KEY
|
||||||
|
4. 重启应用并验证功能
|
||||||
|
|
||||||
|
部署支持文档位置：
|
||||||
|
D:\315mac\Code\zjpb\DEPLOY_v2.2_QUICK.md
|
||||||
|
D:\315mac\Code\zjpb\DEPLOY_v2.2.0.md
|
||||||
|
D:\315mac\Code\zjpb\DEPLOY_v2.2_CHECKLIST.md
|
||||||
|
|
||||||
|
祝部署顺利！
|
||||||
|
================================================================================
|
||||||
201
DEPLOY_v2.2_QUICK.md
Normal file
201
DEPLOY_v2.2_QUICK.md
Normal file
@@ -0,0 +1,201 @@
|
|||||||
|
# ZJPB v2.2.0 部署操作指南
|
||||||
|
|
||||||
|
## 版本信息
|
||||||
|
- **版本**: v2.2.0
|
||||||
|
- **发布日期**: 2025-12-30
|
||||||
|
- **补丁大小**: 56KB
|
||||||
|
- **部署时间**: 约10分钟
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 核心功能
|
||||||
|
|
||||||
|
### 博查新闻搜索集成
|
||||||
|
✅ 自动获取网站相关新闻（博查Web Search API）
|
||||||
|
✅ 智能更新：每日首次访问触发更新
|
||||||
|
✅ 每个网站获取3条一周内新闻
|
||||||
|
✅ 新闻来源展示（名称+图标）
|
||||||
|
✅ 自动去重防止重复
|
||||||
|
|
||||||
|
### 数据库扩展
|
||||||
|
✅ News表新增 `source_name` 字段
|
||||||
|
✅ News表新增 `source_icon` 字段
|
||||||
|
|
||||||
|
### 界面优化
|
||||||
|
✅ 新闻模块在左侧主栏
|
||||||
|
✅ 相似推荐在右侧边栏
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 快速部署（3步）
|
||||||
|
|
||||||
|
### 第1步：上传文件到服务器
|
||||||
|
上传以下2个文件到 `/opt/1panel/apps/zjpb/`：
|
||||||
|
```
|
||||||
|
v2.2.0.patch
|
||||||
|
git_patch_deploy_v2.2.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
### 第2步：执行部署脚本
|
||||||
|
```bash
|
||||||
|
cd /opt/1panel/apps/zjpb
|
||||||
|
chmod +x git_patch_deploy_v2.2.sh
|
||||||
|
./git_patch_deploy_v2.2.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
### 第3步：配置API Key
|
||||||
|
编辑 `.env` 文件，添加：
|
||||||
|
```bash
|
||||||
|
BOCHA_API_KEY=sk-76d0236a50d445ae92e75b634ed5313c
|
||||||
|
BOCHA_BASE_URL=https://api.bocha.cn
|
||||||
|
```
|
||||||
|
|
||||||
|
然后重启：
|
||||||
|
```bash
|
||||||
|
./manage.sh restart
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 验证部署
|
||||||
|
|
||||||
|
### ✓ 前台测试
|
||||||
|
1. 访问任意网站详情页
|
||||||
|
2. 检查"相关新闻"模块是否显示
|
||||||
|
3. 新闻应该显示来源网站名称和图标
|
||||||
|
4. 点击新闻标题可跳转到原文
|
||||||
|
|
||||||
|
### ✓ 后台测试
|
||||||
|
1. 登录 `/admin/login`
|
||||||
|
2. 进入"新闻管理" `/admin/newsadmin/`
|
||||||
|
3. 查看新闻列表是否正常显示
|
||||||
|
|
||||||
|
### ✓ 功能测试
|
||||||
|
```bash
|
||||||
|
cd /opt/1panel/apps/zjpb
|
||||||
|
source venv/bin/activate
|
||||||
|
python test_news_feature.py
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 关键文件
|
||||||
|
|
||||||
|
### 本地准备好的文件
|
||||||
|
```
|
||||||
|
D:\315mac\Code\zjpb\
|
||||||
|
├── v2.2.0.patch (56KB) 补丁文件
|
||||||
|
├── git_patch_deploy_v2.2.sh 部署脚本
|
||||||
|
├── DEPLOY_v2.2.0.md 完整部署文档
|
||||||
|
├── DEPLOY_v2.2_CHECKLIST.md 检查清单
|
||||||
|
├── migrate_news_fields.py 数据库迁移脚本
|
||||||
|
├── test_news_feature.py 测试脚本
|
||||||
|
└── fetch_news_cron.py 定期任务脚本
|
||||||
|
```
|
||||||
|
|
||||||
|
### 服务器需要的文件（只需2个）
|
||||||
|
```
|
||||||
|
v2.2.0.patch
|
||||||
|
git_patch_deploy_v2.2.sh
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Git提交历史
|
||||||
|
|
||||||
|
v2.2.0包含以下3个提交：
|
||||||
|
```
|
||||||
|
2e9f634 docs: 添加v2.2.0部署文档和脚本
|
||||||
|
495248b feat: v2.2.0 智能新闻更新和布局优化
|
||||||
|
d7d21e1 release: v2.2.0 - 博查新闻搜索功能
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 部署脚本自动完成的操作
|
||||||
|
|
||||||
|
```
|
||||||
|
1. 停止应用
|
||||||
|
2. 检查Git状态
|
||||||
|
3. 备份未提交的修改
|
||||||
|
4. 应用v2.2.0补丁
|
||||||
|
- utils/news_searcher.py (新增)
|
||||||
|
- app.py (更新)
|
||||||
|
- models.py (更新)
|
||||||
|
- config.py (更新)
|
||||||
|
- templates/detail_new.html (更新)
|
||||||
|
- migrate_news_fields.py (新增)
|
||||||
|
- test_news_feature.py (新增)
|
||||||
|
- fetch_news_cron.py (新增)
|
||||||
|
- NEWS_FEATURE_v2.2.md (新增)
|
||||||
|
5. 提交到Git
|
||||||
|
6. 激活虚拟环境
|
||||||
|
7. 安装依赖
|
||||||
|
8. 运行数据库迁移
|
||||||
|
9. 重启应用
|
||||||
|
10. 检查状态
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 回滚方案（如需要）
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd /opt/1panel/apps/zjpb
|
||||||
|
./manage.sh stop
|
||||||
|
git reset --hard HEAD~3 # 回滚到v2.1.0
|
||||||
|
./manage.sh start
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 常见问题
|
||||||
|
|
||||||
|
### Q1: 新闻不显示？
|
||||||
|
**A**: 检查 `.env` 中 `BOCHA_API_KEY` 是否配置正确
|
||||||
|
|
||||||
|
### Q2: 补丁应用失败？
|
||||||
|
**A**: 备份本地修改后重试
|
||||||
|
```bash
|
||||||
|
git stash
|
||||||
|
git apply v2.2.0.patch
|
||||||
|
```
|
||||||
|
|
||||||
|
### Q3: 数据库迁移失败？
|
||||||
|
**A**: 手动运行迁移脚本
|
||||||
|
```bash
|
||||||
|
python migrate_news_fields.py
|
||||||
|
```
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 成本估算
|
||||||
|
|
||||||
|
假设每天100个网站被访问：
|
||||||
|
- 每次API调用约 0.01元
|
||||||
|
- 每天成本约 1元
|
||||||
|
- 每月成本约 30元
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 下一步
|
||||||
|
|
||||||
|
部署完成后：
|
||||||
|
1. 访问网站测试功能
|
||||||
|
2. 查看应用日志确认无错误
|
||||||
|
3. 监控API调用情况
|
||||||
|
4. 根据需要调整新闻获取数量和时间范围
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 技术支持文档
|
||||||
|
|
||||||
|
- **完整文档**: `DEPLOY_v2.2.0.md`
|
||||||
|
- **检查清单**: `DEPLOY_v2.2_CHECKLIST.md`
|
||||||
|
- **功能文档**: `NEWS_FEATURE_v2.2.md`
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
**创建时间**: 2025-12-30 22:32
|
||||||
|
**准备就绪**: ✅
|
||||||
|
**可以开始部署**: ✅
|
||||||
Reference in New Issue
Block a user