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