證據、引用與範文¶

系統把「內容看起來像論文」和「內容有可驗證證據」分開處理。每一個來源先取得角色，再決定它能不能支持 claim、method 或 citation。

Evidence and exemplar boundary

Source roles¶

flowchart TD
    Source[Source material] --> Role{Assigned role}
    Role --> Claim[claim_evidence]
    Role --> Method[method_authority]
    Role --> Struct[exemplar_structure]
    Role --> Style[exemplar_style]
    Role --> Primary[user_primary_material]

    Claim --> Verify{metadata / full text verified?}
    Method --> Verify
    Primary --> Provenance{owner + method + data provenance?}
    Struct --> NoCredit[No claim or citation credit]
    Style --> NoCredit
    Verify -->|yes| Eligible[Eligible for bounded use]
    Verify -->|no| Pending[Pending / metadata-only]
    Provenance -->|yes| Eligible
    Provenance -->|no| Pending

Role	可做什麼	不可做什麼
`claim_evidence`	支持可定位的學術 claim	超出原文範圍推論
`method_authority`	支持方法選擇與 reporting	代替研究資料
`exemplar_structure`	分析段落順序、篇幅、論證節奏	搬用獨特句子、資料、引用
`exemplar_style`	校準可量測語氣與密度	逐字或輕度改寫仿寫
`user_primary_material`	在 provenance 清楚時支持研究結果	把未驗證資料包裝成公開文獻

PubMed 保存路徑¶

sequenceDiagram
    autonumber
    participant A as Agent
    participant P as PubMed Search MCP
    participant M as mdpaper MCP
    participant R as Reference store

    A->>P: unified_search(query)
    P-->>A: PMID + verified metadata
    A->>M: save_reference_mcp(pmid)
    M->>P: retrieve canonical record
    P-->>M: source-authentic metadata
    M->>R: persist 🔒 VERIFIED layer
    M-->>A: reference id + next guidance

若 API 不可用，可用 Agent-passed metadata fallback，但必須保留較低 trust 與 provenance；不得靜默升級成 verified。

Claim–evidence 對齊¶

flowchart LR
    Sentence[Draft sentence] --> Claim{Contains claim?}
    Claim -->|no| Continue[Continue]
    Claim -->|yes| Cite[Resolve citation token]
    Cite --> Ref[Reference artifact]
    Ref --> Full{Full text / source supports it?}
    Full -->|yes| Scope{Claim within source scope?}
    Full -->|no| Flag[C10 / C14 failure]
    Scope -->|yes| Pass[Claim-evidence pass]
    Scope -->|no| Narrow[Narrow claim or find evidence]
    Narrow --> Sentence

Citation presence 只證明「有一個 token」，不證明「引用真的支持句子」。C10 檢查全文狀態，C12 保存 citation decision，C14 檢查 claim–evidence alignment。

Exemplar audit¶

使用範文前，透過 project_action(action="exemplar_usage") 記錄：

stable source identity 與 optional SHA-256。
允許的 roles（structure、methodology、reporting、argument-map、style-calibration）。
目標 sections 與明確目的。
固定為 false 的 evidence_eligible、citation_credit、verbatim_copy。

紀錄位於 .audit/exemplar-usage.yaml，store 會拒絕 policy flags 被竄改，也會拒絕 verbatim-copy、evidence-substitute、citation-substitute、fabricated-data 等 prohibited roles。

Citation life cycle¶

stateDiagram-v2
    [*] --> Discovered
    Discovered --> MetadataVerified
    MetadataVerified --> FulltextPending
    FulltextPending --> FulltextReady
    MetadataVerified --> MetadataOnly
    FulltextReady --> Analyzed
    MetadataOnly --> Analyzed: only bounded metadata claims
    Analyzed --> Cited
    Cited --> Audited
    Audited --> [*]

最重要的邊界

範文可以告訴你「一個好 Discussion 如何安排」，不能告訴你「研究結果是真的」。形式相似度永遠不會轉換成 evidence eligibility。