AiTranslatorConfig添加skip_translate参数

docutranslate/static/i18nData.json

@@ -52,7 +52,7 @@
     "chunkSizeLabel": "分块大小",
     "resetBtn": "重置",
     "concurrentLabel": "并发数",
-    "glossaryGenTitle": "5. 术语表",
+    "glossaryGenTitle": "术语表",
     "glossaryLabel": "术语表 (可选)",
     "glossaryHelp": "选择一个或多个CSV文件。文件需包含'src'和'dst'两列标题，分别代表原文和译文。",
     "viewGlossaryBtn": "查看术语表",
@@ -206,7 +206,7 @@
     "chunkSizeLabel": "Chunk Size",
     "resetBtn": "Reset",
     "concurrentLabel": "Concurrency",
-    "glossaryGenTitle": "5. Glossary",
+    "glossaryGenTitle": "Glossary",
     "glossaryLabel": "Glossary (Optional)",
     "glossaryHelp": "Select one or more CSV files. Files must have 'src' and 'dst' headers, representing source and destination text respectively.",
     "viewGlossaryBtn": "View Glossary",

docutranslate/static/index.html

@@ -1 +1 @@
-<!DOCTYPE html>
<html lang="zh-CN" data-bs-theme="auto">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">

    <title data-i18n-title="pageTitle">DocuTranslate - 交互式文档翻译</title>
    <link rel="icon" href="/static/favicon.ico" type="image/x-icon">
    <!-- Bootstrap CSS -->
    <link href="/static/bootstrap.css" rel="stylesheet" crossorigin="anonymous">
    <!-- Bootstrap Icons -->
    <link rel="stylesheet" href="/static/bootstrap-icons.css">

    <style>
        body {
            background-color: var(--bs-body-bg);
        }

        .main-container {
            display: flex;
            flex-direction: column;
            height: 100vh;
            padding-top: 1rem;
            padding-bottom: 1rem;
        }

        .settings-panel {
            height: calc(100vh - 2rem);
            overflow-y: auto;
            padding-right: 15px; /* for scrollbar */
        }

        .task-area {
            height: calc(100vh - 2rem);
            overflow-y: auto;
        }

        .task-card {
            transition: all 0.3s ease-in-out;
        }

        .task-id-placeholder {
            color: var(--bs-secondary-color);
            font-style: italic;
        }

        .log-area {
            height: 150px;
            background-color: var(--bs-tertiary-bg);
            border: 1px solid var(--bs-border-color);
            border-radius: .375rem;
            font-family: monospace;
            font-size: 0.8rem;
            padding: 10px;
            overflow-y: auto;
            white-space: pre-wrap;
            word-break: break-all;
        }

        .file-drop-area {
            border: 2px dashed var(--bs-secondary-bg);
            border-radius: .375rem;
            padding: 2rem;
            text-align: center;
            cursor: pointer;
            transition: all 0.2s ease-in-out;
            background-color: var(--bs-body-bg);
        }

        .file-drop-area.drag-over {
            border-color: var(--bs-primary);
            background-color: var(--bs-secondary-bg);
        }

        .file-drop-area.file-selected {
            border-style: solid;
            border-color: var(--bs-success);
            background-color: var(--bs-success-bg-subtle);
        }

        .file-drop-area.input-error {
            border-color: var(--bs-danger);
        }

        .file-name-display.input-error-text {
            color: var(--bs-danger);
            font-weight: bold;
        }

        #printFrame, #translatedPreviewFrame {
            border: none;
            width: 100%;
        }

        #previewOffcanvas {
            --bs-offcanvas-width: 95vw;
            max-width: 1600px;
        }

        .preview-split-container {
            display: flex;
            flex-direction: row;
            height: 90%;
        }

        .preview-pane-wrapper {
            display: flex;
            flex-direction: column;
            overflow: hidden; /* Important for split.js */
        }

        .preview-pane-wrapper h6 {
            flex-shrink: 0;
            padding: 0.25rem;
        }

        .preview-pane-wrapper .preview-pane {
            flex-grow: 1; /* Make the inner pane grow */
            border: 1px solid var(--bs-border-color);
            border-radius: .375rem;
            overflow: auto;
        }

        .gutter {
            background-color: var(--bs-tertiary-bg);
            background-repeat: no-repeat;
            background-position: 50%;
        }

        .gutter.gutter-horizontal {
            cursor: col-resize;
            border-left: 1px solid var(--bs-border-color);
            border-right: 1px solid var(--bs-border-color);
        }

        .gutter.gutter-vertical {
            cursor: row-resize;
            border-top: 1px solid var(--bs-border-color);
            border-bottom: 1px solid var(--bs-border-color);
        }


        .preview-pane iframe, .preview-pane pre {
            width: 100%;
            height: 95%;
            border: none;
            margin: 0;
            padding: 0;
            overflow: auto;
            background-color: var(--bs-body-bg);
        }

        .slider-reset-btn {
            visibility: hidden;
        }

        .bottom-left-controls {
            position: fixed;
            bottom: 1rem;
            left: 1rem;
            z-index: 1050;
            display: flex;
            gap: 0.5rem;
        }

        @media (max-width: 991.98px) {
            .main-container {
                height: auto;
                padding-bottom: 6rem;
            }

            .settings-panel, .task-area {
                height: auto;
                overflow-y: visible;
            }

            .settings-panel {
                padding-right: 0;
                margin-bottom: 2rem;
            }
        }

        @media (max-width: 767.98px) {
            .task-card .col-md-7 {
                margin-top: 1.5rem;
            }

            Line truncated
+<!DOCTYPE html>
<html lang="zh-CN" data-bs-theme="auto">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">

    <title data-i18n-title="pageTitle">DocuTranslate - 交互式文档翻译</title>
    <link rel="icon" href="/static/favicon.ico" type="image/x-icon">
    <!-- Bootstrap CSS -->
    <link href="/static/bootstrap.css" rel="stylesheet" crossorigin="anonymous">
    <!-- Bootstrap Icons -->
    <link rel="stylesheet" href="/static/bootstrap-icons.css">

    <style>
        body {
            background-color: var(--bs-body-bg);
        }

        .main-container {
            display: flex;
            flex-direction: column;
            height: 100vh;
            padding-top: 1rem;
            padding-bottom: 1rem;
        }

        .settings-panel {
            height: calc(100vh - 2rem);
            overflow-y: auto;
            padding-right: 15px; /* for scrollbar */
        }

        .task-area {
            height: calc(100vh - 2rem);
            overflow-y: auto;
        }

        .task-card {
            transition: all 0.3s ease-in-out;
        }

        .task-id-placeholder {
            color: var(--bs-secondary-color);
            font-style: italic;
        }

        .log-area {
            height: 150px;
            background-color: var(--bs-tertiary-bg);
            border: 1px solid var(--bs-border-color);
            border-radius: .375rem;
            font-family: monospace;
            font-size: 0.8rem;
            padding: 10px;
            overflow-y: auto;
            white-space: pre-wrap;
            word-break: break-all;
        }

        .file-drop-area {
            border: 2px dashed var(--bs-secondary-bg);
            border-radius: .375rem;
            padding: 2rem;
            text-align: center;
            cursor: pointer;
            transition: all 0.2s ease-in-out;
            background-color: var(--bs-body-bg);
        }

        .file-drop-area.drag-over {
            border-color: var(--bs-primary);
            background-color: var(--bs-secondary-bg);
        }

        .file-drop-area.file-selected {
            border-style: solid;
            border-color: var(--bs-success);
            background-color: var(--bs-success-bg-subtle);
        }

        .file-drop-area.input-error {
            border-color: var(--bs-danger);
        }

        .file-name-display.input-error-text {
            color: var(--bs-danger);
            font-weight: bold;
        }

        #printFrame, #translatedPreviewFrame {
            border: none;
            width: 100%;
        }

        #previewOffcanvas {
            --bs-offcanvas-width: 95vw;
            max-width: 1600px;
        }

        .preview-split-container {
            display: flex;
            flex-direction: row;
            height: 90%;
        }

        .preview-pane-wrapper {
            display: flex;
            flex-direction: column;
            overflow: hidden; /* Important for split.js */
        }

        .preview-pane-wrapper h6 {
            flex-shrink: 0;
            padding: 0.25rem;
        }

        .preview-pane-wrapper .preview-pane {
            flex-grow: 1; /* Make the inner pane grow */
            border: 1px solid var(--bs-border-color);
            border-radius: .375rem;
            overflow: auto;
        }

        .gutter {
            background-color: var(--bs-tertiary-bg);
            background-repeat: no-repeat;
            background-position: 50%;
        }

        .gutter.gutter-horizontal {
            cursor: col-resize;
            border-left: 1px solid var(--bs-border-color);
            border-right: 1px solid var(--bs-border-color);
        }

        .gutter.gutter-vertical {
            cursor: row-resize;
            border-top: 1px solid var(--bs-border-color);
            border-bottom: 1px solid var(--bs-border-color);
        }


        .preview-pane iframe, .preview-pane pre {
            width: 100%;
            height: 95%;
            border: none;
            margin: 0;
            padding: 0;
            overflow: auto;
            background-color: var(--bs-body-bg);
        }

        .slider-reset-btn {
            visibility: hidden;
        }

        .bottom-left-controls {
            position: fixed;
            bottom: 1rem;
            left: 1rem;
            z-index: 1050;
            display: flex;
            gap: 0.5rem;
        }

        @media (max-width: 991.98px) {
            .main-container {
                height: auto;
                padding-bottom: 6rem;
            }

            .settings-panel, .task-area {
                height: auto;
                overflow-y: visible;
            }

            .settings-panel {
                padding-right: 0;
                margin-bottom: 2rem;
            }
        }

        @media (max-width: 767.98px) {
            .task-card .col-md-7 {
                margin-top: 1.5rem;
            }

            Line truncated

docutranslate/translator/ai_translator/base.py

@@ -1,5 +1,5 @@
 from abc import abstractmethod
-from dataclasses import dataclass
+from dataclasses import dataclass, field
 from typing import TypeVar
 
 from docutranslate.agents.agent import ThinkingMode
@@ -10,10 +10,10 @@ from docutranslate.translator.base import Translator, TranslatorConfig
 
 @dataclass(kw_only=True)
 class AiTranslatorConfig(TranslatorConfig):
-    base_url: str
+    base_url: str | None = field(default=None,metadata={"description": "OpenAI兼容地址，当skip_translate为False时为必填项"})
-    api_key: str
+    api_key: str | None = field(default=None,metadata={"description": "当skip_translate为False时为必填项"})
-    model_id: str
+    model_id: str | None = field(default=None,metadata={"description": "当skip_translate为False时为必填项"})
-    to_lang: str
+    to_lang: str = "简体中文"
     custom_prompt: str | None = None
     temperature: float = 0.7
     thinking: ThinkingMode = "default"
@@ -23,6 +23,7 @@ class AiTranslatorConfig(TranslatorConfig):
     glossary_dict: dict[str:str] | None = None
     glossary_generate_enable: bool = False
     glossary_agent_config: GlossaryAgentConfig | None = None
+    skip_translate: bool = False
 
 
 T = TypeVar('T', bound=Document)
@@ -35,8 +36,12 @@ class AiTranslator(Translator[T]):
 
     def __init__(self, config: AiTranslatorConfig):
         super().__init__(config=config)
+        self.skip_translate = config.skip_translate
         self.glossary_agent = None
         self.glossary_dict_gen = None
+        if not self.skip_translate and (config.base_url is None or config.api_key is None or config.model_id is None):
+            raise ValueError("skip_translate不为false时，base_url、api_key、model_id为必填项")
+
         if config.glossary_generate_enable:
             if config.glossary_agent_config:
                 self.glossary_agent = GlossaryAgent(config.glossary_agent_config)
@@ -53,6 +58,7 @@ class AiTranslator(Translator[T]):
                     logger=self.logger,
                 )
                 self.glossary_agent = GlossaryAgent(glossary_agent_config)
