name	paper-full-translate-zh
description	将用户提供的论文完整翻译为中文 Markdown，尽量不遗漏正文内容，保留图片、图题、表格与公式，并创建一个以论文名称命名的目录，将原论文与产物统一收纳在其中。 Use when: 用户要求逐段全文翻译论文、保留图片图表公式、输出 Markdown、并附带研究笔记。
license	MIT
metadata	{"author":"workspace","version":"0.5.3"}

Paper Full Translate Zh

你负责把用户提供的论文整理为可读、可追溯的中文 Markdown 版本，并补充一份研究笔记。全文翻译文件只负责保真重建正文；“剥洋葱式文献导读”需要放在 notes.md 的最前面，而不是写入 full.md。

最终产物默认包括：

一个以论文名称命名的目录
被移动进该目录中的原论文文件
位于该目录中的全文翻译 Markdown
位于该目录中的阅读笔记 Markdown
位于该目录中的资源目录，用于保存图片或无法可靠重建的图表片段

总输出仍然只有两个 Markdown 文件：

全文翻译 Markdown
阅读笔记 Markdown

默认命名规则：

输出目录：<paper_title_dir>/
原论文：移动后的原始文件名，保持扩展名不变
全文翻译：<paper_stem>.zh-CN.full.md
资源目录：assets/
阅读笔记：<paper_stem>.zh-CN.notes.md

资源目录命名补充规则：

资源目录默认固定命名为 assets/，不要把长论文标题或 paper stem 再重复拼进资源目录名
这样做的主要目的是降低 Windows 下的路径长度，避免 Markdown 预览、图片加载、文件复制或导出时触发路径过长问题
若历史目录中已经存在旧命名资源目录且用户未要求迁移，可沿用旧目录；新产物默认优先使用短目录名 assets/

目录命名规则：

优先使用论文标题生成目录名
若无法稳定取得论文标题，则回退到原文件名 stem
目录名需要做文件系统安全化处理，移除 Windows 非法路径字符
如果目标目录已存在，则复用该目录，不重复创建平行副本

默认情况下，如果用户提供的是本地论文文件，应将原文件剪切到这个目录中，而不是保留在旧位置。

When to Apply

在以下场景使用本 skill：

用户要求把论文全文翻译成中文
用户要求保留图片、图题、表格、公式
用户要求输出为 Markdown 文件
用户要求把结果与原论文放到同一个目录中
用户要求按论文名称创建目录来收纳原文与产物
用户要求额外生成读书笔记、总结、研究启发

在以下场景不要优先使用本 skill：

用户只要摘要翻译或只要简短总结
用户只要文献综述，不需要逐段全文保真翻译
用户没有提供论文文件、可访问链接或明确来源

Required Outcome

你需要产出三个层面的结果：

一个以论文名称命名的统一输出目录
结构保真的全文中文翻译
图片、图题、表格、公式的完整保留或可追溯降级保留
位于 notes.md 最前面的“剥洋葱式文献导读”
一份可直接用于阅读和研究选题的笔记总结

Inputs to Confirm

如果用户没有明确说明，先补齐以下输入；若任务能继续推进，则采用默认值并在结果中注明：

论文来源：本地 PDF、arXiv 页面、HTML、LaTeX 源码或其他链接
目录命名：使用论文标题，还是强制使用用户给定名称
输出形式：只要中文，还是中英对照
笔记形式：单独笔记文件，还是附在全文翻译末尾
是否需要翻译参考文献条目标题
是否允许对扫描版 PDF 使用 OCR 作为降级方案

默认值：

目录默认使用论文标题命名；若标题不可得，则使用原文件名 stem
输出为纯中文，不做中英对照
笔记单独存为 .notes.md 文件
“剥洋葱式文献导读”默认放在 notes.md 最前面
默认导出图片文件，并创建 assets/ 目录
参考文献保留原始引用串，不强行翻译作者名与出版信息
遇到扫描版或提取质量差的 PDF 时，允许 OCR，但必须标注风险

Workflow

1. Validate the Source

只处理用户提供的本地文件或用户明确指定的论文链接
先识别来源类型：PDF、arXiv HTML、普通 HTML、LaTeX 源码
优先级默认如下：结构化 HTML 或 LaTeX > 可提取文本的 PDF > OCR PDF
如果存在结构化来源与 PDF，同步核对标题、作者、章节，避免版本错配

