1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | nemo-retriever-nvidia-skills |
| 项目自述名称 | NeMo Retriever |
| 作者/维护者 | NVIDIA Corporation |
| 来源链接 | https://github.com/nvidia/skills/tree/main/skills/nemo-retriever |
| 许可证 | Apache-2.0（数据来源：GitHub API / SKILL.md front matter） |
| GitHub Stars | 2,963（数据来源：GitHub API，取自底层产品仓库 NVIDIA/NeMo-Retriever） |
| Forks | 339（数据来源：GitHub API，同上） |
| 最新版本 | 未获取（未标注独立版本号） |
| 安装方式 | npx skills CLI |
⚠️ 上述 Stars/Forks 属 NeMo Retriever 独立产品仓库，不是本技能所在的 nvidia/skills 合集仓库的整体星数。
2. 功能介绍与亮点
nemo-retriever 提供一个 retriever 命令行工具：把一个文件夹的文档一次性索引进本地向量数据库 LanceDB，随后即可做语义检索和问答。
- 覆盖格式广：PDF、扫描图片、Office（docx/pptx）、HTML/文本、音频、视频均可索引。
- 不止语义搜索：还支持按页过滤、逐字引用带出处、跨语料聚合统计。
- 两条推理路径：本地 GPU（CUDA 13.x）用随附嵌入模型；无 GPU 时可接远程 NIM 端点，安装脚本自动探测选择。
- 官方定位：本地部署 NeMo Retriever Library，从语料库提取信息并针对语料库回答问题。
3. 适用场景
固定分类：数据分析与可视化
适合需要对一批异构文档做检索问答、又不想自建 RAG 流水线的场景：整理合同或法律文件后按条款提问、在论文库里语义搜索、把会议录音或培训视频转成可检索知识库。目标用户是处理多格式语料库的开发者、研究人员与知识工作者。
4. 跨 Agent 兼容性
- Claude Code：原生支持（官方
--agent claude-code安装目标）。 - Codex：原生支持（官方安装目标列表包含）。
- OpenClaw：未验证（官方列表未提及）。
- Hermes Agent：未验证（官方列表未提及）。
依据：nvidia/skills README 列出的 --agent 支持为 Claude Code、Codex、Snowflake CoCo、Cursor、Kiro。
5. 推荐理由
把“给 agent 一批异构文档、让它能准确回答问题”打包成现成 CLI：agent 按两步流程（建索引→查询）操作，无需现写 RAG 逻辑，支持格式（含音视频）比多数同类技能更广。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 8 | 底层产品仓库 2,963 stars、339 forks；NVIDIA 为该产品第一方所有者 |
| 可用性 | 7 | 安装脚本自动探测 GPU/CUDA 并选方案，文档按阶段分层；无 GPU 需额外配置远程端点，目录最近提交 2026-06-01 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单：①uv安装依赖、按需sudo apt-get装libreoffice/ffmpeg，均为具名工具；②仅无本地GPU时把内容发往用户自选的远程端点向量化，非静默外发；③API key仅远程路径需要，经参数/环境变量传入；④未发现可疑指令；⑤NVIDIA官方仓库发布；⑥License明确（Apache-2.0）；⑦目录最近提交2026-06-01。
7. 跟同类 Skills 相比的优势
| 同类项目 | 定位 | 与本技能的差异 |
|---|---|---|
| chroma-local | Chroma 向量库本地使用指南 | 只覆盖存取 API，文档解析/分块需自行编排；本技能把整条链路封装为两条命令 |
| weaviate | Weaviate 客户端使用指南 | 聚焦向量库 schema/查询语法，不含文档格式解析层；本技能原生支持音视频转录与 Office 解析 |
| pinecone-quickstart | 托管向量数据库接入指南 | 依赖 Pinecone 云端服务；本技能可完全本地部署，不强制依赖第三方云 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。其底层产品仓库有 228 个公开 issue 与独立 Discussions 板块，但讨论面向 NeMo Retriever Library 整体，未见专门针对该 agent skill 的评价。
9. 其他补充
底层产品仓库采用每日自动同步把技能内容镜像进 nvidia/skills，该技能的实际维护活动发生在产品自身仓库。
10. 安装使用方式
# 通过官方 skills CLI 安装（会提示选择安装目标）
npx skills add nvidia/skills --skill nemo-retriever
# 或直接指定 Claude Code 为安装目标
npx skills add nvidia/skills --skill nemo-retriever --agent claude-code安装后在 Claude Code 中运行 /reload-skills 使新技能生效。首次对一批文档提问时会先建立索引（retriever ingest），后续提问直接查询（retriever query）。
11. 注意事项
- 无本地 GPU 时须自备可访问的远程 NIM 推理端点，否则语义检索不可用。
- 本地 GPU 加速要求 CUDA 版本精确匹配 13.x，不符会自动降级为无本地嵌入模式。
- 处理
.docx/.pptx需装 LibreOffice，处理音视频需装 ffmpeg。 - 混合格式目录建索引前建议核对扩展名，
--input-type=auto会静默丢弃不支持的格式。