前言¶
写综述、补参考文献、查专利或标准时，常见做法是打开多个数据库逐站检索，再把题录和 PDF 手工整理进笔记。把检索和下载接到 Agent 上，可以在对话里用自然语言描述主题，由 Skill 走统一 API 返回元数据、详情，并在授权范围内拉取中文期刊 PDF 或外文 OA 全文。下面介绍 SkillHub 上的「全球12亿文献知识库（8千万中文期刊可下载）」：它通过 SmartLib 开放平台 API 对接大规模题录与中文期刊全文，并约定每次计费调用前先走 /consume 换取 consume_token。
这是什么¶
一句话定位：面向 Agent 的学术文献检索与下载 Skill，数据与能力来自 SmartLib 开放平台 API。
维护与分发：社区来源（community），在 SkillHub 坐标为 @user_814dbe54/global-biblio-base，当前页面标注版本 v3.10.2，分类为 knowledge-management，标签含 requires_api_key=true（需按 Skill 说明配置 API 访问）。
覆盖规模（官方简介）：
- 约 8000 万篇授权中文期刊全文可下载方向能力；
- 12.28 亿条全球文献元数据，其中期刊约 7.19 亿、专利约 2.15 亿、会议约 7155 万、学位论文约 2473 万、标准约 268 万。
官方入口：
- Skill 资源：
https://api.skillhub.cn/user_164f4c1f/global-biblio-base - SkillHub 页面：
https://www.skillhub.cn/skills/user_814dbe54/global-biblio-base
核心功能¶
以下能力均来自 Skill 官方简介，安装后由 Agent 在匹配用户意图时调用后端接口。
检索与呈现
- 中英文关键词检索；
- 文献详情查询；
- 智能关键词扩展；
- 核心期刊优先排序、相关性重排；
- 引文追溯；
- 分类号检索。
下载
- 中文期刊 PDF 全文下载（计入下载配额）；
- 外文 OA 文献通过十级渠道免费下载，不消耗配额（官方说明）。
接口调用顺序（计费相关）
每次需要计费的接口调用前，必须先请求 /consume 获取 consume_token，再携带该 token 调用 /search 等接口。不要跳过 /consume，否则不符合 Skill 约定的计费与鉴权流程。
安装与启用¶
通过 SkillHub CLI 安装¶
SkillHub 页面给出的安装方式是：让 Agent 按 SkillHub 安装文档 安装坐标 @user_814dbe54/global-biblio-base。
若本机已有 skillhub CLI，可先确认版本，再安装到当前 Agent 识别的 skills 目录（必须用 --dir，否则默认装到 ./skills/ 可能不会被加载）：
command -v skillhub && skillhub --version
未安装 CLI 时，官方提供一键脚本（完整安装含默认 Skill；仅 CLI 可加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，将 <skills 目录> 换成你当前客户端的路径，例如文档中常见的：
| 环境 | skills 目录（参考 SkillHub 文档） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
示例命令形态：
skillhub install @user_814dbe54/global-biblio-base --dir ~/.cursor/skills/
路径请按你实际使用的 Agent 调整；安装后按该 Agent 的要求重启或刷新 Skill 列表。
API Key 与配额¶
- 标签
requires_api_key=true：安装后需按 Skill 包内说明完成 SmartLib / API 密钥配置（具体字段以 Skill 内文档为准）。 - 首次使用自动注册；免费档为每月 100 次检索 + 10 次下载。
- 配额用尽后，Skill 会引导选择套餐（体验卡、个人版月、专业版月、单篇下载、下载包等）；在对话中说「升级」或「充值」可唤起相关流程。
- 企业或机构定制：联系
vipsmart@vipslib.com。
典型用法¶
Skill 没有单独列出长示例对话，但触发意图与调用链在官方说明里写得很清楚。可按下面方式使用。
1. 用自然语言触发
中文例如：查论文、找文献、检索学术、搜期刊、查专利、找标准、下论文、写文献综述、找参考文献、查 SCI/EI；或「帮我找关于 XX 的论文」「找几篇引用支撑论点」。
英文例如：find papers、search literature、write literature review、find supporting citations。
2. Agent 侧应遵守的 API 顺序
对每一次计费类调用，逻辑上应先：
POST /consume → 获得 consume_token
POST /search → 携带 consume_token，传入检索条件
具体 URL、请求体、Header 以 Skill 包内对接 SmartLib 开放平台的说明为准；本文只强调「每次计费调用都要先 /consume」这一约束。
3. 结果怎么用
- 写综述：先关键词检索 + 扩展，用核心期刊排序和相关性重排筛一批题录，再拉详情与引文追溯补链条。
- 要全文：中文期刊走 PDF 下载（注意每月 10 次下载额度）；外文优先 OA 十级渠道（不占下载配额）。
适用场景与注意¶
适合谁
- 需要在 IDE / Agent 里快速查题录、对比期刊与会议论文、查专利或标准元数据的开发者与研究者；
- 写文献综述、整理参考文献、为论点找可引用来源时，希望少切换网页、多留在对话流里完成检索的人。
限制与注意
- 配额：检索与下载次数有限，大量批量下载需升级套餐或购买下载包。
- 下载范围：中文全文依赖授权期刊库；并非所有检索命中的文献都能 PDF 下载。
- 外文非 OA：非开放获取文献不一定能免费全文，OA 渠道的「不消耗配额」仅针对官方描述的十级 OA 下载能力。
- 计费接口：重复调用
/search等计费接口时，每次都要重新/consume，避免 token 复用导致失败或计费异常。 - 版本与坐标：SkillHub 展示坐标为
@user_814dbe54/global-biblio-base，与api.skillhub.cn上的用户路径可能不同，安装与更新以 SkillHub 页面与 CLI 坐标为准。
结尾¶
「全球12亿文献知识库」把 SmartLib 的中外文检索、题录详情、中文期刊 PDF 与外文 OA 下载接到 Agent Skill 上，并统一了 /consume + /search 的计费调用方式。若你经常在对话里查论文、写综述或补引用，可先按 SkillHub 文档装好 @user_814dbe54/global-biblio-base，配置 API Key 后直接用自然语言触发。详情与安装提示见 SkillHub 技能页 与 官方 Skill 地址。
