From 1cc39ace7887424f95197a909d93830656ec319d Mon Sep 17 00:00:00 2001 From: xunbu Date: Tue, 29 Jul 2025 15:18:35 +0800 Subject: [PATCH] =?UTF-8?q?0.4.1beta=E7=89=88=E6=9C=AC?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docutranslate/__init__.py | 2 +- .../{document_context => context}/__init__.py | 0 .../md_mask_context.py | 0 docutranslate/static/index.html | 2 +- docutranslate/translater.py | 488 ------------------ docutranslate/translater/md_translator.py | 2 +- 6 files changed, 3 insertions(+), 491 deletions(-) rename docutranslate/{document_context => context}/__init__.py (100%) rename docutranslate/{document_context => context}/md_mask_context.py (100%) delete mode 100644 docutranslate/translater.py diff --git a/docutranslate/__init__.py b/docutranslate/__init__.py index 509d45b..eb902d7 100644 --- a/docutranslate/__init__.py +++ b/docutranslate/__init__.py @@ -1,4 +1,4 @@ -__version__="0.3.4b1" +__version__="0.4.1b1" diff --git a/docutranslate/document_context/__init__.py b/docutranslate/context/__init__.py similarity index 100% rename from docutranslate/document_context/__init__.py rename to docutranslate/context/__init__.py diff --git a/docutranslate/document_context/md_mask_context.py b/docutranslate/context/md_mask_context.py similarity index 100% rename from docutranslate/document_context/md_mask_context.py rename to docutranslate/context/md_mask_context.py diff --git a/docutranslate/static/index.html b/docutranslate/static/index.html index a3bdb62..81373e6 100644 --- a/docutranslate/static/index.html +++ b/docutranslate/static/index.html @@ -1 +1 @@ - DocuTranslate - 交互式文档翻译

DocuTranslate

GitHub主页(欢迎star❤):
https://github.com/xunbu/docutranslate

交流QQ群: 1047781902

任务列表

当前没有任务，点击“新建任务”开始吧！

预览
原文
译文
\ No newline at end of file + DocuTranslate - 交互式文档翻译

DocuTranslate

GitHub主页(欢迎star❤):
https://github.com/xunbu/docutranslate

交流QQ群: 1047781902

任务列表

当前没有任务，点击“新建任务”开始吧！

