# 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稳定版本 - 用户协议修复版

---

**文档结束**
