mcpField
N
nature-reader

nature-reader

github.com/yuan1z0825文档处理51.2k15.2k 次安装今天更新
代码仓库

关于 nature-reader

nature-reader 是将研究论文制作为 Markdown 阅读材料或译文的技能,支持多种来源格式,并通过来源映射和术语表保持内容有据可查且术语一致。

主要功能

  1. 01PDF、HTML、DOI 与粘贴文本流程
  2. 02先建来源映射的阅读流程
  3. 03双语阅读材料
  4. 04重复术语表
  5. 05图表与公式处理指南

适用场景

  1. 01将论文制作为 Markdown 阅读材料
  2. 02翻译整篇论文
  3. 03提取并翻译指定段落
  4. 04回答带来源依据的论文问题

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/yuan1z0825/nature-skills --skill nature-reader

安装后在 Claude Code 中输入/nature-reader确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

manifest.yaml
README_EN.md
README.md
agents/
openai.yaml
evals/
evals.json
references/
article-anatomy.md
equation-handling.md
figure-extraction.md
grounding-rules.md
output-spec.md
scripts/
validate_reader_math.py
static/core/
output-contract.md
principles.md
workflow.md
static/fragments/source/
doi-arxiv.md
html.md
pasted-text.md
pdf-text.md
scanned-pdf.md

详细介绍

全文 Markdown 阅读器 — 路由

路由协议

首先区分是创建阅读器,还是回答问题或翻译摘录。 对于带来源链接的问题,阅读 references/grounding-rules.md,并仅检查相关的 来源材料;在可用时复用已有的 source-map ID。不要重新生成阅读器,也不要 在回答前要求完整的 source map。对于明确的摘录请求,对该摘录应用提取、 翻译和依据规则。下方的完整工件工作流适用于用户请求阅读器或全文翻译时。

对于新任务,加载下方的核心资源和匹配资源。在后续追问中复用已加载的指引;仅在任务需要时加载更多内容。

1. 加载清单和核心层

阅读 manifest.yaml。它声明了 source_format 轴、允许的值,以及每个值映射到的文件路径。

同时阅读 always_load 下列出的每个文件。这些文件包含适用于每个阅读任务的核心原则、阅读工作流和输出契约,以及用于构建重复术语表的共享 Terminology Ledger。

2. 检测来源格式

根据清单的 detect: 提示和用户输入,确定 source_format 的值:

  • pdf-text — 可选文本 PDF。默认值。
  • scanned-pdf — 仅图像或需要 OCR 的 PDF。
  • html — 出版商或预印本 HTML 页面。
  • doi-arxiv — 必须先解析的裸 DOI 或 arXiv 链接。
  • pasted-text — 粘贴的正文或笔记,无可检索的原始排版。

在处理前用一行简短说明向用户告知检测到的值,以便他们能以低成本纠正你。一个来源可能映射到多个值(例如解析为 PDF 的 DOI);先加载解析片段,再加载解析后工件的片段。

3. 加载匹配的片段

阅读为检测到的 source_format 映射的文件。不要阅读 static/ 中的每个片段。仅加载步骤 2 所选的内容。

4. 使用已加载的材料构建阅读器

按以下优先级顺序应用已加载的片段:

  1. 核心原则(core/principles.md)— 默认双语阅读器,按含义翻译,绝不降级为摘要,版权注意事项。
  2. 来源格式片段 — 如何为此输入提取文本、图表和表格。
  3. 阅读工作流(core/workflow.md)— 六步 source-map 优先流程。
  4. 输出契约(core/output-contract.md)— 必需文件以及响应前验证清单。

在翻译时构建 Terminology Ledger(../nature-shared/core/terminology-ledger.md);它将成为 paper.md 的重复术语表和 source_map.json 的术语表。

如果约束条件妨碍完整处理,仍要创建阅读器草稿,并在 translation_notes.md 中标注缺失的页面、图表或低置信度的裁剪。不要切换到摘要模式。

5. 仅在需要时查阅参考

references/ 下的文件是深度参考,而非默认项。根据清单中的 references.on_demand 表按需打开它们:

  • 详细的图表裁剪和放置 → references/figure-extraction.md。
  • paper.md / source_map.json 的确切字段模式 → references/output-spec.md。
  • 方程、数学表达式、化学式或仅图像形式的公式 → references/equation-handling.md。
  • 使用来源引用回答追问 → references/grounding-rules.md。

评论

支持 Markdown