总结论文
概述
使用此技能从用户提供的来源中总结一篇学术论文。提取论文的目的、主要贡献、技术、局限性和未来前景，然后在环境允许创建文件时输出 Markdown 总结和 Excel 工作簿。
核心规则
- 每个事实性声明都必须基于提供的论文。不要添加外部背景、作者意图、影响力声明或领域上下文，除非用户明确要求。
- 区分论文陈述的内容与推断内容。将每个条目标记为
原文明确、原文概括、合理推测或未提及。 - 仅在论文未直接陈述该条目，但推断基于附近的方法、结果、局限性或结论文本时，使用
合理推测。 - 推断性语言需保持谨慎，使用诸如
可推测、可能、倾向于说明或未来可进一步等短语。 - 不要过度解读。如果证据薄弱，将条目标记为
未提及或在证据列中解释不确定性。 - 保留论文实际陈述的重要细节，包括任务设置、数据集、模型/框架、实验设置、评估指标以及相关命名技术。
- 使用简短的证据引用而非长引文。尽可能引用页码、章节、表格、图形或段落锚点。
- 如果论文文本不完整、扫描件或提取质量较差，在总结前说明该限制，避免用自信的声明填补空白。
- 在面向用户的 Markdown 中，按六个所需维度对内容进行分组，并在同一维度下以项目符号形式显示多个声明。不要将重复的
研究目的、主要贡献或其他重复维度作为独立的视觉部分呈现。 - 在 JSON/Excel 行中为可追溯性保留声明级别的记录，但确保行按维度排序，以便下游页面可以清晰地对它们进行分组。
工作流程
- 识别论文来源类型：PDF、DOCX、Markdown、纯文本、粘贴的摘录或提取的文本。
- 首先阅读摘要、引言、方法、实验/结果、讨论、局限性和结论。
- 扫描正文其余部分以查找影响所需类别的声明。
- 在起草最终总结之前，构建一个带有证据锚点的声明列表。
- 填充所需维度：
研究目的主要贡献使用技术/方法实验与结果不足/局限未来前景/后续工作
- 对于每个维度，包含论文中明确存在的所有实质要点。
- 仅在所有原文内容条目之后添加谨慎的推断条目，并明确标记为
合理推测。 - 首先生成 Markdown 输出，将声明列表分组到维度标题下。
- 当文件创建可用时，使用
scripts/write_paper_summary_excel.py生成 Excel 输出。 - 当文件创建可用时，使用
scripts/archive_summary_outputs.py归档生成的 Markdown、JSON 和 Excel 文件，以便文献管理网页可以自动发现新论文。优先采用本地结构，其中一个论文文件夹包含来源 PDF/文本提取和生成的总结输出；网页只会导入总结输出文件。
Markdown 输出
使用此结构：
# 论文总结：<论文标题或用户提供文件名>
## 基本信息
- 标题：
- 作者：
- 年份/会议或期刊：
- 研究领域：
- 资料完整性说明：
## 总览
<用 3-6 句话概括论文解决的问题、方法和结论。只写原文可支持的信息。>
## 逐项总结
### 研究目的
- 【原文明确｜高】...（依据：Abstract; Introduction）
- 【原文概括｜高】...（依据：Introduction）
### 主要贡献
- 【原文明确｜高】...（依据：Contribution bullets）
### 使用技术/方法
- 【原文明确｜高】...（依据：Method）
### 实验与结果
- 【原文明确｜高】...（依据：Experiments; Table 1）
### 不足/局限
- 【原文明确｜高】...（依据：Limitations; Conclusion）
### 未来前景/后续工作
- 【原文明确｜高】...（依据：Conclusion）
## 推测内容清单
| 推测项 | 推测依据 | 置信度 | 后期核查建议 |
|---|---|---|---|
| ... | ... | 高/中/低 | ... |
## 需注意的原文限制
- ...
指南：
- 通过在每条项目符号开头放置类型和置信度，使原文和推断内容在视觉上保持区分，例如
【原文明确｜高】。 - 每个所需维度应作为标题出现一次。如果有多点，则将它们作为该标题下的项目符号列出。
- 如果某个维度在论文中没有支持，则包含一个标记为
【未提及｜】的项目符号，并解释论文未提供该信息。 - 仅当谨慎的推断有用时，才添加单独的
合理推测项目符号，并将其也列在推测内容清单中。 - 即使
推测内容清单为空也要包含；当未使用任何推断时，写入无。 - Markdown 分组项目符号和 JSON/Excel 声明行必须描述相同的底层声明，尽管 Markdown 为了可读性进行了分组。
Excel 输出
当用户要求 Excel 输出，或者可以创建文件时，除了 Markdown 之外，还要生成一个 .xlsx 工作簿。
使用名为 论文总结 的工作表，包含以下列：
维度类型总结原文依据/推测依据置信度后期核查建议
使用 scripts/write_paper_summary_excel.py 从 JSON 文件创建工作簿：
python scripts/write_paper_summary_excel.py summary.json paper_summary.xlsx
预期的 JSON 形状：
{
"paper_title": "论文标题",
"authors": "作者 A; 作者 B",
"venue": "期刊或会议; 年份",
"year": "2026",
"field": "研究领域",
"overview": "供文献管理器卡片使用的简短论文级概述。",
"rows": [
{
"dimension": "研究目的",
"basis_type": "原文明确",
"summary": "论文陈述的内容。",
"evidence": "摘要; 引言。",
"confidence": "高",
"review_suggestion": ""
}
]
}
保持 JSON 和 Excel 行为声明级别的记录，按六个所需维度排序。尽可能包含上述论文级的 JSON 字段，以便文献管理网页可以渲染包含标题、会议/年份、主题和简短概述的紧凑卡片，而不是从声明行推断它们。
数据库归档输出
创建 Markdown、JSON 和 Excel 输出后，将它们归档以供动态文献管理网页使用：
python scripts/archive_summary_outputs.py summary.json paper_summary.md paper_summary.xlsx
归档行为：
- 如果设置了
SUMMARIZE_PAPER_LIBRARY_DIR，则归档到该目录。 - 否则，当 Documents 文件夹存在时，归档到
~/Documents/summarize-paper-library/inbox。 - 否则，归档到
~/.summarize-paper-library/inbox。 - 将每篇论文放入一个稳定的论文标题子文件夹中，并保持
summary.json、summary.md、summary.xlsx和manifest.json在一起。 - 当希望文件夹名称与手动整理的
paper/<论文文件夹>/...库匹配时，使用--folder-name "作者 - 年份 - 标题"。 - 仅当需要将版本化运行保存在不同文件夹中时，才使用
--timestamped。
网页可以监视归档收件箱或父级的 paper 文件夹，并在新的技能输出出现时自动刷新。它会递归扫描子文件夹，仅导入 summary.*、paper_summary.* 和 *_paper_summary.* 文件，忽略 PDF 和提取的文本文件。
质量检查
在完成之前：
- 确认每个所需维度作为 Markdown 标题恰好出现一次。
- 确认一个维度内的多个点是该标题下的项目符号，而不是重复的维度块。
- 确认每个事实性总结条目都有一个证据锚点。
- 确认每个推断条目都标记为
合理推测。 - 确认没有推断条目混入
原文明确或原文概括行。 - 确认 JSON 和 Excel 声明行与分组的 Markdown 项目符号一致。
- 确认缺失的来源信息被标记为
未提及而非编造。 - 确认生成的文件在文件创建可用时已归档以供文献管理网页使用。