2. Create the Paper Directory First

在开始生成任何产物前，先确定论文标题
用论文标题生成一个文件系统安全的目录名 <paper_title_dir>
在原论文所在目录下创建这个目录
如果输入是本地文件，则把原论文文件剪切到该目录中
如果输入是远程链接，则将下载得到的原论文文件直接保存到该目录中
所有后续产物都必须写入该目录内，不要散落在上级目录

目录布局默认如下：

<paper_title_dir>/
  <original_paper_filename>.pdf
  <paper_stem>.zh-CN.full.md
  <paper_stem>.zh-CN.notes.md
  assets/

3. Build a Structural Map Before Translating

在真正翻译前，先建立论文结构清单：

标题、作者、摘要、关键词
各级章节标题
正文段落顺序
公式编号与位置
图片编号、标题、引用位置
表格编号、标题、列结构
脚注、附录、致谢、参考文献

质量要求：

任何进入最终译文的段落，都必须能回溯到原文中的一个明确位置
不允许先总结再“扩写成翻译”
不允许跳过 appendix、figure caption、table caption、footnote 这类容易漏掉的部分

实现建议：

如果来源是结构化 HTML，或者论文包含大量公式、表格、图题、附录，需要重复解析同一来源，允许编写一次性的临时本地提取脚本来批量抽取章节、公式、表格、图题与图片清单
临时脚本只是中间工具，不属于最终交付物；在产物生成完成后应删除，避免在工作区残留无关文件
临时脚本应服务于“结构保真提取”，不要把它写成摘要生成器或自由改写器

4. Extract Figures, Tables, and Equations

Figures

提取所有正文图片，并保存到 assets/ 目录
文件名使用稳定顺序，例如 figure-01.png、figure-02.png
在 Markdown 中用相对路径引用图片
图片插入位置应尽量与原文相对位置一致，至少要与对应 caption 紧邻
如果无法单独提取图片，但能从页面裁切获得可读版本，则保存裁切图，不要直接省略
对双栏或多栏 PDF，必须先判断图片和 caption 所在栏，再按该栏的边界裁切；不要把相邻栏的正文段落一起裁进图片
如果图位于右栏或左栏，不要为了“留白保险”横向扩到整页；允许保留少量页边空白，但不应包含无关正文、节标题、页码或参考文献正文
完成裁切后，应至少再核对一次：导出的图片是否只包含目标图及其必要留白，而不包含相邻正文列
对 PDF 来源，默认优先使用“页面区域渲染”来导出图，而不是直接导出原始 image XObject
只有在确认 raw image XObject 与页面最终渲染结果一致时，才允许直接导出原始图片对象
如果 PDF 图像对象带 soft mask、透明通道、叠加文字、矢量箭头、边框、标注或多图层合成效果，不要直接导出底层图片；应改为按图的边界框裁切页面并渲染
页面区域渲染时，应关闭透明输出或显式铺白底，避免导出的 PNG 出现黑底、缺字、缺线框或透明区域显示错误
若一张图由多个页面对象共同构成，导出结果必须以 PDF 阅读器中的最终可见效果为准，而不是以单个底层对象为准
如果无法稳定确定图的边界框，允许扩大裁切范围并在结果中保留少量页背景，也不要错误导出成黑底或缺损图
在 Windows 环境下，若论文目录名较长，务必优先使用短资源目录 assets/ 与简短图片文件名，例如 assets/figure-01.png，避免因绝对路径过长导致 Markdown 预览无法显示图片

Tables

优先转成 Markdown 表格
如果原表格过宽、跨行跨列复杂或 Markdown 会严重失真，则改用 HTML table
如果仍无法可靠重建，则用文字概括表格结构与关键信息，并明确标记该处建议人工复核
如果表格最终需要以截图形式保留，裁切范围必须覆盖 caption 与完整表体，但不要把表后正文段落、下一小节标题或页码上方的大段正文一起裁入
如果表格跨页，不要只保留其中一页；应把各页表体拼接成同一张图，或按顺序保留多张表格图片并在 Markdown 中连续引用
对截图保留的表格，交付前至少核对一次表头、末行和 caption 是否都完整出现，避免出现只截到半张表或把后续正文误当作表的一部分

