docs: update README files with improved formatting and additional features

2026-01-25 14:12:20 +08:00
parent 73017935e9
commit 5fee1c7b86
2 changed files with 622 additions and 559 deletions
@@ -1,335 +1,311 @@
-# FileCodeBox - 文件快递柜
-
 <div align="center">

-<img src="https://fastly.jsdelivr.net/gh/vastsa/FileCodeBox@V1.6/static/banners/img_1.png" alt="FileCodeBox Logo">
+# FileCodeBox

-<p><em>匿名口令分享文本和文件，像拿快递一样取文件</em></p>
+### 文件快递柜 - 匿名口令分享文本和文件

-[![GitHub stars](https://img.shields.io/github/stars/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/stargazers)
-[![GitHub forks](https://img.shields.io/github/forks/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/network)
-[![GitHub issues](https://img.shields.io/github/issues/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/issues)
-[![GitHub license](https://img.shields.io/github/license/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/blob/master/LICENSE)
-[![QQ Group](https://img.shields.io/badge/QQ%20Group-739673698-blue.svg)](https://qm.qq.com/q/PemPzhdEIM)
-[![Python Version](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://www.python.org)
-[![FastAPI](https://img.shields.io/badge/FastAPI-0.68+-green.svg)](https://fastapi.tiangolo.com)
-[![Vue Version](https://img.shields.io/badge/Vue.js-3.x-brightgreen.svg)](https://v3.vuejs.org)
+<img src="https://fastly.jsdelivr.net/gh/vastsa/FileCodeBox@V1.6/static/banners/img_1.png" alt="FileCodeBox Logo" width="400">

-[English](./readme_en.md) | [部署教程](https://github.com/vastsa/FileCodeBox/wiki/部署教程) | [常见问题](https://github.com/vastsa/FileCodeBox/wiki/常见问题)
+像拿快递一样取文件，无需注册，输入口令即可获取
+
+[![GitHub stars](https://img.shields.io/github/stars/vastsa/FileCodeBox?style=flat-square&logo=github)](https://github.com/vastsa/FileCodeBox/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/vastsa/FileCodeBox?style=flat-square&logo=github)](https://github.com/vastsa/FileCodeBox/network)
+[![GitHub issues](https://img.shields.io/github/issues/vastsa/FileCodeBox?style=flat-square&logo=github)](https://github.com/vastsa/FileCodeBox/issues)
+[![GitHub license](https://img.shields.io/github/license/vastsa/FileCodeBox?style=flat-square)](https://github.com/vastsa/FileCodeBox/blob/master/LICENSE)
+[![Docker Pulls](https://img.shields.io/docker/pulls/lanol/filecodebox?style=flat-square&logo=docker)](https://hub.docker.com/r/lanol/filecodebox)
+
+[![Python](https://img.shields.io/badge/Python-3.8+-3776AB?style=flat-square&logo=python&logoColor=white)](https://www.python.org)
+[![FastAPI](https://img.shields.io/badge/FastAPI-0.68+-009688?style=flat-square&logo=fastapi&logoColor=white)](https://fastapi.tiangolo.com)
+[![Vue.js](https://img.shields.io/badge/Vue.js-3.x-4FC08D?style=flat-square&logo=vue.js&logoColor=white)](https://vuejs.org)
+
+[English](./readme_en.md) | [在线演示](https://share.lanol.cn) | [部署教程](https://github.com/vastsa/FileCodeBox/wiki/部署教程) | [常见问题](https://github.com/vastsa/FileCodeBox/wiki/常见问题) | [QQ群: 739673698](https://qm.qq.com/q/PemPzhdEIM)
+
+```bash
+# 🚀 一键部署
+docker run -d -p 12345:12345 -v /opt/FileCodeBox:/app/data --name filecodebox lanol/filecodebox:latest
+# 国内镜像（如果上面拉取缓慢）: docker.cnb.cool/aixk/filecodebox
+```

 </div>

-## 🚀 更新计划
+---

- [ ] 2025年皮肤
- [ ] 文件收集功能
+## 目录
+
+- [项目简介](#-项目简介)
+- [功能特性](#-功能特性)
+- [界面预览](#-界面预览)
+- [快速开始](#-快速开始)
+- [使用指南](#-使用指南)
+- [开发指南](#-开发指南)
+- [常见问题](#-常见问题)
+- [贡献指南](#-贡献指南)
+- [项目统计](#-项目统计)
+- [免责声明](#-免责声明)
+
+---

 ## 📝 项目简介

-FileCodeBox 是一个基于 FastAPI + Vue3 开发的轻量级文件分享工具。它允许用户通过简单的方式分享文本和文件，接收者只需要一个提取码就可以取得文件，就像从快递柜取出快递一样简单。
+FileCodeBox 是一个轻量级的文件分享工具，基于 **FastAPI + Vue3** 开发。用户可以通过简单的方式匿名分享文本和文件，接收者只需输入提取码即可获取内容——就像从快递柜取出快递一样简单。

-## 🖼️ 功能预览
+### 应用场景

-别问前端源码怎么是js了，麻烦仔细看下面的内容
-<div align="center">
-<h3>
-<a href="https://github.com/vastsa/FileCodeBoxFronted" target="_blank">
-<img src="https://img.shields.io/badge/Frontend-主题2024仓库-blue?style=for-the-badge&logo=github" alt="前端仓库2024">
-</a>
-<a href="https://github.com/vastsa/FileCodeBoxFronted2023" target="_blank">
-<img src="https://img.shields.io/badge/Frontend-主题2023仓库-blue?style=for-the-badge&logo=github" alt="前端仓库2023">
-</a>
-&nbsp;&nbsp;&nbsp;&nbsp;
-<a href="https://share.lanol.cn" target="_blank">
-<img src="https://img.shields.io/badge/Demo-share.lanol.cn-green?style=for-the-badge&logo=internet-explorer" alt="演示站点">
-</a>
-</h3>
-</div>
+| 场景 | 描述 |
+|------|------|
+| 📁 **临时文件分享** | 快速分享文件，无需注册登录 |
+| 📝 **代码片段分享** | 分享代码、配置文件等文本内容 |
+| 🕶️ **匿名文件传输** | 保护隐私的点对点传输 |
+| 🔄 **跨设备传输** | 在不同设备间快速同步文件 |
+| 💾 **临时存储** | 支持自定义过期时间的云存储 |
+| 🌐 **私有服务** | 搭建企业或个人专属分享服务 |

-### 新版界面
+---

+## ✨ 功能特性
+
+<table>
+<tr>
+<td width="33%" valign="top">
+
+### 🚀 轻量高效
+- FastAPI + SQLite3 后端
+- Vue3 + Element Plus 前端
+- Docker 一键部署
+- 资源占用极低
+
+</td>
+<td width="33%" valign="top">
+
+### 🔒 安全可靠
+- IP 上传频率限制
+- 提取码错误次数限制
+- 文件自动过期清理
+- 支持管理员认证
+
+</td>
+<td width="33%" valign="top">
+
+### 📤 便捷上传
+- 拖拽上传
+- 复制粘贴上传
+- 命令行 curl 上传
+- 批量文件上传
+
+</td>
+</tr>
+<tr>
+<td width="33%" valign="top">
+
+### 🎫 灵活分享
+- 随机/自定义提取码
+- 可设置有效期（时间/次数）
+- 支持永久有效
+- 文本和文件统一管理
+
+</td>
+<td width="33%" valign="top">
+
+### 💾 多存储支持
+- 本地文件系统
+- S3 兼容存储
+- [OneDrive](./docs/guide/storage-onedrive.md)
+- [OpenDAL](./docs/guide/storage-opendal.md)
+
+</td>
+<td width="33%" valign="top">
+
+### 🌍 国际化
+- 简体中文
+- 繁体中文
+- English
+- 响应式设计 / 深色模式
+
+</td>
+</tr>
+</table>
+
+---
+
+## 🖼️ 界面预览
+
+> 前端源码仓库：[2024主题](https://github.com/vastsa/FileCodeBoxFronted) | [2023主题](https://github.com/vastsa/FileCodeBoxFronted2023)
+
+<details open>
+<summary><b>🎨 新版界面 (2024)</b></summary>
+<br>
 <div align="center">
 <table>
 <tr>
-<td><img src="./.github/images/img_7.png" alt="文件上传" title="文件上传界面"></td>
-<td><img src="./.github/images/img_8.png" alt="文本分享" title="文本分享界面"></td>
+<td><img src="./.github/images/img_7.png" alt="文件上传"></td>
+<td><img src="./.github/images/img_8.png" alt="文本分享"></td>
 </tr>
 <tr>
-<td><img src="./.github/images/img_10.png" alt="文件管理" title="文件管理界面"></td>
-<td><img src="./.github/images/img_9.png" alt="系统设置" title="系统设置界面"></td>
+<td><img src="./.github/images/img_10.png" alt="文件管理"></td>
+<td><img src="./.github/images/img_9.png" alt="系统设置"></td>
 </tr>
 <tr>
-<td><img src="./.github/images/img_11.png" alt="移动端" title="移动端界面"></td>
-<td><img src="./.github/images/img_12.png" alt="深色模式" title="深色模式界面"></td>
-</tr>
-<tr>
-<td><img src="./.github/images/img_13.png" alt="国际化" title="国际化支持"></td>
-<td><img src="./.github/images/img_14.png" alt="响应式" title="响应式设计"></td>
+<td><img src="./.github/images/img_11.png" alt="移动端"></td>
+<td><img src="./.github/images/img_12.png" alt="深色模式"></td>
 </tr>
 </table>
 </div>
+</details>

-### 经典界面
-
+<details>
+<summary><b>📦 经典界面 (2023)</b></summary>
+<br>
 <div align="center">
 <table>
 <tr>
-<td><img src="./.github/images/img.png" alt="首页" title="首页界面"></td>
-<td><img src="./.github/images/img_1.png" alt="上传" title="上传界面"></td>
+<td><img src="./.github/images/img.png" alt="首页"></td>
+<td><img src="./.github/images/img_1.png" alt="上传"></td>
 </tr>
 <tr>
-<td><img src="./.github/images/img_2.png" alt="管理" title="管理界面"></td>
-<td><img src="./.github/images/img_3.png" alt="设置" title="设置界面"></td>
-</tr>
-<tr>
-<td><img src="./.github/images/img_4.png" alt="分享" title="分享界面"></td>
-<td><img src="./.github/images/img_5.png" alt="下载" title="下载界面"></td>
+<td><img src="./.github/images/img_2.png" alt="管理"></td>
+<td><img src="./.github/images/img_3.png" alt="设置"></td>
 </tr>
 </table>
 </div>
+</details>

-## 🎯 应用场景
-
-<table>
-<tr>
-<td align="center">
-<h4>📁 临时文件分享</h4>
-快速分享单个文件，无需注册登录
-</td>
-<td align="center">
-<h4>📝 文本快速分享</h4>
-分享代码片段、文本内容等
-</td>
-<td align="center">
-<h4>🕶️ 匿名文件传输</h4>
-保护隐私的文件传输方式
-</td>
-</tr>
-<tr>
-<td align="center">
-<h4>💾 临时文件存储</h4>
-支持设置过期时间的文件存储
-</td>
-<td align="center">
-<h4>🔄 跨平台传输</h4>
-在不同设备间快速传输文件
-</td>
-<td align="center">
-<h4>🌐 小型分享服务</h4>
-搭建私有的文件分享服务
-</td>
-</tr>
-</table>
-
-## ✨ 核心特性
-
-<table>
-<tr>
-<td align="center">
-<h4>🚀 轻量简洁</h4>
-基于 FastAPI + SQLite3 + Vue3 + ElementUI，部署简单，性能出色
-</td>
-<td align="center">
-<h4>📤 便捷上传</h4>
-支持复制粘贴、拖拽上传，操作简单直观
-</td>
-<td align="center">
-<h4>📦 多种类型</h4>
-支持文本和各类文件的分享
-</td>
-</tr>
-<tr>
-<td align="center">
-<h4>🔒 安全机制</h4>
-
- IP 限制上传次数
- 错误次数限制
- 文件过期机制
-
-</td>
-<td align="center">
-<h4>🎫 提取码分享</h4>
-随机提取码，可自定义次数及有效期
-</td>
-<td align="center">
-<h4>🌍 多语言支持</h4>
-支持中文简体、繁体及英文
-</td>
-</tr>
-<tr>
-<td align="center">
-<h4>🎭 匿名分享</h4>
-无需注册登录，保护隐私
-</td>
-<td align="center">
-<h4>🛠 管理面板</h4>
-文件管理和系统配置
-</td>
-<td align="center">
-<h4>🐳 容器部署</h4>
-支持 Docker 一键部署
-</td>
-</tr>
-<tr>
-<td align="center">
-<h4>💾 存储扩展</h4>
-支持本地存储、S3 协议、<a href="./docs/guide/storage-onedrive.md">OneDrive</a>、<a href="./docs/guide/storage-opendal.md">OpenDAL</a> 等
-</td>
-<td align="center">
-<h4>📱 响应式设计</h4>
-支持移动端访问
-</td>
-<td align="center">
-<h4>💻 终端支持</h4>
-支持命令行下载
-</td>
-</tr>
-</table>
+---

 ## 🚀 快速开始

-### Docker 部署
+### Docker 部署（推荐）

-#### Docker CLI
+**方式一：Docker CLI**

 ```bash
-docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:latest
+# Docker Hub（推荐）
+docker run -d --restart always -p 12345:12345 -v /opt/FileCodeBox:/app/data --name filecodebox lanol/filecodebox:latest
+
+# 国内镜像（如果 Docker Hub 拉取缓慢）
+docker run -d --restart always -p 12345:12345 -v /opt/FileCodeBox:/app/data --name filecodebox docker.cnb.cool/aixk/filecodebox
 ```

-#### Docker Compose
+**方式二：Docker Compose**

-```yml
-version: "3"
+```yaml
 services:
-  file-code-box:
+  filecodebox:
    image: lanol/filecodebox:latest
-    volumes:
-      - fcb-data:/app/data:rw
+    container_name: filecodebox
    restart: unless-stopped
    ports:
      - "12345:12345"
+    volumes:
+      - ./data:/app/data
    environment:
      - WORKERS=4
      - LOG_LEVEL=info
-volumes:
-  fcb-data:
-    external: false
 ```

-#### 环境变量
+```bash
+docker compose up -d
+```
+
+**环境变量说明**

 | 变量 | 默认值 | 说明 |
 |------|--------|------|
-| `HOST` | `::` | 监听地址，支持 IPv4/IPv6 双栈 |
+| `HOST` | `::` | 监听地址（支持 IPv4/IPv6 双栈） |
 | `PORT` | `12345` | 服务端口 |
-| `WORKERS` | `4` | 工作进程数，建议设置为 CPU 核心数 |
-| `LOG_LEVEL` | `info` | 日志级别：debug/info/warning/error |
+| `WORKERS` | `4` | 工作进程数（建议设为 CPU 核心数） |
+| `LOG_LEVEL` | `info` | 日志级别：`debug` / `info` / `warning` / `error` |

-**自定义配置示例：**
+### 反向代理配置

-```bash
-docker run -d --restart=always \
-  -p 12345:12345 \
-  -v /opt/FileCodeBox/:/app/data \
-  -e WORKERS=8 \
-  -e LOG_LEVEL=warning \
-  --name filecodebox \
-  lanol/filecodebox:latest
-```
-
-### 配置反向代理（Nginx示例）
-
-请注意，必须添加以下配置来确保正确处理客户端IP和代理请求：
+使用 Nginx 时，请添加以下配置以正确获取客户端 IP：

 ```nginx
 location / {
-    proxy_set_header X-Real-IP $remote_addr;      # 设置真实客户端IP
+    proxy_pass http://127.0.0.1:12345;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-    proxy_pass http://localhost:12345;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    client_max_body_size 100m;  # 根据需要调整上传大小限制
 }
 ```

 ### 手动部署

-1. 克隆项目
-
 ```bash
+# 1. 克隆项目
 git clone https://github.com/vastsa/FileCodeBox.git
-```
-
-2. 安装依赖
-
-```bash
 cd FileCodeBox
+
+# 2. 安装依赖
 pip install -r requirements.txt
-```

-3. 启动服务
-
-```bash
+# 3. 启动服务
 python main.py
 ```

-## 📖 使用说明
+---

-### 分享文件
+## 📖 使用指南

-1. 打开网页，点击"分享文件"
-2. 选择或拖拽文件
-3. 设置过期时间和次数
-4. 获取提取码
+### 基础操作

-### 获取文件
+| 操作 | 步骤 |
+|------|------|
+| **分享文件** | 打开网页 → 选择/拖拽文件 → 设置有效期 → 获取提取码 |
+| **获取文件** | 打开网页 → 输入提取码 → 下载文件或查看文本 |
+| **管理后台** | 访问 `/#/admin` → 输入密码 `FileCodeBox2023` |

-1. 打开网页，输入提取码
-2. 点击获取
-3. 下载文件或查看文本
+### 命令行使用（curl）

-### 管理面板
+<details>
+<summary><b>点击展开 curl 使用示例</b></summary>

-1. 访问 `/#/admin`
-2. 输入管理员密码 `FileCodeBox2023`
-3. 管理文件和配置
-
-### 命令行上传（curl）
-
-支持通过 curl 命令上传文件并获取取件码：
+**上传文件**

 ```bash
-# 上传文件（默认1天有效期）
+# 基础上传（默认 1 天有效期）
 curl -X POST "http://localhost:12345/share/file/" \
-  -F "file=@/path/to/your/file.txt"
+  -F "file=@/path/to/file.txt"

-# 上传文件并指定有效期（1小时）
+# 指定 1 小时有效期
 curl -X POST "http://localhost:12345/share/file/" \
-  -F "file=@/path/to/your/file.txt" \
+  -F "file=@/path/to/file.txt" \
  -F "expire_value=1" \
  -F "expire_style=hour"

-# 上传文件并指定有效期（可下载10次）
+# 指定下载 10 次后过期
 curl -X POST "http://localhost:12345/share/file/" \
-  -F "file=@/path/to/your/file.txt" \
+  -F "file=@/path/to/file.txt" \
  -F "expire_value=10" \
  -F "expire_style=count"
-
-# 分享文本
-curl -X POST "http://localhost:12345/share/text/" \
-  -F "text=这是要分享的文本内容"
-
-# 通过取件码下载文件
-curl -L "http://localhost:12345/share/select/?code=取件码" -o downloaded_file
 ```

-**参数说明：**
- `expire_value`: 有效期数值（默认1）
- `expire_style`: 有效期类型
-  - `day` - 天数
-  - `hour` - 小时
-  - `minute` - 分钟
-  - `count` - 下载次数
-  - `forever` - 永久有效
+**分享文本**
+
+```bash
+curl -X POST "http://localhost:12345/share/text/" \
+  -F "text=要分享的文本内容"
+```
+
+**下载文件**
+
+```bash
+curl -L "http://localhost:12345/share/select/?code=提取码" -o filename
+```
+
+**有效期参数**
+
+| `expire_style` | 说明 |
+|----------------|------|
+| `day` | 天数 |
+| `hour` | 小时 |
+| `minute` | 分钟 |
+| `count` | 下载次数 |
+| `forever` | 永久有效 |
+
+**返回示例**

-**返回示例：**
 ```json
 {
  "code": 200,
@@ -341,101 +317,155 @@ curl -L "http://localhost:12345/share/select/?code=取件码" -o downloaded_file
 }
 ```

-> 注意：如果管理面板关闭了游客上传（`openUpload=false`），需要先登录获取 token，然后在请求中添加 `Authorization: Bearer <token>` 头。
-
-**需要认证时的用法：**
+**需要认证时**（管理员关闭游客上传后）

 ```bash
-# 1. 先登录获取 token
+# 1. 获取 token
 curl -X POST "http://localhost:12345/admin/login" \
  -H "Content-Type: application/json" \
  -d '{"password": "FileCodeBox2023"}'

-# 返回示例：
-# {"code":200,"msg":"success","detail":{"token":"xxx.xxx.xxx","token_type":"Bearer"}}
-
-# 2. 使用 token 上传文件
+# 2. 携带 token 上传
 curl -X POST "http://localhost:12345/share/file/" \
-  -H "Authorization: Bearer xxx.xxx.xxx" \
-  -F "file=@/path/to/your/file.txt"
-
-# 2. 使用 token 分享文本
-curl -X POST "http://localhost:12345/share/text/" \
-  -H "Authorization: Bearer xxx.xxx.xxx" \
-  -F "text=这是要分享的文本内容"
+  -H "Authorization: Bearer <token>" \
+  -F "file=@/path/to/file.txt"
 ```

+</details>
+
+---
+
 ## 🛠 开发指南

 ### 项目结构

 ```
 FileCodeBox/
-├── apps/           # 应用代码
-│   ├── admin/     # 管理后台
-│   └── base/      # 基础功能
-├── core/          # 核心功能
-├── data/          # 数据目录
-└── fcb-fronted/   # 前端代码
+├── apps/              # 应用模块
+│   ├── admin/         # 管理后台
+│   └── base/          # 基础功能
+├── core/              # 核心模块
+├── data/              # 数据目录（运行时生成）
+├── docs/              # 文档
+└── main.py            # 入口文件
 ```

-### 开发环境
-
- Python 3.8+
- Node.js 14+
- Vue 3
- FastAPI
-
 ### 本地开发

-1. 后端开发
+**后端**

 ```bash
+pip install -r requirements.txt
 python main.py
 ```

-2. 前端开发
+**前端**

 ```bash
+# 前端仓库: https://github.com/vastsa/FileCodeBoxFronted
 cd fcb-fronted
 npm install
 npm run dev
 ```

-## 🤝 贡献指南
+### 技术栈

-1. Fork 本项目
-2. 创建新分支 `git checkout -b feature/xxx`
-3. 提交更改 `git commit -m 'Add xxx'`
-4. 推送到分支 `git push origin feature/xxx`
-5. 提交 Pull Request
+| 类别 | 技术 |
+|------|------|
+| **后端框架** | FastAPI 0.128+ / Uvicorn |
+| **数据库** | SQLite + Tortoise ORM |
+| **数据验证** | Pydantic 2.x |
+| **异步支持** | aiofiles / aiohttp / aioboto3 |
+| **对象存储** | S3 协议 / OneDrive / OpenDAL |
+| **前端框架** | Vue 3 + Element Plus + Vite |
+| **运行环境** | Python 3.8+ / Node.js 18+ |
+| **容器化** | Docker / Docker Compose |
+
+---

 ## ❓ 常见问题

-### Q: 如何修改上传大小限制？
+<details>
+<summary><b>如何修改上传大小限制？</b></summary>

-A: 在管理面板中修改配置项 `uploadSize`
+在管理面板中修改 `uploadSize` 配置项。如果使用 Nginx 反向代理，还需修改 `client_max_body_size`。
+</details>

-### Q: 如何配置存储引擎？
+<details>
+<summary><b>如何配置存储引擎？</b></summary>

-A: 在管理面板中选择存储引擎并配置相应参数
+在管理面板中选择存储引擎类型并配置相应参数。支持本地存储、S3、OneDrive、OpenDAL 等。
+</details>

-### Q: 如何备份数据？
+<details>
+<summary><b>如何备份数据？</b></summary>

-A: 备份 `data` 目录即可
+备份 `data` 目录即可，包含数据库和上传的文件。
+</details>

-更多问题请访问 [Wiki](https://github.com/vastsa/FileCodeBox/wiki/常见问题)
+<details>
+<summary><b>如何修改管理员密码？</b></summary>
+
+登录管理面板后，在系统设置中修改 `adminPassword` 配置项。
+</details>
+
+更多问题请访问 [Wiki](https://github.com/vastsa/FileCodeBox/wiki/常见问题) 或加入 [QQ群: 739673698](https://qm.qq.com/q/PemPzhdEIM)
+
+---
+
+## 🤝 贡献指南
+
+欢迎提交 Issue 和 Pull Request！
+
+```bash
+# 1. Fork 并克隆
+git clone https://github.com/your-username/FileCodeBox.git
+
+# 2. 创建分支
+git checkout -b feature/your-feature
+
+# 3. 提交更改
+git commit -m "feat: add your feature"
+
+# 4. 推送并创建 PR
+git push origin feature/your-feature
+```
+
+---

 ## 📊 项目统计

 <div align="center">
-<a href="https://hellogithub.com/repository/75ad7ffedd404a6485b4d621ec5b47e6" target="_blank"><img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=75ad7ffedd404a6485b4d621ec5b47e6&claim_uid=beSz6INEkCM4mDH" alt="Featured｜HelloGitHub" style="width: 200px; height: 45px;" width="200" height="45" /></a>
+
+<a href="https://hellogithub.com/repository/75ad7ffedd404a6485b4d621ec5b47e6" target="_blank">
+  <img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=75ad7ffedd404a6485b4d621ec5b47e6&claim_uid=beSz6INEkCM4mDH" alt="HelloGitHub" width="200">
+</a>

 ![Repobeats](https://repobeats.axiom.co/api/embed/7a6c92f1d96ee57e6fb67f0df371528397b0c9ac.svg)

 [![Star History](https://api.star-history.com/svg?repos=vastsa/FileCodeBox&type=Date)](https://star-history.com/#vastsa/FileCodeBox&Date)
+
 </div>

+---
+
+## 🗓 更新计划
+
+- [ ] 2025 年新皮肤
+- [ ] 文件收集功能
+
+---
+
 ## 📜 免责声明

-本项目开源仅供学习使用，不得用于任何违法用途，否则后果自负，与作者无关。使用时请保留项目地址和版权信息。
+本项目开源仅供学习交流使用，不得用于任何违法用途，否则后果自负，与作者无关。使用本项目时请保留项目地址和版权信息。
+
+---
+
+<div align="center">
+
+**如果觉得项目不错，欢迎 ⭐ Star 支持！**
+
+Made with ❤️ by [vastsa](https://github.com/vastsa)
+
+</div>
@@ -1,331 +1,311 @@
-# FileCodeBox
-
 <div align="center">

-<img src="https://fastly.jsdelivr.net/gh/vastsa/FileCodeBox@V1.6/static/banners/img_1.png" alt="FileCodeBox Logo">
+# FileCodeBox

-<p><em>Share text and files anonymously with a passcode, like picking up a package</em></p>
+### Anonymous File & Text Sharing with Passcode

-[![GitHub stars](https://img.shields.io/github/stars/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/stargazers)
-[![GitHub forks](https://img.shields.io/github/forks/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/network)
-[![GitHub issues](https://img.shields.io/github/issues/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/issues)
-[![GitHub license](https://img.shields.io/github/license/vastsa/FileCodeBox)](https://github.com/vastsa/FileCodeBox/blob/master/LICENSE)
-[![QQ Group](https://img.shields.io/badge/QQ%20Group-739673698-blue.svg)](https://qm.qq.com/q/PemPzhdEIM)
-[![Python Version](https://img.shields.io/badge/Python-3.8+-blue.svg)](https://www.python.org)
-[![FastAPI](https://img.shields.io/badge/FastAPI-0.68+-green.svg)](https://fastapi.tiangolo.com)
-[![Vue Version](https://img.shields.io/badge/Vue.js-3.x-brightgreen.svg)](https://v3.vuejs.org)
+<img src="https://fastly.jsdelivr.net/gh/vastsa/FileCodeBox@V1.6/static/banners/img_1.png" alt="FileCodeBox Logo" width="400">

-[简体中文](./readme.md) | [Deployment Guide](https://github.com/vastsa/FileCodeBox/wiki/Deployment-Guide) | [FAQ](https://github.com/vastsa/FileCodeBox/wiki/FAQ)
+Share files like picking up a package — no registration required, just enter the passcode
+
+[![GitHub stars](https://img.shields.io/github/stars/vastsa/FileCodeBox?style=flat-square&logo=github)](https://github.com/vastsa/FileCodeBox/stargazers)
+[![GitHub forks](https://img.shields.io/github/forks/vastsa/FileCodeBox?style=flat-square&logo=github)](https://github.com/vastsa/FileCodeBox/network)
+[![GitHub issues](https://img.shields.io/github/issues/vastsa/FileCodeBox?style=flat-square&logo=github)](https://github.com/vastsa/FileCodeBox/issues)
+[![GitHub license](https://img.shields.io/github/license/vastsa/FileCodeBox?style=flat-square)](https://github.com/vastsa/FileCodeBox/blob/master/LICENSE)
+[![Docker Pulls](https://img.shields.io/docker/pulls/lanol/filecodebox?style=flat-square&logo=docker)](https://hub.docker.com/r/lanol/filecodebox)
+
+[![Python](https://img.shields.io/badge/Python-3.8+-3776AB?style=flat-square&logo=python&logoColor=white)](https://www.python.org)
+[![FastAPI](https://img.shields.io/badge/FastAPI-0.128+-009688?style=flat-square&logo=fastapi&logoColor=white)](https://fastapi.tiangolo.com)
+[![Vue.js](https://img.shields.io/badge/Vue.js-3.x-4FC08D?style=flat-square&logo=vue.js&logoColor=white)](https://vuejs.org)
+
+[简体中文](./README.md) | [Live Demo](https://share.lanol.cn) | [Documentation](https://github.com/vastsa/FileCodeBox/wiki/Deployment-Guide) | [FAQ](https://github.com/vastsa/FileCodeBox/wiki/FAQ)
+
+```bash
+# 🚀 Quick Deploy
+docker run -d -p 12345:12345 -v /opt/FileCodeBox:/app/data --name filecodebox lanol/filecodebox:latest
+# China Mirror (if slow): docker.cnb.cool/aixk/filecodebox
+```

 </div>

+---
+
+## Table of Contents
+
+- [Introduction](#-introduction)
+- [Features](#-features)
+- [Screenshots](#-screenshots)
+- [Quick Start](#-quick-start)
+- [Usage Guide](#-usage-guide)
+- [Development](#-development)
+- [FAQ](#-faq)
+- [Contributing](#-contributing)
+- [Statistics](#-statistics)
+- [Disclaimer](#-disclaimer)
+
+---
+
 ## 📝 Introduction

-FileCodeBox is a lightweight file sharing tool developed with FastAPI + Vue3. It allows users to share text and files
-easily, where recipients only need a passcode to retrieve the files, just like picking up a package from a delivery
-locker.
+FileCodeBox is a lightweight file sharing tool built with **FastAPI + Vue3**. Users can anonymously share text and files, and recipients only need to enter a passcode to retrieve the content — just like picking up a package from a locker.

-## 🖼️ Preview
+### Use Cases

-<div align="center">
-<h3>
-<a href="https://github.com/vastsa/FileCodeBoxFronted" target="_blank">
-<img src="https://img.shields.io/badge/Frontend-FileCodeBoxFronted2024-blue?style=for-the-badge&logo=github" alt="前端仓库2024">
-</a>
-<a href="https://github.com/vastsa/FileCodeBoxFronted2023" target="_blank">
-<img src="https://img.shields.io/badge/Frontend-FileCodeBoxFronted2023-blue?style=for-the-badge&logo=github" alt="前端仓库2023">
-</a>
-&nbsp;&nbsp;&nbsp;&nbsp;
-<a href="https://share.lanol.cn" target="_blank">
-<img src="https://img.shields.io/badge/Demo-share.lanol.cn-green?style=for-the-badge&logo=internet-explorer" alt="演示站点">
-</a>
-</h3>
-</div>
+| Scenario | Description |
+|----------|-------------|
+| 📁 **Temporary File Sharing** | Quick file sharing without registration |
+| 📝 **Code Snippet Sharing** | Share code, config files, and text content |
+| 🕶️ **Anonymous Transfer** | Privacy-protected peer-to-peer transfer |
+| 🔄 **Cross-Device Transfer** | Quickly sync files between devices |
+| 💾 **Temporary Storage** | Cloud storage with custom expiration |
+| 🌐 **Private Service** | Build your own enterprise or personal sharing service |

-### New Interface
+---

+## ✨ Features
+
+<table>
+<tr>
+<td width="33%" valign="top">
+
+### 🚀 Lightweight & Fast
+- FastAPI + SQLite3 backend
+- Vue3 + Element Plus frontend
+- One-click Docker deployment
+- Minimal resource usage
+
+</td>
+<td width="33%" valign="top">
+
+### 🔒 Secure & Reliable
+- IP upload rate limiting
+- Passcode attempt limiting
+- Auto file expiration cleanup
+- Admin authentication support
+
+</td>
+<td width="33%" valign="top">
+
+### 📤 Easy Upload
+- Drag & drop upload
+- Copy & paste upload
+- Command line curl upload
+- Batch file upload
+
+</td>
+</tr>
+<tr>
+<td width="33%" valign="top">
+
+### 🎫 Flexible Sharing
+- Random / custom passcodes
+- Set expiration (time/count)
+- Permanent validity support
+- Unified text & file management
+
+</td>
+<td width="33%" valign="top">
+
+### 💾 Multiple Storage
+- Local file system
+- S3-compatible storage
+- [OneDrive](./docs/guide/storage-onedrive.md)
+- [OpenDAL](./docs/guide/storage-opendal.md)
+
+</td>
+<td width="33%" valign="top">
+
+### 🌍 Internationalization
+- Simplified Chinese
+- Traditional Chinese
+- English
+- Responsive design / Dark mode
+
+</td>
+</tr>
+</table>
+
+---
+
+## 🖼️ Screenshots
+
+> Frontend repositories: [2024 Theme](https://github.com/vastsa/FileCodeBoxFronted) | [2023 Theme](https://github.com/vastsa/FileCodeBoxFronted2023)
+
+<details open>
+<summary><b>🎨 New Interface (2024)</b></summary>
+<br>
 <div align="center">
 <table>
 <tr>
-<td><img src="./.github/images/img_7.png" alt="File Upload" title="File Upload Interface"></td>
-<td><img src="./.github/images/img_8.png" alt="Text Share" title="Text Share Interface"></td>
+<td><img src="./.github/images/img_7.png" alt="File Upload"></td>
+<td><img src="./.github/images/img_8.png" alt="Text Share"></td>
 </tr>
 <tr>
-<td><img src="./.github/images/img_10.png" alt="File Management" title="File Management Interface"></td>
-<td><img src="./.github/images/img_9.png" alt="System Settings" title="System Settings Interface"></td>
+<td><img src="./.github/images/img_10.png" alt="File Management"></td>
+<td><img src="./.github/images/img_9.png" alt="System Settings"></td>
 </tr>
 <tr>
-<td><img src="./.github/images/img_11.png" alt="Mobile View" title="Mobile Interface"></td>
-<td><img src="./.github/images/img_12.png" alt="Dark Mode" title="Dark Mode Interface"></td>
-</tr>
-<tr>
-<td><img src="./.github/images/img_13.png" alt="Internationalization" title="Language Support"></td>
-<td><img src="./.github/images/img_14.png" alt="Responsive" title="Responsive Design"></td>
+<td><img src="./.github/images/img_11.png" alt="Mobile View"></td>
+<td><img src="./.github/images/img_12.png" alt="Dark Mode"></td>
 </tr>
 </table>
 </div>
+</details>

-### Classic Interface
-
+<details>
+<summary><b>📦 Classic Interface (2023)</b></summary>
+<br>
 <div align="center">
 <table>
 <tr>
-<td><img src="./.github/images/img.png" alt="Home" title="Home Page"></td>
-<td><img src="./.github/images/img_1.png" alt="Upload" title="Upload Interface"></td>
+<td><img src="./.github/images/img.png" alt="Home"></td>
+<td><img src="./.github/images/img_1.png" alt="Upload"></td>
 </tr>
 <tr>
-<td><img src="./.github/images/img_2.png" alt="Management" title="Management Interface"></td>
-<td><img src="./.github/images/img_3.png" alt="Settings" title="Settings Interface"></td>
-</tr>
-<tr>
-<td><img src="./.github/images/img_4.png" alt="Share" title="Share Interface"></td>
-<td><img src="./.github/images/img_5.png" alt="Download" title="Download Interface"></td>
+<td><img src="./.github/images/img_2.png" alt="Management"></td>
+<td><img src="./.github/images/img_3.png" alt="Settings"></td>
 </tr>
 </table>
 </div>
+</details>

-## 🎯 Use Cases
-
-<table>
-<tr>
-<td align="center">
-<h4>📁 Temporary File Sharing</h4>
-Quick file sharing without registration
-</td>
-<td align="center">
-<h4>📝 Quick Text Sharing</h4>
-Share code snippets and text content
-</td>
-<td align="center">
-<h4>🕶️ Anonymous Transfer</h4>
-Privacy-protected file transfer
-</td>
-</tr>
-<tr>
-<td align="center">
-<h4>💾 Temporary Storage</h4>
-File storage with expiration time
-</td>
-<td align="center">
-<h4>🔄 Cross-platform Transfer</h4>
-Quick file transfer between devices
-</td>
-<td align="center">
-<h4>🌐 Private Share Service</h4>
-Build your own file sharing service
-</td>
-</tr>
-</table>
-
-## ✨ Core Features
-
-<table>
-<tr>
-<td align="center">
-<h4>🚀 Lightweight</h4>
-Based on FastAPI + SQLite3 + Vue3 + ElementUI
-</td>
-<td align="center">
-<h4>📤 Easy Upload</h4>
-Support copy-paste and drag-drop
-</td>
-<td align="center">
-<h4>📦 Multiple Types</h4>
-Support text and various file types
-</td>
-</tr>
-<tr>
-<td align="center">
-<h4>🔒 Security</h4>
-
- IP upload limits
- Error attempt limits
- File expiration
-
-</td>
-<td align="center">
-<h4>🎫 Passcode Sharing</h4>
-Random codes with customizable limits
-</td>
-<td align="center">
-<h4>🌍 Multi-language</h4>
-Support for Simplified Chinese, Traditional Chinese, and English
-</td>
-</tr>
-<tr>
-<td align="center">
-<h4>🎭 Anonymous</h4>
-No registration required
-</td>
-<td align="center">
-<h4>🛠 Admin Panel</h4>
-File and system management
-</td>
-<td align="center">
-<h4>🐳 Docker</h4>
-One-click deployment
-</td>
-</tr>
-<tr>
-<td align="center">
-<h4>💾 Storage Options</h4>
-Local, S3, <a href="./docs/guide/storage-onedrive.md">OneDrive</a>, <a href="./docs/guide/storage-opendal.md">OpenDAL</a> support
-</td>
-<td align="center">
-<h4>📱 Responsive</h4>
-Mobile-friendly design
-</td>
-<td align="center">
-<h4>💻 CLI Support</h4>
-Command-line download
-</td>
-</tr>
-</table>
+---

 ## 🚀 Quick Start

-### Docker Deployment
+### Docker Deployment (Recommended)

-#### Docker CLI
+**Option 1: Docker CLI**

 ```bash
-docker run -d --restart=always -p 12345:12345 -v /opt/FileCodeBox/:/app/data --name filecodebox lanol/filecodebox:latest
+# Docker Hub (Recommended)
+docker run -d --restart always -p 12345:12345 -v /opt/FileCodeBox:/app/data --name filecodebox lanol/filecodebox:latest
+
+# China Mirror (if Docker Hub is slow)
+docker run -d --restart always -p 12345:12345 -v /opt/FileCodeBox:/app/data --name filecodebox docker.cnb.cool/aixk/filecodebox
 ```

-#### Docker Compose
+**Option 2: Docker Compose**

-```yml
-version: "3"
+```yaml
 services:
-  file-code-box:
+  filecodebox:
    image: lanol/filecodebox:latest
-    volumes:
-      - fcb-data:/app/data:rw
+    container_name: filecodebox
    restart: unless-stopped
    ports:
      - "12345:12345"
+    volumes:
+      - ./data:/app/data
    environment:
      - WORKERS=4
      - LOG_LEVEL=info
-volumes:
-  fcb-data:
-    external: false
 ```

-#### Environment Variables
+```bash
+docker compose up -d
+```
+
+**Environment Variables**

 | Variable | Default | Description |
 |----------|---------|-------------|
-| `HOST` | `::` | Listen address, supports IPv4/IPv6 dual-stack |
+| `HOST` | `::` | Listen address (supports IPv4/IPv6 dual-stack) |
 | `PORT` | `12345` | Service port |
-| `WORKERS` | `4` | Number of worker processes, recommended to set to CPU cores |
-| `LOG_LEVEL` | `info` | Log level: debug/info/warning/error |
+| `WORKERS` | `4` | Worker processes (recommended: CPU cores) |
+| `LOG_LEVEL` | `info` | Log level: `debug` / `info` / `warning` / `error` |

-**Custom configuration example:**
+### Reverse Proxy Configuration

-```bash
-docker run -d --restart=always \
-  -p 12345:12345 \
-  -v /opt/FileCodeBox/:/app/data \
-  -e WORKERS=8 \
-  -e LOG_LEVEL=warning \
-  --name filecodebox \
-  lanol/filecodebox:latest
-```
-
-### Configure Reverse Proxy (Nginx Example)
-
-Please note that the following configurations must be added to ensure proper handling of client IP and proxy requests:
+When using Nginx, add the following configuration to properly obtain client IP:

 ```nginx
 location / {
-    proxy_set_header X-Real-IP $remote_addr;      # Set real client IP
+    proxy_pass http://127.0.0.1:12345;
+    proxy_set_header Host $host;
+    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
-    proxy_pass http://localhost:12345;
+    proxy_set_header X-Forwarded-Proto $scheme;
+    client_max_body_size 100m;  # Adjust upload size limit as needed
 }
 ```

 ### Manual Deployment

-1. Clone the repository
-
 ```bash
+# 1. Clone the repository
 git clone https://github.com/vastsa/FileCodeBox.git
-```
-
-2. Install dependencies
-
-```bash
 cd FileCodeBox
+
+# 2. Install dependencies
 pip install -r requirements.txt
-```

-3. Start the service
-
-```bash
+# 3. Start the service
 python main.py
 ```

+---
+
 ## 📖 Usage Guide

-### Share Files
+### Basic Operations

-1. Open the website, click "Share File"
-2. Select or drag files
-3. Set expiration time and count
-4. Get the passcode
+| Operation | Steps |
+|-----------|-------|
+| **Share File** | Open website → Select/drag files → Set expiration → Get passcode |
+| **Retrieve File** | Open website → Enter passcode → Download file or view text |
+| **Admin Panel** | Visit `/#/admin` → Enter password `FileCodeBox2023` |

-### Retrieve Files
+### Command Line Usage (curl)

-1. Open the website, enter passcode
-2. Click retrieve
-3. Download file or view text
+<details>
+<summary><b>Click to expand curl examples</b></summary>

-### Admin Panel
-
-1. Visit `/#/admin`
-2. Enter admin password `FileCodeBox2023`
-3. Manage files and settings
-
-### Command Line Upload (curl)
-
-Upload files and get extraction codes via curl:
+**Upload File**

 ```bash
-# Upload file (default 1 day expiration)
+# Basic upload (default 1 day expiration)
 curl -X POST "http://localhost:12345/share/file/" \
-  -F "file=@/path/to/your/file.txt"
+  -F "file=@/path/to/file.txt"

-# Upload file with expiration (1 hour)
+# Set 1 hour expiration
 curl -X POST "http://localhost:12345/share/file/" \
-  -F "file=@/path/to/your/file.txt" \
+  -F "file=@/path/to/file.txt" \
  -F "expire_value=1" \
  -F "expire_style=hour"

-# Upload file with download limit (10 downloads)
+# Set expiration after 10 downloads
 curl -X POST "http://localhost:12345/share/file/" \
-  -F "file=@/path/to/your/file.txt" \
+  -F "file=@/path/to/file.txt" \
  -F "expire_value=10" \
  -F "expire_style=count"
-
-# Share text
-curl -X POST "http://localhost:12345/share/text/" \
-  -F "text=This is the text content to share"
-
-# Download file by extraction code
-curl -L "http://localhost:12345/share/select/?code=YOUR_CODE" -o downloaded_file
 ```

-**Parameters:**
- `expire_value`: Expiration value (default 1)
- `expire_style`: Expiration type
-  - `day` - Days
-  - `hour` - Hours
-  - `minute` - Minutes
-  - `count` - Download count
-  - `forever` - Never expire
+**Share Text**
+
+```bash
+curl -X POST "http://localhost:12345/share/text/" \
+  -F "text=Text content to share"
+```
+
+**Download File**
+
+```bash
+curl -L "http://localhost:12345/share/select/?code=PASSCODE" -o filename
+```
+
+**Expiration Parameters**
+
+| `expire_style` | Description |
+|----------------|-------------|
+| `day` | Days |
+| `hour` | Hours |
+| `minute` | Minutes |
+| `count` | Download count |
+| `forever` | Never expire |
+
+**Response Example**

-**Response Example:**
 ```json
 {
  "code": 200,
@@ -337,102 +317,155 @@ curl -L "http://localhost:12345/share/select/?code=YOUR_CODE" -o downloaded_file
 }
 ```

-> Note: If guest upload is disabled in admin panel (`openUpload=false`), you need to login first to get a token, then add `Authorization: Bearer <token>` header to your requests.
-
-**When Authentication Required:**
+**When Authentication Required** (after admin disables guest upload)

 ```bash
-# 1. Login to get token
+# 1. Get token
 curl -X POST "http://localhost:12345/admin/login" \
  -H "Content-Type: application/json" \
  -d '{"password": "FileCodeBox2023"}'

-# Response:
-# {"code":200,"msg":"success","detail":{"token":"xxx.xxx.xxx","token_type":"Bearer"}}
-
-# 2. Upload file with token
+# 2. Upload with token
 curl -X POST "http://localhost:12345/share/file/" \
-  -H "Authorization: Bearer xxx.xxx.xxx" \
-  -F "file=@/path/to/your/file.txt"
-
-# 3. Share text with token
-curl -X POST "http://localhost:12345/share/text/" \
-  -H "Authorization: Bearer xxx.xxx.xxx" \
-  -F "text=This is the text content to share"
+  -H "Authorization: Bearer <token>" \
+  -F "file=@/path/to/file.txt"
 ```

-## 🛠 Development Guide
+</details>
+
+---
+
+## 🛠 Development

 ### Project Structure

 ```
 FileCodeBox/
-├── apps/           # Application code
-│   ├── admin/     # Admin backend
-│   └── base/      # Base functions
-├── core/          # Core functions
-├── data/          # Data directory
-└── fcb-fronted/   # Frontend code
+├── apps/              # Application modules
+│   ├── admin/         # Admin backend
+│   └── base/          # Base functionality
+├── core/              # Core modules
+├── data/              # Data directory (generated at runtime)
+├── docs/              # Documentation
+└── main.py            # Entry point
 ```

-### Development Environment
-
- Python 3.8+
- Node.js 14+
- Vue 3
- FastAPI
-
 ### Local Development

-1. Backend development
+**Backend**

 ```bash
+pip install -r requirements.txt
 python main.py
 ```

-2. Frontend development
+**Frontend**

 ```bash
+# Frontend repo: https://github.com/vastsa/FileCodeBoxFronted
 cd fcb-fronted
 npm install
 npm run dev
 ```

-## 🤝 Contributing
+### Tech Stack

-1. Fork the project
-2. Create your feature branch `git checkout -b feature/xxx`
-3. Commit your changes `git commit -m 'Add xxx'`
-4. Push to the branch `git push origin feature/xxx`
-5. Open a Pull Request
+| Category | Technology |
+|----------|------------|
+| **Backend Framework** | FastAPI 0.128+ / Uvicorn |
+| **Database** | SQLite + Tortoise ORM |
+| **Data Validation** | Pydantic 2.x |
+| **Async Support** | aiofiles / aiohttp / aioboto3 |
+| **Object Storage** | S3 Protocol / OneDrive / OpenDAL |
+| **Frontend Framework** | Vue 3 + Element Plus + Vite |
+| **Runtime** | Python 3.8+ / Node.js 18+ |
+| **Containerization** | Docker / Docker Compose |
+
+---

 ## ❓ FAQ

-### Q: How to modify upload size limit?
+<details>
+<summary><b>How to modify upload size limit?</b></summary>

-A: Change `uploadSize` in admin panel
+Modify the `uploadSize` configuration in the admin panel. If using Nginx reverse proxy, also modify `client_max_body_size`.
+</details>

-### Q: How to configure storage engine?
+<details>
+<summary><b>How to configure storage engine?</b></summary>

-A: Select storage engine and configure parameters in admin panel
+Select the storage engine type and configure parameters in the admin panel. Supports local storage, S3, OneDrive, OpenDAL, etc.
+</details>

-### Q: How to backup data?
+<details>
+<summary><b>How to backup data?</b></summary>

-A: Backup the `data` directory
+Backup the `data` directory, which contains the database and uploaded files.
+</details>

-For more questions, visit [Wiki](https://github.com/vastsa/FileCodeBox/wiki/常见问题)
+<details>
+<summary><b>How to change admin password?</b></summary>

-## �� Project Statistics and Analytics
+After logging into the admin panel, modify the `adminPassword` configuration in system settings.
+</details>
+
+For more questions, visit [Wiki](https://github.com/vastsa/FileCodeBox/wiki/FAQ)
+
+---
+
+## 🤝 Contributing
+
+Issues and Pull Requests are welcome!
+
+```bash
+# 1. Fork and clone
+git clone https://github.com/your-username/FileCodeBox.git
+
+# 2. Create branch
+git checkout -b feature/your-feature
+
+# 3. Commit changes
+git commit -m "feat: add your feature"
+
+# 4. Push and create PR
+git push origin feature/your-feature
+```
+
+---
+
+## 📊 Statistics

 <div align="center">
-<a href="https://hellogithub.com/repository/75ad7ffedd404a6485b4d621ec5b47e6" target="_blank"><img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=75ad7ffedd404a6485b4d621ec5b47e6&claim_uid=beSz6INEkCM4mDH" alt="Featured｜HelloGitHub" style="width: 200px; height: 45px;" width="200" height="45" /></a>
+
+<a href="https://hellogithub.com/repository/75ad7ffedd404a6485b4d621ec5b47e6" target="_blank">
+  <img src="https://api.hellogithub.com/v1/widgets/recommend.svg?rid=75ad7ffedd404a6485b4d621ec5b47e6&claim_uid=beSz6INEkCM4mDH" alt="HelloGitHub" width="200">
+</a>

 ![Repobeats](https://repobeats.axiom.co/api/embed/7a6c92f1d96ee57e6fb67f0df371528397b0c9ac.svg)

 [![Star History](https://api.star-history.com/svg?repos=vastsa/FileCodeBox&type=Date)](https://star-history.com/#vastsa/FileCodeBox&Date)
+
 </div>

+---
+
+## 🗓 Roadmap
+
+- [ ] 2025 New Theme
+- [ ] File Collection Feature
+
+---
+
 ## 📜 Disclaimer

-This project is open-source for learning purposes only. It should not be used for any illegal purposes. The author is
-not responsible for any consequences. Please retain the project address and copyright information when using it.
+This project is open-source for learning and communication purposes only. It should not be used for any illegal purposes. The author is not responsible for any consequences. Please retain the project address and copyright information when using it.
+
+---
+
+<div align="center">
+
+**If you find this project helpful, please give it a ⭐ Star!**
+
+Made with ❤️ by [vastsa](https://github.com/vastsa)
+
+</div>