# tkfile

**Repository Path**: yzhh/tkfile

## Basic Information

- **Project Name**: tkfile
- **Description**: ftp client
- **Primary Language**: Python
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-22
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# macaws

FTP 客户端工具，支持命令行和图形界面两种使用方式。

## 功能特性

### FTPClient（命令行客户端）

- **连接管理**：支持连接 FTP 服务器，支持自定义端口和编码
- **文件操作**：
  - 上传文件（支持本地路径到远程路径的映射）
  - 下载文件（支持远程路径到本地路径的映射）
  - 删除文件/目录
  - 重命名文件/目录
  - 创建目录和文本文件
- **目录操作**：
  - 浏览文件列表
  - 切换目录
  - 查看当前目录
- **文件预览**：支持读取文件字节流进行预览
- **连接管理**：安全断开连接

### FTPGUI（图形界面客户端）

- **连接界面**：输入服务器地址、端口、用户名、密码进行连接
- **文件浏览**：
  - 树形展示 FTP 服务器上的文件和目录
  - 支持双击进入目录
  - 支持右键菜单操作
  - 支持返回上级目录
  - 显示文件大小和类型
- **文件操作**：
  - 上传文件到服务器
  - 从服务器下载文件
  - 预览文本文件（自动检测编码，支持 UTF-8 和 UTF-16）
  - 创建新文件夹
  - 创建新文本文件
  - 删除文件和目录
  - 重命名文件和目录
- **日志显示**：显示操作日志和状态信息

## 环境要求

- Python 3.x
- Tkinter（用于图形界面）

## 安装教程

1. 确保已安装 Python 3.x
2. 直接运行 `python main.py` 即可启动图形界面

## 使用说明

### 图形界面模式

运行程序后：
1. 在连接面板填写 FTP 服务器地址、端口（默认 21）、用户名和密码
2. 点击"连接"按钮连接服务器
3. 连接成功后可以在文件列表中浏览和操作文件
4. 双击文件夹进入，双击文件预览内容
5. 使用右键菜单进行更多操作

### 命令行模式

```python
from main import FTPClient

# 创建客户端实例
client = FTPClient(host="ftp.example.com", port=21, encoding="utf-8")

# 连接服务器
client.connect(username="your_username", password="your_password")

# 列出文件
files = client.list_files()
print(files)

# 上传文件
client.upload_file(local_path="/local/file.txt", remote_path="/remote/file.txt")

# 下载文件
client.download_file(remote_path="/remote/file.txt", local_path="/local/file.txt")

# 切换目录
client.change_directory("/some_directory")

# 创建目录
client.create_directory("/new_directory")

# 删除文件
client.delete_file("/file.txt")

# 断开连接
client.disconnect()
```

## 项目结构

```
tkfile/
├── main.py          # 主程序文件，包含 FTPClient 和 FTPGUI 类
├── README.md        # 说明文档
└── LICENSE         # 许可证文件
```

## 许可证

本项目仅供学习和研究使用。