literature-translation-to-tex

name	literature-translation-to-tex
description	将“文献”文件夹下用户指定或选择的外文文献转换为广东工业大学 LaTeX 模板格式的“文献翻译”文档并翻译正文。用户要求做外文文献翻译、把文献/论文/PDF/Word/Markdown 转成文献翻译 LaTeX、生成“文献翻译.tex”、或需要按“外文文献译文/外文文献原文”结构整理时必须使用。本 skill 会读取文献原文、按自然段且每段不超过 500 字翻译、套用默认 GDUT 模板、替换为文献翻译封面，并输出到“文献”文件夹。

文献翻译转 LaTeX

把项目 文献 文件夹下用户选择的外文文献整理为基于 GDUT LaTeX 模板的文献翻译 .tex 文档。该 skill 负责选择文献、提取原文、按自然段翻译、套用固定目录结构、替换封面配置，并把最终文件生成在 文献 文件夹下。

固定路径

• 文献目录：项目根目录下的 文献/。
• 默认 LaTeX 模板：/g:/My_code/Agent_atuo_graduation_project_of_GDUT/模板/GDUT-Undergraduate-Thesis-LaTeX-Template-main/模板.tex。
• 文献翻译封面：/g:/My_code/Agent_atuo_graduation_project_of_GDUT/模板/文献翻译封面.pdf。
• 默认输出文件：文献/文献翻译.tex。

如果用户明确指定其他文献目录、模板或输出文件名，以用户指定为准；否则使用以上默认值。

触发后的启动流程

1. 定位项目根目录下的 文献/ 文件夹。
2. 列出可用文献文件，让用户选择要翻译的文献；如果用户已经明确指定文件，直接使用该文件。
3. 确认输入文件类型并提取正文：
   • PDF：使用 PDF 读取/OCR 能力提取文本；扫描版或无法复制的 PDF 需要说明 OCR 可能有误。
   • 加密或权限受限 PDF：先尝试读取元数据；若正文无法提取，暂停并要求用户提供未加密版本、可复制文本、DOCX/TXT 版本或密码，不要编造译文和文献信息。
   • DOCX：使用 Word 文档读取能力提取段落。
   • Markdown/TXT/LaTeX：直接读取文本内容。
   • CAJ/其他不可直接读取格式：先提示需要转换为 PDF、DOCX、TXT 或提供可提取文本版本。
4. 读取默认 LaTeX 模板，保留模板导言区、宏包、版式配置和文档结构。
5. 将模板中的封面命令替换为文献翻译封面。
6. 按规定目录结构生成文献翻译内容。
7. 写入 文献/文献翻译.tex；若该文件已存在，不要无提示覆盖，先询问用户是否覆盖，或生成带后缀的新文件名。
8. 简要报告源文献、输出路径、是否有 OCR/格式/参考信息需要人工复查。

封面替换规则

默认模板里可能存在类似配置：

% 封面设置
% 封面设置（仅当封面文件存在时插入，避免编译因找不到文件失败）
\newcommand{\makecover}{%
      \IfFileExists{论文封面.pdf}{\includepdf[pages=-]{论文封面.pdf}}{}%
}

生成文献翻译 .tex 时，应将封面文件改为模板目录中的 文献翻译封面.pdf。优先使用相对路径，确保编译入口所在位置能找到该 PDF；如果输出文件在 文献/ 下且直接编译该文件更方便，可使用可解析的相对路径或绝对路径。

推荐替换为：

% 封面设置
% 封面设置（仅当封面文件存在时插入，避免编译因找不到文件失败）
\newcommand{\makecover}{%
      \IfFileExists{/g:/My_code/Agent_atuo_graduation_project_of_GDUT/模板/文献翻译封面.pdf}{\includepdf[pages=-]{/g:/My_code/Agent_atuo_graduation_project_of_GDUT/模板/文献翻译封面.pdf}}{}%
}