Equations

优先保留为 LaTeX 形式的行内公式与块级公式
原始变量名、上下标、希腊字母、编号必须保持一致，不要意译
块级公式使用 $$...$$
行内公式使用 $...$
如果公式原本是图片或提取失败，先尝试手工转写为 LaTeX；若仍不可靠，则保留公式图片并标记该处为降级保留

5. Translate Without Omissions

翻译时必须遵守以下原则：

逐段推进，不跳段，不合并多段后只写摘要式中文
所有章节标题、图题、表题、脚注、附录标题都要处理
公式本身不翻译，只翻译公式前后的说明文字
代码、伪代码、算法名、数据集名、模型名保持原文；必要时可在后面补一个简短中文解释
专有名词首次出现时可写成“中文（英文）”，后续保持一致
遇到拿不准的短语，不要编造；保留原词并在邻近处给出谨慎中文释义

特别要求：

目标是全文翻译，不是摘要翻译
如果某段无法可靠提取，必须显式标注“此处原文提取不稳定，建议人工复核”，而不是默默省略

6. Reconstruct the Markdown

全文 Markdown 的推荐结构：

# 中文标题

## 论文信息
- 原文标题：...
- 作者：...
- 来源：...
- 原文件：<paper_title_dir>/<original_paper_filename>

## 摘要
...

## 1 引言
...

![Figure 1: ...](assets/figure-01.png)

$$
...
$$

## 参考文献
...

重建时注意：

保持原文章节层级，不要随意改写结构
图片和表格尽量放在原文首次引用之后的近邻位置
使用相对路径，确保 Markdown 在同目录打开时可直接显示资源
如果原文有编号标题，尽量保留编号
若在 VS Code 或 Windows 中预览 Markdown，优先使用短相对路径，例如 assets/figure-01.png，不要让资源目录名随论文标题无限增长

7. Add the Onion-Peeling Paper Guide

在 notes.md 的最前面追加一个独立章节，标题固定为：

## 剥洋葱式文献导读

该章节必须包含以下 4 步，且顺序固定：

第 1 步：全盘吸收与一句话总结（Context）

阅读整篇论文后，提炼该部分内容的核心动机
用一句话说明“这段内容在解决什么实际问题”
这句话必须落到实际问题，而不是泛泛复述论文标题

第 2 步：构建直觉与生活隐喻（Grounding）

暂时抛开学术名词
强制使用一个极其通俗的生活场景来类比核心机制，例如水管分流、切蛋糕、图书馆借书、快递分拣、餐厅排队等
隐喻必须覆盖论文的主要运行逻辑，而不是只类比局部现象

第 3 步：聚焦核心公式拆解（Core Focus）

挑出最能代表论文机制的 1 到 2 个核心公式
把公式中的关键符号与第 2 步的生活隐喻做一一对应
用大白话解释这些符号在现实场景里分别代表什么
说明这些公式的物理意义、逻辑意义或优化目标

第 4 步：全盘扫荡与补全（Exhaustive Mapping）

在讲清楚核心逻辑之后，再把剩余边缘公式、辅助定义或推导步骤逐步补进整体框架
解释这些部分分别在整个方法里承担什么角色
强调它们是“补全主线”而不是另起一套解释

约束要求：

这部分必须写在 notes.md 的最前面，放在其他笔记内容之前
这部分不得写入 full.md，也不得新建第三个 Markdown 文件
语气应偏讲解，不要写成论文式摘要复述
隐喻必须真正可理解，避免使用新的抽象术语去解释旧术语
核心公式只能选 1 到 2 个，避免把“核心公式拆解”写成公式流水账

8. Write the Notes File

笔记文件要面向研究阅读，而不是重复全文翻译。其顺序应当是：

先写“剥洋葱式文献导读”
再写常规研究笔记

除导读部分外，笔记至少包含：

论文基本信息
一句话核心问题
方法主线
主要贡献
关键实验结论
关键公式或机制
优点
局限
与当前研究主题的关系
值得追的后续问题

推荐模板：

# 论文阅读笔记

## 剥洋葱式文献导读

