# fileseq

**Repository Path**: weekend/fileseq

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-14
- **Last Updated**: 2026-04-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 文件监控重命名工具 (fileseq)

## 功能说明

该脚本监控指定目录中新增的文件，在1分钟内将其移动到目标目录，并按照四位数字序列进行重命名。重命名规则是根据目标目录中当前最大编号自增。

## 系统要求

- Python 3.7+
- Windows / Linux / macOS

## 安装依赖

### 1. 安装Python包

在项目目录运行以下命令安装所需的依赖：

```bash
pip install -r requirements.txt
```

或单独安装：

```bash
pip install watchdog>=3.0.0
pip install tomli>=2.0.0  # Python 3.11之前版本需要
```

### 2. 配置文件

编辑 `config.toml` 文件，配置以下参数：

```toml
[monitor]
# 监控的源目录（程序会监听这个目录的新文件）
src_dir = "D:\\Snipaste"

# 目标目录（新文件会被移动到这里）
dst_dir = "D:\\Screenshots"

# 最大等待时间（秒）- 程序会等待文件写入完成
wait_time = 60
```

## 运行

### 启动监控服务

```bash
python fileseq.py
```

程序会输出：
```
开始监听...
```

### 工作流程

1. 程序启动后，开始监听 `src_dir` 目录
2. 新文件出现时，程序等待文件写入完成（最多等待 `wait_time` 秒）
3. 文件写入完成后，自动移动到 `dst_dir` 目录
4. 文件被重命名为四位数字格式（如：`0001`, `0002` 等），扩展名保持不变
5. 编号基于目标目录中当前最大编号自增

### 停止监控

按 `Ctrl + C` 停止程序

## 示例

假设配置如下：
- 监听目录：`D:\Snipaste`
- 目标目录：`D:\Screenshots`（当前有文件 `0001.png`, `0002.png`）

当新文件 `screenshot.png` 出现在 `D:\Snipaste` 时：
1. 程序检测到新文件
2. 等待文件写入完成
3. 将文件移动到 `D:\Screenshots` 并重命名为 `0003.png`

## 故障排除

### 错误：`需要 tomli 库`

**解决方案**：运行 `pip install tomli`

### 错误：`配置文件不存在`

**解决方案**：确保 `config.toml` 文件与 `fileseq.py` 在同一目录

### 文件没有被处理

1. 检查 `config.toml` 中的路径是否正确
2. 检查是否有文件读写权限
3. 根据需要调整 `wait_time` 参数（某些场景可能需要更长的等待时间）

## 日志输出

```
开始监听...
检测到新文件: D:\Snipaste\screenshot.png
移动并重命名为: D:\Screenshots\0001.png
```