添加原始otf/ttf字体，并完整编写README

README.md

@@ -0,0 +1,224 @@
+# DRHPS-Translation 仓库
+
+用于存放 **Deltarune - Hypothesis** 汉化项目的所有重要文件。  
+当前仓库适用于游戏版本：**2025-04-02发布的愚人节预览版**。
+
+## 目录结构
+
+### `code-csharp` 目录
+
+存放通过对 `DRHPS/Managed/Assembly-CSharp.dll` 进行反编译得到的全部 C# 源代码，供使用 DnspyEx 修改硬编码文本和逻辑时参考。
+
+- `en_US/`：完整的原始代码，用于参考算法和结构；
+- `zh_CN/` 和 `zh_TW/`：仅包含有**硬编码文本或打字机逻辑改动**的文件，未修改的代码不会放入。
+
+> 💡 使用 DnspyEx 时，可通过搜索类名或字符串快速定位要修改的文件。
+>
+> ⚠️ 注意：由于反编译并非完全无损，可能出现报错，建议尽量 **小范围修改**（只修改方法，不修改整个类）。
+
+---
+
+### `dll-backup` 目录
+
+备份原始与汉化后的 `Assembly-CSharp.dll` 文件，用于版本对比。
+
+- `en_US/`：原始DLL  
+- `zh_CN/` / `zh_TW/`：当前最新的汉化版本DLL
+
+---
+
+### `font` 目录
+
+存放汉化过程中用到的字体资源，用于通过 UABEA 替换字体。
+
+- `original/`：游戏原始字体
+- `processed/`：已嵌入中文字符的字体
+- `ttf-otf/`：可在其他项目中使用的独立字体文件
+
+在基于 TextMeshPro 的 Unity 项目中，字体资源包含以下三部分：
+
+1. `Font*.json`：字体配置信息；
+2. `Font Atlas*.json` 与 `Font Atlas*.png`：字图（字体贴图）；
+3. `Font Material*.json`：材质信息（通常无需修改）。
+
+导入方法：
+- `.json`：通过 UABEA 的 **Import Dump (JSON)** 导入；
+- `.png`：使用 UABEA 的 **Plugin - Edit Texture** 进行替换。
+
+> ⚠️ 建议打开 UABEA 后 **导入两次 JSON 文件**，第一次可能会失败。
+
+---
+
+### `image` 目录
+
+记录所有需要汉化的贴图资源，以及当前的翻译进度。
+
+贴图导入方式：
+1. 使用 UABEA 批量打开 `level0 ~ level50`；
+2. 按 Type 排序，选中所有 `Texture2D`；
+3. 使用 **Plugin - Batch Import**，选择对应语言的目录：
+
+```plaintext
+images/zh_CN/import   # 导入简体中文贴图
+images/zh_TW/import   # 导入繁体中文贴图
+images/en_US/import   # 还原英文贴图
+```
+
+其他子目录用于**标注翻译进度和贴图状态**，具体格式见：`images/标注.txt`。
+
+---
+
+### `strings` 目录
+
+存放通过脚本提取的非硬编码文本（用于翻译和对照）。
+
+- 分为两类：
+  - `dialogue/`：对话文本（Weblate 中的 textmeshpro 模块）
+  - `mtext/`：UI文本、日志文本等（Weblate 中的 mtext 模块）
+
+命名规范说明：
+- `*.json`：原始英文文本，键为 `场景-导入文件-PathID-编号`，值为英文文本；
+- `*-zh_CN.json`：简体中文翻译（空值表示未翻译）；
+- `*-newtext.json`：更新版本中新出现的文本；
+- `*-notfound.json`：更新版本中消失的文本，可用于找回已翻译内容。
+
+👉 所有 json 可通过运行根目录下 `translation-script.py` 中的 `update_translation_json()` 自动生成。
+
+---
+
+### `tasks` 目录
+
+收录汉化过程中的各种标准、规范和注意事项，目前仍在整理中，欢迎协助补充。
+
+---
+
+### `text` 目录
+
+存放可导入游戏内的最终翻译文本（由脚本生成）。结构与 `text/en_US` 保持一致。
+
+导入流程：
+1. 运行脚本中 `import_translation()` 函数；
+2. 使用 UABEA 批量打开 `level0 ~ level50`；
+3. 按 Type 排序，选中所有 **MonoBehaviour** 项；
+4. 使用 **Import Dump - JSON**，选择 `text/zh_CN` 或 `text/zh_TW` 文件夹。
+
+> ⚠️ UABEA 导入 MonoBehaviour 时首次导入可能失败，建议尝试两次以确保成功。
+
+---
+
+### `translation-tools/weblate` 目录
+
+存放从 Weblate 下载的最新翻译内容（ZIP解压后）。
+
+使用说明：
+1. 登录 Weblate，点击项目主页下载翻译 ZIP；
+2. 解压其中的 `drhps/` 文件夹至此目录；
+3. 运行脚本中的 `initialize_translation_json()` 与 `update_translation_json()` 更新本地 `strings` 中的翻译文本。
+
+## 使用方法
+1. **准备工作**
+
+   - 安装依赖：
+     使用Python的包管理工具安装zhconv库，用于将简体中文转换为繁体中文。
+
+     确保当前目录结构完整，尤其是`strings`、`text/en_US`、`translation-tools/weblate`等目录已经存在。
+     
+     > （一般应该都是存在的，写这段是以防万一）
+     > 如果不存在，请创建好对应的文件夹，使用 UABEA 打开游戏资源（level0 ~ level50），按 `Type` 排序，选择所有 `Monobehaviour` 类型资源，并用 `Export dump - JSON` 导出到 `text/en_US`
+
+   - 获取Weblate翻译文本：
+     从Weblate页面下载翻译 ZIP 文件（选择“下载翻译ZIP”），将其中的 `drhps` 目录的所有子文件夹解压至 `translation-tools/weblate` 下。
+
+1. **运行脚本**
+
+   在项目根目录运行主脚本：
+
+   ```bash
+   python translation-script.py
+   ```
+
+   此操作会依次执行以下内容：
+
+   ### （1）生成原始英文文本对照表
+
+   ```python
+   initialize_translation_json()
+   ```
+
+   - 将 `text/en_US` 目录下提取的原始英文文本，整理为 `strings/mtext.json` 和 `strings/dialogue.json` 两个文件。
+   - 其中 `mtext.json` 包含UI元素、系统文本等，`dialogue.json` 则为角色对白等内容。
+
+   ### （2）更新翻译文本
+
+   ```python
+   update_translation_json()
+   ```
+
+   - 读取 `translation-tools/weblate` 中的翻译文件，合并进原始json，生成带翻译的 `strings/*-zh_CN.json` 文件。
+
+   ### （3）同步翻译文件
+
+   ```python
+   os.system("cp -r ...")
+   ```
+
+   - 将更新后的翻译文件复制覆盖回 `translation-tools/weblate` 目录，保持两个目录同步。
+
+   ### （4）生成用于导入的文本文件
+
+   ```python
+   import_translation()
+   ```
+
+   - 根据英文原文和翻译文本，生成可用于UABEA导入的文本，输出至 `text/zh_CN/`。
+
+   ### （5）生成繁体中文文本
+
+   ```python
+   convert_zh_to_tw()
+   ```
+
+   - 自动将简体中文翻译文件转为繁体，输出至 `text/zh_TW/`。
+
+2. **导入游戏**
+
+   - 使用 UABEA 打开游戏资源（level0 ~ level50），按 `Type` 排序，选择所有 `Monobehaviour` 类型资源；
+   - 使用 `Import Dump - JSON` 批量导入 `text/zh_CN` 或 `text/zh_TW` 下的文本；
+   - 若首次导入失败（导入后使用 Edit Data 报错），请立即**重新导入一次**以确保成功。
+
+## 开发者注意事项
+
+- **尽量小范围修改DLL**  
+  在使用Dnspy修改`Assembly-CSharp.dll`时，建议优先修改**方法（Method）级别**而非整个类（Class），避免因逆向还原的不完整性导致报错。
+
+- **类名或方法找不到？**
+  使用DnspyEx的全局搜索功能，查找关键词（如字符串文本、类名、变量名等）定位相关代码。
+
+- **字体资源三件套必须同时导入**
+  修改字体时，务必通过UABEA同时导入 `.json`、`.png` 的三件套（Font.json, Font Atlas.json, Font Atlas.png），否则游戏可能无法正常显示汉字。
+
+- **使用批量导入时注意文件名与格式**
+  UABEA的 `Batch Import` 识别文件名，需保持贴图或文本文件结构、命名与原始资源一致。
+
+---
+
+## 常见问题
+
+### Q: 为什么第一次导入JSON时总是失败？
+
+A:  这通常是UABEA的bug。建议导入失败后**立即导入第二次**，大多数情况第二次可以成功解析。
+
+### Q: 转换后的简中/繁中文本没有效果？
+A:  请检查是否：
+- 导入了正确的语言文件（zh_CN 或 zh_TW）；
+- 修改过的DLL是否被正确替换进游戏目录；
+- 使用的字体资源是否覆盖了所有汉字；
+- 批量导入贴图是否成功（必要时重新导入）。
+
+
+### Q: 脚本跑完但内容没有更新？
+
+A:  请检查：
+- `translation-tools/weblate`目录下的翻译文件是否为**最新导出的版本**；
+- Weblate中的中文翻译是否为空（脚本不会导入空翻译）；
+- 脚本运行中是否有报错输出。

