# 极简文件快递柜

**Repository Path**: scicat-team/wenji

## Basic Information

- **Project Name**: 极简文件快递柜
- **Description**: 极简的文件快递柜
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-06
- **Last Updated**: 2026-02-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 快捷文件柜 (SciCat Team)

一个基于Flask的文件上传与分享系统，支持取件码模式的文件存储和检索。本项目由SciCat团队开发和维护。

## 功能特性

- **文件上传**：支持各种文件类型的上传，包含进度条显示
- **取件码模式**：上传后生成唯一取件码，用于文件提取
- **文件压缩存储**：自动压缩上传的文件以节省存储空间
- **文件预览**：支持图片、视频和文本文件的在线预览
- **我的文件列表**：仅显示当前用户上传的文件记录
- **安全验证**：文件类型验证、大小限制、路径遍历防护
- **定时清理**：自动清理过期文件

## 安装要求

- Python 3.8+
- Flask 2.3.3+
- zstandard 0.22.0+

## 安装步骤

1. 克隆或下载项目文件
2. 安装依赖：
   ```bash
   pip install -r requirements.txt
   ```
3. 启动应用：
   ```bash
   python app.py
   ```
4. 访问 `http://localhost:2026`

## 使用说明

1. **上传文件**：点击"选择文件"按钮或拖拽文件到上传区域，设置保留时间后上传
2. **获取取件码**：上传成功后会生成唯一取件码，请妥善保存
3. **提取文件**：在提取区域输入取件码，验证后可查看和下载文件
4. **查看文件列表**：页面下方显示当前用户上传的文件记录
5. **删除记录**：可删除自己上传的文件记录

## 安全特性

- 文件类型验证：限制允许上传的文件类型
- 文件大小限制：单个文件最大100MB
- MIME类型检查：防止恶意文件上传
- 路径遍历防护：防止访问系统敏感文件
- IP地址验证：确保用户只能查看和删除自己的文件

## 技术架构

- 后端：Flask Web框架
- 存储：JSON文件存储 + 压缩文件存储
- 前端：原生JavaScript + HTML + CSS
- 压缩算法：Zstandard (zstd)

## 开源协议

本项目采用 MIT 开源协议，详情请参见 [LICENSE](LICENSE) 文件。

## 开发团队

SciCat Team

## 贡献

欢迎提交 Issue 和 Pull Request 来帮助改进项目。

## 版本

v1.0.0