预览
原文
译文
\ No newline at end of file diff --git a/docutranslate/translater.py b/docutranslate/translater.py deleted file mode 100644 index 062e043..0000000 --- a/docutranslate/translater.py +++ /dev/null @@ -1,488 +0,0 @@ -import asyncio -import html -import io -import logging -import zipfile -from pathlib import Path -from typing import Literal - -import jinja2 -import markdown2 - -from docutranslate.agents import Agent, AgentArgs -from docutranslate.agents import MDRefineAgent, MDTranslateAgent -from docutranslate.cacher import md_based_convert_cacher -from docutranslate.ir.document import Document -from docutranslate.global_values import available_packages -from docutranslate.logger import global_logger -from docutranslate.utils.markdown_splitter import split_markdown_text, join_markdown_texts -from docutranslate.utils.markdown_utils import uris2placeholder, placeholder2uris, MaskDict, clean_markdown_math_block, \ - unembed_base64_images_to_zip, embed_inline_image_from_zip, find_markdown_in_zip -from docutranslate.utils.resource_utils import resource_path - -DOCLING_FLAG = True if available_packages.get("docling") else False -if DOCLING_FLAG: - from docutranslate.converter import ConverterDocling - -default_params = { - "chunk_size": 3000, - "concurrent": 30, - "temperature": 0.7, -} - - -class FileTranslater: - def __init__(self, file_path: Path | str | None = None, chunk_size: int = default_params["chunk_size"], - base_url: str | None = None, key=None, model_id: str | None = None, - temperature=default_params["temperature"], - concurrent: int = default_params["concurrent"], timeout=2000, - convert_engin: Literal["docling", "mineru"] = "mineru", - docling_artifact: Path | str | None = None, - mineru_token: str = None, cache=True, - logger: logging.Logger | None = None): - self.logger = logger if logger else global_logger - - self.convert_engin = convert_engin - self.mineru_token = mineru_token.strip() if mineru_token is not None else None - self._mask_dict = MaskDict() - self.markdown: str = "" - self.chunk_size = chunk_size - self.concurrent = concurrent - self.base_url = base_url - self.key = key if key is not None else "xx" - self.model_id = model_id - self.temperature = temperature - self.docling_artifact = docling_artifact - if docling_artifact is None: - artifact_path = Path("./docling_artifact") - print(f"artifact_path:{artifact_path.resolve()}，existed：{artifact_path.is_dir()}") - if artifact_path.is_dir(): - self.logger.info("检测到docling_artifact文件夹") - self.docling_artifact = artifact_path - self.timeout = timeout - self.document: Document | None = None - self.cache = cache - self.cacher = md_based_convert_cacher - if file_path: - self.read_file(file_path=file_path) - - def _markdown_format(self): - # 该方法还需要改进 - # self.markdown=mdformat.text(self.markdown) - self.markdown = self.markdown.replace(r'\（', r'\(') - self.markdown = self.markdown.replace(r'\）', r'\)') - self.markdown = clean_markdown_math_block(self.markdown) - pass - - def _mask_uris_in_markdown(self): - self.markdown = uris2placeholder(self.markdown, self._mask_dict) - return self - - def _unmask_uris_in_markdown(self): - self.markdown = placeholder2uris(self.markdown, self._mask_dict) - return self - - def _split_markdown_into_chunks(self) -> list[str]: - chunks: list[str] = split_markdown_text(self.markdown, self.chunk_size) - self.logger.info(f"markdown分为{len(chunks)}块") - return chunks - - def _default_agent_params(self) -> AgentArgs: - if self.base_url is None: - raise Exception("base_url为空") - if self.model_id is None: - raise Exception("model_id为空") - result: AgentArgs = { - "baseurl": self.base_url, - "key": self.key, - "model_id": self.model_id, - "temperature": self.temperature, - "max_concurrent": self.concurrent, - "timeout": self.timeout, - "logger":self.logger - } - return result - - def default_refine_agent(self, custom_prompt=None) -> MDRefineAgent: - return MDRefineAgent(custom_prompt=custom_prompt, **self._default_agent_params()) - - def default_translate_agent(self, custom_prompt=None, to_lang="中文") -> MDTranslateAgent: - return MDTranslateAgent(custom_prompt=custom_prompt, to_lang=to_lang, **self._default_agent_params()) - - def _convert2markdown(self, document: Document, formula: bool, code: bool, artifact: Path = None) -> str: - cached_result = self.cacher.get_cached_result(document, formula, code, convert_engin=self.convert_engin) - if cached_result: - self.logger.info("正在获取缓存结果") - return cached_result - if document.suffix in [".md", ".txt"]: - return document.filebytes.decode("utf-8") - if document.suffix in ['.zip']: - # 寻找zip内的filename - filename = find_markdown_in_zip(document.filebytes) - return embed_inline_image_from_zip(document.filebytes, filename) - self.logger.info("正在转化为markdown") - if self.convert_engin == "docling": - if artifact is None: - artifact = self.docling_artifact - mdconverter = ConverterDocling(formula=formula, code=code, artifact=artifact,logger=self.logger) - result = mdconverter.convert(document) - else: - if self.mineru_token is None: - raise Exception("mineru_token未配置") - if code: - self.logger.info("mineru暂不支持code识别") - mdconverter = ConverterMineru(token=self.mineru_token, formula=formula,logger=self.logger) - result = mdconverter.convert(document) - return self.cacher.cache_result(result, document, formula, code, convert_engin=self.convert_engin) - - async def _convert2markdown_async(self, document: Document, formula: bool, code: bool, - artifact: Path = None) -> str: - cached_result = self.cacher.get_cached_result(document, formula, code, convert_engin=self.convert_engin) - if cached_result: - self.logger.info("解析结果已缓存，获取缓存结果") - return cached_result - if document.suffix in [".md", ".txt"]: - return document.filebytes.decode("utf-8") - if document.suffix in ['.zip']: - # 寻找zip内的filename - filename = find_markdown_in_zip(document.filebytes) - return embed_inline_image_from_zip(document.filebytes, filename) - self.logger.info("正在转化为markdown") - if self.convert_engin == "docling": - if artifact is None: - artifact = self.docling_artifact - mdconverter = ConverterDocling(formula=formula, code=code, artifact=artifact,logger=self.logger) - result = await mdconverter.convert_async(document) - else: - if self.mineru_token is None: - raise Exception("mineru_token未配置") - if code: - self.logger.info("mineru暂不支持code识别") - mdconverter = ConverterMineru(token=self.mineru_token, formula=formula,logger=self.logger) - result = await mdconverter.convert_async(document) - return self.cacher.cache_result(result, document, formula, code, convert_engin=self.convert_engin) - - def read_document(self, document: Document, formula: bool, code: bool, save: bool, - save_format: Literal["markdown", "html"], refine: bool, - refine_agent: Agent | None): - self.document = document - self.markdown = self._convert2markdown(document, formula=formula, code=code, artifact=self.docling_artifact) - if refine: - self.refine_markdown_by_agent(refine_agent) - if save: - if save_format == "html": - self.save_as_html(filename=f"{document.stem}.html") - else: - self.save_as_markdown(filename=f"{document.stem}.md") - return self - - async def read_document_async(self, document: Document, formula: bool, code: bool, save: bool, - save_format: Literal["markdown", "html"], refine: bool, - refine_agent: Agent | None): - self.document = document - self.markdown = await self._convert2markdown_async(document, formula=formula, code=code, - artifact=self.docling_artifact) - if refine: - await self.refine_markdown_by_agent_async(refine_agent) - if save: - if save_format == "html": - self.save_as_html(filename=f"{document.stem}.html") - else: - self.save_as_markdown(filename=f"{document.stem}.md") - return self - - def read_bytes(self, name: str, file: bytes, formula=True, code=True, save=False, - save_format: Literal["markdown", "html"] = "markdown", refine=False, - refine_agent: Agent | None = None): - document = Document(filename=name, filebytes=file) - self.read_document(document, formula=formula, code=code, save=save, save_format=save_format, - refine=refine, refine_agent=refine_agent) - return self - - async def read_bytes_async(self, name: str, file: bytes, formula=True, code=True, save=False, - save_format: Literal["markdown", "html"] = "markdown", refine=False, - refine_agent: Agent | None = None): - document = Document(filename=name, filebytes=file) - await self.read_document_async(document, formula=formula, code=code, save=save, save_format=save_format, - refine=refine, refine_agent=refine_agent) - return self - - def read_file(self, file_path: Path | str | None = None, formula=True, code=True, save=False, - save_format: Literal["markdown", "html"] = "markdown", refine=False, - refine_agent: Agent | None = None): - if file_path: - document = Document(path=file_path) - else: - document = self.document - if document is None: - raise Exception("未读取文件") - self.logger.info(f"读取文件：{document.filename}") - self.read_document(document, formula=formula, code=code, save=save, save_format=save_format, refine=refine, - refine_agent=refine_agent) - return self - - async def read_file_async(self, file_path: Path | str | None = None, formula=True, code=True, save=False, - save_format: Literal["markdown", "html"] = "markdown", refine=False, - refine_agent: Agent | None = None): - if file_path: - document = Document(path=file_path) - else: - document = self.document - if document is None: - raise Exception("未读取文件") - self.logger.info(f"读取文件：{document.filename}") - # 如果是markdown，直接读取 - await self.read_document_async(document, formula=formula, code=code, save=save, save_format=save_format, - refine=refine, refine_agent=refine_agent) - return self - - def refine_markdown_by_agent(self, refine_agent: Agent | None = None, custom_prompt=None) -> str: - self.logger.info("正在修正markdown") - self._mask_uris_in_markdown() - chuncks = self._split_markdown_into_chunks() - if refine_agent is None: - refine_agent = self.default_refine_agent(custom_prompt) - result: list[str] = refine_agent.send_prompts(chuncks) - if self.document.suffix == ".txt": - self.markdown = "\n".join(result) - else: - self.markdown = join_markdown_texts(result) - self._unmask_uris_in_markdown() - self.logger.info("markdown已修正") - return self.markdown - - def translate_markdown_by_agent(self, translate_agent: Agent | None = None, to_lang="中文", custom_prompt=None): - self.logger.info("正在翻译markdown") - self._mask_uris_in_markdown() - chuncks = self._split_markdown_into_chunks() - if translate_agent is None: - translate_agent = self.default_translate_agent(custom_prompt=custom_prompt, to_lang=to_lang) - result: list[str] = translate_agent.send_prompts(chuncks) - if self.document.suffix == ".txt": - self.markdown = "\n".join(result) - else: - self.markdown = join_markdown_texts(result) - self._unmask_uris_in_markdown() - self.logger.info("翻译完成") - return self.markdown - - async def refine_markdown_by_agent_async(self, refine_agent: Agent | None = None, custom_prompt=None) -> str: - self.logger.info("正在修正markdown") - self._mask_uris_in_markdown() - chuncks = self._split_markdown_into_chunks() - if refine_agent is None: - refine_agent = self.default_refine_agent(custom_prompt=custom_prompt) - result: list[str] = await refine_agent.send_prompts_async(chuncks) - if self.document.suffix == ".txt": - self.markdown = "\n".join(result) - else: - self.markdown = join_markdown_texts(result) - self._unmask_uris_in_markdown() - self.logger.info("markdown已修正") - return self.markdown - - async def translate_markdown_by_agent_async(self, translate_agent: Agent | None = None, to_lang="中文", - custom_prompt=None): - self.logger.info("正在翻译markdown") - self._mask_uris_in_markdown() - chuncks = self._split_markdown_into_chunks() - if translate_agent is None: - translate_agent = self.default_translate_agent(to_lang=to_lang, custom_prompt=custom_prompt) - result: list[str] = await translate_agent.send_prompts_async(chuncks) - if self.document.suffix == ".txt": - self.markdown = "\n".join(result) - else: - self.markdown = join_markdown_texts(result) - self._unmask_uris_in_markdown() - self.logger.info("翻译完成") - return self.markdown - - def save_as_markdown(self, filename: str | Path | None = None, output_dir: str | Path = "./output", embeded=True): - if isinstance(filename, str): - filename = Path(filename) - if filename is None: - filename = Path(f"{self.document.stem}.md") - # 确保输出目录存在 - if isinstance(output_dir, str): - output_dir = Path(output_dir) - if embeded: - output_dir.mkdir(parents=True, exist_ok=True) - full_name = output_dir / filename.name - with open(full_name, "w", encoding="utf-8") as file: - file.write(self.export_to_markdown()) - self.logger.info(f"文件已写入{full_name.resolve()}") - else: - output_dir = output_dir / filename.stem - output_dir.mkdir(parents=True, exist_ok=True) - with zipfile.ZipFile(io.BytesIO(self.export_to_unembed_markdown())) as zip_ref: - zip_ref.extractall(output_dir) - return self - - def export_to_markdown(self) -> str: - # 输出前格式化markdown - self._markdown_format() - return self.markdown - - def export_to_unembed_markdown(self, filename: str | Path | None = None) -> bytes: - if isinstance(filename, str): - filename = Path(filename) - if filename is None: - filename = Path(f"{self.document.stem}.md") - self._markdown_format() - return unembed_base64_images_to_zip(self.markdown, markdown_name=filename.name) - - async def export_to_unembed_markdown_async(self, filename: str | Path | None = None) -> bytes: - return await asyncio.to_thread(self.export_to_unembed_markdown,filename) - - def save_as_html(self, filename: str | Path | None = None, output_dir: str | Path = "./output"): - if isinstance(filename, str): - filename = Path(filename) - if isinstance(output_dir, str): - output_dir = Path(output_dir) - if filename is None: - if filename is None: - filename = f"{self.document.stem}.html" - # 确保输出目录存在 - output_dir.mkdir(parents=True, exist_ok=True) - full_name = output_dir / filename - html_content = self.export_to_html(title=str(full_name.resolve().stem)) - with open(full_name, "w", encoding="utf-8") as file: - file.write(html_content) - self.logger.info(f"文件已写入{full_name.resolve()}") - return self - - def export_to_html(self, title="title", cdn=True) -> str: - markdowner = markdown2.Markdown(extras=['tables', 'fenced-code-blocks', 'mermaid', "code-friendly"]) - # language=html - pico = f'' - html_template = resource_path("template/markdown.html").read_text(encoding="utf-8") - katex_css = f'' if not cdn else r"""""" - katex_js = f'' if not cdn else r"""""" - auto_render = f'' if not cdn else r"""""" - # language=javascript - render_math_in_element = r""" - """ if cdn else r""" - """ - mermaid = f'' - - if self.document.suffix == ".txt": - content = html.escape(self.export_to_markdown()).replace("\n", "
") - else: - content = markdowner.convert(self.export_to_markdown().replace("\\", "\\\\")) - # TODO:实现MathJax本地化 - render = jinja2.Template(html_template).render( - title=title, - pico=pico, - katexCss=katex_css, - katexJs=katex_js, - autoRender=auto_render, - markdown=content, - renderMathInElement=render_math_in_element, - mermaid=mermaid, - ) - return render - async def export_to_html_async(self, title="title", cdn=True): - return await asyncio.to_thread(self.export_to_html,title,cdn) - def translate_file(self, file_path: Path | str | None = None, to_lang="中文", output_dir="./output", - formula=True, - code=True, output_format: Literal["markdown", "html"] = "markdown", refine=False, - custom_prompt_translate=None, refine_agent: Agent | None = None, - translate_agent: Agent | None = None, - save=True): - self.read_file(file_path, formula=formula, code=code) - if refine: - self.refine_markdown_by_agent(refine_agent) - self.translate_markdown_by_agent(translate_agent, to_lang=to_lang, custom_prompt=custom_prompt_translate) - - if save: - if output_format == "markdown": - self.save_as_markdown(f"{self.document.stem}_{to_lang}.md", output_dir=output_dir) - elif output_format == "html": - self.save_as_html(f"{self.document.stem}_{to_lang}.html", output_dir=output_dir) - return self - - async def translate_file_async(self, file_path: Path | str | None = None, to_lang="中文", output_dir="./output", - formula=True, - code=True, output_format: Literal["markdown", "html"] = "markdown", - custom_prompt_translate=None, refine=False, - refine_agent: Agent | None = None, translate_agent: Agent | None = None, save=True): - - await self.read_file_async(file_path, formula=formula, code=code) - if refine: - await self.refine_markdown_by_agent_async(refine_agent) - await self.translate_markdown_by_agent_async(translate_agent, to_lang=to_lang, - custom_prompt=custom_prompt_translate) - if save: - if output_format == "markdown": - filename = f"{file_path.stem}_{to_lang}.md" - self.save_as_markdown(filename=filename, output_dir=output_dir) - elif output_format == "html": - filename = f"{file_path.stem}_{to_lang}.html" - self.save_as_html(filename=filename, output_dir=output_dir) - return self - - def translate_bytes(self, name: str, file: bytes, to_lang="中文", output_dir="./output", - formula=True, - code=True, output_format: Literal["markdown", "html"] = "markdown", - custom_prompt_translate=None, - refine=False, - refine_agent: Agent | None = None, translate_agent: Agent | None = None, save=False): - self.read_bytes(name=name, file=file, formula=formula, code=code) - if refine: - self.refine_markdown_by_agent(refine_agent) - self.translate_markdown_by_agent(translate_agent, to_lang=to_lang, custom_prompt=custom_prompt_translate) - if save: - if output_format == "markdown": - filename = f"{name}_{to_lang}.md" - self.save_as_markdown(filename=filename, output_dir=output_dir) - elif output_format == "html": - filename = f"{name}_{to_lang}.html" - self.save_as_html(filename=filename, output_dir=output_dir) - return self - - async def translate_bytes_async(self, name: str, file: bytes, to_lang="中文", output_dir="./output", - formula=True, - code=True, output_format: Literal["markdown", "html"] = "markdown", - custom_prompt_translate=None, refine=False, - refine_agent: Agent | None = None, translate_agent: Agent | None = None, - save=False): - await self.read_bytes_async(name=name, file=file, formula=formula, code=code) - - if refine: - await self.refine_markdown_by_agent_async(refine_agent) - await self.translate_markdown_by_agent_async(translate_agent, to_lang=to_lang, - custom_prompt=custom_prompt_translate) - if save: - if output_format == "markdown": - filename = f"{name}_{to_lang}.md" - self.save_as_markdown(filename=filename, output_dir=output_dir) - elif output_format == "html": - filename = f"{name}_{to_lang}.html" - self.save_as_html(filename=filename, output_dir=output_dir) - return self diff --git a/docutranslate/translater/md_translator.py b/docutranslate/translater/md_translator.py index 04640f2..ea79691 100644 --- a/docutranslate/translater/md_translator.py +++ b/docutranslate/translater/md_translator.py @@ -3,7 +3,7 @@ from dataclasses import dataclass from typing import Self from docutranslate.agents import MDTranslateAgent -from docutranslate.document_context.md_mask_context import MDMaskUrisContext +from docutranslate.context.md_mask_context import MDMaskUrisContext from docutranslate.ir.markdown_document import MarkdownDocument from docutranslate.logger import global_logger from docutranslate.translater.base import AiTranslateConfig