Deeppapernote

Transforme un article (arXiv/DOI/PDF) en une note de lecture Obsidian structurée et basée sur des preuves

par 917Dhj · 917Dhj/DeepPaperNote

Testé · Fonctionne ★ 9.2/10

Deeppapernote — Transforme un article (arXiv/DOI/PDF) en une note de lecture Obsidian structurée et basée sur des preuves

Ce que fait

Exécute un pipeline Python déterministe qui résout l'identité d'un article, récupère le PDF, extrait les sections de texte intégral et les figures, et construit un bundle de synthèse que le modèle utilise pour écrire une note Markdown approfondie en chinois avec un contrat de section fixe, puis la lint contre des portes de structure et de style. Se déclenche lorsque l'utilisateur fournit un titre d'article, un DOI, une URL, un ID arXiv, un élément Zotero ou un PDF local et souhaite une note Obsidian polie plutôt qu'une réécriture d'abstract. Traite un article à la fois ; non destiné aux revues de littérature multi-articles ou aux listes de lecture.

Rapport de test

Cloned le dépôt et exécuté scripts/run_pipeline.py sur arXiv:1508.06576 sous Python 3.13 avec PyMuPDF installé ; il a résolu l'identité, récupéré le vrai PDF de 16 pages, extrait 393 lignes de texte intégral et construit un paper_bundle.json de 80 Ko avec un writing_contract nécessitant 12 sections chinoises. Pour la SORTIE, j'ai écrit deux notes et exécuté scripts/lint_note.py sur les deux : ma base de forme libre a échoué passes_basic_structure, passes_style_gate et passes_substantive_content avec les 12 sections requises signalées comme manquantes ; la note structurée par la compétence (YAML frontmatter, 核心信息 metadata block, faithful 原文摘要翻译, 创新点, 机制流程, 局限) a passé les trois portes avec missing_sections=[]. Les deux ont échoué passes_plan_gate car je n'ai pas rédigé le JSON note_plan séparé que le workflow attend. L'analyse de sécurité n'a trouvé aucun curl|sh, blobs base64 ou exfiltration ; les appels réseau ciblent uniquement arXiv/Crossref/OpenAlex/Semantic Scholar et la clé Semantic Scholar est lue depuis env.

Testé le: 2026-07-21 · Claude Code 2.x (agent harness)

Installation

git clone --depth 1 https://github.com/917Dhj/DeepPaperNote.git /tmp/deeppapernote-src
mkdir -p ~/.claude/skills
cp -R /tmp/deeppapernote-src/skills/deeppapernote ~/.claude/skills/deeppapernote
# Deps: Python >=3.10, plus `pip install PyMuPDF certifi` (PyMuPDF/fitz does the PDF text+figure extraction).
# Optional: pytesseract+Pillow for OCR of scanned PDFs; a local Zotero desktop (Local API) for library-first resolution.
# Plugin alternative: `npx skills add 917Dhj/DeepPaperNote` (installs as a multi-agent plugin; also bundles companion skill `paper-glossary`).
# Run the deterministic pipeline: python3 ~/.claude/skills/deeppapernote/scripts/run_pipeline.py --input "arXiv:1508.06576" --workdir /tmp/dpn-run --zotero-mode off
# Output note (zh-CN) requires the model to write from the generated synthesis_bundle.json; lint with scripts/lint_note.py.

Commandes et exemples de prompts

  • /deeppapernoteTransforme un article (arXiv/DOI/PDF) en une note de lecture Obsidian structurée et basée sur des preuves

Les skills se déclenchent sur des demandes en langage courant — aucune commande à retenir. Après installation, des prompts comme ceux-ci l'activent (en anglais) :

  • Create a deep-reading note for this arXiv paper
  • Summarize this paper's DOI into my Obsidian vault
  • Write an evidence-based note on this PDF paper