docs: 添加v2.2.0快速部署指南和部署就绪报告

This commit is contained in:
Jowe
2025-12-30 22:35:32 +08:00
parent 2e9f634caa
commit f5f73025d7
2 changed files with 318 additions and 0 deletions

117
DEPLOY_READY_v2.2.txt Normal file
View 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
祝部署顺利!
================================================================================