translation-script.py

@@ -18,8 +18,8 @@ def convert_zh_to_tw(path, format):
                     f.write(content_tw)
 
 
-# 递归读取文件夹tmpgui中的所有JSON文件
-def read_json_files(directory, textkeylist):
+# 递归读取文件夹中的所有JSON文件，并导出
+def initialize_translation_json(directory, textkeylist, output_file):
     translation_dict = {}  # 用来存储所有的m_text值
     translation_set = set()
     it = list([1])
@@ -69,10 +69,6 @@ def read_json_files(directory, textkeylist):
                             recursive_search(data, key)
                     except json.JSONDecodeError:
                         print(f"文件 {file_path} 解析错误")
-    return translation_dict
-
-
-def save_translation_dict(translation_dict, output_file):
     with open(output_file, "w", encoding="utf-8") as f:
         json.dump(translation_dict, f, ensure_ascii=False, indent=4)
 
@@ -231,12 +227,13 @@ if __name__ == "__main__":
         "controls",
     ]
 
-    save_translation_dict(
-        read_json_files("text/en_US", translation_key_mtext),
+    initialize_translation_json(
+        "text/en_US",
+        translation_key_mtext,
         "strings/mtext.json",
     )
-    save_translation_dict(
-        read_json_files("text/en_US", ["Text", "Array"]), "strings/dialogue.json"
+    initialize_translation_json(
+        "text/en_US", ["Text", "Array"], "strings/dialogue.json"
     )
     update_translation_json(
         "translation-tools/weblate/dialogue/en.json",