+
     @abstractmethod
     def translate(self, document: T) -> Document:
         ...

docutranslate/translator/ai_translator/docx_translator.py

@@ -37,20 +37,22 @@ class DocxTranslator(AiTranslator):
     def __init__(self, config: DocxTranslatorConfig):
         super().__init__(config=config)
         self.chunk_size = config.chunk_size
-        agent_config = SegmentsTranslateAgentConfig(
+        self.translate_agent = None
-            custom_prompt=config.custom_prompt,
+        if not self.skip_translate:
-            to_lang=config.to_lang,
+            agent_config = SegmentsTranslateAgentConfig(
-            baseurl=config.base_url,
+                custom_prompt=config.custom_prompt,
-            key=config.api_key,
+                to_lang=config.to_lang,
-            model_id=config.model_id,
+                baseurl=config.base_url,
-            temperature=config.temperature,
+                key=config.api_key,
-            thinking=config.thinking,
+                model_id=config.model_id,
-            max_concurrent=config.concurrent,
+                temperature=config.temperature,
-            timeout=config.timeout,
+                thinking=config.thinking,
-            logger=self.logger,
+                max_concurrent=config.concurrent,
-            glossary_dict=config.glossary_dict
+                timeout=config.timeout,
-        )
+                logger=self.logger,
-        self.translate_agent = SegmentsTranslateAgent(agent_config)
+                glossary_dict=config.glossary_dict
+            )
+            self.translate_agent = SegmentsTranslateAgent(agent_config)
         self.insert_mode = config.insert_mode
         self.separator = config.separator
 
