Simple_Python_Work

这是一个个人 Python 小工具集合，里面包含自动化、图像处理、音视频处理、网页/数据处理、工作流脚本和一些本地实验项目。仓库整体更像“工具箱”，每个目录下是一组独立小功能，不一定共用同一套依赖。

快速使用

1. 建议为每个工具或当前任务单独创建虚拟环境。
2. 优先查看子目录里的 requirements.txt，例如 PngToIcon/requirements.txt、NovelDownload/Fanqie-novel-Downloader-main/requirements.txt。
3. 大部分脚本可以直接运行对应的 .py 文件；部分脚本需要先修改输入/输出路径，或准备图片、视频、音频、cookie、邮箱配置等本地数据。
4. build/、dist/、__pycache__/、音频/PDF/网页抓取缓存等运行产物不建议提交，已在 .gitignore 中排除。

目录索引

目录	主要内容	备注
2D/	图片拆分、精灵图切割	PictureBreakToMorePic.py 默认读取 input.png，输出到 output_sprites/
2Dto3D/	2D 视频转多视角 3D 排列视频	2D视频转3D视频.py 默认读取 input.mp4，输出 output.mp4
3D/	3D 立方体、3D 烟花特效	适合图形效果练习
animation/	双窗口打字机式文本展示	speak.py 读取 speech.txt
Auto/	自动点击、刷新、刷视频、CSDN 数据获取、OpenStageAI 自动操作	依赖本地屏幕环境、ADB、cookie 或图片模板
BlenderFunction/	Blender 脚本	高模烘焙低模法线贴图、视口字符画
Draw/	绘图与 GIF 生成	盾牌绘制、图片旋转 GIF
DynamicViewChart_csv/	CSV 动态图表	动态折线图/流动图表效果
GenerateQRcode/	二维码生成器	支持单个和批量生成二维码
Local_AI_website/	DeepSeek/网页抓取和 Selenium 实验	saved pages 属于抓取缓存，不建议提交
LocalTestPy/	本地 Flask 接收服务	用于局域网设备上传文本、JSON、图片、视频、文件
NovelDownload/	番茄小说下载器项目	子项目较完整，包含 GUI、阅读器、EPUB 生成和配置
OtherFunction/	其他图像功能	图片转 ASCII 图像
PDFCreate/	图片合成 PDF	示例是身份证正反面合并，输入图片通常有隐私风险
PngToIcon/	PNG 转 ICO/ICNS/PNG 图标套件	带 PySide6 GUI、批处理、配置管理
QucikFunction/	快速操作脚本	文件复制/重命名、图片处理、取色、目录结构生成等
simulation/	模拟实验	当前主要是占位/本地音频代理文件
Test/	临时测试脚本	作为本地实验目录处理
TTS/	文本转语音、Base64/JSON 音频转换	输出的音频和大文本缓存不建议提交
VideoAndAudio/	音视频时长统计、MP3 变速	依赖本地音视频文件路径
Web/	Streamlit Web UI 示例	AccessibleWeb.py
Widget/	桌面小组件	简单画板
WorkFlow/	自动化工作流	当前包含“每日收集信息发送邮箱”脚本

重点功能清单

自动化与工作流

脚本	功能	配置/输入
Auto/AutoClick.py	根据 click.jpg 在屏幕上查找并自动点击	需要本地截图模板
Auto/AutoClick2.py	记录点击坐标并结合图片识别触发点击	会生成 click_positions.txt
Auto/RefreshF5.py	定时按下 F5 刷新页面	适合保持页面活跃
Auto/FreshVideo.py	通过 ADB 自动刷视频和点赞	需要连接安卓设备
Auto/FreshVideo_windows.py	Windows 环境视频自动操作	依赖本地窗口环境
Auto/CSDNCheck.py	获取 CSDN 文章数据并写入 Excel	需要 CSDN cookie/Referer
Auto/auto_3D_openstageai.py	OpenStageAI 相关自动点击流程	需要 pic/、html/ 等本地资源
WorkFlow/GetMessageSendEmail/GetMessageSendEmail.py	RSS 信息收集、生成汇总/词云并发送邮件	需要 .env 邮箱配置和 prompt.txt

图像、图标、PDF 与 3D

脚本/项目	功能	配置/输入
3D/3DCube.py	可旋转查看的 3D 方块	图形演示
3D/3DVFX.py	简单 3D 烟花粒子特效	图形演示
2D/PictureBreakToMorePic.py	将透明图片中的独立元素切割成小图	input.png
2Dto3D/2D视频转3D视频.py	生成 5x8 多视角排列视频	input.mp4、可选 working.mp4
Draw/EasyDraw.py	绘制美国队长盾牌	Turtle 绘图
Draw/ToGif.py	将图片生成旋转 GIF	image.png
OtherFunction/PictureConvertASCII.py	图片转 ASCII 图像	默认路径需要按本机修改
PDFCreate/IDcardCreate.py	身份证图片矫正、上下拼接并生成 PDF	id1.jpg、id2.jpg
GenerateQRcode/main.py	二维码生成器入口	Tkinter GUI
PngToIcon/main.py	PNG 转图标工具入口	PySide6 GUI
BlenderFunction/HighMeshToLowNormalPNG.py	Blender 高模到低模法线贴图烘焙	Blender 内运行
BlenderFunction/StringInMesh.py	Blender 视口转字符画	Blender 内运行

音视频与 TTS

