# 文件上传服务文档

## 📖 文档导航

### 核心文档
- [版本对比](COMPARISON.md) - 各版本功能特性对比
- [更新日志](CHANGELOG.md) - 历史版本变更记录

### 版本文档
- **[1.0.4-SNAPSHOT](versions/v1.0.4/api.md)** (开发中)
    - [API接口](versions/v1.0.4/api.md)
    - [配置说明](versions/v1.0.4/config.md)
    - [图片压缩](versions/v1.0.4/image-compression.md)
- **[1.0.3-SNAPSHOT](versions/v1.0.3/api.md)** (稳定版)
    - [API接口](versions/v1.0.3/api.md)
    - [配置说明](versions/v1.0.3/config.md)
    - [迁移指南](versions/v1.0.3/migration.md)

### 未来版本
- [1.0.5规划](versions/upcoming/v1.0.5.md)

### 共享文档
[//]: # (- [通用API规范](shared/api-common.md))
- [错误代码](shared/error-codes.md)

---

## 🚀 快速开始

### 使用1.0.3版本（稳定）

# 查看配置
查看 [1.0.3配置说明](versions/v1.0.3/config.md)

# API文档
查看 [1.0.3 API接口](versions/v1.0.3/api.md)

# 新功能：图片多版本压缩
查看 [图片压缩功能](versions/v1.0.4/image-compression.md)
查看 [视频压缩功能](versions/v1.0.4/video-compression.md)

# 完整文档
查看 [1.0.4版本目录](versions/v1.0.4/api.md)


## 📊 版本概览

| 版本 | 状态 | 主要特性 | 文档                                |
|------|------|----------|-----------------------------------|
| 1.0.4 | 开发中 | 图片多版本压缩 | [详情](versions/v1.0.4/api.md)      |
| 1.0.3 | 稳定版 | 基础文件上传 | [详情](versions/v1.0.3/api.md)      |
| 1.0.5 | 规划中 | 视频处理、CDN集成 | [规划](versions/upcoming/v1.0.5.md) |

详细对比请查看：[版本对比表](COMPARISON.md)

---

## 🔗 相关链接
[//]: # (- [API在线文档](https://api.your-domain.com/docs))
- [问题反馈](https://thoughts.aliyun.com/workspaces/63bb72bed164b5001a3b5e9c/docs/692fcf1374e4030001e04b6a)

---

## 📝 维护说明

### 文档更新流程
1. 修改对应版本目录下的文档
2. 更新 [COMPARISON.md](COMPARISON.md) 对比表
3. 添加变更记录到 [CHANGELOG.md](CHANGELOG.md)
4. 更新本README中的链接和状态

### 添加新版本
1. 创建新版本目录 `versions/v1.0.x/`
2. 复制模板文档
3. 更新所有相关链接
4. 通知团队成员

---
*最后更新: 2025-12-04*