@@ -160,10 +162,14 @@ class DocxTranslator(AiTranslator):
 
         if self.glossary_agent:
             self.glossary_dict_gen = self.glossary_agent.send_segments(original_texts, self.chunk_size)
-            self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+            if self.translate_agent:
+                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
 
         # 调用翻译 agent
-        translated_texts = self.translate_agent.send_segments(original_texts, self.chunk_size)
+        if self.translate_agent:
+            translated_texts = self.translate_agent.send_segments(original_texts, self.chunk_size)
+        else:
+            translated_texts = original_texts
 
         # 将翻译结果写回文档
         document.content = self._after_translate(doc, elements_to_translate, translated_texts, original_texts)
@@ -184,11 +190,14 @@ class DocxTranslator(AiTranslator):
 
         if self.glossary_agent:
             self.glossary_dict_gen = await self.glossary_agent.send_segments_async(original_texts, self.chunk_size)
-            self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+            if self.translate_agent:
+                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
 
         # 异步调用翻译 agent
-        translated_texts = await self.translate_agent.send_segments_async(original_texts, self.chunk_size)
+        if self.translate_agent:
-
+            translated_texts = await self.translate_agent.send_segments_async(original_texts, self.chunk_size)
+        else:
+            translated_texts = original_texts
         # 将翻译结果写回文档
         document.content = await asyncio.to_thread(self._after_translate, doc, elements_to_translate, translated_texts,
                                                    original_texts)

