用途：research-library 是一个技能，管理位于 $RESEARCH_HOME（默认 ~/research）的跨项目共享研究资料库，用于存放不应放进单个 git 仓库的参考资料：vendor 仓库克隆、PDF/epub、镜像的文档站快照。它旨在避免两件事：agent 因为第三方内容恰好躺在仓库工作树里就随意阅读，以及每个项目把同一份参考资料重复克隆进自己的 gitignore 目录。
主要能力：资料库是一个普通目录，没有安装过程，只有约定依赖其布局。repos/<host>--<owner>--<repo>/ 存放浅克隆，docs/ 存放下载的 PDF/epub，pages/<slug>/ 存放镜像的文档站快照。scripts/library.py 提供 name、add、check、update、deepen、reshallow、size 等子命令；add 会克隆、推导规范名并写入 provenance 文件，默认 text-only，只检出文本搜索能读取的文件。package_health.py 用于在挑选依赖时查看注册表元数据与包健康度。
使用方式：先检查资料库中是否已有相关材料，再决定是否联网获取。命令需保持原样，例如 python3 $S/scripts/library.py name <url>、add <url>、check 等。add 在克隆主机报告的大体积条目时会以退出码 3 提示而非交互等待，--yes 继续，--min 调整阈值，--depth/--full 改变历史深度。设置 RESEARCH_HOME 是唯一的安装步骤。
限制：写入仅限于 $RESEARCH_HOME 内，从不创建指向项目仓库的符号链接或副本。默认 text-only 会排除图片、视频、音频、字体、归档、编译对象和模型权重，但保留文档类格式（含 PDF）。缺少 $RESEARCH_HOME 时不会静默回退到网络抓取。具体价格、收费、平台支持与效果资料暂未提供。