前言¶
项目里堆着 Word、PDF、Markdown 和 TXT，用关键词搜往往漏掉「意思相近、措辞不同」的段落。自己接 embedding、向量库和检索链路，开发和维护成本都不低。下面介绍 SkillHub 上的社区 Skill「文档向量检索」，把文档向量化、存储和语义检索收进 Agent 可调用的能力里；简介中说明在 v3.0 侧增加了查询缓存与 BM25 加向量的混合检索，且标注 requires_api_key=false，不依赖外部 API Key。
这是什么¶
「文档向量检索」是 SkillHub 分类 knowledge-management 下的社区 Skill，坐标为 @user_af28adda/chromadb-document-vectorizer，SkillHub 页面版本为 1.0.0，来源 community，发布者为 user_af28adda（页面展示作者为 Captain）。定位是：处理文档向量化、存储和语义检索；当用户需要向量化文档、查找相似内容或对文档集合做语义查询时，由 Agent 按需 Invoke。
核心功能¶
以下能力均来自 SkillHub 官方简介与详情页，未在资料中出现的实现细节不写。
- 多格式文档：支持 Word、Markdown、PDF、TXT 等格式的处理与检索。
- 向量化与存储：完成文档向量化并持久化，供后续检索使用。
- 语义检索：按语义相似度在文档集合中查找内容，而不只依赖字面匹配。
- v3.0 能力（简介所述）：查询缓存（简介称速度提升约 70 倍）；混合检索，结合 BM25 与向量检索。
- 触发场景（英文 Invoke 说明）：用户需要向量化文档、搜索相似内容，或对文档集合执行语义查询时使用。
安装与启用¶
Skill 基于通用 SKILL.md 格式。在 SkillHub 安装时，需把技能装到当前 Agent 能识别的 skills 目录，否则默认落在 ./skills/ 可能不会被加载。
方式一：SkillHub CLI¶
先确认是否已安装 CLI：
command -v skillhub && skillhub --version
未安装时可按 SkillHub 安装文档执行完整安装或仅 CLI（限网环境需允许联网）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时指定目标目录（将 <skills 目录> 换成当前环境路径）：
skillhub install user_af28adda/chromadb-document-vectorizer --dir <skills 目录>
常用目录示例（以 SkillHub 安装文档为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
方式二：让 AI 按官方指引安装¶
SkillHub 详情页提供的提示为：根据 https://skillhub.cn/install/skillhub.md 安装 @user_af28adda/chromadb-document-vectorizer。
资料中未单独列出 Cursor、Codex CLI、Claude Code 的安装差异，除 skills 目录路径外，安装步骤与上述 CLI 或 AI 指引一致。
典型用法¶
公开页面未给出可复制的一步步命令示例（例如具体脚本名或配置文件字段）。可复现的用法边界如下：
- 按上一节完成安装并确保 Skill 位于当前 Agent 的 skills 目录。
- 在对话中提出与官方 Invoke 说明一致的需求，例如：将某批 PDF/Markdown 纳入检索、用自然语言问题在文档库中找相似段落、对已有文档集合做语义查询。
- Agent 加载该 Skill 后，按 SKILL.md 中的流程执行向量化、存储与检索；混合检索与查询缓存行为以 Skill 内文档与 v3.0 说明为准。
若需核对安装包内容与具体工具调用，可在安装后阅读技能目录内的 SKILL.md（资料未截断其正文，本文不展开未核实项）。
适用场景与注意¶
适合谁：需要在 Agent 工作流里做本地或项目内文档语义搜索、相似内容查找的团队或个人；希望减少自研向量管线时，可先评估该 Skill 是否覆盖自己的格式与检索方式。
社区与版本：来源为 community，SkillHub 展示版本为 1.0.0，简介中的 v3.0 指 Skill 自述的功能代际，与商店包版本号可能不一致，以实际安装包为准。
数据与合规：处理 Word/PDF 等文件时注意版权与敏感信息；向量与索引的落盘位置以 Skill 实现为准，生产环境部署前应在本地核对。
商店数据（截至页面展示）：评分 100000，下载 1113，安装 12；标签含 requires_api_key=false。
结尾¶
「文档向量检索」把多格式文档向量化、存储与语义检索（含简介中的混合检索与查询缓存）封装为 Agent Skill，适合在知识管理类任务中按需 Invoke。官方入口：