docutranslate/translator/ai_translator/epub_translator.py

@@ -28,14 +28,22 @@ class EpubTranslator(AiTranslator):
     def __init__(self, config: EpubTranslatorConfig):
         super().__init__(config=config)
         self.chunk_size = config.chunk_size
-        agent_config = SegmentsTranslateAgentConfig(
+        self.translate_agent = None
-            custom_prompt=config.custom_prompt, to_lang=config.to_lang,
+        if not self.skip_translate:
-            baseurl=config.base_url, key=config.api_key, model_id=config.model_id,
+            agent_config = SegmentsTranslateAgentConfig(
-            temperature=config.temperature, thinking=config.thinking,
+                custom_prompt=config.custom_prompt,
-            max_concurrent=config.concurrent, timeout=config.timeout, logger=self.logger,
+                to_lang=config.to_lang,
-            glossary_dict=config.glossary_dict
+                baseurl=config.base_url,
-        )
+                key=config.api_key,
-        self.translate_agent = SegmentsTranslateAgent(agent_config)
+                model_id=config.model_id,
+                temperature=config.temperature,
+                thinking=config.thinking,
+                max_concurrent=config.concurrent,
+                timeout=config.timeout,
+                logger=self.logger,
+                glossary_dict=config.glossary_dict
+            )
+            self.translate_agent = SegmentsTranslateAgent(agent_config)
         self.insert_mode = config.insert_mode
         self.separator = config.separator
 
@@ -175,8 +183,12 @@ class EpubTranslator(AiTranslator):
             return self
         if self.glossary_agent:
             self.glossary_dict_gen = self.glossary_agent.send_segments(original_texts, self.chunk_size)
-            self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+            if self.translate_agent:
-        translated_texts = self.translate_agent.send_segments(original_texts, self.chunk_size)
+                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+        if self.translate_agent:
+            translated_texts = self.translate_agent.send_segments(original_texts, self.chunk_size)
+        else:
+            translated_texts = original_texts
         document.content = self._after_translate(
             all_files, items_to_translate, translated_texts, original_texts
         )
@@ -195,11 +207,14 @@ class EpubTranslator(AiTranslator):
 
         if self.glossary_agent:
             self.glossary_dict_gen = await self.glossary_agent.send_segments_async(original_texts, self.chunk_size)