### 第 1 步：全盘吸收与一句话总结（Context）

### 第 2 步：构建直觉与生活隐喻（Grounding）

### 第 3 步：聚焦核心公式拆解（Core Focus）

### 第 4 步：全盘扫荡与补全（Exhaustive Mapping）

## 基本信息
- 标题：
- 作者：
- 年份：
- 来源：

## 一句话总结

## 研究问题

## 方法概览

## 主要贡献
1. 
2. 
3. 

## 实验与结果

## 关键点摘录

## 局限与风险

## 对我当前课题的启发

## 后续可追论文

9. Perform Completion Checks

交付前逐项检查：

章节数量与原文主结构是否一致
是否漏掉摘要、附录、图题、表题、脚注、致谢、参考文献
原论文文件是否已经移动到论文名称目录中
full.md、notes.md、assets 和原论文是否都位于同一个论文名称目录中
所有图片链接是否存在且可相对访问
表格是否可读
公式是否保持原义和排版边界
“剥洋葱式文献导读”是否位于 notes.md 最前面
导读部分是否完整覆盖 4 个步骤
输出文件是否与原论文位于同一目录
是否对所有无法可靠提取的部分做了显式标注

Decision Rules

If the source is arXiv

优先使用结构化页面或 LaTeX/HTML 内容提取正文与公式
使用 PDF 仅作为核对图片编号、分页和可能遗漏内容的补充来源

If the source is a normal PDF with extractable text

先做文本层提取，再与页面视觉结构核对
对多栏、脚注、浮动图表额外检查，避免阅读顺序错乱
对图片导出，优先验证是否存在 transparency / smask / 多对象叠加；一旦存在，必须改用页面裁切渲染而不是 raw image export

If the source is a scanned PDF

明确告知会使用 OCR，准确率可能下降
优先保证不遗漏内容，其次再优化排版
不确定的内容要保留原截图或原文片段用于人工复核

If figures or equations cannot be reconstructed perfectly

允许降级为截图或原始片段保留
不允许静默丢弃
在 Markdown 中注明该元素采用降级保留

Output Standard

优秀结果应满足：

用户能直接打开 Markdown 顺序阅读整篇中文论文
用户能在一个以论文名称命名的目录中同时找到原文、全文译文、笔记和资源文件
图片、图题、表格、公式在阅读位置上基本正确
即使有个别提取失败之处，也有明确标注与回退内容
用户在读完 notes.md 开头的“剥洋葱式文献导读”后，能够先抓住直觉，再回到公式与全文
笔记部分能够帮助用户快速判断论文价值、方法逻辑与研究启发
PDF 导出的图片应与 PDF 阅读器中的最终显示效果一致，不应出现因透明蒙版、黑底或图层丢失导致的失真

Example Prompts

把这篇 PDF 收进一个以论文名命名的目录里，原文件剪切进去，再生成全文中文 Markdown、notes 和 assets。
处理这个 arXiv 论文链接，创建论文名称目录，并把下载的原论文、中文全文 md、notes 文件和 assets 一起放进去。
对这篇论文做逐段翻译，不要省略 appendix，公式用 LaTeX，图表尽量原位保留，所有结果与原论文放在同一个论文名称目录里。
在 notes.md 最前面追加“剥洋葱式文献导读”，但总共仍然只输出 full.md 和 notes.md 两个文件。

Weak Points to Clarify with the User

当首次为某个用户执行此 skill 时，优先确认下面几个容易引发返工的问题：

参考文献部分是保留原始英文，还是连标题一起翻译
最终要单独两份文件，还是全文翻译和笔记合并成一份
目录名是使用论文标题，还是使用用户给定的名称
对扫描版 PDF 的 OCR 误差是否接受
是否需要中英对照版本而不是纯中文版本

name	paper-full-translate-zh
description	将用户提供的论文完整翻译为中文 Markdown，尽量不遗漏正文内容，保留图片、图题、表格与公式，并创建一个以论文名称命名的目录，将原论文与产物统一收纳在其中。 Use when: 用户要求逐段全文翻译论文、保留图片图表公式、输出 Markdown、并附带研究笔记。
license	MIT
metadata	{"author":"workspace","version":"0.5.3"}