146 lines
2.9 KiB
Markdown
146 lines
2.9 KiB
Markdown
|
# v1.2.4 版本问题修复说明
|
|||
|
|
|
|||
|
|
**版本**: v1.2.4-stable
|
|||
|
|
**发布日期**: 2026-03-20
|
|||
|
|
**维护人**: 甲辰生产
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 问题列表及解决方案
|
|||
|
|
|
|||
|
|
### 问题1: OCR识别后保存藏品失败
|
|||
|
|
|
|||
|
|
**现象**: OCR识别成功后，点击保存藏品返回404错误
|
|||
|
|
|
|||
|
|
**原因**:
|
|||
|
|
- OCR代码只尝试小写扩展名(jpg/jpeg/png/gif)
|
|||
|
|
- 用户上传的图片文件扩展名是大写的.JPG
|
|||
|
|
|
|||
|
|
**解决方案**:
|
|||
|
|
修改 `backend/app/routers/ocr.py` 第299行：
|
|||
|
|
```python
|
|||
|
|
# 修改前
|
|||
|
|
temp_extensions = [jpg, jpeg, png, gif]
|
|||
|
|
|
|||
|
|
# 修改后
|
|||
|
|
temp_extensions = [jpg, jpeg, png, gif, JPG, JPEG, PNG, GIF]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 问题2: 用户协议页面乱码
|
|||
|
|
|
|||
|
|
**现象**: 点击用户协议显示乱码，只有一个标题
|
|||
|
|
|
|||
|
|
**原因**:
|
|||
|
|
- 协议文件只有一个空的HTML骨架
|
|||
|
|
- 没有实际内容
|
|||
|
|
|
|||
|
|
**解决方案**:
|
|||
|
|
创建完整的用户协议HTML文件 `/var/www/frontend/user_agreement.html`，包含完整的中文协议内容（服务条款、用户责任、数据安全、免责声明等）
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 问题3: 用户协议页面无返回按钮
|
|||
|
|
|
|||
|
|
**现象**: 打开用户协议后无法返回
|
|||
|
|
|
|||
|
|
**解决方案**:
|
|||
|
|
在用户协议页面添加返回按钮：
|
|||
|
|
```html
|
|||
|
|
<button class="back-btn" onclick="window.close()">← 返回</button>
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 问题4: 首页Logo显示不出来
|
|||
|
|
|
|||
|
|
**现象**: 登录页Logo正常，登录后首页Logo显示404
|
|||
|
|
|
|||
|
|
**原因**:
|
|||
|
|
- 部署时static目录没有复制到正确位置
|
|||
|
|
- 浏览器缓存了旧的JS文件
|
|||
|
|
|
|||
|
|
**解决方案**:
|
|||
|
|
1. 确保部署时复制static目录：
|
|||
|
|
```bash
|
|||
|
|
cp -r /root/jiachenlong/static /var/www/frontend/
|
|||
|
|
cp -r /root/jiachenlong/static /var/www/mobile/
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
2. 首页Logo添加版本号防止缓存：
|
|||
|
|
```jsx
|
|||
|
|
// 修改Home.jsx
|
|||
|
|
<img src="/static/images/jiachenlong-logo.png?v=1.2.4" ... />
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
### 问题5: 版本号显示重复
|
|||
|
|
|
|||
|
|
**现象**: 标题显示"vv1.2.4"（v重复）
|
|||
|
|
|
|||
|
|
**原因**:
|
|||
|
|
- VERSION文件中版本号为"v1.2.4"（带v前缀）
|
|||
|
|
- vite.config.js中又自动添加了"v"前缀
|
|||
|
|
|
|||
|
|
**解决方案**:
|
|||
|
|
修改VERSION文件，去掉v前缀：
|
|||
|
|
```
|
|||
|
|
# 修改前
|
|||
|
|
VERSION=v1.2.4
|
|||
|
|
|
|||
|
|
# 修改后
|
|||
|
|
VERSION=1.2.4
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 部署检查清单
|
|||
|
|
|
|||
|
|
### 前端部署
|
|||
|
|
```bash
|
|||
|
|
# 1. 确保VERSION文件格式正确（不带v前缀）
|
|||
|
|
cat config/VERSION
|
|||
|
|
# 输出: VERSION=1.2.4
|
|||
|
|
|
|||
|
|
# 2. 构建
|
|||
|
|
cd frontend
|
|||
|
|
npm run build
|
|||
|
|
|
|||
|
|
# 3. 部署（两个目录都要部署）
|
|||
|
|
rm -rf /var/www/mobile/*
|
|||
|
|
rm -rf /var/www/frontend/*
|
|||
|
|
cp -r dist/* /var/www/mobile/
|
|||
|
|
cp -r dist/* /var/www/frontend/
|
|||
|
|
cp -r ../static /var/www/mobile/
|
|||
|
|
cp -r ../static /var/www/frontend/
|
|||
|
|
|
|||
|
|
# 4. 重载Nginx
|
|||
|
|
nginx -s reload
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 后端部署
|
|||
|
|
```bash
|
|||
|
|
# 1. 拉取最新代码
|
|||
|
|
cd /root/jiachenlong
|
|||
|
|
git pull
|
|||
|
|
|
|||
|
|
# 2. 重启后端服务
|
|||
|
|
pkill -f uvicorn
|
|||
|
|
cd backend
|
|||
|
|
python3 -m uvicorn app.main:app --host 0.0.0.0 --port 3000 &
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## 标签信息
|
|||
|
|
|
|||
|
|
- **当前稳定版本**: v1.2.4-stable
|
|||
|
|
- **Gitea标签地址**: http://47.253.189.47:3000/coolbot/jiachenlong/tags
|
|||
|
|
- **发布说明**: v1.2.4稳定版本 - 用户协议修复版
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**文档结束**
|