-            self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+            if self.translate_agent:
-
+                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
-        translated_texts = await self.translate_agent.send_segments_async(
+        if self.translate_agent:
-            original_texts, self.chunk_size
+            translated_texts = await self.translate_agent.send_segments_async(
-        )
+                original_texts, self.chunk_size
+            )
+        else:
+            translated_texts = original_texts
         document.content = await asyncio.to_thread(
             self._after_translate, all_files, items_to_translate, translated_texts, original_texts
         )

docutranslate/translator/ai_translator/html_translator.py

@@ -85,20 +85,22 @@ class HtmlTranslator(AiTranslator):
     def __init__(self, config: HtmlTranslatorConfig):
         super().__init__(config=config)
         self.chunk_size = config.chunk_size
-        agent_config = SegmentsTranslateAgentConfig(
+        self.translate_agent = None
-            custom_prompt=config.custom_prompt,
+        if not self.skip_translate:
-            to_lang=config.to_lang,
+            agent_config = SegmentsTranslateAgentConfig(
-            baseurl=config.base_url,
+                custom_prompt=config.custom_prompt,
-            key=config.api_key,
+                to_lang=config.to_lang,
-            model_id=config.model_id,
+                baseurl=config.base_url,
-            temperature=config.temperature,
+                key=config.api_key,
-            thinking=config.thinking,
+                model_id=config.model_id,
-            max_concurrent=config.concurrent,
+                temperature=config.temperature,
-            timeout=config.timeout,
+                thinking=config.thinking,
-            logger=self.logger,
+                max_concurrent=config.concurrent,
-            glossary_dict=config.glossary_dict
+                timeout=config.timeout,
-        )
+                logger=self.logger,
-        self.translate_agent = SegmentsTranslateAgent(agent_config)
+                glossary_dict=config.glossary_dict
+            )
+            self.translate_agent = SegmentsTranslateAgent(agent_config)
         self.insert_mode = config.insert_mode
         self.separator = config.separator
 
@@ -199,9 +201,12 @@ class HtmlTranslator(AiTranslator):
 
         if self.glossary_agent:
             self.glossary_dict_gen = self.glossary_agent.send_segments(original_texts, self.chunk_size)
-            self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+            if self.translate_agent:
-
+                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
-        translated_texts = self.translate_agent.send_segments(original_texts, self.chunk_size)
+        if self.translate_agent:
+            translated_texts = self.translate_agent.send_segments(original_texts, self.chunk_size)
+        else:
+            translated_texts = original_texts
         document.content = self._after_translate(soup, translatable_items, translated_texts, original_texts)
         return self
 
@@ -218,9 +223,12 @@ class HtmlTranslator(AiTranslator):
 
         if self.glossary_agent:
             self.glossary_dict_gen = await self.glossary_agent.send_segments_async(original_texts, self.chunk_size)
-            self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+            if self.translate_agent:
-
+                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
-        translated_texts = await self.translate_agent.send_segments_async(original_texts, self.chunk_size)
+        if self.translate_agent:
+            translated_texts = await self.translate_agent.send_segments_async(original_texts, self.chunk_size)
+        else:
+            translated_texts = original_texts
         document.content = await asyncio.to_thread(
             self._after_translate, soup, translatable_items, translated_texts, original_texts
         )

docutranslate/translator/ai_translator/json_translator.py

@@ -18,18 +18,22 @@ class JsonTranslator(AiTranslator):
     def __init__(self, config: JsonTranslatorConfig):
         super().__init__(config=config)
         self.chunk_size = config.chunk_size
-        agent_config = SegmentsTranslateAgentConfig(custom_prompt=config.custom_prompt,
+        self.translate_agent = None
-                                                    to_lang=config.to_lang,
+        if not self.skip_translate:
-                                                    baseurl=config.base_url,
+            agent_config = SegmentsTranslateAgentConfig(
-                                                    key=config.api_key,
+                custom_prompt=config.custom_prompt,
-                                                    model_id=config.model_id,
+                to_lang=config.to_lang,
-                                                    temperature=config.temperature,
+                baseurl=config.base_url,
-                                                    thinking=config.thinking,
+                key=config.api_key,
-                                                    max_concurrent=config.concurrent,
+                model_id=config.model_id,
-                                                    timeout=config.timeout,
+                temperature=config.temperature,
-                                                    logger=self.logger,
+                thinking=config.thinking,
-                                                    glossary_dict=config.glossary_dict)
+                max_concurrent=config.concurrent,
-        self.translate_agent = SegmentsTranslateAgent(agent_config)
+                timeout=config.timeout,
+                logger=self.logger,
+                glossary_dict=config.glossary_dict
+            )
+            self.translate_agent = SegmentsTranslateAgent(agent_config)
         self.jsonpaths = config.json_paths
 
     def _extract_matches(self, content: dict) -> list[Any]:
