litmap

文献地图生成器 GitLink AI Agent Skill。把一批文献题录按主题归类、按年份铺出时间线图景，并启发式指出冷门、停滞、新兴三类研究缺口。

GitLink 智能化服务开源项目贡献赛 子赛题二（编写和丰富 GitLink Skills） 参赛作品。作者：Ct201314

它解决什么

文献囤了一文件夹，理不出综述框架。litmap 帮你从「一堆论文」理出「这领域到哪了」：

• 主题归类：按主题把文献分组，看清领域分成哪几块、各块多少工作
• 时间线图景：按年份铺出文献分布，看清哪年热、近年还活跃吗
• 缺口启发：冷门主题（少有人碰）、停滞主题（近年无新作）、新兴主题（新近出现量小）

设计特点

纯本地、纯标准库，处理你已收集好的题录。区别于在线综述工具，它的洞察来自结构化分析——尤其停滞主题检测（某方向已数年无更新）能给出「经典问题可重启」这类单纯堆摘要给不出的线索。给的是综述脚手架，不替你写结论。

安装与使用

python scripts/litmap.py --inputs refs.bib --output map.md
python scripts/litmap.py --titles titles.txt --format json

目录结构

litmap/
├── SKILL.md
├── scripts/litmap.py
├── references/  topics.md + gap-heuristics.md
├── examples/  真实文献地图产物
├── tests/test_litmap.py（13 用例）
├── requirements.txt
└── LICENSE

真实验证

输入 10 条文献标题列表，正确归入 11 个主题，时间线显示 2024/2025 高峰；缺口分析准确识别出图神经网络（2019，6 年无新作）、鲁棒性（2020，5 年）两个停滞主题。产物见 examples/。

python -m pytest tests/ -q   # 13 passed

许可证

Mulan PSL v2。