# little-tools

**Repository Path**: keyingbo/little-tools

## Basic Information

- **Project Name**: little-tools
- **Description**: 个人使用的小工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-13
- **Last Updated**: 2026-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python Web 小工具集合

一个基于 FastAPI 的实用小工具 Web 应用，支持 Docker 部署。

## 功能特性

- 📊 **Excel转Markdown**：将Excel表格转换为格式化的Markdown文档
- 🎨 **简洁界面**：用户友好的操作界面
- 🔧 **可扩展架构**：模块化设计，方便添加新工具
- 🐳 **Docker支持**：一键部署

## 快速开始

### 方式一：Docker 部署（推荐）

```bash
# 构建并启动
docker-compose up -d

# 访问应用
# http://localhost:8000
```

### 方式二：本地运行

```bash
# 安装依赖
pip install -r requirements.txt

# 启动服务
uvicorn app.main:app --host 0.0.0.0 --port 8000

# 访问应用
# http://localhost:8000
```

## 项目结构

```
little-tools/
├── app/                    # 应用主目录
│   ├── main.py            # 应用入口
│   ├── config.py          # 配置文件
│   ├── templates/         # HTML模板
│   │   └── index.html
│   ├── static/            # 静态文件
│   │   ├── css/
│   │   │   └── style.css
│   │   └── js/
│   │       └── main.js
│   └── tools/             # 工具模块
│       └── excel2md/      # Excel转Markdown工具
│           ├── __init__.py
│           ├── router.py  # API路由
│           └── service.py # 业务逻辑
├── uploads/               # 上传文件目录（自动创建）
├── temp/                  # 临时文件目录（自动创建）
├── requirements.txt       # Python依赖
├── Dockerfile            # Docker配置
├── docker-compose.yml    # Docker Compose配置
└── README.md             # 说明文档
```

## 使用指南

### Excel转Markdown工具

1. **上传Excel文件**：点击或拖拽Excel文件到上传区域
2. **配置参数**：
   - 表头行号：指定表头所在的行（默认第1行）
   - 数据开始行号：指定数据从哪一行开始（默认第2行）
3. **预览结果**：点击"预览结果"查看转换效果
4. **下载文件**：点击"下载Markdown"获取完整的Markdown文件

### 输出格式

每一行数据会转换为以下格式：

```markdown
### 表头1:内容1
表头2:内容2
表头3:内容3

---
```

## 扩展新工具

要添加新工具，只需以下步骤：

1. 在 `app/tools/` 下创建新的工具目录
2. 实现 `router.py`（API路由）和 `service.py`（业务逻辑）
3. 在 `app/main.py` 中注册新路由
4. 在 `index.html` 中添加新工具按钮和界面

示例：

```python
# app/main.py
from app.tools.your_tool.router import router as your_tool_router

app.include_router(your_tool_router, prefix="/tools/your-tool", tags=["Your Tool"])
```

## 技术栈

- **后端**：FastAPI + Uvicorn
- **前端**：原生HTML/CSS/JavaScript
- **Excel处理**：openpyxl
- **模板引擎**：Jinja2
- **部署**：Docker + Docker Compose

## API文档

启动应用后访问：http://localhost:8000/docs

## 注意事项

- 支持的Excel格式：`.xlsx`, `.xls`
- 最大文件大小：10MB
- 上传的文件会在处理后自动删除

## License

MIT