lit-pdf-zotero

name	lit-pdf-zotero
description	文献 PDF 获取 + Zotero 入库 + 可视化（乔淼PhD · AI学术训练营 · AI学术工作流）。对一份文献清单批量：确认 DOI/CNKI ID → 补全引用数 → 多渠道找 PDF 落盘（OA/preprint/sd-download/wos-download/cnki-download）→ 按金字塔结构建 Zotero Collection 逐条入库（含标签与 extra 元数据）→ 生成金字塔分布图 + PXYV 罗盘投影双图 HTML。Trigger on："把这批文献下载 PDF 入库 Zotero"、"文献入库+可视化"、"batch download PDFs and import to Zotero"、"入 Zotero 并画文献金字塔"。

Lit PDF + Zotero · 获取 PDF → 入库 → 可视化

对一份文献清单（最好是 lit-pyramid 的分层清单；无分层也能跑，只是入库不分子集合、图 1 跳过）执行四步。

调用约定（独立运行）

• 输入：文献清单（分层表 / 普通表 / DOI 列表均可）+ Zotero Collection 名（默认 = 项目名或用户给的短名）。
• 落盘（默认当前工作目录）：PDF 存 pdf_download/，命名 AuthorYear.pdf；最终清单写 文献清单.md；可视化写 [slug]-visualization.html。
• 工具适配：Zotero MCP 不可用 → 只做 PDF + 清单落盘，并告知手动导入方式；下载工具按环境可用性挑。
• 调用方覆盖约定：调用方（工作台 prompt / 用户）显式给出的参数、输入路径、落盘路径与工具选择，一律覆盖本 skill 的默认；但本 skill 的方法步骤、硬约束与停点不可被省略或稀释——调用方若要求跳过某硬约束，以本 skill 为准并提示冲突。

Step 1 · 确认 DOI / URL / CNKI ID

英文论文 → DOI；中文论文 → CNKI ID + 期刊+期号；经典专著 → 出版商 URL 或 DOI；非学术来源 → URL。

Step 2 · 补全引用数

英文用 OpenAlex API（https://api.openalex.org/works/doi:{DOI} 取 cited_by_count）或 Google Scholar；中文用 cnki-paper-detail。清单里已有的不重采。

Step 3 · 查找 PDF 并落盘

• 英文优先 sd-download / wos-download → Open Access（Unpaywall / OpenAlex / 出版商 OA）→ 作者自存档 → preprint（arXiv / SSRN / OSF）
• 中文用 cnki-download（要求已登录）
• 找不到的标 "no-pdf"；不从可疑来源硬凑。

最终清单落盘（下游文献分析在 Zotero 不可用时的兜底元数据）： | # | 标题 | 作者+年份 | 金字塔层 | PXYV 节点 | DOI/CNKI ID | 被引数 | 核心论点 | PDF 状态 |（状态 = open-access / preprint / author-copy / cnki / no-pdf）

Step 4 · 入库 Zotero + 可视化

Collection 结构：顶层 = Collection 名，下设 Classic / Key Texts / Supporting-P / Supporting-X / Supporting-Y / Supporting-V（无分层信息则只建顶层）。

逐条入库：有 DOI → zotero_add_by_doi(doi, collections=[对应子集], tags=[金字塔层, PXYV节点, 项目slug], attach_mode="auto")；只有 URL/CNKI → zotero_add_by_url（或用 gs-export / sd-export / wos-export / cnki-export 直接推送）。入库后用 zotero_update_item 写 extra 字段：

citations: 123
core_argument: 一句话核心论点
pxyv_weights: P=0.7, V=0.3

（pxyv_weights 按"主导维度"生成，单一维度 = 1.0。标签：金字塔层 "classic"/"key"/"supporting"；节点 "P"/"X"/"Y"/"V" 可多选；项目 slug。）

入库报告：| # | 标题 | 入库状态 | PDF 附件 | Collection | 标签 | + 统计（总入库 / PDF 已附 / 金字塔分布 / 节点覆盖）。

可视化（单文件 HTML，纯 HTML+CSS+内联 SVG 无外部库；浅色背景 #FAF7F2，amber #B8834A）：

• 图 1 文献金字塔分布图：三层水平堆叠，顶 Classic（窄，标篇名+作者）→ 中 Key（标标题+主要节点）→ 底 Supporting（按数量宽度）；Classic #E65100 / Key #1565C0 / Supporting #558B2F。
• 图 2 PXYV 罗盘投影：800×800 SVG；四锚点 P=(0,+1) / X=(+1,0) / Y=(0,-1) / V=(-1,0)，边缘标大字母 + 颜色（P #B8834A / X #5B8DBE / Y #7BAE7F / V #9B6DB0）。每篇一个圆点：位置 = pxyv_weights 归一化加权质心；半径 = 4 + 6*log10(citations+1) clip [4,24]px；填充 = 金字塔层色 opacity 0.7；描边 = 主导维度色；悬停 tooltip（标题/作者年/引用数/核心论点）；同心圆 0.25/0.5/0.75/1.0 网格 + 双图例。