# 图片 URL 优化更新文档

## 概述
本次更新优化了图片访问方式，从原来通过后端 API 代理访问改为直接通过 Nginx 静态资源访问，提高了图片加载效率。

## 修改内容

### 1. 配置文件
- 使用配置项 `file.upload.path` 确定本地保存路径
- 使用配置项 `file.upload.url-prefix` 确定 Nginx 访问前缀（默认为 `/files/`）

### 2. ImageService 接口
- 新增 `getNginxUrlByImageId(String imageId)` 方法，用于根据图片 ID 获取 Nginx 格式的 URL

### 3. ImageServiceImpl 实现
- 使用配置的 `file.upload.path` + `/img` 作为图片存储目录
- 保存图片时返回相对路径（如 `img/xxx.jpg`）而非绝对路径
- 修改本地读取图片逻辑，支持相对路径
- 新增 `getNginxUrlByImageId` 方法
- 新增 `extractFilenameFromPath` 辅助方法

### 4. AiChatServiceImpl 修改
- 在保存图片后立即更新 imageMetadata 中的 url 为 Nginx 格式
- 在 SSE 的 finish 事件中，对无 metadata 的图片也尝试生成 Nginx 格式 URL

### 5. ChatServiceImpl 修改
- 查看历史记录时，将图片 URL 从 `/api/image/xxx/data` 转换为 Nginx 格式（`/files/img/xxx.jpg`）

## 使用示例

### Nginx 配置示例
```nginx
server {
    listen 80;
    
    location /files/ {
        alias /path/to/upload/;
        expires 7d;
        add_header Cache-Control "public, immutable";
    }
    
    location / {
        proxy_pass http://localhost:8080;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}
```

### 配置文件 (application-prod.yml)
```yaml
file:
  upload:
    path: /opt/deploy/uploads/
    url-prefix: /files/
```

## 部署说明
1. 确保 Nginx 配置正确，`/files/` 路径指向实际的上传目录
2. 确保应用配置文件中的 `file.upload.path` 和 `file.upload.url-prefix` 设置正确
3. 重新构建并部署应用

## 兼容性
- 保留了向后兼容，如果 Nginx 格式 URL 无法获取，会回退为原 `/api/image/xxx/data` 格式
- 旧数据仍然可以正常访问

## 图片 URL 格式对比
| 旧格式 | 新格式 |
|--------|--------|
| /api/image/xxx/data | /files/img/xxx.jpg |