@@ -76,10 +80,13 @@ class JsonTranslator(AiTranslator):
         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)
-            self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+            if self.translate_agent:
+                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
         # 步骤 2: 批量翻译提取出的文本
-        translated_texts = self.translate_agent.send_segments(original_texts, self.chunk_size)
+        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("翻译服务返回的项目数量与发送的数量不匹配。")
@@ -107,11 +114,14 @@ class JsonTranslator(AiTranslator):
 
         if self.glossary_agent:
             self.glossary_dict_gen = await self.glossary_agent.send_segments_async(original_texts, self.chunk_size)
-            self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+            if self.translate_agent:
-
+                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
-        # 步骤 2: 批量翻译提取出的文本
-        translated_texts = await self.translate_agent.send_segments_async(original_texts, self.chunk_size)
 
+            # 步骤 2: 批量翻译提取出的文本
+        if self.translate_agent:
+            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("翻译服务返回的项目数量与发送的数量不匹配。")

docutranslate/translator/ai_translator/md_translator.py

@@ -19,18 +19,20 @@ class MDTranslator(AiTranslator):
     def __init__(self, config: MDTranslatorConfig):
         super().__init__(config=config)
         self.chunk_size = config.chunk_size
-        agent_config = MDTranslateAgentConfig(custom_prompt=config.custom_prompt,
+        self.translate_agent = None
-                                              to_lang=config.to_lang,
+        if not self.skip_translate:
-                                              baseurl=config.base_url,
+            agent_config = MDTranslateAgentConfig(custom_prompt=config.custom_prompt,
-                                              key=config.api_key,
+                                                  to_lang=config.to_lang,
-                                              model_id=config.model_id,
+                                                  baseurl=config.base_url,
-                                              temperature=config.temperature,
+                                                  key=config.api_key,
-                                              thinking=config.thinking,
+                                                  model_id=config.model_id,
-                                              max_concurrent=config.concurrent,
+                                                  temperature=config.temperature,
-                                              timeout=config.timeout,
+                                                  thinking=config.thinking,
-                                              logger=self.logger,
+                                                  max_concurrent=config.concurrent,
-                                              glossary_dict=config.glossary_dict)
+                                                  timeout=config.timeout,
-        self.translate_agent = MDTranslateAgent(agent_config)
+                                                  logger=self.logger,
+                                                  glossary_dict=config.glossary_dict)
+            self.translate_agent = MDTranslateAgent(agent_config)
 
     def translate(self, document: MarkdownDocument) -> Self:
         self.logger.info("正在翻译markdown")
@@ -38,9 +40,13 @@ class MDTranslator(AiTranslator):
             chunks: list[str] = split_markdown_text(document.content.decode(), self.chunk_size)
             if self.glossary_agent:
                 self.glossary_dict_gen = self.glossary_agent.send_segments(chunks, self.chunk_size)
-                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+                if self.translate_agent:
+                    self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
             self.logger.info(f"markdown分为{len(chunks)}块")
-            result: list[str] = self.translate_agent.send_chunks(chunks)
+            if self.translate_agent:
+                result: list[str] = self.translate_agent.send_chunks(chunks)
+            else:
+                result = chunks
             content = join_markdown_texts(result)
             # 做一些加强鲁棒性的操作
             content = content.replace(r'\（', r'\(')
@@ -57,10 +63,14 @@ class MDTranslator(AiTranslator):
 
             if self.glossary_agent:
                 self.glossary_dict_gen = await self.glossary_agent.send_segments_async(chunks, self.chunk_size)
-                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+                if self.translate_agent:
+                    self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
 
             self.logger.info(f"markdown分为{len(chunks)}块")
-            result: list[str] = await self.translate_agent.send_chunks_async(chunks)
+            if self.translate_agent:
+                result: list[str] = await self.translate_agent.send_chunks_async(chunks)
+            else:
+                result = chunks
 
             def run():
                 content = join_markdown_texts(result)

docutranslate/translator/ai_translator/srt_translator.py

@@ -24,20 +24,22 @@ class SrtTranslator(AiTranslator):
     def __init__(self, config: SrtTranslatorConfig):
         super().__init__(config=config)
         self.chunk_size = config.chunk_size
