diff --git a/DEPLOY_READY_v2.2.txt b/DEPLOY_READY_v2.2.txt new file mode 100644 index 0000000..f7924d3 --- /dev/null +++ b/DEPLOY_READY_v2.2.txt @@ -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 + +祝部署顺利！ +================================================================================ diff --git a/DEPLOY_v2.2_QUICK.md b/DEPLOY_v2.2_QUICK.md new file mode 100644 index 0000000..a67ac1b --- /dev/null +++ b/DEPLOY_v2.2_QUICK.md @@ -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 +**准备就绪**: ✅ +**可以开始部署**: ✅