json翻译path匹配到的对象的中所有字符串

docutranslate/translator/ai_translator/json_translator.py

@@ -2,7 +2,7 @@
 # SPDX-License-Identifier: MPL-2.0
 import json
 from dataclasses import dataclass
-from typing import Self, Any
+from typing import Self, Any, Tuple, List
 
 from jsonpath_ng.ext import parse
 
@@ -36,28 +36,78 @@ class JsonTranslator(AiTranslator):
                 glossary_dict=config.glossary_dict
             )
             self.translate_agent = SegmentsTranslateAgent(agent_config)
-        self.jsonpaths = config.json_paths
+        self.json_paths = config.json_paths
+        if not self.json_paths:
+            self.json_paths = ["$.*"]  # 翻译所有字符串
 
-    def _extract_matches(self, content: dict) -> list[Any]:
+    def _get_key_or_index_from_path(self, path) -> Any:
+        """从jsonpath_ng的Path对象中提取键或索引。"""
+        if hasattr(path, 'fields') and path.fields:
+            return path.fields[0]
+        if hasattr(path, 'index'):
+            return path.index
+        return None
+
+    def _collect_strings_for_translation(self, content: dict) -> Tuple[List[str], List[Tuple[Any, Any]]]:
         """
-        根据 self.jsonpaths 从 JSON 内容中提取所有匹配项。
+        根据jsonpath查找匹配项，并递归地从中收集所有字符串以进行翻译。
-        与原始代码不同，这里直接返回 Match 对象列表，它同时包含了值和路径信息。
+        为了防止重复，会跟踪每个字符串的精确位置。
+
+        返回:
+            - original_texts: 一个包含所有待翻译字符串的列表。
+            - update_targets: 一个包含更新信息的目标列表，每个元素为 (container, key_or_index)。
         """
+        original_texts = []
+        update_targets = []
+        # 使用 (id(container), key_or_index) 来唯一标识一个位置，防止重复添加
+        seen_targets = set()
+
+        # 辅助递归函数，用于遍历json对象
+        def _traverse(node: Any, container: Any, key_or_index: Any):
+            # 如果当前节点是字符串，并且其位置尚未被记录
+            target_id = (id(container), key_or_index)
+            if isinstance(node, str):
+                if target_id not in seen_targets:
+                    original_texts.append(node)
+                    update_targets.append((container, key_or_index))
+                    seen_targets.add(target_id)
+            # 如果是字典，则遍历其所有子节点
+            elif isinstance(node, dict):
+                for k, v in node.items():
+                    _traverse(v, node, k)
+            # 如果是列表，则遍历其所有子节点
+            elif isinstance(node, list):
+                for i, item in enumerate(node):
+                    _traverse(item, node, i)
+
+        # 1. 查找所有顶层匹配项
         all_matches = []
-        for path_str in self.jsonpaths:
+        for path_str in self.json_paths:
-            path_expr = parse(path_str)
+            jsonpath_expr = parse(path_str)
-            matches = path_expr.find(content)
+            all_matches.extend(jsonpath_expr.find(content))
-            all_matches.extend(matches)
-        return all_matches
 
-    def _update_content_with_translations(self, content: dict, matches: list[Any], translated_texts: list[str]):
+        # 2. 遍历匹配项并启动递归收集
+        for match in all_matches:
+            parent = match.context.value if match.context else None
+            key_or_index = self._get_key_or_index_from_path(match.path)
+
+            # 直接在匹配到的值上启动遍历
+            _traverse(match.value, parent, key_or_index)
+
+        return original_texts, update_targets
+
+    def _apply_translations(self, update_targets: List[Tuple[Any, Any]], translated_texts: List[str]):
         """
         使用翻译后的文本更新原始JSON内容。
         """
