论文翻译工作台

本地论文翻译 Agent。它提供 Responses API 循环、流式输出、运行记录、停止/继续、上下文压缩、附件上传和原生 WebUI。

支持范围

• 输入：PDF、DOCX、Markdown、TXT；术语表可用 Markdown、TSV 或 原文 -> 译法 文本。
• 输出：data/result/{run_id}/bilingual.md，按章节保存原文与中文译文。
• 风格：忠实学术直译，保留公式、变量、引用、URL、图表编号和 Markdown 结构。
• 约束：摘要随每章翻译任务返回，术语表贯穿全文，章节按顺序连续处理。

启动

python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
Copy-Item config.json.example config.json
# 编辑 config.json 填入兼容 Responses API 的模型和 API Key
python -m core

打开 http://127.0.0.1:8765，新建对话后上传论文；如有术语表，一并上传并在输入框发送“开始翻译”。Agent 会先解析论文和摘要，再循环取得、翻译、保存各章节。

运行产物

每个对话使用独立的运行 ID：

• data/resources/{run_id}：上传的论文和术语表
• data/result/{run_id}/paper_source.md：提取后的原文
• data/result/{run_id}/bilingual.md：双语对照译文
• data/result/{run_id}/glossary.md：用户与模型术语表
• data/result/{run_id}/paper.json：章节进度和待确认问题
• data/run/{run_id}：事件、状态和可恢复上下文

PDF 解析使用 PyMuPDF；DOCX 使用标准库读取文档 XML。翻译本身由 config.json 中的主模型完成。

模型连接遇到超时、连接中断、限流或服务端错误时会自动重试，最多 5 次；请求参数错误（例如工具调用上下文不完整）不会重试。

配置控件在成功读取当前 config.json 后才启用，保存内容由该配置文件统一管理。