feat: add extractor

Author: black-06

ReadMe.md

@@ -25,6 +25,56 @@ python ddcs.py
 ```
 注意：请务必使用管理员权限启动终端。
 
+## 自动提取 (Beta)
+
+通过正则和简单的代码分析, 自动提取出 Docker Desktop 页面中出现的文本,
+并保存到 [extract_config.py](./lib/extract_config.py).
+
+### 对于使用者
+
+目前自动提取翻译属于 Beta 状态, 因此需要在使用 ddcs.py 时显式地声明使用 v2, 即
+
+```bash
+python ddcs.py --v2
+```
+
+### 对于翻译者 & 开发者
+
+1. 运行自动提取 (仅在 Docker Desktop 发布新版本后需要)
+
+    ```shell
+    # 默认情况下与 ddcs.py 一致, 自动寻找本机 Docker Desktop app.asar 并解包
+    python ddcs_extract.py
+    ```
+   或
+    ```shell
+    # path 参数为手动解包 asar 之后的路径 
+    python ddcs_extract.py --path xxx
+    ```
+2. 进行翻译
+
+   在 [extract_config.py](./lib/extract_config.py) 中的 config 是一个元组列表, 即 `[(英文, 中文), ...]`. 运行自动提取后,
+   新增的元组项包含一个英文文本, 和一个为空字符串(`""`)的中文文本, 请在 [extract_config.py](./lib/extract_config.py)
+   搜索空字符串并进行翻译.
+
+   **注意事项**:
+    - 英文文本可能为包含 js 变量的模板字符串, 如 `Images (${c.images.count})`, 翻译后的中文应当保留变量, 即
+      `镜像（${c.images.count}）`
+    - 英文文本可能为包含替换字段(`{0},{1},etc.`)的格式化字符串,如 `Select {0} in the {1} column to see it running.`,
+      翻译后的中文应当保留替换字段, 即`在 {1} 列选择 {0} 以查看其运行情况`. 如果替换字段遗漏, 在替换阶段也会有警告日志输出.
+    - 对于不需要翻译的项目, **请不要删除**, 而是将中文值设为 `None`, 如 `("Python", None)`
+    - 对于没有自动提取的文本, 请添加到 [extract_config_manually.py](./lib/extract_config_manually.py) 中
+
+3. 验证翻译
+
+    ```bash
+    python ddcs.py --v2
+    ```
+   替换后启动 Docker Desktop, 验证各个页面. 因为自动提取显然不可能足够精准, 因此可能会:
+    - 遗漏部分内容. 表现: 某些地方仍为英文; 解决方法: 添加到 extract_config_manually.py 或者优化 extract.py
+    - 错误提取. 表现: Docker Desktop 页面出现报错; 解决方法: 根据报错定位错误文本并修复 (大多出现在
+      extract_config_manually 中, 如漏掉引号等)
+
 ## 更多问题？
 有问题的可以扫码加群咨询。
 ![](images/1.jpg)

ddcs.py

@@ -4,10 +4,12 @@
 #
 # @Time    : 2024/8/9 下午4:17
 # @Author  : ASXE
-
+import argparse
 import time
+from pathlib import Path
 
 from common import log
+from lib.extract import replace
 from lib.processor import DDProcessor, FileProcessor
 
 
@@ -43,7 +45,25 @@ def run(root_path, config_path):
     DDProcessor(False)
 
 
+@cost_time
+def run_v2(root_path: str):
+    log.info("脚本已启动...")
+    time.sleep(1)
+
+    DDProcessor(True)
+    log.info("汉化开始")
+    replace(Path(root_path))
+    DDProcessor(False)
+
+
 if __name__ == "__main__":
-    root_path = './app/build/'
-    config_path = './config.json'
-    run(root_path, config_path)
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--v2", action="store_true")
+    args = parser.parse_args()
+
+    root_path = "./app/build/"
+    config_path = "./config.json"
+    if args.v2:
+        run_v2(root_path)
+    else:
+        run(root_path, config_path)

ddcs_extract.py

@@ -0,0 +1,17 @@
+import argparse
+from pathlib import Path
+
+from lib.extract import generate_config
+from lib.processor import DDProcessor
+
+if __name__ == "__main__":
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--path", type=str, default=None)
+    args = parser.parse_args()
+
+    if args.path is None:
+        DDProcessor(True)
+        path = Path("./app/build")
+    else:
+        path = Path(args.path)
+    generate_config(path)