文本性别称谓批量替换工具 (Yuri Turning Script)

本项目包含一个 Python 脚本 (yuri_turning.py)，旨在帮助用户批量替换指定文件夹内所有 .txt 文件中的男性相关称谓及词汇为女性相关称谓及词汇，转为更符合个人阅读偏好（百合）的视角。

主要功能

• 批量文本替换：自动处理指定文件夹内的所有 .txt 文件。
• 高度自定义替换规则：用户可以在脚本中轻松定义和修改需要查找及替换的词汇对列表。替换规则的顺序非常重要，会影响最终替换结果。
• 灵活的文件夹指定：
  • 默认尝试定位用户桌面上的“新建文件夹”作为目标处理文件夹。
  • 用户可以轻松修改脚本，手动指定任何其他文件夹路径。
• 支持子文件夹处理：用户可以选择是否递归处理指定文件夹内所有子文件夹中的 .txt 文件。
• 自定义文件编码：支持用户指定文件的读写编码，以适应不同来源的文本文件（脚本在读取文件时会依次尝试 utf-8、gbk 以及 utf-16 等常用编码）。

运行环境

• Python 3.x

配置说明

在使用此脚本前，您必须根据您的需求修改 yuri_turning.py 文件开头的用户配置区域。

1. 目标文件夹路径 (folder_path)：

   • 脚本会尝试自动获取您桌面上的“新建文件夹”路径。
   • 如果自动获取失败，或者您希望处理其他位置的文件夹，您需要手动修改 desktop_path 变量，或者直接为 folder_path 变量赋值。
   • Windows 用户路径示例：folder_path = r"C:\Users\你的用户名\Documents\我的小说" (注意前面的 r 用来防止反斜杠被错误解析)。
   • macOS 或 Linux 用户路径示例：folder_path = r"/Users/你的用户名/Documents/我的小说"
   • 请确保您指定的文件夹真实存在。

2. 替换规则列表 (replacements)：

   • 这是一个包含多个元组 (旧词, 新词) 的列表。脚本会按照列表中定义的顺序依次进行替换。
   • 示例：replacements = [("他", "她"), ("先生", "女士"), ("儿子", "女儿")]
   • 重要：请仔细检查并根据您的需求调整此列表。某些词的替换顺序会显著影响结果（例如，先替换“老爷”为“大人”，再替换“爷爷”为“奶奶”，与反过来的顺序结果可能不同）。提供的脚本中已经考虑了部分顺序问题，您可以继续优化。

3. 是否处理子文件夹 (include_subfolders)：

   • 设置为 True：脚本会查找并处理主目标文件夹及其所有子文件夹内的 .txt 文件。
   • 设置为 False：脚本仅处理主目标文件夹根目录下的 .txt 文件。
   • 默认为 False。

4. 文件编码 (file_encoding)：

   • 指定脚本读写 .txt 文件时使用的编码。
   • 默认为 'utf-8'，这是一个广泛使用的编码。
   • 如果您的文本文件主要来自简体中文Windows环境，它们可能是 'gbk' 编码。若处理时出现乱码，请尝试修改此项为 'gbk' 或文本实际的编码。

使用方法

1. 环境准备：确保您的电脑上已安装 Python 3.x 环境。
2. 获取脚本：下载本项目中的 yuri_turning.py 脚本文件。
3. 修改配置：（关键步骤） 打开 yuri_turning.py 文件，仔细阅读并修改文件开头的“用户配置区域”，特别是 folder_path 和 replacements 列表。
4. 准备文本文件：将您需要处理的 .txt 文件或包含这些文件的文件夹，放置到您在脚本中配置的 folder_path 所指向的位置。
5. 运行脚本：
   • 可以通过命令行运行：打开终端（Windows上是命令提示符或PowerShell），进入脚本所在目录，然后执行 python yuri_turning.py。
   • 如果您使用带有Python支持的编辑器（如VS Code、PyCharm等），可以直接在编辑器中运行脚本。
6. 检查结果：脚本运行完毕后，目标文件夹中的 .txt 文件内容会被直接修改。

!!! 重要注意事项 !!!

• 数据备份警告：本脚本会直接修改原始 .txt 文件内容。在运行脚本前，强烈建议您备份所有需要处理的原始文件或整个文件夹，以防发生意外或不满意的替换结果。
• 替换局限性：脚本执行的是基于字符串的机械查找和替换。因此，在某些复杂语境下，替换结果可能不够自然、产生歧义，甚至出现错误。请对替换后的文本进行审阅。
• 尊重版权：请尊重原始内容的版权。本工具主要用于个人学习、研究或提升个人阅读体验，请勿用于非法传播或侵犯他人权益的活动。

许可证 (License)

本项目采用 MIT 许可证。详情请参阅项目中的 LICENSE 文件。

---