Deeppapernote

Omdanner én artikel (arXiv/DOI/PDF) til en struktureret, evidensbaseret Obsidian-læsenote

Af 917Dhj · 917Dhj/DeepPaperNote

Testet · Virker ★ 9.2/10

Deeppapernote — Omdanner én artikel (arXiv/DOI/PDF) til en struktureret, evidensbaseret Obsidian-læsenote

Hvad det gør

Kører en deterministisk Python-pipeline, der løser en artikels identitet, henter PDF'en, udtrækker fuldtekstsektioner og figurer og bygger et syntesebundt, som modellen bruger til at skrive en dyb kinesisk-sproget Markdown-note med en fast sektionskontrakt, og derefter linter den mod struktur- og stil-gates. Udløses, når brugeren giver en artikeltitel, DOI, URL, arXiv ID, Zotero-element eller lokal PDF og ønsker en poleret Obsidian-note frem for en abstrakt omskrivning. Håndterer én artikel ad gangen; ikke til litteraturgennemgange med flere artikler eller læselister.

Testrapport

Klonede repo'et og kørte scripts/run_pipeline.py på arXiv:1508.06576 under Python 3.13 med PyMuPDF installeret; den løste identitet, hentede den ægte 16-siders PDF, udtrækkede 393 linjer fuld tekst og byggede en 80KB paper_bundle.json med en writing_contract, der krævede 12 kinesiske sektioner. For OUTPUT skrev jeg to noter og kørte scripts/lint_note.py på begge: min fritformede baseline fejlede passes_basic_structure, passes_style_gate og passes_substantive_content med alle 12 krævede sektioner rapporteret som manglende; den skill-strukturerede note (YAML frontmatter, 核心信息 metadata block, faithful 原文摘要翻译, 创新点, 机制流程, 局限) bestod alle tre gates med missing_sections=[]. Begge fejlede passes_plan_gate, fordi jeg ikke forfattede den separate note_plan JSON, som workflowet forventer. Sikkerhedsscanning fandt ingen curl|sh, base64 blobs eller eksfiltrering; netværkskald retter sig kun mod arXiv/Crossref/OpenAlex/Semantic Scholar, og Semantic Scholar-nøglen læses fra env.

Testet: 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.

Kommandoer og eksempelprompter

  • /deeppapernoteOmdanner én artikel (arXiv/DOI/PDF) til en struktureret, evidensbaseret Obsidian-læsenote

Skills udløses af almindelige forespørgsler — ingen kommandoer at huske. Efter installationen aktiverer prompter som disse skillen (på engelsk):

  • 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