zotero-analytical-writer

name	zotero-analytical-writer
description	使用 Zotero metadata、批注和 MinerU Fulltext，严格按 D:\ResearchVault\模板\论文精读模板.md 创建或更新 ResearchVault 中文精读笔记，并确保 Zotero 链接、公式与原文引用真实可追溯。

Zotero Analytical Writer

Canonical template

For every Note creation or content update, read D:\ResearchVault\模板\论文精读模板.md first and use it as the sole structural authority. Start a new Note by copying that template; for an existing Note, update it in place and normalize its body to the template rather than introducing a parallel structure.

Keep the visible section order exactly as follows:

基本信息 → 一句话摘要 → 研究对象 → 研究方法（方法概述 → 方法分析） → 数据来源 → 研究结论 → 关联精读笔记 → 我的判断

Keep the template's table, field labels, heading levels, and frontmatter fields. Replace every retained placeholder with verified content; remove unused optional formula blocks, surplus finding/quote pairs, and placeholder related-note links. Do not add legacy headings such as 研究对象与问题, 整体流程, 数据与证据定位, 局限与后续问题, or Zotero信息. Put limitations only in 方法局限、数据局限 and 我的判断.

职责与语料顺序

Writer 只负责分析层：metadata + annotations + MinerU Fulltext + 必要时 PDF → 中文 analytical note。

• Fulltext 是原文证据，分析笔记是中文理解层；不得把二者混为一谈。
• 仍保留现有的 theme、study_area、data_source、methodology、core_variable、key_finding、relevance、中文逻辑重构、学术垃圾过滤、公式防乱码、Zotero URI 和 Dataview 刷新逻辑。
• 不负责 PDF→MinerU；缺全文时交给 zotero-fulltext-archiver，不要自行伪造原文。
• 若已有正式 Fulltext，先复用并校验，不因 Note 模板修整而重新运行 MinerU。

Knowledge handoff contract

The Analytical Note is the structural-library layer for later Knowledge synthesis; it is not a substitute for the Knowledge Page template. Preserve machine-readable fields and make the following handoff explicit whenever the Note will feed Knowledge:

• distinguish author-reported findings, methods, limitations, and the writer's interpretation;
• retain the exact zotero_key, note_path, fulltext_path, formulas, quotations, and PDF/Fulltext entry points;
• record which conclusions were checked against Fulltext and which remain Note-only;
• never mark a Knowledge claim as fulltext_verified merely because the Note contains a summary;
• if a field or conclusion cannot be located in the Note or Fulltext, write “未在当前材料中定位到可核验原文”，not a reconstructed quote or inferred page number.

When a later Knowledge task asks for “all papers”, the Knowledge Maintainer must read the Note's structured fields and the linked Fulltext independently; the Writer must not collapse the two layers into a single unsupported summary.

Frontmatter 与稳定身份

Keep the template frontmatter (title、aliases、tags、created、source、author、year、theme、study_area、data_source、methodology、core_variable、key_finding、relevance) and replace its placeholders with verified values. Add the following identity and navigation fields after the template fields when the values are known:

type: literature-note
zotero_key: "Q22PFLNV"
pdf_key: "4RMSR7ZR"
doi: "..."
collection: "创新经济地理"
note_path: "论文库/创新经济地理/论文标题.md"
fulltext_path: "fulltext/创新经济地理/Q22PFLNV.md"

Do not batch-rewrite untouched historical Notes. When updating a specified Note, normalize that same file to the template and preserve verified content and stable identity; never create a duplicate Note. Add only confirmable fields and fulltext entry points. Treat zotero_key as the primary key and pdf_key as the attachment key. Prefer note/<collection>/ for new Notes while continuing to support the Vault's current 论文库/ paths.

原文引用规则

• “主要发现 + 原文引用”中的原文必须真实出现在 MinerU Fulltext 或 Original PDF。
• 严禁根据中文摘要反向生成英文 quote；定位不到时写“未在当前全文中定位到可核验原句”。
• 引用要保留必要上下文，检查否定、条件、稳健性限定、假设和局限。
• PDF 页码只有在可靠映射或实际 PDF 验证后才写入 zotero://open-pdf/...?...page= 或写入“PDF 第 n 页”；否则保留 Fulltext 链接并写“PDF 页码未验证”。不能因为 Fulltext 的 page_mapping: unknown 就猜页码，也不能因为页码未知而阻止通过原 PDF 直接核验引文。
• 结论区每一条“主要发现”都要紧邻至少一条真实原文引用；先在 MinerU Fulltext 定位，再在 Original PDF 核对上下文、否定、条件、稳健性和页码。找不到原句时明确写“未在当前全文中定位到可核验原句”，不得反向生成 quote。

内容与格式约束

• theme 概括研究问题；study_area、data_source、methodology、core_variable、key_finding、relevance 必须来自真实材料，不复制大段摘要。
• 过滤作者地址、单位、邮编、邮箱、基金号和排版垃圾；数据与方法缺失时如实说明。
• 公式仅在原文可靠时保留；乱码或残片不强行解释，也不为占位符生成符号拆解。
• 写入前检查 YAML、美元符号配对、zotero://select/... 和 PDF/Fulltext 入口。
• 写入前检查标题层级、模板占位符是否清除、结论是否成对、公式是否闭合，以及 fulltext_path 与 Note↔Fulltext 双向入口是否存在。
• 关联精读笔记 只保留与研究问题、方法或结论存在直接关系的真实 Note；没有可确认的关联时，保留章节说明但移除示例链接。

写入与索引

1. 先判定是新建还是更新指定 Note；两种情况都先读取当前模板。更新时允许重排正文以匹配模板，但不得改变稳定身份或制造重复 Note。
2. 在基本信息区的链接行加入 全文 Markdown：[[fulltext/<collection>/<zotero_key>]]（路径存在时），并保留可验证的 Zotero 入口。
3. 新建论文笔记时才刷新四个根 Dataview 索引；更新既有 Note 不触发全库批量重写，但若标题、路径或索引字段变化，定向刷新受影响索引。