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稳定版本 - 用户协议修复版
|
||
|
||
---
|
||
|
||
**文档结束**
|