DeepPaperNote v1.1.1

Small update that fixes several existing logic gaps in DeepPaperNote.

Highlights:

• Tightened figure placeholder validation so retained placeholders must use the standard [!figure] callout format.
• Strengthened table crop quality checks to reject contaminated or mixed-caption crops.

Project homepage: https://917dhj.github.io/DeepPaperNote/

The attached DeepPaperNote.zip is a clean manually installable skill package. Unzip it and place the DeepPaperNote folder into your agent's skills directory.

DeepPaperNote v1.1.0

Minor release with a major figure/table extraction quality upgrade.

Highlights:

• Added figure-level PDF asset extraction that renders caption-anchored page regions instead of relying only on raw xref image objects.
• Improved extraction for complete figures, vector-heavy papers, fragmented LaTeX tables, and caption-on-bottom tables.
• Preserved DeepPaperNote's placeholder-first behavior: extracted figure assets are exposed as candidates, not automatic note insertions.
• Added visual quality signals so weak crops can fail closed and remain placeholders.
• Included figure_assets in the synthesis bundle so model-side review can inspect richer figure/table candidates.
• Added regression tests for figure asset candidates, placeholder-first planning, label normalization, and visual quality rejection.

Contributor note:

• This release incorporates the figure-level extraction work from PR #1 by KuangjuX, with follow-up changes to keep insertion semantics placeholder-first.

The attached DeepPaperNote.zip is a clean manually installable skill package. Unzip it and place the DeepPaperNote folder into your agent's skills directory.

DeepPaperNote v1.0.1

Patch release after v1.0.0.

Highlights:

• Added YAML frontmatter and wikilink rules for Obsidian-native features.
• Fixed lint_note.py compatibility with YAML frontmatter.
• Added tests for frontmatter stripping and frontmatter-aware lint compatibility.
• Fixed wikilink target resolution with a lookup-first, fail-closed approach.
• Removed unused image assets that were no longer referenced by the README files.

The attached DeepPaperNote.zip is a clean manually installable skill package. Unzip it and place the DeepPaperNote folder into your agent's skills directory.

DeepPaperNote v1.0.0

First stable release of DeepPaperNote.

DeepPaperNote is now a pure cross-agent skill for Claude Code, Codex, Cursor, Copilot, Gemini CLI, and other Agent Skills-compatible environments.

Highlights:

• The root SKILL.md is the single canonical skill entrypoint.
• Installation now supports npx skills add 917Dhj/DeepPaperNote -a codex and npx skills add 917Dhj/DeepPaperNote -a claude-code.
• Removed experimental onboarding/setup pseudo-surfaces and Claude plugin wrapper structure.
• Added AGENTS.md and CLAUDE.md for repo-level agent guidance.
• Preserved the evidence-first deep-reading pipeline, Obsidian-first output behavior, figure/table placeholder policy, lint gate, and final readability review.
• Added explicit Python >=3.10 interpreter guidance for agents running bundled scripts.

The attached DeepPaperNote.zip is a clean manually installable skill package. Unzip it and place the DeepPaperNote folder into your agent's skills directory.

DeepPaperNote v0.3.2-alpha

This alpha refresh strengthens local PDF metadata resolution so Zotero-style attachment names no longer dominate enrichment, while preserving the existing title, DOI, and arXiv workflows.

What’s New

• 📄 Local PDF metadata now prefers embedded PDF title, DOI, arXiv identifiers, and first-page title signals before falling back to cleaned filenames.
• 🧹 Local-PDF-only title correction can now replace noisy attachment-style titles with high-confidence external matches without changing the global merge policy.
• 🏷️ Candidate scoring now prefers published DOI and venue matches over preprint-style alternatives when both are available.
• 🔤 Common PDF ligatures such as fi and fl are normalized during extraction, so resolved titles are cleaner and more stable.
• 📦 The release package has been rebuilt from the latest main branch state for v0.3.2-alpha.

DeepPaperNote v0.3.1-alpha

This alpha refresh republishes DeepPaperNote on top of the latest main branch and aligns the default Obsidian paper output path with the current recommended vault layout.

What’s New

• 📂 The default Obsidian paper root is now Research/Papers instead of 20_Research/Papers.
• 🧭 Runtime path resolution and save behavior are aligned with the new default, so newly generated notes land in the updated location more consistently.
• 📦 The release package has been rebuilt from the latest main branch state for v0.3.1-alpha.

