Summary

第 1 步：获取 PDF 路径

强制规则（必须遵守）

只要用户输入不是 URL 且不是本地文件路径，就必须通过 Zotero Better-BibTeX JSON-RPC 搜索本地论文库。严禁使用 WebSearch / WebFetch / 任何网络搜索工具去 查找论文。paper-vault 的核心前提是用户想学习他们已经在 Zotero 里管理的论文。

如果 Zotero 查询失败（服务未启动、Better-BibTeX 未安装、搜索结果为空）， 必须停下来询问用户，不要自行改用 WebSearch 或编造 PDF 链接。

支持多种输入格式：

• 论文标题或关键词：在 Zotero 中搜索
• citation key（如 hafnerMasteringDiverseControl2025）：直接通过 Zotero 获取
• 本地路径：~/Downloads/paper.pdf
• URL：https://arxiv.org/abs/1706.03762

注意：当输入是标题/关键词时，不要猜测 arxiv URL 去下载——必须走 Zotero。

第 1a 步：判断输入类型

USER_INPUT="<user-input>"

if [[ "$USER_INPUT" =~ ^https?:// ]]; then
  # URL：下载 PDF
  INPUT_PATH=$(node ${CLAUDE_PLUGIN_ROOT}/skills/study/scripts/download-pdf.cjs "$USER_INPUT")
elif [[ -f "${USER_INPUT/#\~/$HOME}" ]]; then
  # 本地文件路径
  INPUT_PATH="${USER_INPUT/#\~/$HOME}"
else
  # 默认分支：只要不是 URL/本地路径就进入这里（标题、关键词或 citation key）
  # 必须通过 Zotero 查询，禁止使用 WebSearch/WebFetch。
  echo "Searching Zotero for: $USER_INPUT"

  # 搜索匹配的论文
  SEARCH_RESULT=$(curl -s -f --max-time 5 "http://localhost:23119/better-bibtex/json-rpc" \
    -X POST -H "Content-Type: application/json" \
    -d "{\"jsonrpc\":\"2.0\",\"method\":\"item.search\",\"params\":[\"${USER_INPUT}\"],\"id\":1}")
  CURL_EXIT=$?

  echo "$SEARCH_RESULT"
  echo "curl exit code: $CURL_EXIT"
fi

Claude 必须按下述规则解析 SEARCH_RESULT 并处理异常情况：

1. Zotero 不可达（curl 返回非 0，或连接被拒绝）：
   • 告诉用户："Zotero 似乎没有运行，请启动 Zotero 并确认 Better-BibTeX 插件已安装。"
   • 停止工作流，不要改用 WebSearch。
2. 搜索结果为空（result 字段是空数组）：
   • 告诉用户："在 Zotero 中未找到与 <input> 匹配的论文。请提供更精确的标题/作者、 改用 URL（arxiv/DOI）或本地 PDF 路径。"
   • 停止工作流，不要自动退回到 WebSearch 或编造链接。
3. 只有一个匹配：直接取其 citation-key 作为 CITATION_KEY，进入 1b。
4. 多个匹配：向用户展示前若干候选（标题 + 作者 + 年份 + citation-key）， 请用户选择一个后再进入 1b。

第 1b 步：通过 citation key 获取 PDF 路径（Zotero 输入时）

此处使用的 CITATION_KEY 只能来自：(a) 用户直接输入的 citation key，或 (b) 1a 步 Zotero 搜索的结果。绝不能由 Claude 凭标题推断或来自 WebSearch。

CITATION_KEY="<citation-key-from-search>"

ATTACH_RESULT=$(curl -s "http://localhost:23119/better-bibtex/json-rpc" \
  -X POST -H "Content-Type: application/json" \
  -d "{\"jsonrpc\":\"2.0\",\"method\":\"item.attachments\",\"params\":[\"${CITATION_KEY}\"],\"id\":1}")

echo "$ATTACH_RESULT"
# 从返回结果中提取 path 字段（选择 .pdf 后缀的条目）
# INPUT_PATH="<extracted-pdf-path>"

第 1c 步：解析 PDF

node ${CLAUDE_PLUGIN_ROOT}/skills/study/scripts/parse-pdf.js "$INPUT_PATH"

输出内容包括：

• title、authors、abstract、full content、githubLinks、codeLinks

第 2 步：生成快速总结

根据解析内容，生成 quick-summary.md，结构如下：

# Quick Summary: [Paper Title]

## One Sentence
[One sentence that captures what the paper is about]

## Problem
[What problem does this paper solve? Why is it important?]

## Core Idea
[The key innovation explained in 2-3 sentences. What makes this paper novel?]

## Key Contributions
- [Contribution 1]
- [Contribution 2]
- [Contribution 3]

## Main Results
| Metric | Value | Dataset/Benchmark |
|--------|-------|-------------------|
| [metric1] | [value] | [dataset] |

## Why It Matters
[Practical implications. How does this advance the field?]

## Limitations
- [Limitation 1]
- [Limitation 2]

各部分写作指南：

**总长度：**约 300-500 词（不含结果表格）

第 3 步：写入 Obsidian

将 quick-summary.md 写入 Obsidian vault 并打开：

OBSIDIAN_VAULT="$HOME/Documents/Obsidian Vault"
NOTE_DIR="$OBSIDIAN_VAULT/Paper-Vault/{paper-slug}"

mkdir -p "$NOTE_DIR"

使用 Write tool 将生成的 quick-summary.md 内容写入：

$HOME/Documents/Obsidian Vault/Paper-Vault/{paper-slug}/quick-summary.md

写入完成后，在 Obsidian 中打开：

obsidian vault="Obsidian Vault" open path="Paper-Vault/{paper-slug}/quick-summary.md" newtab

第 4 步：向用户展示总结

1. 向用户完整展示 quick-summary.md 的内容

2. 提示笔记位置：

   • 已保存至 Obsidian：Paper-Vault/{paper-slug}/quick-summary.md

3. 提供下一步建议：

   • "如果你想更深入地学习这篇论文，可以使用 /paper-vault:study 生成完整材料。"
   • "你是否想问论文某个部分的具体问题？"
   • "是否希望我把某个章节讲得更细一些？"

备注

• 这个技能刻意保持最小化，只生成总结，不生成代码演示、交互式 HTML 或深度讲解材料
• 对于需要更完整材料的用户，可以使用 /paper-vault:study
• 总结应该自包含，并可在 5 分钟内读完
• 优先保证概念清晰，而不是技术细节的全面展开