mcpField
P
paper-source-trace

paper-source-trace

github.com/aminerorg生产力6438 次安装今天更新
代码仓库

关于 paper-source-trace

Paper Source Trace 是一项研究技能，可追踪目标论文中的主张及其引用来源，并生成有依据的分析材料。它强调本地证据、不确定性标注和结构化引用图。

主要功能

  1. 01以主张为中心追踪来源
  2. 02引用意图分类
  3. 03机器可读的引用图
  4. 04SVG 与交互式 HTML 图
  5. 05可选 AMiner 元数据补充

适用场景

  1. 01追溯论文主张的证据来源
  2. 02检查引用作用与上下文
  3. 03生成可视化引用图

安装

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

$npx skills add https://github.com/aminerorg/aminer-open-skill --skill paper-source-trace

安装后在 Claude Code 中输入/paper-source-trace确认已加载。

详细介绍

Paper Source Trace

Paper Source Trace 会将一篇目标论文转化为以证据为依据、以论点为中心的来源追踪产物。它始终使用规范的技能名称 paper-source-trace。

可通过自然语言或 /paper-source-trace 调用。

语言路由

  • 当用户主要使用中文写作或明确要求中文输出时，使用 SKILL.zh.md。
  • 其他请求均使用此 SKILL.md。
  • 在两种工作流中，json/graph/citation_graph.json 的键、意图标签、关系类型、来源角色和参数名称均保留英文。

英文工作流

标准产物

在证据和文件系统访问权限允许时，生成以下产物：

  • analysis.md：供人阅读的报告。
  • json/graph/citation_graph.json：遵循 references/schema.md 的规范机器可读图谱。
  • citation_map.svg：在可生成 SVG 时提供静态引用图。
  • citation_map.html：有图数据时提供单文件交互式图谱。
  • citation_map_chain.svg：仅当 svg: both 时提供链式来源追踪 SVG。
  • citation_map_spec.md：仅当 SVG 生成存在注意事项或失败时提供。

默认输出目录：

outputs/paper-source-trace/<safe-paper-stem>/

首选布局：

