前言¶
寫綜述、補參考文獻、查專利或標準時，常見做法是打開多個數據庫逐站檢索，再把題錄和 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 地址。