-        # 使用 zip 将每个匹配项与其对应的翻译文本配对
+        if len(update_targets) != len(translated_texts):
-        for match, translated_text in zip(matches, translated_texts):
+            raise ValueError("The number of translation targets does not match the number of translated texts.")
-            # match.full_path 包含了更新原始 content 所需的精确位置信息
+
-            match.full_path.update(content, translated_text)
+        for target, text in zip(update_targets, translated_texts):
+            container, key_or_index = target
+            # 确保容器和键/索引是有效的，然后执行更新
+            if container is not None and key_or_index is not None:
+                container[key_or_index] = text
 
     def translate(self, document: Document) -> Self:
         """
@@ -65,55 +115,49 @@ class JsonTranslator(AiTranslator):
 
         流程:
         1. 解析输入的JSON文档。
-        2. 提取所有符合jsonpath规则的匹配项 (Match对象)。
+        2. 根据jsonpath找到匹配对象，并递归遍历它们以提取所有字符串。
-        3. 从匹配项中获取原始文本，并批量发送进行翻译。
+        3. 批量发送提取的字符串进行翻译。
         4. 将翻译回来的文本根据其原始位置，更新回JSON对象中。
-        5. 将更新后的 content 写回 document
+        5. 将更新后的 content 写回 document。
         """
         content = json.loads(document.content.decode())
 
-        # 步骤 1: 提取所有需要翻译的匹配项
+        # 步骤 1: 提取所有需要翻译的字符串及其位置
-        all_matches = self._extract_matches(content)
+        original_texts, update_targets = self._collect_strings_for_translation(content)
 
-        if not all_matches:
+        if not original_texts:
-            # 如果没有找到任何内容，则无需执行任何操作
             return self
 
-        original_texts = [match.value for match in all_matches]
         if self.glossary_agent:
             self.glossary_dict_gen = self.glossary_agent.send_segments(original_texts, self.chunk_size)
             if self.translate_agent:
                 self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+
         # 步骤 2: 批量翻译提取出的文本
         if self.translate_agent:
             translated_texts = self.translate_agent.send_segments(original_texts, self.chunk_size)
         else:
             translated_texts = original_texts
-        # 健壮性检查：确保翻译回来的项目数量与发送的一致
+
         if len(original_texts) != len(translated_texts):
             raise ValueError("翻译服务返回的项目数量与发送的数量不匹配。")
 
         # 步骤 3: 将翻译结果写回原始JSON对象
-        self._update_content_with_translations(content, all_matches, translated_texts)
+        self._apply_translations(update_targets, translated_texts)
 
-        # 更新原始 document 对象的内容（可选，但良好实践）
+        document.content = json.dumps(content, ensure_ascii=False, indent=2).encode('utf-8')
-        document.content = json.dumps(content, ensure_ascii=False).encode('utf-8')
 
         return self
 
-    # todo:增加协程粒度
     async def translate_async(self, document: Document) -> Self:
         content = json.loads(document.content.decode())
 
-        # 步骤 1: 提取所有需要翻译的匹配项
+        # 步骤 1: 提取所有需要翻译的字符串及其位置
-        all_matches = self._extract_matches(content)
+        original_texts, update_targets = self._collect_strings_for_translation(content)
 
-        if not all_matches:
+        if not original_texts:
-            # 如果没有找到任何内容，则无需执行任何操作
             return self
 
-        original_texts = [match.value for match in all_matches]
-
         if self.glossary_agent:
             self.glossary_dict_gen = await self.glossary_agent.send_segments_async(original_texts, self.chunk_size)
             if self.translate_agent:
@@ -124,13 +168,12 @@ class JsonTranslator(AiTranslator):
             translated_texts = await self.translate_agent.send_segments_async(original_texts, self.chunk_size)
         else:
             translated_texts = original_texts
-        # 健壮性检查：确保翻译回来的项目数量与发送的一致
+
         if len(original_texts) != len(translated_texts):
             raise ValueError("翻译服务返回的项目数量与发送的数量不匹配。")
 
         # 步骤 3: 将翻译结果写回原始JSON对象
-        self._update_content_with_translations(content, all_matches, translated_texts)
+        self._apply_translations(update_targets, translated_texts)
 
-        # 更新原始 document 对象的内容（可选，但良好实践）
+        document.content = json.dumps(content, ensure_ascii=False, indent=2).encode('utf-8')
-        document.content = json.dumps(content, ensure_ascii=False).encode('utf-8')
         return self

更新日志.txt

@@ -4,6 +4,7 @@ v1.3.1版 2025.8.28
 优化
 - 优化前端显示效果
 - 优化网址在cmd中的显示时机
+- json工作流将翻译json_path匹配对象内的所有字符串
 修复
 - 修复自动生成的术语表转csv附件下载时出现的问题
 ----------------------------------------