analysis.md
citation_map.svg
citation_map.html
citation_map_chain.svg          # only when svg is both
citation_map_spec.md            # only when SVG generation has caveats or fails
json/graph/citation_graph.json
json/aminer/*.json              # only when AMiner raw results are saved
json/extraction/*.json          # only when structured intermediates are saved

旧版兼容：如果用户写了 mode: current，则视为 svg: radial；mode: example 视为 svg: chain；mode: all 视为 svg: both。如果同时提供了 svg 和 mode，且二者冲突，请用户确认所需的 SVG 输出。hybrid、interactive graph 或 expandable knowledge graph 表示用户需要标准的 citation_map.html；这不是 SVG 模式，也不会改变 SVG 选项。

启动确认

在阅读论文、提取引用、检查 AMINER_API_KEY、调用 AMiner 或生成 SVG 之前，请先让用户确认：

  • SVG 输出：radial、chain 或 both。
  • AMiner 信息增强：on 或 off。

如果用户已提供其中一项或两项，请复述为暂定选项，并仍需请求最终确认。收到用户答复前应停止。

如果确实无法进行交互式确认，请使用建议的默认值：svg: both 和 aminer: on。在进行任何预计费用达到 ¥5 或更高的 AMiner 调用之前，仍须遵守高成本确认规则；如果缺少 AMINER_API_KEY，则跳过 AMiner 信息增强并继续本地分析。

核心规则
  1. 仅使用提供的论文文本、引用上下文、参考文献条目、用户备注或用户明确请求的 AMiner 结果作为证据。
  2. 不要仅凭领域知识推断引用意图。
  3. AMiner 信息增强必须由用户明确选择启用。除非用户提出请求，否则不要检查 AMINER_API_KEY。
  4. AMiner 可用于补充 ID、URL、候选参考文献匹配结果和外部引用关系，但不能取代本地引用上下文，也不能单独证明引用意图或来源追踪关系。
  5. 保留不确定性；如果引用上下文、参考文献匹配或来源角色证据不完整，应降低置信度。
  6. citation_sentence 和 context 保持目标论文的原文语言。它们是原始证据锚点，不是本地化说明。
  7. evidence、summary、notes、Markdown 报告文本以及可见的 SVG/HTML 界面均使用用户指定的输出语言。
  8. 如果可以写入输出文件，不要只提供聊天摘要就结束。
AMiner 补充信息

只要可以确认，就将 AMiner 视为 off，除非用户确认 aminer: on，或明确写出 enhance with AMiner、use AMiner metadata、complete paper_id 或 trace AMiner citation relationships。如果确实无法确认，建议的备用设置为 aminer: on。

启用时：

  1. 只检查 AMINER_API_KEY 是否存在；绝不打印令牌。
  2. 如果缺少该变量，继续本地分析，并记录已跳过补充信息。
  3. 使用最短可行调用链：paper_search 或 paper_search_pro、paper_detail、paper_relation 和 paper_info。
  4. 输出所有计划调用或已完成调用的费用汇总。
  5. 如果预估费用达到或超过 ¥5，在发起付费调用前请求明确确认。
  6. 将补充信息元数据记录在 json/graph/citation_graph.json 的 metadata.aminer_enrichment 下。
意图标签

除非用户明确扩展分类体系，否则只使用以下标签：

background、problem、core-method、supporting-method、dataset、metric、baseline、tool-resource、theory、result-evidence、limitation、future-work。

执行步骤
  1. 提出启动确认问题并等待答复。
  2. 确定输入证据和输出目录。
  3. 提取可靠的论文文本、参考文献条目和引文上下文。
  4. 在进行重要分类或追溯来源前，阅读 references/evidence_protocol.md。
  5. 使用允许的意图标签对引文进行分类。
  6. 在文本支持的前提下，提取目标论文的关键主张或贡献。
  7. 构建 source_traces[]，将主张与本地引文上下文、被引来源的作用及证据步骤关联起来。
  8. 提取能够解释目标论文的实体和关系。
  9. 如果启用了 AMiner，在不替代本地证据的前提下补充元数据。
  10. 在可视化产物之前写入 json/graph/citation_graph.json。
  11. 写入 analysis.md；仅在用户明确要求使用模板或固定格式时，才使用 references/analysis_template.md。
  12. 使用一条渲染器命令生成 citation_map.html 和已确认的 SVG 输出：python3 scripts/render_html.py --graph <output>/json/graph/citation_graph.json --output <output>/citation_map.html --svg <radial|chain|both> --language auto。
  13. 不要临时手写 SVG 或 HTML；两种静态 SVG 模式和 HTML 的 radial / chain 视图必须共用渲染器的布局、颜色、语言包、文本换行、节点优先级和边规则。
  14. 在最终答复前验证产物。
参考文件
  • references/schema.md：规范架构和 JSON 示例。
  • references/evidence_protocol.md：证据与不确定性规则。
  • references/prompts.md：英文和中文提取／审核提示词。
  • references/visual.md：SVG 和 HTML 图谱规则。
  • references/analysis_template.md：明确要求使用模板模式时的固定报告模板。
  • scripts/render_html.py：标准图谱渲染器。使用它生成 citation_map.html、citation_map.svg 和 citation_map_chain.svg；不要临时手写 SVG 或 HTML。
质量检查
  • 每条引用都包含 intent、evidence、confidence，以及 reference_id 或 unmatched_reference: true。
  • 每个意图标签都属于允许列表。
  • 关键引用可追溯到引用句或局部上下文。
  • citation_sentence 和 context 保留目标论文的原始语言；只有说明字段使用本地化语言。
  • 每个实体至少由一条引用支持。
  • 每条来源追溯信息都至少基于一个局部引用上下文；AMiner 元数据不能作为唯一依据。
  • 写入 json/graph/citation_graph.json 后，使用 scripts/render_html.py 生成 citation_map.html 和 SVG 图。HTML 和 SVG 必须使用同一种可见语言、相同的规范分组标签、相同的节点排序，以及相同的简化边布局策略。
  • 静态 SVG 只应使用有用的主要边，用 +N 概括密集分组，并避免引用到引用的交叉链接或仅基于 AMiner 的关系线。
  • 即使 Markdown、SVG 或 HTML 中带有注意事项，json/graph/citation_graph.json 仍须保持完整。

评论

支持 Markdown