-        agent_config = SegmentsTranslateAgentConfig(
+        self.translate_agent = None
-            custom_prompt=config.custom_prompt,
+        if not self.skip_translate:
-            to_lang=config.to_lang,
+            agent_config = SegmentsTranslateAgentConfig(
-            baseurl=config.base_url,
+                custom_prompt=config.custom_prompt,
-            key=config.api_key,
+                to_lang=config.to_lang,
-            model_id=config.model_id,
+                baseurl=config.base_url,
-            temperature=config.temperature,
+                key=config.api_key,
-            thinking=config.thinking,
+                model_id=config.model_id,
-            max_concurrent=config.concurrent,
+                temperature=config.temperature,
-            timeout=config.timeout,
+                thinking=config.thinking,
-            logger=self.logger,
+                max_concurrent=config.concurrent,
-            glossary_dict=config.glossary_dict
+                timeout=config.timeout,
-        )
+                logger=self.logger,
-        self.translate_agent = SegmentsTranslateAgent(agent_config)
+                glossary_dict=config.glossary_dict
+            )
+            self.translate_agent = SegmentsTranslateAgent(agent_config)
         self.insert_mode = config.insert_mode
         self.separator = config.separator
 
@@ -109,10 +111,13 @@ class SrtTranslator(AiTranslator):
             return self
         if self.glossary_agent:
             self.glossary_dict_gen = self.glossary_agent.send_segments(original_texts, self.chunk_size)
-            self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+            if self.translate_agent:
+                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
         # --- 步骤 2: 调用翻译Agent ---
-        translated_texts = self.translate_agent.send_segments(original_texts, self.chunk_size)
+        if self.translate_agent:
-
+            translated_texts = self.translate_agent.send_segments(original_texts, self.chunk_size)
+        else:
+            translated_texts = original_texts
         # --- 步骤 3: 后处理并更新文档内容 ---
         document.content = self._after_translate(subtitles, translated_texts, original_texts)
         return self
@@ -130,11 +135,14 @@ class SrtTranslator(AiTranslator):
 
         if self.glossary_agent:
             self.glossary_dict_gen = await self.glossary_agent.send_segments_async(original_texts, self.chunk_size)
-            self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+            if self.translate_agent:
+                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
 
         # --- 步骤 2: 调用翻译Agent (异步) ---
