📌Skill基础信息
Skill名称:paper-search-pro
简称:PSP
来源:社区第三方(O0000-code)
运行宿主:Claude-Code CLI、Cursor、MCP兼容Agent工具
核心定位:跨7大学术源(OpenAlex/Semantic Scholar/CrossRef/PubMed/arXiv + 中文NSSD/yiigle)的智能文献检索系统,支持从快速扫描(5分钟)到系统审查(3小时)的多层级搜索深度,专为中英文文献检索和期刊分级过滤而设计。
🧩内部核心组成
核心架构
- 主Agent:工作流协调器
- Python助手:确定性数据处理(无LLM,无外部API密钥)
- 内联子Agent:并行分类器(文件IPC通信,5个/消息)
数据源体系
L1 - OpenAlex(主引擎):深度Top-100多策略检索
L2 - PubMed(医学):MeSH增强检索
L2 - arXiv(CS/预印本):T-0~T-4新鲜度监控
L3 - Semantic Scholar:高引计数+摘要备用
L3 - CrossRef:基金/许可/临床试验号
中文 - NSSD(国家哲社文献中心)+ yiigle(中华医学期刊)
命令/工具表格
| 命令/工具 | 功能简述 |
|---|---|
| agent_search | Agent模式单命令检索(JSON输出) |
| detect_language | 查询语言检测(中英文识别) |
| parse_rank_intent | 期刊分级意图解析(中科院分区/Q过滤) |
| config检查 | API密钥和配置验证 |
目录结构
scripts/ - Python核心模块
references/ - 详细参考文档(setup.md, tier_decision.md等)
paper-search-results/ - 输出目录(原始数据/批次/分类结果)
🛠安装与启用方式
安装命令:
skills install --user O0000-code/paper-search-pro
关键步骤:
- 通过上述命令安装到Agent技能目录
- 设置环境变量
PSP_HOME指向技能安装路径 - 配置5个免费API密钥(OpenAlex、NCBI邮箱等)
- 从用户工作目录启动,禁止cd到技能目录
前置依赖:
- Python 3环境
- Bash shell支持
- 免费的学术API访问权限
📋标准工作流
四层搜索深度
| 层级 | 耗时 | 论文量 | 适用场景 |
|---|---|---|---|
| Quick | 5-8分钟 | 20-60篇 | 快速查阅/初步调研 |
| Standard | 10-17分钟 | 60-180篇 | 主题范围确定/背景写作 |
| Deep | 30-45分钟 | 180-400篇 | 综述文章写作 |
| Audit | 2-3小时 | 400-1000+篇 | 系统评价/PRISMA流程 |
标准工作流程
- STEP 0 - 环境设置(PSP_HOME、工作目录)
- STEP 1 - 查询规划(语言检测、期刊分级意图解析)
- STEP 2-5 - 多源检索执行(OpenAlex为主,其他源补充)
- STEP 6 - 并行子Agent分类(5个并行任务)
- STEP 7-14 - 结果去重、相关性评分、饱和检测、期刊指标计算
- 输出 - Shadcn HTML报告 + BibTeX/RIS/CSV + PRISMA-S日志
⚠️关键限制、缺陷、注意事项
平台限制:
- 仅支持具有Bash环境的Agent工具
- 需要Python 3运行时环境
Token消耗:
- 标准层级:中等token消耗(主要来自子Agent分类)
- Audit层级:高token消耗(大量论文处理)
适用项目:
- 学术文献检索
- 中英文混合文献调研
- 系统评价/meta分析前期工作
不适用场景:
- 单篇论文阅读/总结(使用PDF阅读器)
- 已知文献集的综述写作(使用literature-set-review)
- 概念解释("X是什么"类问题)
- PDF下载(使用paper-downloader-portable)
生产环境适用性:✅ 可用于生产环境,但需注意:
- 需要稳定的API访问
- Audit层级的长时间运行可能超时
- 中文检索依赖NSSD和yiigle的稳定性
✅适用场景 & ❌不适合场景
✅适用场景
- 研究人员:进行文献综述、系统评价准备
- 学生:论文开题、课程作业文献收集
- 学术作者:领域范围界定、背景研究
- 中文研究者:需要检索中文核心/CSSCI期刊文献
- 医学研究者:需要PubMed和中华医学期刊检索
❌不适合场景
- 单篇论文深度分析(使用专门的阅读工具)
- 实时对话式问答(概念解释类问题)
- 已有文献集的处理(使用文献集处理技能)
- 纯娱乐性或非学术性内容检索
- 需要即时响应的简单查询(过度工程化)
如何安装
skills install --user O0000-code/paper-search-pro通用安装教程:在哪里输入上面的命令
上面的命令本质是在「终端 / 命令行」中调用技能管理器,把该 Skill 下载并注册到你的 AI 工具。各主流工具打开终端的位置不同,按下面操作即可:
- 打开工具自带的终端面板,或系统终端(macOS「终端」、Windows「PowerShell」、Linux「Terminal」)。
- 把上面的安装命令复制进去,回车运行,等待下载与注册完成。
- 重启或重新加载 AI 工具,让新安装的 Skill 被识别。
- 新建对话并触发:直接描述用途,或通过该工具的技能 / 斜杠菜单选中此 Skill。
Claude 桌面版(macOS / Windows)
桌面版没有内置命令行,Skill 需通过 Claude Code CLI 安装。打开系统终端,先执行 npm install -g @anthropic-ai/claude-code,再运行上面的安装命令;完成后完全退出并重新打开 Claude。
Claude Code(终端 CLI)
直接在项目目录的终端里运行上面的命令即可。也可先输入 claude 启动交互界面,再在对话中引用该 Skill(/ 斜杠菜单或直接描述用途)。
VS Code(含 GitHub Copilot)
打开终端面板:菜单「终端 → 新建终端」,或快捷键 Ctrl+`(macOS 为 ⌃+`)。在终端里运行上面的命令;装完后执行「重新加载窗口」(Ctrl+Shift+P → Reload Window),让 Copilot 等扩展识别新技能。
Cursor
底部「终端」面板(Ctrl+`)即是内置终端。粘贴运行上面的命令,完成后在命令面板执行「Reload Window」刷新,再开始对话。
Windsurf
底部「终端」面板运行命令;也可直接使用其内置 Agent 终端,在对话侧执行安装。
其他工具(ChatGPT、本地脚本等)
不支持本地终端的产品,可先在本机终端完成安装,再在对话中描述该 Skill 的能力让其调用;不同工具的命令格式请以其官方文档为准。
风险提示
本 Skill 涉及读取隐私 / 敏感信息(如密钥、环境变量、凭据)。安装前请确认其用途是否必要。
检测到隐私/敏感信息读取(预设模式 #6)
命中检测项
- privacy_collect
Aitishiku.com