mirror of
https://github.com/keven1024/015.git
synced 2026-05-26 07:08:02 +00:00
docs(README): update screenshots section for clarity, enhance quick start instructions, and refine project structure details
This commit is contained in:
54
README-zh.md
54
README-zh.md
@@ -41,16 +41,16 @@
|
|||||||
|
|
||||||
## 📸 截图预览
|
## 📸 截图预览
|
||||||
|
|
||||||
| 选择文件上传页面 | 输入文本上传页面 |
|
| 选择文件上传页面 | 输入文本上传页面 |
|
||||||
|---------------------------------------|-----------------------------------------------|
|
| ------------------------- | ------------------------- |
|
||||||
|  |  |
|
|  |  |
|
||||||
|
|
||||||
| 多选文件上传 | 文件上传进度热力图 |
|
| 多选文件上传 | 文件上传进度热力图 |
|
||||||
|------------------------------------------------|---------------------------------------------------|
|
| ------------------------- | ------------------------- |
|
||||||
|  |  |
|
|  |  |
|
||||||
|
|
||||||
| 文件上传进度条 | 文件上传成功页面 |
|
| 文件上传进度条 | 文件上传成功页面 |
|
||||||
|------------------------------------------------|-------------------------------------------------|
|
| ------------------------- | ------------------------- |
|
||||||
|  |  |
|
|  |  |
|
||||||
|
|
||||||
## 🚀 快速开始
|
## 🚀 快速开始
|
||||||
@@ -61,31 +61,15 @@
|
|||||||
- config.example.yaml
|
- config.example.yaml
|
||||||
- docker-compose.yml
|
- docker-compose.yml
|
||||||
|
|
||||||
2. 把config.example.yaml配置完成后改为config.yaml
|
2. 把 config.example.yaml 配置完成后改为 config.yaml
|
||||||
|
|
||||||
|
|
||||||
3. 启动
|
|
||||||
```bash
|
|
||||||
docker compose up -d
|
|
||||||
```
|
|
||||||
|
|
||||||
|
|
||||||
## 🚀 快速开始
|
|
||||||
|
|
||||||
### Docker
|
|
||||||
|
|
||||||
1. 下载文件
|
|
||||||
- config.example.yaml
|
|
||||||
- docker-compose.yml
|
|
||||||
|
|
||||||
2. 把config.example.yaml配置完成后改为config.yaml
|
|
||||||
|
|
||||||
|
|
||||||
3. 启动
|
3. 启动
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
docker compose up -d
|
docker compose up -d
|
||||||
```
|
```
|
||||||
|
|
||||||
|
4. 访问 `http://localhost:8080`
|
||||||
|
|
||||||
## 🏗️ 技术架构
|
## 🏗️ 技术架构
|
||||||
|
|
||||||
@@ -130,15 +114,15 @@ docker compose up -d
|
|||||||
015/
|
015/
|
||||||
├── front/ # 前端应用 (Vue 3 + Nuxt 3)
|
├── front/ # 前端应用 (Vue 3 + Nuxt 3)
|
||||||
│ ├── components/ # Vue 组件
|
│ ├── components/ # Vue 组件
|
||||||
│ │ ├── pages/ # 页面路由
|
│ ├── pages/ # 页面路由
|
||||||
│ │ ├── composables/ # 组合式函数
|
│ ├── composables/ # 组合式函数
|
||||||
│ │ ├── i18n/ # 国际化文件
|
│ ├── i18n/ # 国际化文件
|
||||||
│ │ └── assets/ # 静态资源
|
│ ├── assets/ # 静态资源
|
||||||
│ └── middleware/ # 中间件
|
│ ├── plugins/ # Nuxt 插件
|
||||||
|
│ └── server/ # 服务端路由
|
||||||
├── backend/ # 后端服务 (Go + Echo)
|
├── backend/ # 后端服务 (Go + Echo)
|
||||||
│ ├── internal/ # 内部包
|
│ ├── internal/ # 内部包
|
||||||
│ │ ├── controllers/ # 控制器
|
│ │ ├── controllers/ # 控制器
|
||||||
│ │ ├── models/ # 数据模型
|
|
||||||
│ │ ├── services/ # 业务逻辑
|
│ │ ├── services/ # 业务逻辑
|
||||||
│ │ └── utils/ # 工具函数
|
│ │ └── utils/ # 工具函数
|
||||||
│ └── middleware/ # 中间件
|
│ └── middleware/ # 中间件
|
||||||
@@ -147,7 +131,7 @@ docker compose up -d
|
|||||||
│ │ ├── tasks/ # 任务处理器
|
│ │ ├── tasks/ # 任务处理器
|
||||||
│ │ └── utils/ # 工具函数
|
│ │ └── utils/ # 工具函数
|
||||||
│ └── middleware/ # 中间件
|
│ └── middleware/ # 中间件
|
||||||
└── tmp/ # 临时文件
|
└── pkg/ # 公共包
|
||||||
```
|
```
|
||||||
|
|
||||||
## 🔧 开发指南
|
## 🔧 开发指南
|
||||||
@@ -186,19 +170,19 @@ cd worker && go build -o worker .
|
|||||||
- 前端计算哈希和秒传
|
- 前端计算哈希和秒传
|
||||||
- 并发切片上传 (使用 Web Worker)
|
- 并发切片上传 (使用 Web Worker)
|
||||||
- 文件上传/文本上传和分享
|
- 文件上传/文本上传和分享
|
||||||
|
- 支持多文件上传
|
||||||
- 上传统计页面
|
- 上传统计页面
|
||||||
- 多语言支持
|
- 多语言支持
|
||||||
- 最大上传限制
|
- 最大上传限制
|
||||||
- 后端队列系统和 Worker 处理文件
|
- 后端队列系统和 Worker 处理文件
|
||||||
|
- 断点续传 (后端计算已上传部分并返回)
|
||||||
|
- 图片格式转换和压缩
|
||||||
|
|
||||||
### 计划功能 🚧
|
### 计划功能 🚧
|
||||||
|
|
||||||
- 断点续传 (后端计算已上传部分并返回)
|
|
||||||
- 图片格式转换和压缩
|
|
||||||
- 图片 OCR 复制
|
- 图片 OCR 复制
|
||||||
- 文档转 Markdown
|
- 文档转 Markdown
|
||||||
- 文本翻译/总结
|
- 文本翻译/总结
|
||||||
- 支持上传多文件
|
|
||||||
|
|
||||||
## 🤝 贡献指南
|
## 🤝 贡献指南
|
||||||
|
|
||||||
|
|||||||
70
README.md
70
README.md
@@ -41,17 +41,34 @@ English | [中文](README-zh.md)
|
|||||||
|
|
||||||
## 📸 Screenshots
|
## 📸 Screenshots
|
||||||
|
|
||||||
| File Selection Upload Page | Text Input Upload Page |
|
| File Selection Upload Page | Text Input Upload Page |
|
||||||
|---------------------------------------|-----------------------------------------------|
|
| -------------------------- | ------------------------- |
|
||||||
|  |  |
|
|  |  |
|
||||||
|
|
||||||
| Multiple File Upload | Upload Progress Heatmap |
|
| Multiple File Upload | Upload Progress Heatmap |
|
||||||
|------------------------------------------------|---------------------------------------------------|
|
| -------------------------- | ------------------------- |
|
||||||
|  |  |
|
|  |  |
|
||||||
|
|
||||||
| Upload Progress Bar | Upload Success Page |
|
| Upload Progress Bar | Upload Success Page |
|
||||||
|------------------------------------------------|-------------------------------------------------|
|
| -------------------------- | ------------------------- |
|
||||||
|  |  |
|
|  |  |
|
||||||
|
|
||||||
|
## 🚀 Quick Start
|
||||||
|
|
||||||
|
### Docker
|
||||||
|
|
||||||
|
1. Download files
|
||||||
|
- config.example.yaml
|
||||||
|
- docker-compose.yml
|
||||||
|
|
||||||
|
2. Rename config.example.yaml to config.yaml after configuration
|
||||||
|
|
||||||
|
3. Start
|
||||||
|
```bash
|
||||||
|
docker compose up -d
|
||||||
|
```
|
||||||
|
|
||||||
|
4. Visit `http://localhost:8080`
|
||||||
|
|
||||||
## 🏗️ Technical Architecture
|
## 🏗️ Technical Architecture
|
||||||
|
|
||||||
@@ -90,36 +107,21 @@ English | [中文](README-zh.md)
|
|||||||
- **Redis Cache** - Share information and file metadata caching
|
- **Redis Cache** - Share information and file metadata caching
|
||||||
- **Queue System** - Asynchronous task processing queue
|
- **Queue System** - Asynchronous task processing queue
|
||||||
|
|
||||||
## 🚀 Quick Start
|
|
||||||
|
|
||||||
### Docker
|
|
||||||
|
|
||||||
1. Download files
|
|
||||||
- config.example.yaml
|
|
||||||
- docker-compose.yml
|
|
||||||
|
|
||||||
2. Rename config.example.yaml to config.yaml after configuration
|
|
||||||
|
|
||||||
3. Start
|
|
||||||
```bash
|
|
||||||
docker compose up -d
|
|
||||||
```
|
|
||||||
|
|
||||||
## 📁 Project Structure
|
## 📁 Project Structure
|
||||||
|
|
||||||
```
|
```
|
||||||
015/
|
015/
|
||||||
├── front/ # Frontend application (Vue 3 + Nuxt 3)
|
├── front/ # Frontend application (Vue 3 + Nuxt 3)
|
||||||
│ ├── components/ # Vue components
|
│ ├── components/ # Vue components
|
||||||
│ │ ├── pages/ # Page routes
|
│ ├── pages/ # Page routes
|
||||||
│ │ ├── composables/ # Composable functions
|
│ ├── composables/ # Composable functions
|
||||||
│ │ ├── i18n/ # Internationalization files
|
│ ├── i18n/ # Internationalization files
|
||||||
│ │ └── assets/ # Static assets
|
│ ├── assets/ # Static assets
|
||||||
│ └── middleware/ # Middleware
|
│ ├── plugins/ # Nuxt plugins
|
||||||
|
│ └── server/ # Server-side routes
|
||||||
├── backend/ # Backend service (Go + Echo)
|
├── backend/ # Backend service (Go + Echo)
|
||||||
│ ├── internal/ # Internal packages
|
│ ├── internal/ # Internal packages
|
||||||
│ │ ├── controllers/ # Controllers
|
│ │ ├── controllers/ # Controllers
|
||||||
│ │ ├── models/ # Data models
|
|
||||||
│ │ ├── services/ # Business logic
|
│ │ ├── services/ # Business logic
|
||||||
│ │ └── utils/ # Utility functions
|
│ │ └── utils/ # Utility functions
|
||||||
│ └── middleware/ # Middleware
|
│ └── middleware/ # Middleware
|
||||||
@@ -128,7 +130,7 @@ docker compose up -d
|
|||||||
│ │ ├── tasks/ # Task processors
|
│ │ ├── tasks/ # Task processors
|
||||||
│ │ └── utils/ # Utility functions
|
│ │ └── utils/ # Utility functions
|
||||||
│ └── middleware/ # Middleware
|
│ └── middleware/ # Middleware
|
||||||
└── tmp/ # Temporary files
|
└── pkg/ # Shared packages
|
||||||
```
|
```
|
||||||
|
|
||||||
## 🔧 Development Guide
|
## 🔧 Development Guide
|
||||||
@@ -167,19 +169,19 @@ cd worker && go build -o worker .
|
|||||||
- Frontend hash calculation and instant transfer
|
- Frontend hash calculation and instant transfer
|
||||||
- Concurrent chunked upload (using Web Worker)
|
- Concurrent chunked upload (using Web Worker)
|
||||||
- File upload/text upload and sharing
|
- File upload/text upload and sharing
|
||||||
|
- Multiple file upload support
|
||||||
- Upload statistics page
|
- Upload statistics page
|
||||||
- Multi-language support
|
- Multi-language support
|
||||||
- Maximum upload limits
|
- Maximum upload limits
|
||||||
- Backend queue system and Worker file processing
|
- Backend queue system and Worker file processing
|
||||||
|
- Resume upload (backend calculates uploaded parts and returns)
|
||||||
|
- Image format conversion and compression
|
||||||
|
|
||||||
### Planned Features 🚧
|
### Planned Features 🚧
|
||||||
|
|
||||||
- Resume upload (backend calculates uploaded parts and returns)
|
|
||||||
- Image format conversion and compression
|
|
||||||
- Image OCR copy
|
- Image OCR copy
|
||||||
- Document to Markdown conversion
|
- Document to Markdown conversion
|
||||||
- Text translation/summarization
|
- Text translation/summarization
|
||||||
- Support for multiple file uploads
|
|
||||||
|
|
||||||
## 🤝 Contributing
|
## 🤝 Contributing
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user