mapping-documents

用途：把 PDF 转成带语义注释的层级文档地图，便于以地图而非原文检索内容。主要能力：字体分析提取章节结构；按章节用 LLM 抽取章节摘要、类型化论断（paper 类型含 result、definition、method、caveat、open-question）、符号定义与跨章节依赖，全部锚定页码。产物为 {stem}_MAP.md、{stem}.symbols.json、{stem}.anchors.json、{stem}_USAGE.md，其中 USAGE.md 可粘贴进 CLAUDE.md 或项目知识。安装：pip install pdfplumber anthropic --break-system-packages -q。完整生成：python /mnt/skills/user/mapping-documents/scripts/docmap.py paper.pdf --out docs/ --genre paper --workers 4；仅结构（无 API 调用、无费用）：python /mnt/skills/user/mapping-documents/scripts/docmap.py paper.pdf --out docs/ --structure-only。API 密钥顺序：--api-key 参数 > ANTHROPIC_API_KEY 环境变量 > API_KEY 环境变量。genre 可选 paper（默认）、spec、legal，决定论断分类体系。限制：目前仅支持 PDF，假设单栏排版；无缓存，重跑会全部重新抽取；无引用交叉引用；需手动指定 genre；语义抽取可能产生幻觉，页码来自 LLM，关键论断需回原文核对。模型默认 claude-sonnet-5-5，可用 --model 覆盖；--no-usage-snippet 可跳过生成 USAGE.md。具体价格与更多平台信息暂未提供。