Python_Tools/UserGuide.txt at main · CrimsonSeraph/Python_Tools · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
Python Tools
	一系列通过Python实现的小工具集合

	首先请确保支持python运行环境，并安装所需依赖库
——————————————————————————————————————————————
"Word_To_Html_Or_Js.py" - Word文档转HTML/JS、CSS文件

	将Word文档(.docx格式)转换为HTML(.html)/JavaScript(.js)和CSS(.css)文件，便于在网页中使用Word文档内容。

功能/注意事项
-  提取文本内容到HTML/JS文件
-  提取样式信息到CSS文件
-  保持基本的格式结构

-  仅支持 .docx 格式
-  生成后请手动检查和调整样式以确保符合需求

使用方法

-  安装额外依赖库:
pip install python-docx

- 使用
直接运行脚本，按照提示操作。
——————————————————————————————————————————————
"Picture_Batch_Conv.py" - 图片批量格式转换工具

	支持多种图片格式之间的批量转换，包括PNG、WEBP、JPG、JPEG、JPE、TIF、TIFF、BMP等格式。

功能/注意事项
-  支持多种图片格式的相互转换
-  自动创建输入（input_images）和输出（converted_images）文件夹
-  批量处理文件夹中的所有图片文件
-  显示详细的转换进度和统计信息
-  智能处理透明通道（转换为JPG等格式时自动填充白色背景）
-  跳过相同格式的文件避免重复处理
-  提供清空输入文件夹选项便于连续处理多批图片

-  需要安装Pillow库
-  输入文件夹中不支持的文件会被跳过并提示
-  转换前请确保图片文件具有读取权限
-  JPEG格式不支持透明通道，转换时会自动处理

使用方法

-  安装额外依赖库:
pip install Pillow

- 使用
1. 直接运行脚本
2. 将需要转换的图片放入自动创建的"input_images"文件夹
3. 根据提示选择目标格式（如png、jpg、webp等）
4. 查看转换进度和结果统计
5. 可选择继续转换下一批图片或清空输入文件夹

- 支持的格式转换示例：
  PNG → JPG, WEBP → PNG, BMP → WEBP 等
- 自动处理特性：
  透明PNG转JPG时自动添加白色背景
  保持图片质量（WEBP默认80，JPG默认95）
——————————————————————————————————————————————
"Batch_Decompress.py" - 批量解压工具

	批量解压多种格式的压缩文件，支持ZIP、RAR、7z等常见格式，能够自动识别分段压缩包并合并解压。

功能/注意事项
-  支持ZIP、RAR、7z等常见压缩格式
-  自动识别并处理分段压缩包（如.001、.z01等）
-  支持密码保护的压缩文件，遇到密码时暂停并提示输入
-  批量验证压缩包完整性，有问题文件会被跳过并提示
-  保持原始文件结构，每个压缩包解压到独立的同名文件夹
-  分段压缩包合并为一个整体文件夹输出
-  友好的控制台交互界面，支持循环操作
-  可选择使用现有文件夹或在程序目录创建临时文件夹

-  需要安装rarfile和py7zr库
-  RAR文件需要系统级unrar工具支持
-  建议在处理重要文件前先备份
-  密码输入错误超过3次会自动跳过该文件

系统要求
-  Windows: 需要安装WinRAR或下载unrar工具
-  macOS: 需要安装Homebrew后执行 brew install unrar
-  Linux (Ubuntu/Debian): 需要执行 sudo apt-get install unrar

使用方法

-  安装额外依赖库:
pip install rarfile py7zr

- 使用
1. 直接运行脚本
2. 选择输入文件夹方式：
   - Y: 选择现有文件夹作为输入目录
   - N: 在程序目录创建临时输入文件夹
3. 选择输出文件夹方式：
   - Y: 选择现有文件夹作为输出目录
   - N: 在程序目录创建临时输出文件夹
4. 程序自动扫描并验证所有压缩包完整性
5. 显示问题文件列表（如有）并确认是否继续
6. 开始批量解压，遇到密码保护文件时：
   - Y: 在控制台输入密码
   - N: 跳过此文件
   - quit: 终止当前解压任务
7. 查看解压结果统计（成功/失败数量）
8. 可选择继续新的解压任务或退出程序

- 支持的压缩格式：
  ZIP (.zip), RAR (.rar), 7z (.7z), 分段压缩包 (.001, .z01, .r00, .7z.001等)
- 自动处理特性：
  分段压缩包自动识别并合并解压
  密码保护文件提供多次重试机会
  保持原始目录结构，便于管理
——————————————————————————————————————————————