docs: 添加v1.2.4问题修复说明文档

docs/v1.2.4问题修复说明.md

@@ -0,0 +1,145 @@
+# 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稳定版本 - 用户协议修复版
+
+---
+
+**文档结束**