脚本	功能	配置/输入
VideoAndAudio/mp3LengthGet.py	统计文件夹下 MP3 总时长	本地文件夹路径
VideoAndAudio/mp3SpeedChange.py	批量调整 MP3 播放速度	本地输入/输出文件夹
VideoAndAudio/ViedoLengthGet.py	统计文件夹下视频总时长	本地文件夹路径
TTS/edgeTTS.py	使用 Edge TTS 生成语音	文本与输出文件名
TTS/Base64ToMp3.py	Base64 音频转 WAV/MP3	audio_base64.txt
TTS/JsonToMp3.py	流式 JSON 音频数据转 WAV	audio_json.txt
animation/speak.py	双窗口按角色逐字显示台词	speech.txt

Web、数据与网络

脚本/项目	功能	配置/输入
Web/AccessibleWeb.py	Streamlit 基础表单界面	streamlit run Web/AccessibleWeb.py
DynamicViewChart_csv/DynamicViewChart_csv.py	动态展示 CSV 图表	CSV 数据
Local_AI_website/deepseek_get_html.py	抓取并格式化网页 HTML	输出到 saved_pages/
Local_AI_website/deepseek_chat_simulate_API_get.py	模拟 DeepSeek Chat 接口请求	token/cookie 请只放本地环境
Local_AI_website/dynamic.py	Selenium 自动打开 DeepSeek 并交互	需要浏览器驱动环境
LocalTestPy/t_local_machine.py	Flask 本地接收服务	运行后监听 0.0.0.0:5445
NovelDownload/Fanqie-novel-Downloader-main/gui.py	番茄小说下载器 GUI	会生成 cookie、配置和下载内容

快速操作脚本

脚本	功能
QucikFunction/FindSuffixCopy.py	遍历文件夹，按后缀复制文件
QucikFunction/MoreDeleteRenameFile.py	批量按正则删除/重命名图片文件
QucikFunction/GenerateSmallPicture.py	将大图生成 4K/2K/1K，并给 1K 图加水印
QucikFunction/PictureMoreDispose.py	批量生成氛围感图片变体
QucikFunction/colorGet.py	获取图片或屏幕颜色信息
QucikFunction/getdata.py	从 HTML 中提取聊天内容并输出 JSON
QucikFunction/文件夹结构生成工具.py	Tkinter 目录结构生成器
QucikFunction/SimpleTimer.py、QucikFunction/write_one.py	当前为空文件/占位脚本

敏感配置与提交建议

以下内容不建议提交或推送，已经在 .gitignore 中加入规则：

位置/类型	风险	建议
WorkFlow/GetMessageSendEmail/.env	包含 SMTP、邮箱账号、授权码、字体路径等本地配置	保留在本机，参考 .env.example
Local_AI_website/deepseek_chat_simulate_API_get.py	运行时需要 token/cookie/session	代码从环境变量读取，真实值不要入库
Auto/CSDNCheck.py	运行时需要 CSDN cookie/Referer 和可选签名头	代码从环境变量读取，真实值不要入库
NovelDownload/**/cookie.json、user_config.json、chapter.json	登录/阅读/下载状态	只保留本地
PDFCreate/id1.jpg、PDFCreate/id2.jpg、PDFCreate/output.pdf	可能包含身份证或个人图片	只保留本地
Local_AI_website/saved_pages/、*_prettified.html	网页抓取缓存，可能混入个人状态	不提交
TTS/audio_base64.txt、TTS/audio_json.txt、TTS/*.mp3、TTS/*.wav	大体积运行产物	不提交
build/、dist/、__pycache__/	打包和解释器缓存	不提交

auto_3D_openstageai.spec 和其他 .spec 文件是打包配置，当前没有在 .gitignore 中屏蔽；如果后续确定不需要共享，也可以再加入忽略规则。

环境变量模板

仓库根目录提供了 .env.example。复制为 .env 后，只填写当前脚本需要的变量；真实 .env 已被 .gitignore 排除。

常用变量分组如下：

# CSDN
CSDN_TOTAL_ARTICLES=
CSDN_ID=
CSDN_COOKIES=
CSDN_REFERER=

# DeepSeek
DEEPSEEK_API_TOKEN=
DEEPSEEK_COOKIE=
DEEPSEEK_CHAT_SESSION_ID=

# 邮箱工作流
SMTP_SERVER=smtp.qq.com
SMTP_PORT=465
SENDER_EMAIL=
SENDER_PASS=
RECEIVER_EMAIL=
FONT_PATH=C:/Windows/Fonts/simhei.ttf
SCHEDULE_TIME=06:00

# 本地文件路径类工具
ASCII_INPUT_IMAGE=
SMALL_PICTURE_INPUT=
RENAME_FOLDER_PATH=
MP3_DIRECTORY=
VIDEO_DIRECTORY=

WorkFlow/GetMessageSendEmail/ 目录下也有单独的 .env.example，适合只运行邮件工作流时复制使用。

已有博客说明

功能	链接
3D 方块	Python功能制作之3D方块
3D 特效	Python功能制作之简单的3D特效
CSDN 文章数据获取	Python功能制作之获取CSDN所有发布文章的对应数据
Blender 字符画	通过Python脚本实现字符画
动态折线图	Python功能制作之流动折线图
图片转字符图片	Python功能制作之图片转换为字符图片
按后缀复制文件	Python功能制作之按后缀批量复制文件
批量重命名	Python功能制作之正则表达式批量删除并重命名文件
Streamlit Web UI	Python功能制作之使用streamlit做一个简单的WebUI
简单绘画板	Python功能制作之简单的绘画板

新增工具记录模板

以后新增小功能时，可以按这个小表补到对应分类里：

| `目录/脚本.py` | 这个工具做什么 | 需要哪些输入/配置 |

如果功能开始变复杂，建议在对应子目录再补一个单独的 README.md，主 README 只保留入口索引。