DeepPaperNote v0.3.0-alpha

This release is a substantial quality upgrade focused on making DeepPaperNote produce notes that feel more like durable, reusable deep-reading research notes rather than polished abstract summaries.

What’s New

• ✨ Stronger note structure: added and stabilized a dedicated Innovation section near the beginning of the note.
• 🧠 Clearer method understanding: method and system papers now more explicitly reconstruct the execution chain through a Mechanism Flow section.
• 📉 Better ablation coverage: notes are less likely to focus only on best-case results and now pay more attention to failed settings, weaker variants, and trade-offs.
• 🈶 Clearer abstract handling: the opening abstract block is now framed as Original Abstract Translation, making it much clearer that this section should be a Chinese translation of the paper’s original abstract rather than a newly written summary.
• 🧾 Cleaner metadata block: Core Info is now treated as a fixed metadata zone, so analysis or personal judgment is less likely to leak into it.
• 🚦 Stronger workflow discipline: the skill is now more explicit about following the full pipeline instead of silently skipping steps or downgrading behavior.
• 🔍 Added final readability review: after script lint passes, the model must reread the full note once more to improve fluency and remove awkward phrasing or unnecessary English leftovers.
• ∑ Safer formula handling: added a math syntax gate to catch common Obsidian / MathJax rendering failures before final save.
• 📂 More reliable saving behavior: fixed the occasional duplicated paper-slug directory issue and tightened Obsidian write / fallback rules.

DeepPaperNote v0.2.0-alpha

Highlights

• Stronger replication-oriented note writing for technical papers
• Explicit short note_plan before final note generation
• Equation-aware output when formulas are central to understanding the method
• Stricter final self-review for key numbers, method depth, and technical completeness
• Original abstract section now keeps both the English original and a Chinese translation
• Stronger formatting checks for suspicious mid-sentence line breaks and math accidentally rendered as code
• Chinese README is now the default GitHub homepage

What works now

• Single-paper deep-reading note generation for Codex
• Obsidian-native output with one folder per paper and paper-local images/
• Workspace fallback output when no Obsidian vault is configured
• Zotero-first helper workflow for local-library-first resolution
• OCR fallback for low-text PDF pages
• Placeholder-first figure handling with conservative image replacement
• Minimal test suite and GitHub Actions CI

Known limitations

• Chinese remains the only fully supported note language today
• High-confidence figure replacement still depends on extraction quality and semantic matching confidence
• Different sessions may still expose different python3 interpreters depending on environment inheritance

Recommended setup

• Configure your Obsidian vault for the best long-term note workflow
• Add a Zotero MCP option if you already manage papers in Zotero
• Install OCR dependencies if you often read scanned or low-text PDFs

DeepPaperNote v0.1.0-alpha

Highlights

• First public alpha release of DeepPaperNote as a Codex skill.
• Turns one research paper into a high-quality Markdown deep-reading note.
• Uses a model-first workflow: scripts gather evidence, the model does the paper understanding and final writing.
• Supports placeholder-first figure handling so missing images do not erase important note structure.

What Works Now

• Single-paper note generation from title, DOI, arXiv ID, URL, local PDF, or Zotero-resolved input.
• Obsidian-native output with folder-per-paper layout.
• Workspace fallback output when no Obsidian vault is configured.
• Zotero-first helper flow for local-library-first paper resolution.
• OCR fallback for low-text PDF pages.
• Domain-aware routing that prefers existing vault domains before creating a new one.
• Paper-local images/ folder creation during final save.
• Minimal automated tests and GitHub Actions CI.

Recommended Setup

• Configure an Obsidian vault for the best note-management experience.
• Optionally configure Zotero MCP if you already manage papers in Zotero.
• Optionally configure OCR tools for scanned or low-quality PDFs.
• Optionally configure a Semantic Scholar API key for stronger metadata fallback.
• Use /deeppapernote doctor or /deeppapernote start to inspect the local setup.

Known Limitations

• Figure replacement quality still depends on PDF extraction quality and semantic matching confidence.
• Some environments may expose different python3 interpreters across sessions; doctor now reports the active interpreter explicitly.
• Zotero integration quality depends on the user's available Codex-compatible Zotero MCP workflow.

Notes

This is an alpha release. The core workflow is usable, but the project is still being actively refined around figure handling, environment consistency, and broader real-world testing.