前言¶
做研究时,文献往往散落在检索平台、本地下载、剪藏资讯和手写笔记里。检索结果进 Zotero,专题笔记在别处,写综述时还要回头核对「这条记录最初来自 Scopus 还是 PubMed」。下面介绍 SkillHub 上的 个人文献知识库,自带全球文献检索(支持向量搜索+传统分词搜索)(坐标 @user_164f4c1f/academic-knowledge-base,当前版本 v3.11.3):把 Karpathy LLM Wiki 的知识编译、SmartLib 的外部文献检索和本地私有库放在同一套 Agent Skill 里,用自然语言完成入库、专题整理和检索。
这是什么¶
一句话定位:面向学术研究者的个人知识中枢,由社区发布者 user_164f4c1f 维护,分类为 knowledge-management。
它解决的核心问题是「私有积累」与「外部文献库」脱节:Skill 侧整合 Karpathy LLM Wiki 的知识编译能力与 SmartLib 的海量文献检索,形成双轨联动的研究助手。页面标注 requires_api_key=true,外部检索与配额依赖 global-biblio-base 的 gateway 凭证;生产环境 SmartLib 地址从 global-biblio-base/config.json 的 SMARTLIB_GATEWAY_URL 读取(说明中对应 SmartLib Gateway v52.1)。
核心功能¶
以下能力均来自 SkillHub 官方简介,按使用链路归纳。
四类数据入库¶
- 文献检索结果
- 用户上传文献
- 资讯报道
- 个人学术数据
入库后的文献会自动保留原始数据库来源链接。说明中写明覆盖 300+ 数据库(例如 Scopus、WoS、EI、PubMed 等),并支持多源交叉验证。
研究专题¶
可在文献子集上组织「研究专题」,配套能力包括:智能命名、笔记、AI 分析、导出。
检索方式¶
- 向量化语义检索:按语义找相近文献或笔记。
- 传统分词匹配检索:按关键词精确匹配。
两种方式可覆盖「模糊回忆题目」和「记得专有名词」两类查找习惯。
参考文献与 Wiki 层¶
支持参考文献管理;Wiki 知识层由 Skill 侧自动维护,与 Karpathy LLM Wiki 的知识编译能力衔接。
初始化与配额¶
- 懒加载引导式初始化:无需前置配置即可开始使用,首次使用由 Skill 引导完成必要步骤。
- 配额:复用 global-biblio-base 的 gateway 凭证与计次规则(v3.9.0:5 个接口,每次成功调用计 1 次)。配额耗尽后暂停外部检索请求(本地已有知识库能力是否仍可用,以 Skill 实际行为为准;外部 SmartLib 检索会受限制)。
安装与启用¶
方式一:让 Agent 按官方指引安装¶
将下面提示词发给已支持 Skill 的 AI 客户端(Cursor、Claude Code、Codex CLI 等),由 Agent 读取 SkillHub 安装文档并执行:
请根据 https://skillhub.cn/install/skillhub.md,安装 `@user_164f4c1f/academic-knowledge-base`。
方式二:本机使用 skillhub CLI¶
先确认 CLI 是否已安装:
command -v skillhub && skillhub --version
未安装时,可按 SkillHub 文档执行完整安装(示例为官方推荐命令):
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录,否则默认装到 ./skills/ 可能不会被客户端加载。常见路径如下(摘自 SkillHub 安装文档):
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装命令示例(将 <skills目录> 换成上表对应路径):
skillhub install user_164f4c1f/academic-knowledge-base --dir <skills目录>
Skill 依赖外部检索时需配置 global-biblio-base 的 gateway 凭证;SmartLib 生产 URL 以 global-biblio-base/config.json 内 SMARTLIB_GATEWAY_URL 为准。安装或升级后,若客户端未自动加载新 Skill,按各客户端说明重启或刷新 skills 目录。
典型用法¶
官方未提供固定 CLI 子命令列表,交互以自然语言为主。Skill 说明中给出的触发词可直接用在对话里,例如:
- 入库与收藏:
保存到知识库、加入知识库、收藏这篇文章 - 浏览与统计:
我的知识库、知识库统计、文献管理、论文管理、我的论文库 - 专题与笔记:
列出我的专题、研究笔记、给这篇打标签 - 整理与综述:
知识整理、文献整理、文献综述工具
可复现的用法模式如下。
- 从检索到入库:在对话中描述检索需求,将结果保存到知识库;入库记录应带上原始库来源链接,便于日后核验。
- 建专题写综述:用「列出我的专题」查看已有子集,对子集加笔记或请求 AI 分析,需要时再导出。
- 查已有材料:用自然语言提问,Skill 可在向量检索与分词检索之间选用合适方式;外部库检索每次成功调用会计入 global-biblio-base 配额。
适用场景与注意¶
适合谁:需要文献管理、知识积累、论文写作辅助、研究调研的学术用户;希望 Agent 能同时查 SmartLib、管本地库、维护 Wiki 知识层的人。
使用前提:标签 requires_api_key=true;做全球文献检索需 global-biblio-base 网关与配额。未配置或配额用尽时,外部检索会暂停。
版本与来源:社区 Skill,版本 v3.11.3;与 global-biblio-base v3.9.0 计次规则、SmartLib Gateway v52.1 在说明中一并提及,升级 Skill 或依赖包时注意版本说明是否变化。
平台数据(SkillHub 抓取):评分 100000,下载 12310 次,供选型参考。
结尾¶
个人文献知识库把 Wiki 编译、SmartLib 检索、向量与分词搜索、专题与参考文献管理收进一个 Skill,并强调来源链接保留与多源交叉验证,适合把「查文献」和「攒知识」放在同一条 Agent 工作流里。官方页面与 API 入口:
- https://www.skillhub.cn/skills/user_164f4c1f/academic-knowledge-base
- https://api.skillhub.cn/user_164f4c1f/academic-knowledge-base