QQcites-skill/references/citation-ranking.md

5.3 KiB

QQcites Citation Ranking

Use this reference when a request has more than one claim, many local-note hits, or ambiguous citation choices.

Candidate Search Pattern

Search each claim with four groups of terms:

  1. Core nouns: material, molecule, device, disease, target, method, or phenomenon.
  2. Mechanism verbs: drives, activates, suppresses, coordinates, adsorbs, transports, degrades, detects, heals, oxidizes, reduces.
  3. Performance words: sensitivity, stability, conductivity, capacity, selectivity, efficiency, biocompatibility, degradation, response time.
  4. Synonyms and translations: Chinese terms, English terms, abbreviations, chemical formulas, and common aliases.

Use several narrow searches instead of one broad search. Example:

rg -n -i "MXene|Ti3C2|conductivity|electromagnetic shielding" "C:\Users\qyh15\Documents\Obsidian Vault\01 文献阅读"

Adjust the vault subfolder if QQnote-skill documents a different current literature-note folder.

DeepSeek Screening Prompt

When DeepSeek is available, pass only the manuscript claim and candidate snippets needed for ranking:

Task: Rank local literature-note candidates for supporting one manuscript sentence.

Manuscript sentence:
<sentence>

Candidate notes:
<numbered snippets with title/year/DOI/path if available>

For each candidate, judge:
1. relevance: direct, partial, background/review, weak, unrelated
2. article type: review, primary research, method, unclear
3. whether it truly supports the sentence or only shares keywords
4. one-sentence reason

Return a ranked list. Prefer review articles for broad background claims, but prefer primary evidence for specific experimental or mechanistic claims.
Do not invent metadata or references not present in the candidates.

Tie-Breaking

Rank candidates using this order:

  1. Direct support for the exact claim.
  2. Stronger article type for the sentence purpose:
    • review first for broad field status, motivation, classification, mechanisms overview, or "recent advances" wording.
    • primary research first for exact material composition, synthetic method, measurement, performance number, biological effect, or device result.
  3. Newer review if two reviews provide similar background coverage.
  4. Higher-quality note evidence: abstract plus detailed AI note beats title-only or metadata-only matches.
  5. DOI and complete Zotero metadata available.

Final Table Template

Use this compact table for most answers:

Rank Citation candidate Type Strength Why it fits Suggested use
1 Title. Journal, Year. DOI: ... review direct/background ... Cite after clause ...

If a sentence has no strong local match, write No strong local match found and list the closest weak candidates separately.

Performance Comparison Tables

When the user asks for a literature performance table, define hard inclusion criteria before recommending papers. Typical criteria include material family, stimulus type, whether the paper is primary research, whether the target metric is reported, whether units can be normalized, and whether the item is present in local Zotero/Obsidian. Put only papers that satisfy the table criteria in the main table. Papers that report only angle, displacement, speed, demonstration photos, or concept-level behavior should be listed as supplemental or non-comparable unless the user explicitly wants them.

Extract performance parameters from the local Zotero PDF whenever possible. Record the evidence level for every number: main text, figure caption, supporting information, graph digitization, abstract only, or calculated. If a value requires graph reading, label it as needs digitization until the figure has actually been digitized. Do not present graph-estimated values as directly reported values.

Normalize units before comparison. Use cm^-1 for curvature (1 mm^-1 = 10 cm^-1) and mW cm^-2 for light intensity (1 W cm^-2 = 1000 mW cm^-2). If the paper reports total optical power rather than power density, label it as total power, not normalized and do not convert it to mW cm^-2 without the illuminated area. Keep maximum temperature, temperature rise, and photothermal conversion efficiency as separate metrics.

For angle-only actuator data, convert to curvature only when the effective bending length is known and the geometry makes the conversion defensible. Use kappa = theta(rad) / L(cm) and record the length and source. If the effective length is missing, write not convertible from main text rather than forcing a number.

Default table triage:

  • main-table usable: primary research, target material/stimulus, directly reports the target metric or supports a defensible unit conversion.
  • supplemental comparison: relevant material/stimulus but reports a different metric such as angle, speed, displacement, or application behavior.
  • not recommended: review, wrong stimulus, non-target material family, no performance metric, or only broad background relevance.

Maintain a manuscript-specific performance-table ledger in addition to the citation ledger. Track table name, DOI, Zotero key, title, material system, metric values, evidence level, whether it was used in the main or supplemental table, and any caveats such as figure only, angle-only, or total power.