-        translated_texts = await self.translate_agent.send_segments_async(original_texts, self.chunk_size)
+        if self.translate_agent:
-
+            translated_texts = await self.translate_agent.send_segments_async(original_texts, self.chunk_size)
+        else:
+            translated_texts = original_texts
         # --- 步骤 3: 后处理并更新文档内容 (I/O密集型) ---
         document.content = await asyncio.to_thread(
             self._after_translate, subtitles, translated_texts, original_texts

docutranslate/translator/ai_translator/txt_translator.py

@@ -16,27 +16,33 @@ class TXTTranslator(AiTranslator):
     def __init__(self, config: TXTTranslatorConfig):
         super().__init__(config=config)
         self.chunk_size = config.chunk_size
-        agent_config = TXTTranslateAgentConfig(custom_prompt=config.custom_prompt,
+        self.translate_agent =None
-                                               to_lang=config.to_lang,
+        if not self.skip_translate:
-                                               baseurl=config.base_url,
+            agent_config = TXTTranslateAgentConfig(custom_prompt=config.custom_prompt,
-                                               key=config.api_key,
+                                                   to_lang=config.to_lang,
-                                               model_id=config.model_id,
+                                                   baseurl=config.base_url,
-                                               temperature=config.temperature,
+                                                   key=config.api_key,
-                                               thinking=config.thinking,
+                                                   model_id=config.model_id,
-                                               max_concurrent=config.concurrent,
+                                                   temperature=config.temperature,
-                                               timeout=config.timeout,
+                                                   thinking=config.thinking,
-                                               logger=self.logger,
+                                                   max_concurrent=config.concurrent,
-                                               glossary_dict=config.glossary_dict)
+                                                   timeout=config.timeout,
-        self.translate_agent = TXTTranslateAgent(agent_config)
+                                                   logger=self.logger,
+                                                   glossary_dict=config.glossary_dict)
+            self.translate_agent = TXTTranslateAgent(agent_config)
 
     def translate(self, document: Document) -> Self:
         self.logger.info("正在翻译txt")
         chunks: list[str] = split_markdown_text(document.content.decode(), max_block_size=self.chunk_size)
         if self.glossary_agent:
             self.glossary_dict_gen = self.glossary_agent.send_segments(chunks, self.chunk_size)
-            self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+            if self.translate_agent:
+                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
         self.logger.info(f"txt分为{len(chunks)}块")
-        result: list[str] = self.translate_agent.send_chunks(chunks)
+        if self.translate_agent:
+            result: list[str] = self.translate_agent.send_chunks(chunks)
+        else:
+            result=chunks
         content = "\n".join(result)
         document.content = content.encode()
         self.logger.info("翻译完成")
@@ -48,10 +54,14 @@ class TXTTranslator(AiTranslator):
 
         if self.glossary_agent:
             self.glossary_dict_gen = await self.glossary_agent.send_segments_async(chunks, self.chunk_size)
-            self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+            if self.translate_agent:
+                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
 
         self.logger.info(f"txt分为{len(chunks)}块")
-        result: list[str] = await self.translate_agent.send_chunks_async(chunks)
+        if self.translate_agent:
+            result: list[str] = await self.translate_agent.send_chunks_async(chunks)
+        else:
+            result=chunks
         content = "\n".join(result)
         document.content = content.encode()
         self.logger.info("翻译完成")

docutranslate/translator/ai_translator/xlsx_translator.py

@@ -26,18 +26,22 @@ class XlsxTranslator(AiTranslator):
     def __init__(self, config: XlsxTranslatorConfig):
         super().__init__(config=config)
         self.chunk_size = config.chunk_size
-        agent_config = SegmentsTranslateAgentConfig(custom_prompt=config.custom_prompt,
+        self.translate_agent = None
-                                                    to_lang=config.to_lang,
+        if not self.skip_translate:
-                                                    baseurl=config.base_url,
+            agent_config = SegmentsTranslateAgentConfig(
-                                                    key=config.api_key,
+                custom_prompt=config.custom_prompt,
-                                                    model_id=config.model_id,
+                to_lang=config.to_lang,
-                                                    temperature=config.temperature,
+                baseurl=config.base_url,
-                                                    thinking=config.thinking,
+                key=config.api_key,
-                                                    max_concurrent=config.concurrent,
+                model_id=config.model_id,
-                                                    timeout=config.timeout,
+                temperature=config.temperature,
-                                                    logger=self.logger,
+                thinking=config.thinking,
-                                                    glossary_dict=config.glossary_dict)
+                max_concurrent=config.concurrent,
-        self.translate_agent = SegmentsTranslateAgent(agent_config)
+                timeout=config.timeout,
+                logger=self.logger,
+                glossary_dict=config.glossary_dict
+            )
+            self.translate_agent = SegmentsTranslateAgent(agent_config)
         self.insert_mode = config.insert_mode
         self.separator = config.separator
         # --- 新增功能 ---
@@ -156,9 +160,13 @@ class XlsxTranslator(AiTranslator):
             return self
         if self.glossary_agent:
             self.glossary_dict_gen = self.glossary_agent.send_segments(original_texts, self.chunk_size)
-            self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+            if self.translate_agent:
+                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
         # --- 步骤 2: 调用翻译函数 ---
-        translated_texts = self.translate_agent.send_segments(original_texts, self.chunk_size)
+        if self.translate_agent:
+            translated_texts = self.translate_agent.send_segments(original_texts, self.chunk_size)
+        else:
+            translated_texts = original_texts
 
         document.content = self._after_translate(workbook, cells_to_translate, translated_texts, original_texts)
         return self
@@ -173,11 +181,14 @@ class XlsxTranslator(AiTranslator):
 
         if self.glossary_agent:
             self.glossary_dict_gen = await self.glossary_agent.send_segments_async(original_texts, self.chunk_size)
-            self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
+            if self.translate_agent:
+                self.translate_agent.update_glossary_dict(self.glossary_dict_gen)
 
         # --- 步骤 2: 调用翻译函数 ---
-        translated_texts = await self.translate_agent.send_segments_async(original_texts, self.chunk_size)
+        if self.translate_agent:
-
+            translated_texts = await self.translate_agent.send_segments_async(original_texts, self.chunk_size)
+        else:
+            translated_texts = original_texts
         document.content = await asyncio.to_thread(self._after_translate, workbook, cells_to_translate,
                                                    translated_texts, original_texts)
         return self