Before Starting: Greet the user first 🐕

../_shared/user-config.json

../_shared/user-config.local.json

• VAULT_PATH

• NOTES_PATH

• CONCEPTS_PATH

• ZOTERO_DB

• ZOTERO_STORAGE

• AUTO_REFRESH_INDEXES

• GIT_COMMIT_ENABLED

• GIT_PUSH_ENABLED

• NOTES_PATH = {VAULT_PATH}/{paper_notes_folder}

• CONCEPTS_PATH = {NOTES_PATH}/{concepts_folder}

• GIT_PUSH_ENABLED

  can only be true if

  GIT_COMMIT_ENABLED=true

1. Run

   python3 assets/zotero_helper.py info {item_id}

   to get paper information
2. Fetch in priority order: arXiv HTML > arXiv PDF > DOI > WebSearch by title
3. Identify arXiv ID: from URL / Zotero extra field / title search
4. Recommend directly using WebFetch on

   https://arxiv.org/html/{arxiv_id}

   without downloading
5. Skip conditions: neither PDF nor online source available / non-paper content

For detailed Zotero operations, see

references/zotero-guide.md

1. No Omissions: All Figures, formulas, and Tables in the paper must be included in the notes
2. Inline Concept Links: Technical terms appearing for the first time in the text must be linked using

   [[Concept]]

   , not just at the end
3. No ASCII Flowcharts: Describe architectures using structured Markdown lists +

   $mathematical symbols$

4. Formula Completeness: Each formula must have a name (

   [[Concept|Name]]

   ), LaTeX formula, meaning, and symbol explanation
5. Priority to Image External Links: arXiv HTML / project homepage / GitHub; download locally only if not found

Detailed quality specifications for formulas/images/tables can be found in

references/quality-standards.md

1. WebSearch

   "{paper title} arxiv"

   to get the arXiv ID
2. Source A — arXiv HTML (preferred):
   • WebFetch

     https://arxiv.org/html/{arxiv_id}

     to extract titles and img src URLs of all

     <figure>

     elements
   • Count the total number of Figures in the paper and confirm if the extracted quantity is complete
3. Source B — Project Homepage (when HTML returns 404 or images are incomplete):
   • Find the project homepage URL from the abstract/HTML (common patterns:

     project page

     ,

     github.io

     ,

     our website

     )
   • WebFetch the project homepage and extract displayed images (usually includes teaser/demo images)
4. Source C — PDF Extraction (when the first two sources fail):
   • Use

     pdfimages -png

     to extract from PDF, filter valid images larger than 10KB
5. Embed in notes using

   ![Figure X](url)

   external links
6. Verification: External links are loadable / local files are >10KB
7. URL Deduplication: Check for duplicate arxiv_id path segments in the URL (e.g.,

   2603.05312v1/2603.05312v1/

   ) before writing; remove duplicates if present. See

   references/image-troubleshooting.md

   for details.

ar5iv numbers do not necessarily correspond to Figure numbers; see

references/image-troubleshooting.md

for troubleshooting

python3 ../daily-papers/download_note_images.py "{full note path}"

• Accessible external links remain unchanged; inaccessible ones are automatically downloaded to

  assets/

  and replaced with Obsidian wikilinks
• If localization is performed, the frontmatter

  image_source

  is automatically updated to

  mixed

1. Refresh the directory pages only if

   AUTO_REFRESH_INDEXES=true

   :
   bash

   python3 ../_shared/generate_concept_mocs.py
   python3 ../_shared/generate_paper_mocs.py

2. Perform git operations only if

   GIT_COMMIT_ENABLED=true

   :
   • First confirm that

     VAULT_PATH/.git

     exists
   • Ensure there are actual staged changes after

     git add {new file} {paper_notes_folder}/

   • Execute the following only if conditions are met:
   bash

   cd {VAULT_PATH} && git add {new file} {paper_notes_folder}/ && git commit -m "add paper note: {method_name}"

   • Push only if

     GIT_PUSH_ENABLED=true

     and the remote repository is configured

1. Scan all

   [[Concept]]

   links in the paper notes
2. Check if the corresponding concept notes exist for each link (using

   ls

   +

   find

   )
3. Create non-existent concepts (cannot be skipped), and automatically classify them into corresponding subdirectories

Classification rules and templates can be found in

references/concept-categories.md

• Do all

  [[Concept]]

  links in the notes have corresponding concept notes?
• Do the concept notes include this paper as a "representative work"?

• Are all Figures included in the notes (quantity matches the paper)?
• Are all formulas included in the notes (variables consistent, no conflicts)?
• Are all Tables completely retained (all rows and columns)?
• Are technical terms in the text linked with

  [[Concept]]

  inline links?
• Has the concept library been updated (missing concepts have been created)?
• Are images usable (external links loadable / local files >10KB)?

• references/zotero-guide.md

  — Zotero query, classification, PDF path retrieval, intelligent category judgment

• references/image-troubleshooting.md

  — ar5iv image number correspondence, PDF extraction alternatives

• references/concept-categories.md

  — 16 subdirectory rules + templates for automatic concept classification

• references/quality-standards.md

  — Detailed quality specifications + self-checklists for formulas/images/tables