前言¶
写综述、做课题调研时，常见路径是反复打开 arXiv、Semantic Scholar 或校内数据库，把标题和 PDF 先堆到本地，再用文件名或笔记工具慢慢翻。索引一旦散落在多个文件夹，关键词检索往往靠肉眼或通用全文搜索，和「按论文元数据、经典条目快速定位」的需求对不上。
下面介绍 SkillHub 上的社区 Skill「论文秒搜」（坐标 @user_3cdbf8ea/paper-search，当前版本 v1.0.4）。它定位为 Python 技能：在 Agent 侧按 SKILL.md 约定驱动纯 Python 实现，强调学术论文的本地检索与导出，并内置经典论文索引；页面标注 requires_api_key=false，不依赖额外 API Key 配置。
这是什么¶
「论文秒搜」由社区发布者 user_3cdbf8ea 维护，来源为 community，在 SkillHub 分类为 knowledge-management（知识管理）。官方简介概括为：
[Python技能] 论文秒搜 - 学术论文本地检索与导出，内置经典论文索引，纯Python实现
和「每次联网查一篇再手动下载」相比，它把检索、导出与本地索引能力封装成 Agent 可加载的 Skill，由对话触发，具体步骤写在安装包内的 SKILL.md 中。截至 SkillHub 页面与 API 摘要信息，评分为 100000，下载约 13333 次（统计以 SkillHub 展示为准）。
核心功能¶
以下能力均来自官方简介与 SkillHub 元数据，未在公开页展开的实现细节不展开臆测：
- 学术论文本地检索：在本地侧完成检索流程，减少反复切换外部站点查单篇的习惯性操作。
- 导出：支持将检索结果或论文相关材料导出（具体格式与路径以安装后的
SKILL.md为准）。 - 内置经典论文索引：自带经典论文索引，便于按常见文献条目快速定位，而非仅从空目录起步建库。
- 纯 Python 实现：实现语言为 Python，便于在已有 Python 环境的机器上与 Agent 技能目录一并部署。
- 无需 API Key：标签
requires_api_key=false，安装与启用时不以配置第三方 API Key 为前提。
安装与启用¶
SkillHub 推荐通过官方安装说明安装 CLI，再把技能装进当前 Agent 的 skills 目录；装错目录时 Agent 可能无法识别，需要按文档使用 --dir。
1. 安装 SkillHub CLI（若尚未安装）¶
先检查是否已安装：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档 执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
若只需要 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装「论文秒搜」¶
官方 Skill 页给出的安装提示为：依据 https://skillhub.cn/install/skillhub.md，安装 @user_3cdbf8ea/paper-search。
在已具备 skillhub 的前提下，将技能安装到当前 Agent 对应的 skills 目录（文档要求必须指定 --dir）：
skillhub install user_3cdbf8ea/paper-search --dir <skills 目录>
常见客户端的 skills 路径（摘自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
也可把官方页上的提示词发给 AI，让其按同一文档完成安装，例如：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_3cdbf8ea/paper-search`。
安装完成后，重启或重新加载 Agent，使其读取新目录下的 SKILL.md。
典型用法¶
公开 Skill 页未列出独立 CLI 示例外，可复现的入口只有两类：
- 通过 SkillHub 流程安装，确认
SKILL.md已出现在上述 skills 目录中。 - 在对话中说明检索与导出意图，由 Agent 按
SKILL.md调用内置 Python 逻辑，例如：按关键词在本地索引中查找论文、导出某次检索结果、查阅内置经典论文条目等。
具体子命令、脚本路径、索引数据位置与导出字段，以安装包内 SKILL.md 及附带脚本为准；本文不写未在官方摘要中出现的命令行参数。
适用场景与注意¶
适合谁
- 需要把「找论文、落本地、再检索」收成一条 Agent 工作流的研究人员或工程师。
- 希望使用纯 Python、且不想为 Skill 本身配置 API Key 的用户（以 SkillHub 标签为准）。
- 已在 Cursor、Claude Code、Codex 等支持 skills 目录的客户端中日常使用 SkillHub 安装流程的团队。
限制与注意
- 来源为 community，维护节奏与索引更新策略需自行关注 SkillHub 上的版本号（当前 v1.0.4）。
- 本地检索依赖本机已建立的索引与 Skill 自带经典索引；与实时联网全文库的行为不同，预期应区分。
- 安装统计中的「安装 0」与下载量并存时，以你本机
skills目录是否实际出现该 Skill 为准。 - 评分与下载量为平台展示数据，会随时间变化，引用时以 SkillHub 页面为准。
结尾¶
「论文秒搜」把学术论文的本地检索、导出和经典论文索引收进一个纯 Python 的 SkillHub 知识管理类技能，适合接到 Cursor 等环境的 skills 目录里，用对话驱动文献整理。官方 Skill 页与 API 入口：
- https://www.skillhub.cn/skills/user_3cdbf8ea/paper-search
- https://api.skillhub.cn/user_3cdbf8ea/paper-search