如果当前 TeX 环境不支持 /g:/... 形式的绝对路径，则改用从输出文件到封面 PDF 的相对路径，并在完成说明中提示用户确认封面路径。

文档目录结构

最终正文必须使用以下一级和二级结构：

1 外文文献译文（1）
1.1 译文信息
1.2 翻译正文
2 外文文献原文（1）
2.1 文献原文

LaTeX 中通常映射为：

\section{外文文献译文（1）}
\subsection{译文信息}
...
\subsection{翻译正文}
...
\section{外文文献原文（1）}
\subsection{文献原文}
...

不要把编号写进标题文本中，除非模板没有自动编号能力。优先让 LaTeX 自动编号。

译文信息

1.1 译文信息 应尽量包含可从文献中提取到的信息：

• 外文题名
• 中文译名
• 作者
• 来源/期刊/会议/出版社
• 年份
• DOI 或 URL（如有）

缺失信息不要编造；用“未在原文中明确给出”或省略该项，并在完成说明中列为需复查项。

翻译正文规则

• 按自然段翻译，不要按句子碎片化翻译。
• 每次处理一个自然段；如果原文自然段过长，应按语义边界拆分，单次翻译内容不超过 500 个中文字或约 500 个英文单词对应的内容。
• 保留原文的技术术语、变量名、算法名、模块名、公式编号、图表编号和引用编号。
• 专业术语第一次出现时可采用“中文译名（英文原词）”，后文保持译名一致。
• 不要扩写、改写或添加原文没有的信息；翻译以忠实、通顺、学术化为目标。
• 公式、代码、表格、图题、图注、参考文献编号应尽量保留原样，必要时转换为 LaTeX 可编译格式。
• 如果原文含图表但无法直接嵌入图片，可保留图题/图注并说明图片需人工补齐。

原文保留规则

2.1 文献原文 中应放入被翻译的外文原文。

• 保留原始段落顺序。
• 对 LaTeX 特殊字符进行转义，避免 %、_、&、#、{} 等破坏编译。
• 原文中的公式、引用编号、图表编号尽量保留。
• 如果输入来源是 PDF/OCR，应说明原文文本可能存在识别错误。

加密或无法提取文本的文献

如果 PDF 加密、受权限限制、扫描质量过差或工具无法提取正文：

• 不要继续生成看似完整的译文；这会造成虚构内容风险。
• 可以生成一个流程测试或占位文件，但必须明确标注“未能提取原文，不能作为正式译文”。
• 正式任务中应暂停并请求用户提供未加密 PDF、密码、可复制文本、DOCX/TXT 版本，或允许改用 OCR。
• 只能使用文件名、PDF 元数据或用户明确提供的信息填写译文信息；无法确认的作者、来源、年份、DOI 不要猜测。

LaTeX 整合要求

• 保留模板的文档类、宏包、页眉页脚、目录、封面命令和编译配置。
• 仅替换或插入正文区域；不要随意删除模板依赖资源。
• 如果模板包含摘要、致谢、参考文献等毕业论文专用部分，而文献翻译不需要，应优先移除或注释这些与文献翻译无关的正文内容，同时保留必要导言区。
• 中文内容应使用模板已配置的中文支持，不要额外引入冲突宏包。
• 生成后检查：标题层级、封面路径、特殊字符、长表格、公式、图片路径、未闭合环境。

文件命名和覆盖

默认输出为 文献/文献翻译.tex。

• 如果文件不存在，直接写入。
• 如果文件已存在，先询问用户是否覆盖。
• 如果用户不想覆盖，使用 文献翻译_1.tex、文献翻译_2.tex 等递增命名。

完成回复格式

转换完成后，用简短清单说明：

文献翻译 LaTeX 已生成：
- 源文献：...
- 输出文件：文献/文献翻译.tex
- 使用模板：...
- 使用封面：...
- 需人工复查：...

若未能完成，说明卡在哪一步以及用户需要补充什么文件或确认什么选择。