📁 重组文档目录结构

变更：
- 创建 docs/ 目录统一管理所有文档
- 移动所有 API 文档到 docs/ 目录
  - API_DOCS_INDEX.md
  - RESTFUL_API_DOCUMENTATION.md
  - API_SERVICE_README.md
  - API_CLIENT_EXAMPLES.md
  - API_SERVICE_GUIDE.md
  - BRANCH_README.md
  - openapi.yaml
  - IOPaint_API.postman_collection.json
  - UPGRADE_NOTES.md

- 更新所有文档间的引用路径
- 更新 README.md 中的文档链接
- 创建 docs/README.md 作为文档入口

优势：
✅ 清晰的目录结构
✅ 文档集中管理
✅ 易于查找和维护
✅ 符合项目规范

🔧 Generated with Claude Code

.github/API_BRANCH_MANIFEST.md

@@ -205,16 +205,16 @@ git commit -m "sync: 同步工具函数优化"
 ## 🚀 快速链接
 
 ### 文档
-- [📑 文档导航](../API_DOCS_INDEX.md)
+- [📑 文档导航](./API_DOCS_INDEX.md)
-- [🚀 快速开始](../API_SERVICE_README.md)
+- [🚀 快速开始](./API_SERVICE_README.md)
-- [📖 REST API 文档](../RESTFUL_API_DOCUMENTATION.md)
+- [📖 REST API 文档](./RESTFUL_API_DOCUMENTATION.md)
-- [💻 客户端示例](../API_CLIENT_EXAMPLES.md)
+- [💻 客户端示例](./API_CLIENT_EXAMPLES.md)
-- [🏗️ 部署方案](../API_SERVICE_GUIDE.md)
+- [🏗️ 部署方案](./API_SERVICE_GUIDE.md)
-- [🌿 分支说明](../BRANCH_README.md)
+- [🌿 分支说明](./BRANCH_README.md)
 
 ### 配置文件
-- [OpenAPI 规范](../openapi.yaml)
+- [OpenAPI 规范](./openapi.yaml)
-- [Postman Collection](../IOPaint_API.postman_collection.json)
+- [Postman Collection](./IOPaint_API.postman_collection.json)
 - [Docker Compose](../docker-compose.mvp.yml)
 - [Nginx 配置](../nginx/nginx.conf)
 

README.md

@@ -5,14 +5,14 @@
 >
 > This branch provides a **production-ready REST API service** for watermark removal and inpainting.
 >
-> - 🚀 **Quick Start**: See [API_SERVICE_README.md](./API_SERVICE_README.md)
+> - 🚀 **Quick Start**: See [API_SERVICE_README.md](./docs/API_SERVICE_README.md)
-> - 📖 **API Documentation**: See [RESTFUL_API_DOCUMENTATION.md](./RESTFUL_API_DOCUMENTATION.md)
+> - 📖 **API Documentation**: See [RESTFUL_API_DOCUMENTATION.md](./docs/RESTFUL_API_DOCUMENTATION.md)
-> - 🏗️ **Deployment Guide**: See [API_SERVICE_GUIDE.md](./API_SERVICE_GUIDE.md)
+> - 🏗️ **Deployment Guide**: See [API_SERVICE_GUIDE.md](./docs/API_SERVICE_GUIDE.md)
-> - 📑 **All Docs**: See [API_DOCS_INDEX.md](./API_DOCS_INDEX.md)
+> - 📑 **All Docs**: See [API_DOCS_INDEX.md](./docs/API_DOCS_INDEX.md)
 >
 > **Looking for the WebUI version?** Switch to [main branch](https://github.com/let5sne/IOPaint/tree/main)
 >
-> **Branch Comparison**: See [BRANCH_README.md](./BRANCH_README.md)
+> **Branch Comparison**: See [BRANCH_README.md](./docs/BRANCH_README.md)
 
 <p align="center">
   <a href="https://github.com/Sanster/IOPaint">

docs/README.md

@@ -0,0 +1,77 @@
+# IOPaint API Service Documentation
+
+Welcome to the IOPaint API Service documentation! This directory contains all the documentation for the API service branch.
+
+## 📑 Documentation Index
+
+### Quick Start
+- **[API Service README](./API_SERVICE_README.md)** - 🚀 Get started in 10 minutes
+- **[Documentation Index](./API_DOCS_INDEX.md)** - 📑 Complete navigation guide
+
+### API Reference
+- **[RESTful API Documentation](./RESTFUL_API_DOCUMENTATION.md)** - 📖 Complete API reference (OpenAI style)
+- **[OpenAPI Specification](./openapi.yaml)** - 🔧 OpenAPI 3.0.3 spec file
+- **[Postman Collection](./IOPaint_API.postman_collection.json)** - 🧪 API testing collection
+
+### Integration & Examples
+- **[Client Examples](./API_CLIENT_EXAMPLES.md)** - 💻 Multi-language code examples
+  - Python (Basic + Advanced)
+  - JavaScript/Node.js
+  - PHP
+  - Go
+  - Java
+  - cURL/Bash
+
+### Deployment & Architecture
+- **[Service Guide](./API_SERVICE_GUIDE.md)** - 🏗️ MVP to production deployment guide
+  - Architecture design (Docker → Kubernetes)
+  - Cost analysis & revenue models
+  - Implementation roadmap
+
+### Branch Information
+- **[Branch README](./BRANCH_README.md)** - 🌿 Branch comparison and switching guide
+- **[Upgrade Notes](./UPGRADE_NOTES.md)** - 📝 Package upgrade history
+
+## 🎯 Choose Your Path
+
+### I want to...
+
+**...get started quickly**
+→ Read [API_SERVICE_README.md](./API_SERVICE_README.md)
+
+**...integrate the API**
+→ Read [RESTFUL_API_DOCUMENTATION.md](./RESTFUL_API_DOCUMENTATION.md) + [API_CLIENT_EXAMPLES.md](./API_CLIENT_EXAMPLES.md)
+
+**...test the API**
+→ Import [IOPaint_API.postman_collection.json](./IOPaint_API.postman_collection.json) or visit http://localhost:8080/docs
+
+**...deploy for production**
+→ Read [API_SERVICE_GUIDE.md](./API_SERVICE_GUIDE.md)
+
+**...understand branch differences**
+→ Read [BRANCH_README.md](./BRANCH_README.md)
+
+## 📊 Documentation Stats
+
+| Type | Files | Pages | Languages |
+|------|-------|-------|-----------|
+| Core Docs | 6 | ~120 | - |
+| Code Examples | 1 | ~28 | 6 |
+| Spec Files | 2 | - | - |
+| **Total** | **9** | **~150** | **6** |
+
+## 🔗 External Links
+
+- **Repository**: https://github.com/let5sne/IOPaint
+- **API Branch**: https://github.com/let5sne/IOPaint/tree/feature/api-service
+- **Main Branch**: https://github.com/let5sne/IOPaint/tree/main
+
+## 📞 Support
+
+- **GitHub Issues**: https://github.com/let5sne/IOPaint/issues
+- **Documentation Feedback**: Open an issue with label `documentation`
+
+---
+
+**Last Updated**: 2025-11-28
+**Version**: 1.0.0