前言¶
寫綜述、做課題調研時，常見路徑是反覆打開 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
