# doc

**Repository Path**: liuweishow1/doc

## Basic Information

- **Project Name**: doc
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-08
- **Last Updated**: 2026-07-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文档整理助手

一个基于 Vue 前端和 Python Flask 后端的文档整理工具，支持拖拽上传文件/文件夹，自动整理并下载结果。

## 功能特性

- 拖拽或选择文件/文件夹上传
- 自动整理文档到指定目录结构
- 实时进度显示
- 整理完成后下载 ZIP 包
- 复用现有整理逻辑和配置

## 安装依赖

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

# 安装 Node.js 依赖
npm install
```

或者使用一键安装脚本：

```bash
npm run install-deps
```

## 启动应用

### 一键启动前后端

```bash
npm start
```

这将：
1. 检查端口 8000 (后端) 和 3000 (前端) 是否可用
2. 如果端口被占用，会提示错误并退出
3. 并行启动后端 (Flask) 和前端 (HTTP 服务器)

### 单独启动

```bash
# 只启动前端 (用于开发)
npm run dev

# 只启动后端
npm run backend
```

## 使用说明

1. 打开浏览器访问 `http://localhost:3000`
2. 拖拽文件或文件夹到上传区域，或点击选择文件
3. 点击"开始整理"按钮
4. 等待整理完成，查看进度
5. 下载整理结果 ZIP 包

## 配置

- 后端配置：`config.json`
- 输出目录：默认 `/Users/weiliu/Desktop/organized-docs`
- 端口：后端 8000，前端 3000

## 技术栈

- 前端：Vue 3 + HTML/CSS/JS
- 后端：Python Flask
- 整理逻辑：复用 `scripts/organize.py`